Skip to main content

Webhooks

Danatorex POSTs signed JSON to your configured endpoint when a partner conversion or withdrawal reaches a terminal status.

Events​

EventWhen
conversion.terminalConversion finished in a terminal status
withdrawal.terminalCrypto withdrawal finished as done or failed

Headers​

HeaderPurpose
x-danatorex-timestampUnix timestamp (seconds) used in the signature
x-danatorex-signatureHex HMAC-SHA256

Verification​

  1. Reject if absolute skew between x-danatorex-timestamp and your clock exceeds 600 seconds.
  2. Compute HMAC-SHA256 over timestamp + "." + rawBody, where rawBody is the exact request body bytes/string.
  3. Compare to x-danatorex-signature using 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.