Payout

📡 Payout Callbacks (Webhooks)

These are server-side callbacks sent to the merchant's server whenever the status of payout changes.

Payout Callback

• Triggered when:

  • A payout is created, processed, completed, or failed

• The callback sends the current payout status and related info to the provided callbackUrl.

Callback body example

Successful

{
  "id": "9f9cf80f-be0c-4052-9c60-648c482d798c",
  "status": 1,
  "statusName": "Successful",
  "fiatAmount": "0.00",
  "fiatCurrency": "USD",
  "payCurrency": "ETH_ETHEREUM",
  "fromAddress": "0x1000000000000000000000000000000000000000",
  "address": "0x0000000000000000000000000000000000000000",
  "createDate": "2026-01-13 17:04:23.024",
  "modifiedDate": "2026-01-13 17:13:10.776",
  "transactionId": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "withdrawalAmount": "0.00600000",
  "transferAmount": "0.00400000",
  "blockchainFee": "0.00200000",
  "payoutCommissionPercentage": "0",
  "isApiCalled": true,
  "creationWay": "API",
  "uniqueUserId": "SQCGMWJZ",
  "description": "",
  "merchantId": "CJGUEQV0",
  "callbackUrl": "https://webhook.site/"
}

Unpaid

Rejected

Notes:

• These callbacks enable your server to automatically update the order/payment status based on real-time data from TheDex.

• Callbacks can be manually re-sent from the admin panel in case of delivery failure or testing purposes.

• For testing callback URLs, services like https://webhook.site/ can be used.