Documentation Index
Fetch the complete documentation index at: https://xaferapi.apacx.io/llms.txt
Use this file to discover all available pages before exploring further.
NOTIFY_NOT_ENOUGH_MONEY (type=6)
当提币操作因热钱包余额不足而暂时失败时,WaaS会通过此回调通知商户。这是一个临时性失败状态,商户补充热钱包余额后,该提币单会自动重试处理。
核心说明
- 临时性失败:提币操作暂未成功,但可恢复
- 资金保持冻结:用户资金保持冻结状态,待后续重试
- 后续操作:商户补充热钱包余额后,WaaS会自动重试该提币单
请求参数
WaaS发送的请求是经过RSA加密的Base64字符串,商户需解密获取业务参数:
商户需确保该 callBackId 的唯一性。WaaS 将携带该参数主动回调商户,以通知商户哪一笔提币订单因余额不足而触发了回调。
响应参数
商户处理完回调后,需返回 JSON 格式的响应体。其中 data 字段需返回 RSA加密的Base64字符串(使用 WaaS 提供的公钥加密),其余字段为明文:
加密的业务数据,比如:BDn6Liv5Z4TJ9vjfd(具体参考右侧响应示例)由以下原始业务参数加密生成:requestUUID (String) : 请求的唯一标识符号,商户在响应中需要同样返回相同的requestUUID以帮助 WaaS 确认tenantUserId (String) : 发起提款的用户ID(在商户系统中,并非WaaS系统中)type (Integer) : 回调类型trackingId (String) : 业务事件标识符callBackId (String) : 回调ID
{
"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": ""
}