webhook
接口描述
当 KYC 状态发生变更时,平台会通知状态并返回申请卡号。
接口地址
由申请接口提供具体请求地址。
请求方式
POST
内容类型
Content-Type: application/json
请求参数
| 参数名称 | 必填 | 示例 | 参数说明 |
|---|---|---|---|
| orderNo | 是 | 1448538596381429760 | 平台订单号 |
| merOrderNo | 是 | 1448535323381429760 | 接入方订单号 |
| cardNumber | 否 | 1448535323381429760 | 卡号/卡ID(申请成功返回) |
| status | 是 | 3 | 订单状态(1-处理中,2-成功,3-失败) |
| completeTime | 是 | 20220331121212 | 订单完成时间 |
| createTime | 是 | 20220331121212 | 订单创建时间 |
| appKey | 是 | edy2378eh23gf29w2 | appKey |
| sign | 是 | a87694dbd3be64a356a42be95e123360 | 接口签名 |
| ext | 否 | {“settleAmount”:10} | 依据订单类型返回,预留字段 |
| failReason | 否 | 资料信息错误 | 失败时返回明确失败原因 |
响应示例
body 内容为字符串:
ok
注意事项
如果未按要求返回 ok,平台将视为推送失败,并将按照指数退避(Exponential Backoff)策略进行重试:
- 首次失败后,1 分钟后重试,后续每次重试间隔时间翻倍(2、4、8、16 分钟),共推送 5 次。
- 若 5 次仍未成功,将在 10 分钟后再次进行重试。
- 只有返回字符串
ok表示推送成功,平台才会停止重试。