Insufficient Gas Notification Callback

{
  "business": 0,
  "requestUUID": "5aceadbb-0783-4d38-895a-3418127c5f10",
  "tenantUserId": "1945",
  "callBackId": "250529528850002",
  "type": 7,
  "trackingId": "101934"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "errCode": 0,
  "data": "{\"type\":7,\"callBackId\":\"250529528850002\",\"trackingId\":\"101934\",\"requestUUID\":\"5aceadbb-0783-4d38-895a-3418127c5f10\",\"tenantUserId\":\"1945\"}"
  "message": ""
}

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

Key Points

Insufficient Gas Fees: Hot wallet lacks sufficient main coin to pay network transaction fees
Funds Remain Frozen: User withdrawal funds remain frozen
Next Steps: After replenishing main coin balance in hot wallet, WaaS automatically retries withdrawal

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 Gas.

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’s unique API identifier

String

required

Encrypted business data, e.g.: i2H9eQf22gLnJoTeo1WbWVR6wmNv (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": "5aceadbb-0783-4d38-895a-3418127c5f10",
  "tenantUserId": "1945",
  "callBackId": "250529528850002",
  "type": 7,
  "trackingId": "101934"
}

{
  "apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
  "errCode": 0,
  "data": "{\"type\":7,\"callBackId\":\"250529528850002\",\"trackingId\":\"101934\",\"requestUUID\":\"5aceadbb-0783-4d38-895a-3418127c5f10\",\"tenantUserId\":\"1945\"}"
  "message": ""
}

Introduction

Integration Guide

System Flowchart

API List

Webhook

Insufficient Gas Notification Callback

Key Points

Request Parameters

Response Parameters

​Key Points

​Request Parameters

​Response Parameters

Key Points

Request Parameters

Response Parameters