开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

进件状态回调

接口功能描述:将进件成功或失败的消息通知给开发者/服务商。

注意事项

  1. 在小程序开发者平台上的担保支付平台设置页面中,填写回调相关配置。回调 token 与回调 url。该回调地址为必填项。开发者可以在请求中动态指定回调地址,动态指定地址会覆盖默认配置。
  2. 开发者服务端接收到异步通知时,必须通过验签(验证通知中的 sign 参数)来确保支付通知是由抖音发送的。详细验签规则参考 DEMO
  3. 回调可能存在延时,若实时性要求高,开发者可以通过主动请求查询进件结果接口,感知进件结果。
  4. 在开发者服务端收到回调且处理成功后,需要按以下 json 返回表示处理成功,否则小程序服务端会认为通知失败进行重试。
  5. 通知失败的重试时间间隔:15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h。

回调参数

参数

类型

是否必填

最大长度

描述

示例值

timestamp

number

10

Unix 秒级时间戳,10 位,整型数

1646398076

nonce

string

4

随机数

4353

msg

string

-

进件信息的 json 字符串

"msg": { "status": "SUCCESS", "channel": "hz", "uid": "70372492201318182840", "apply_time": "2022-03-04 21:10:15", "apply_id": "SMA202202212156514", "sub_status": "SUCCESS", "sub_fail_reason": "" }

type

string

32

回调类型标记,进件成功回调为"create_merchant"

create_merchant

msg_signature

string

128

签名DEMO

a0e96a41c3fe0bb81ef527f3fb2948dad2fb2616

回调示例

{
  "msg": {
    "status": "SUCCESS",
    "channel": "hz",
    "uid": "70372492201318182840",
    "apply_time": "2022-03-04 21:10:15",
    "apply_id": "SMA202202212156514",
    "sub_status": "SUCCESS",
    "sub_fail_reason": ""
  },
  "msg_signature": "a0e96a41c3fe0bb81ef527f3fb2948dad2fb2616",
  "nonce": 5269,
  "timestamp": 1646399490,
  "type": "create_merchant"
}

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "success"
}

异常响应示例

{
  "err_no": 1000,
  "err_tips": "内部错误,请稍后重试"
}
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助