退款回调通知

Webhook 

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

信息

商户可以在发起退款申请时设置回调地址，当退款结果确认时，系统会向该 URL 发送退款成功的通知。

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

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

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

Request

application/json

Body

required

chainId int32required

链 ID

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

currencyId int32required

货币 ID

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

refundId int32required

退款订单 ID

outTradeNo stringrequired

商户订单号

outPaymentNo stringrequired

支付单号

refundAddress stringrequired

退款地址

refundAmount stringnullablerequired

退款金额

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

refundFee stringnullable

手续费

refundStatus int32required
Possible values: [0, 1, 2, 3, 4, 5]
退款订单状态
• 0 - 成功
• 1 - 待审批
• 2 - 审批中
• 3 - 区块确认中
• 4 - 失败
• 5 - 驳回
refundTime date-timerequired

退款时间

transferHash stringnullable

交易哈希

Responses

200

OK

plain/text

Schema

Schema

string

Possible values: [success]

Example

success

Loading...