Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

webhook

接口描述

当 KYC 状态发生变更时,平台会通知状态并返回申请卡号。

接口地址

由申请接口提供具体请求地址。

请求方式

POST

内容类型

Content-Type: application/json

请求参数

参数名称必填示例参数说明
orderNo1448538596381429760平台订单号
merOrderNo1448535323381429760接入方订单号
cardNumber1448535323381429760卡号/卡ID(申请成功返回)
status3订单状态(1-处理中,2-成功,3-失败)
completeTime20220331121212订单完成时间
createTime20220331121212订单创建时间
appKeyedy2378eh23gf29w2appKey
signa87694dbd3be64a356a42be95e123360接口签名
ext{“settleAmount”:10}依据订单类型返回,预留字段
failReason资料信息错误失败时返回明确失败原因

响应示例

body 内容为字符串:

ok

注意事项

如果未按要求返回 ok,平台将视为推送失败,并将按照指数退避(Exponential Backoff)策略进行重试:

  • 首次失败后,1 分钟后重试,后续每次重试间隔时间翻倍(2、4、8、16 分钟),共推送 5 次。
  • 若 5 次仍未成功,将在 10 分钟后再次进行重试。
  • 只有返回字符串 ok 表示推送成功,平台才会停止重试。