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

结算及分账结果回调

接口功能描述:将整单分账结果通知给开发者/服务商。

注意事项

  1. 本接口是整单回调,(无论几个分账方)整个分账单只需要回调一次。
  2. 回调可能存在延时,若实时性要求高,开发者可以通过主动请求分账查询接口,获取分账结果。
  3. 强烈建议接入者加验签,防止不是抖音的假通知。
  4. 回调接口最多重试 15 次(共 16 次),重试间隔分别为(15s、15s、30s、3min、10min、20min、30min、30min、30min、60min、3h、3h、3h、6h、6h)
  5. 重要:在开发者服务端收到回调且处理成功后,需要按以下 json 返回表示处理成功,否则小程序服务端会认为通知失败进行重试。

参数

类型

是否必填

最大长度

描述

示例值

timestamp

number

10

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

1644399124

nonce

string

4

随机数

797

msg

string

-

订单信息的 json 字符串

{\"app_id\":\"tt07e3715e98c9aac0\",\"cp_settle_no\":\"out_settle_no_1\",\"cp_extra\":\"2856\",\"status\":\"SUCCESS\",\"rake\":95,\"commission\":0,\"settle_detail\":\"商户号6891537072713100000-分成金额(分)100\",\"settled_at\":0,\"message\":\"\",\"order_id\":\"6892779245089720000\"}

type

string

32

回调类型标记,分账结果回调为"settle"

settle

msg_signature

string

128

签名,详见地址

52fff5f7a4bf4a921c2daf83c75cf0e716432c73

msg 参数

回调参数中的 msg 字段,为以下内容序列化得到的 json 字符串

参数

类型

是否必填

最大长度

描述

示例值

appid

string

64

小程序ID

tt07e3715e98c9aac0

cp_settle_no

string

64

开发者自定义的分账单号

out_settle_no_1

cp_extra

string

2048

开发者发起分账传入的额外参数,回调时回传

2856

status

string

-

分账状态枚举值:

SUCCESS:成功

FAIL:失败

FAIL

rake

number

[1,99999999999]

平台收取的手续费,单位为分

95

commission

number

[1,99999999999]

平台收取的佣金,单位为分

0

settle_detail

string

1024

分账明细描述

商户号6891537072713100000-分成金额(分)100

settled_at

number

10

分账成功时间戳,否则为0

1645513202

message

string

128

分账结果描述

原支付单未支付成功并核销,禁止分账

order_id

string

64

分账对应原支付单单号

6892779245089720000

{
  "timestamp": 1602507471,
  "nonce": "797",
  "msg": {
    "app_id": "tt07e3715e98c9aac0",
    "cp_settle_no": "out_settle_no_1",
    "cp_extra": "2856",
    "status": "FAIL",
    "rake": 95,
    "commission": 0,
    "settle_detail": "商户号6891537072713100000-分成金额(分)100",
    "settled_at": 0,
    "message": "原支付单未支付成功并核销,禁止分账",
    "order_id": "6892779245089720000"
  },
  "type": "settle",
  "msg_signature": "52fff5f7a4bf4a921c2daf83c75cf0e716432c73"
}
{
  "err_no": 0,
  "err_tips": "success"
}
{
  "err_no": 400,
  "err_tips": "business fail"
}
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助