开发
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": "", "extra": "", "message": "", "withdraw_at": , "order_id": "", "out_order_id": "", "ch_order_id": "" },

type

string

32

回调类型标记,提现成功回调为"withdraw"

withdraw

msg_signature

string

128

签名,验签方式见DEMO

a0e96a41c3fe0bb81ef527f3fb2948dad2fb2616

回调示例

{
  "msg": {
    "status": "SUCCESS",
    "extra": "",
    "message": "",
    "withdraw_at": 1646399890,
    "order_id": "7078192267961368620",
    "out_order_id": "7078192267961466924",
    "ch_order_id": "TP2022032317293701648440769151"
  },
  "msg_signature": "a0e96a41c3fe0bb81ef527f3fb2948dad2fb2616",
  "nonce": 5269,
  "timestamp": 1646399490,
  "type": "withdraw"
}

响应参数

参数

类型

是否必填

最大长度

描述

示例值

err_no

number

-

返回码,详见下文错误码

2008

err_tips

string

-

返回码描述,详见下文错误码

签名校验异常,请使用正确的签名和 json 传参

响应示例

正常响应示例

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

异常响应示例

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