Withdrawal Notification Callback

{
  "tenantUserId": "1945",
  "requestUUID": "00f2faf7-b705-4d65-9d82-0b6e372b92e4",
  "txId": "598433d2fe70a2e944bbda8b517cca36e0cf7cfe49642b569e73cf1a641148cb",
  "type": 3,
  "chainName": "TRON",
  "symbol": "USDT",
  "amount": "2.500000000000",
  "fromAddress": "TBmNNTP84QSRW8Dvb1aCBk7GmxQnNS5rAb",
  "toAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
  "business": 0,
  "callBackId": "250624392590001",
  "newAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
  "trackingId": "102003"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "data": "{\"type\":3,\"callBackId\":\"250624392590001\",\"trackingId\":\"102003\",\"txId\":\"598433d2fe70a2e944bbda8b517cca36e0cf7cfe49642b569e73cf1a641148cb\",\"chainName\":\"TRON\",\"symbol\":\"USDT\",\"amount\":\"2.500000000000\",\"fromAddress\":\"TBmNNTP84QSRW8Dvb1aCBk7GmxQnNS5rAb\",\"toAddress\":\"TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK\",\"requestUUID\":\"00f2faf7-b705-4d65-9d82-0b6e372b92e4\",\"tenantUserId\":\"1945\"}",
  "errCode": 0,
  "message": ""
}

{
  "tenantUserId": "1945",
  "requestUUID": "00f2faf7-b705-4d65-9d82-0b6e372b92e4",
  "txId": "598433d2fe70a2e944bbda8b517cca36e0cf7cfe49642b569e73cf1a641148cb",
  "type": 3,
  "chainName": "TRON",
  "symbol": "USDT",
  "amount": "2.500000000000",
  "fromAddress": "TBmNNTP84QSRW8Dvb1aCBk7GmxQnNS5rAb",
  "toAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
  "business": 0,
  "callBackId": "250624392590001",
  "newAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
  "trackingId": "102003"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "data": "{\"type\":3,\"callBackId\":\"250624392590001\",\"trackingId\":\"102003\",\"txId\":\"598433d2fe70a2e944bbda8b517cca36e0cf7cfe49642b569e73cf1a641148cb\",\"chainName\":\"TRON\",\"symbol\":\"USDT\",\"amount\":\"2.500000000000\",\"fromAddress\":\"TBmNNTP84QSRW8Dvb1aCBk7GmxQnNS5rAb\",\"toAddress\":\"TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK\",\"requestUUID\":\"00f2faf7-b705-4d65-9d82-0b6e372b92e4\",\"tenantUserId\":\"1945\"}",
  "errCode": 0,
  "message": ""
}

NOTIFY_WITHDRAW (type=3) When a user completes a withdrawal operation through WaaS, WaaS will notify you of the withdrawal details through this callback. The merchant needs to confirm in the response whether this callback has been accepted.

Request Parameters

The request sent by WaaS is an RSA-encrypted Base64 string. Merchants need to decrypt it using their public key to obtain the following business parameters:

Withdrawal Callback Request Parameters

object

Show View Full Parameter List

type

Integer

required

Callback type, withdrawal callback=3

txId

String

required

Blockchain transaction hash

chainName

String

required

Chain name, e.g., TRON, ETH, BSC…

symbol

String

required

Token symbol, e.g., USDT, USDC, PHT…

amount

BigDecimal

required

Actual withdrawal amount

fromAddress

String

required

Withdrawal source address

toAddress

String

required

Withdrawal target address

callBackId

String

required

callBackId carried by merchant when requesting withdrawal. Note: Merchant must ensure its uniqueness

newAddress

string

required

New address, replaces toAddress when type=4

Response Parameters

After processing the callback, merchants need to return a JSON-formatted response body. The data field must return an RSA-encrypted Base64 string (encrypted using the public key provided by WaaS), while other fields are in plain text:

Withdrawal Callback Response Parameters

object

Show View Full Parameter List

apiKey

String

required

Merchant API key

data

String

required

Encrypted business data, e.g.: BDn6Liv5Z4TJ9vjfd (refer to example on right)Generated by encrypting the following raw business parameters:type (Integer) : Callback typecallBackId : Merchant must return callBackId to help WaaS with secondary confirmationtrackingId (String) : Business event identifiertxId (String) : Blockchain transaction hashchainName (String) : Blockchain namesymbol (String) : Token symbolamount (Integer) : Withdrawal amountfromAddress (String) : Withdrawal source addresstoAddress (String) : Withdrawal target addressrequestUUID (String) : Unique request identifier, merchant must return the same requestUUID in response to help WaaS confirmtenantUserId (String) : User ID initiating withdrawal (in merchant system, not WaaS system)

errCode

Integer

required

Global processing status code: 0=Success, non-0=Failure

message

String

required

Error details (required when failed):

Can return empty string when successful
Must describe specific error when failed

{
  "tenantUserId": "1945",
  "requestUUID": "00f2faf7-b705-4d65-9d82-0b6e372b92e4",
  "txId": "598433d2fe70a2e944bbda8b517cca36e0cf7cfe49642b569e73cf1a641148cb",
  "type": 3,
  "chainName": "TRON",
  "symbol": "USDT",
  "amount": "2.500000000000",
  "fromAddress": "TBmNNTP84QSRW8Dvb1aCBk7GmxQnNS5rAb",
  "toAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
  "business": 0,
  "callBackId": "250624392590001",
  "newAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
  "trackingId": "102003"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "data": "{\"type\":3,\"callBackId\":\"250624392590001\",\"trackingId\":\"102003\",\"txId\":\"598433d2fe70a2e944bbda8b517cca36e0cf7cfe49642b569e73cf1a641148cb\",\"chainName\":\"TRON\",\"symbol\":\"USDT\",\"amount\":\"2.500000000000\",\"fromAddress\":\"TBmNNTP84QSRW8Dvb1aCBk7GmxQnNS5rAb\",\"toAddress\":\"TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK\",\"requestUUID\":\"00f2faf7-b705-4d65-9d82-0b6e372b92e4\",\"tenantUserId\":\"1945\"}",
  "errCode": 0,
  "message": ""
}

Deposit Notification Callback Withdrawal Secondary Confirmation Callback

Introduction

Integration Guide

System Flowchart

Checkout

API List

Webhook

Withdrawal Notification Callback

Request Parameters

Response Parameters

Introduction

Integration Guide

System Flowchart

Checkout

API List

Webhook

​Request Parameters

​Response Parameters

Request Parameters

Response Parameters