Insufficient Balance Notification Callback

{
  "business": 0,
  "requestUUID": "8a900d65-65a7-4a71-a6eb-e1ec0d44d106",
  "tenantUserId": "ryan_test_2",
  "callBackId": "D682988196",
  "type": 6,
  "trackingId": "102006"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "errCode": 0,
  "data": "{\"tenantUserId\":\"ryan_test_2\",\"callBackId\":\"D682988196\",\"requestUUID\":\"8a900d65-65a7-4a71-a6eb-e1ec0d44d106\",\"trackingId\":\"102006\",\"type\":6}"
  "message": ""
}

NOTIFY_NOT_ENOUGH_MONEY (type=6) When a withdrawal operation temporarily fails due to insufficient hot wallet balance, WaaS notifies the merchant through this callback. This is a temporary failure state. After the merchant replenishes the hot wallet balance, this withdrawal order will automatically retry.

Key Points

Temporary Failure: Withdrawal operation not yet successful but recoverable
Funds Remain Frozen: User funds remain frozen for subsequent retry
Next Steps: After merchant replenishes hot wallet balance, WaaS automatically retries this withdrawal order

Request Parameters

The request sent by WaaS is an RSA-encrypted Base64 string. Merchants need to decrypt to obtain business parameters:

object

Show View Full Parameter List

String

required

Merchant must ensure the uniqueness of this callBackId. WaaS will actively callback the merchant carrying this parameter to notify which withdrawal order triggered the callback due to insufficient balance.

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:

object

Show View Full Parameter List

String

required

Merchant API key

String

required

Encrypted business data, e.g.: BDn6Liv5Z4TJ9vjfd (refer to example on right)Generated by encrypting the following raw business parameters:requestUUID (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)type (Integer) : Callback typetrackingId (String) : Business event identifiercallBackId (String) : Callback ID

Integer

required

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

String

required

Error details (required when failed):

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

{
  "business": 0,
  "requestUUID": "8a900d65-65a7-4a71-a6eb-e1ec0d44d106",
  "tenantUserId": "ryan_test_2",
  "callBackId": "D682988196",
  "type": 6,
  "trackingId": "102006"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "errCode": 0,
  "data": "{\"tenantUserId\":\"ryan_test_2\",\"callBackId\":\"D682988196\",\"requestUUID\":\"8a900d65-65a7-4a71-a6eb-e1ec0d44d106\",\"trackingId\":\"102006\",\"type\":6}"
  "message": ""
}

Introduction

Integration Guide

System Flowchart

Checkout

API List

Webhook

Insufficient Balance Notification Callback

Key Points

Request Parameters

Response Parameters

​Key Points

​Request Parameters

​Response Parameters

Key Points

Request Parameters

Response Parameters