Webhooks
Danatorex POSTs signed JSON to your configured endpoint when a partner conversion or withdrawal reaches a terminal status.
Events
| Event | When |
|---|---|
conversion.terminal | Conversion finished in a terminal status |
withdrawal.terminal | Crypto withdrawal finished as done or failed |
Headers
| Header | Purpose |
|---|---|
x-danatorex-timestamp | Unix timestamp (seconds) used in the signature |
x-danatorex-signature | Hex HMAC-SHA256 |
Verification
- Reject if absolute skew between
x-danatorex-timestampand your clock exceeds 600 seconds. - Compute HMAC-SHA256 over
timestamp + "." + rawBody, whererawBodyis the exact request body bytes/string. - Compare to
x-danatorex-signatureusing a constant-time compare.
signature = hex(HMAC-SHA256(webhookSecret, timestamp + "." + rawBody))
Payload shape (schemaVersion: 1)
conversion.terminal
{
"schemaVersion": 1,
"event": "conversion.terminal",
"conversionId": 101,
"clientOrderId": "ord_9f3c2a",
"externalUserId": "user-42",
"status": "completed",
"sourceSymbol": "USDT",
"targetSymbol": "BTC",
"sourceAmount": "100.5",
"targetAmount": "0.001",
"filledSourceAmount": "100.5",
"filledTargetAmount": "0.001",
"fee": "0.25",
"refId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"timestamp": "2026-09-05T09:00:00.000Z"
}
withdrawal.terminal
{
"schemaVersion": 1,
"event": "withdrawal.terminal",
"withdrawalId": 101,
"clientOrderId": "wd_9f3c2a",
"externalUserId": "user-42",
"status": "done",
"symbol": "USDT",
"network": "BSC",
"amount": "5",
"fee": "1",
"transferAmount": "4",
"refId": "local-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"txHash": "0xabc…",
"receiverAddress": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
"timestamp": "2026-09-05T09:00:00.000Z"
}
Bump handling when schemaVersion increases in a breaking way.
Retries
Failed deliveries are retried with backoff (outbox worker). Respond quickly with 2xx after durable processing. Non-2xx responses schedule another attempt until the attempt budget is exhausted.
Configure endpoint URL and signing secret with your Danatorex contact.