Skip to main content

Withdrawal Webhooks

Withdrawal webhooks have a different payload structure than invoice webhooks, with transaction details included.

Status Values

StatusTriggered when
processingWithdrawal initiated and/or transaction received by blockchain (sent twice — see below)
doneWithdrawal completed on both platform and blockchain side
rejectedWithdrawal blocked by AML/TMS checks and/or failed on blockchain side
Two processing webhooks

Each withdrawal triggers the processing webhook twice:

  1. First — sent when the withdrawal is initiated. txHash is empty at this stage.
  2. Second — sent when the transaction is received by the blockchain. txHash is now populated.

Payload Fields

typestring

Always "withdrawal".

statusstring

processing, done, or rejected.

assetstring

Withdrawn asset (e.g., usdt).

dchainstring

Asset + network (e.g., trc20usdt).

amountnumber

Withdrawn amount.

feestring

Withdrawal fee.

tostring

Receiver wallet address.

txHashstring

Blockchain transaction link (empty for first processing and rejected).

uidstring

Internal UUID from the withdrawal API response.