Withdrawal Webhooks
Withdrawal webhooks have a different payload structure than invoice webhooks, with transaction details included.
Status Values
| Status | Triggered when |
|---|---|
processing | Withdrawal initiated and/or transaction received by blockchain (sent twice — see below) |
done | Withdrawal completed on both platform and blockchain side |
rejected | Withdrawal blocked by AML/TMS checks and/or failed on blockchain side |
Two
processing webhooksEach withdrawal triggers the processing webhook twice:
- First — sent when the withdrawal is initiated.
txHashis empty at this stage. - Second — sent when the transaction is received by the blockchain.
txHashis now populated.
Payload Fields
typestringAlways "withdrawal".
statusstringprocessing, done, or rejected.
assetstringWithdrawn asset (e.g., usdt).
dchainstringAsset + network (e.g., trc20usdt).
amountnumberWithdrawn amount.
feestringWithdrawal fee.
tostringReceiver wallet address.
txHashstringBlockchain transaction link (empty for first processing and rejected).
uidstringInternal UUID from the withdrawal API response.