通知分账结果

分账处理完成后，抖音开平交易系统会给向开发者的服务发起请求，将分账结果通知到开发者服务端。

注意事项

由于网络波动等原因，可能会产生重复的通知消息，接入方需要做好幂等，正确处理。

回调可能存在延时，开发者可以通过主动请求查询分账，确认分账结果。

在开发者服务端收到回调且处理成功后，需要按下文正常响应示例返回并且 HTTP 响应状态码设为 200，否则会认为通知失败进行重试。

结果通知失败的重试的时间间隔为 2s、4s、8s、16s、32s、64s、128s、256s、512s、1024s、 2048s、4096s、8192s、5h、5h、5h、5h、5h、5h、 5h，总共重试 20 次。

对于旧订单（担保支付订单）在交易 2.0 发起的退款和分账产生的回调通知，采用的回调签名算法和旧系统（担保支付）保证一致，仅当回调请求中有 version 字段且为 2.0 时，采用签名算法，否则采用的就是旧系统的回调签名算法。

基本信息

基本信息
HTTP URL	在行业模板配置-消息通知中指定的回调地址在分账请求中指定 notify_url
HTTP Method	POST

msg 字段内容示例

按券分账时item_order_id不为空

//分账成功回调示例

{

"app_id": "ttcfdbbxxx650exxx0",

"status": "SUCCESS",

"order_id": "ot7057435515980663048",

"cp_extra": "test",

"message": "SUCCESS",

"event_time": 1643189272388,

"settle_id": "ot7057416814925531429",

"out_settle_no": "ext_order_no_1643188675912_settle1",

"rake": 60,

"commission": 100,

"settle_detail": "商户号68882720803499563550-分成金额(分)840",

"settle_amount": 1000,

"item_order_id":"ot78318372940872837161",

"is_auto_settle":false

}

//分账失败回调示例

{

"app_id": "ttcfdbb9XXXXXX50",

"status": "FAIL",

"order_id": "ot7057435515980663048",

"cp_extra": " esse dolore",

"message": "FAIL",

"event_time": 1643189272388,

"settle_id": "ot7057416814925531429",

"out_settle_no": "ext_order_no_1643188675912_settle——1",

"rake": 0,

"commission": 0,

"settle_detail": "",

"settle_amount": 2，

"item_order_id":"ot78318372940872837161",

"is_auto_settle":false

}

curl --location --request POST 'http://dev-cn.your-api-server.com/api/v2/result_callback?timestamp=1345678901234&nonce=iuy987q4htafreqw' \ --header 'Content-Type: application/json' \ --data-raw '{ "version": "2.0", //固定为2.0, 通过版本信息识别，用不同的结构体去解析上述关键参数 "msg":"{\"app_id\":\"ttcfdbb96650e33350\",\"status\":\"SUCCESS\",\"order_id\":\"ot7057435515980663048\",\"cp_extra\":\"test\",\"message\":\"SUCCESS\",\"event_time\":1643189272388,\"settle_id\":\"ot7057416814925531429\",\"out_settle_no\":\"ext_order_no_1643188675912_settle——1\",\"rake\":0,\"commission\":0,\"settle_detail\":\"商户号68882720803499563550-分成金额(分)2\",\"settle_amount\":2,\"item_order_id\":\"ot78318372940872837161\",\"is_auto_settle\":false}", "type": "settle" }'

请求参数

Query 参数

timestamp

string

必需

示例值:

1345678901234

nonce

string

必需

示例值:

iuy987q4htafreqw

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

version

string

必需

固定为2.0, 通过版本信息识别，用不同的结构体去解析上述关键参数

msg

string

必需

订单相关信息的 JSON 字符串

type

string

必需

枚举值（分账结果回调为 settle）： payment：支付成功/支付取消 refund：退款成功/退款失败 settle：分账成功/分账失败

示例

通知分账结果

注意事项#

基本信息#

msg 字段内容示例#

请求参数

返回响应

注意事项

基本信息

msg 字段内容示例