WaaS Developer home page
简体中文
搜索...
⌘K
搜索...
Navigation
Webhook
公共请求参数
介绍
欢迎使用 WaaS 开发者平台
系统支持存款模式
支持代币列表
风险评分参考说明
接入指南
接入准备
核心机制
API 通用说明
请求示例
响应示例
核心工具类
常见问题解答
系统流程图
系统资金流向图
存币业务流程图
提币业务流程图
系统归集流程图
系统风控通知流程图
收银台
介绍
POST
用户存款(独立地址模式)
POST
用户存款(共享地址模式)
POST
请求预存款
API 列表
POST
获取用户地址
POST
查询存款订单
POST
提交加速存币单请求
POST
请求提币单(无需二次确认)
POST
请求提币单(需二次确认)
POST
获取提币单状态
POST
获取商户日报表
Webhook
WaaS 回调机制总览
回调接入准备说明
回调数据解密实现
回调枚举类型说明
公共请求参数
Webhook API
Webhook
公共请求参数
所有回调类型均包含以下基础参数,这些参数提供了请求的基本上下文信息和标识能力。
requestUUID
string
required
全局唯一的请求标识符
作用:
作为请求的唯一标识
用于请求追踪和日志记录
tenantUserId
string
required
商户用户ID
重要说明:
tenantUserId 指的是商户系统中的用户ID,而非商户在 WaaS 系统中的ID。
trackingId
string
required
业务事件的持久化标识符,trackingId 是 WaaS 系统为每个业务事件(如一笔提币请求)创建的
永久性标识符
,在业务事件的整个生命周期内保持不变。
核心特性
业务事件锚点
唯一标识一个业务事件(如一笔提币订单),从创建到结束的所有回调都共享相同的 trackingId
重试识别器
当回调失败需要重试时: ✅ trackingId 保持不变 ❌ requestUUID 会更新为新值
响应关联键
商户必须在响应中原样返回,用于 WaaS 确认回调所属的具体业务事件
type
integer
required
回调类型标识
枚举值:
类型值
枚举名称
1
NOTIFY_DEPOSITED
2
NOTIFY_REQUEST_WITHDRAW
3
NOTIFY_WITHDRAW
4
NOTIFY_ADDRESS
5
NOTIFY_INVALID_ADDRESS
6
NOTIFY_NOT_ENOUGH_MONEY
7
NOTIFY_NOT_ENOUGH_HOT_MONEY
查看详细的回调类型说明 →
business
int
required
租户类型标识
当前版本说明:
该字段作为保留参数,当前版本没有业务逻辑作用。保留该字段是为未来可能的扩展需求提供支持。
预期用途:
区分不同业务线的处理逻辑
特殊费率或规则应用标识
多租户系统中的租户标识
最佳实践:
虽然当前没有业务逻辑作用,但仍需在请求处理中保留和记录该字段,避免未来扩展时出现兼容性问题。
示例值:
0
回调枚举类型说明
存币通知回调
助手
Responses are generated using AI and may contain mistakes.