充值回调通知

Webhook 

充值订单状态变为成功或者失败时，商户会收到充值回调通知，商户需要根据回调通知更新本地订单状态。

信息

商户可以在 Pay Protocol 管理后台的机构信息里添加充值回调地址（公网可访问的 HTTPS 协议 URL），当充值结果确认时，系统会向该 URL 发送充值成功的通知。

回调最多发送 6 次，分别在充值确认后的 0 秒、15 秒、30 秒、3 分钟、5 分钟、10 分钟时发送。

当商户正常返回 success 时，系统会认为回调成功，不再发送后续回调。

注：商户需要验证回调通知的签名，确保通知的安全性，回调的加签方式与普通请求一致。

Request

application/json

Body

required

chainId int32required

链 ID

此为平台内部 ID，不是链上或者钱包里的链 ID，可以从查询链列表接口获取

rechargeId int32required

充值订单 ID

userId int32required

用户 ID

uuid stringrequired

用户 UUID

currencyId int32required

货币 ID

可以从查询货币列表接口获取

rechargeAmount stringrequired

充值订单金额

注：该字段的值为整型数字，通过 (实际金额 * 10^货币小数位数) 计算而来

rechargeStatus int32required
Possible values: [0, 1, 2]
充值订单状态
• 0 - 成功
• 1 - 充值中
• 2 - 失败
transferHash stringrequired

交易哈希

walletId int32required

用户子钱包 ID

walletAddress stringrequired

用户子钱包地址

fromAddress stringrequired

付款地址

createTime date-timerequired

订单创建时间

blockTime date-timerequired

交易确认时间

Responses

200

OK

plain/text

Schema

Schema

string

Possible values: [success]

Example

success

Loading...