自动结算结果回调

平台发起自动结算后会通知服务商/开发者。

接口说明

回调地址会默认使用开发者在进件时设置的URL，该URL查看步骤如下【开放平台控制台->小程序->能力->支付能力->支付设置】。![img](https://sf1-cdn-tos.douyinstatic.com/obj/microapp/frontend/docs/images/output (2)-3395802477876779.png)

支付回调一定要做验签处理，防止收到假通知，回调验签的Token见上图中的Token【开放平台控制台->小程序->能力->支付能力->支付设置】；Token在发生变更时，会以订单在支付时设置的Token为准。

分账成功或者分账失败都会进行回调通知，且仅通知一次。

回调可能存在延时，若实时性要求高，开发者可以通过主动自动结算结果查询接口，获取分账结果。

回调接口最多重试 15 次（共 16 次），重试间隔分别为（15s、15s、30s、3min、10min、20min、30min、30min、30min、60min、3h、3h、3h、6h、6h）

在开发者服务端收到回调且处理成功后，需要按文档中响应示例 json格式返回表示处理成功，否则小程序服务端会认为通知失败进行重试。

curl --location --request POST 'http://dev-cn.your-api-server.com' \ --header 'Content-Type: application/json' \ --data-raw '{ "timestamp": "1602507471", "nonce": "797", "msg": { "ma_app_id": "tt07e3715e98c9aac0", "out_order_id": "tt07e3715e98c9aac0", "auto_settle_list": [ { "created_at": "2023-01-01 00:00:00", "settle_plat_no": "7021447466642032940", "settle_no": "7021447466642032941", "settle_info": [ { "merchant_uid": "6891537072713100000", "amount": 100 } ], "settle_status": "SUCCESS", "service_charge": 10, "cps": 20, "settled_at": "2023-01-01 01:00:00", "settle_way": "1" } ] }, "type": "settle_finish", "msg_signature": "52fff5f7a4bf4a921c2daf83c75cf0e716432c73" }'

请求参数

Body 参数application/json

timestamp

string

必需

Unix 时间戳，字符串类型

nonce

string

随机数

必需

msg

object

必需

订单信息的 json 字符串

ma_app_id

string

小程序ID

必需

out_order_id

string

外部支付订单编号

必需

auto_settle_list

array [object {9}]

必需

关联的自动结算订单信息

type

string

必需

回调类型标记，自动分账结果回调为"settle_finish"

msg_signature

string

必需

签名，详见签名DEMO

示例

自动结算结果回调

接口说明#

请求参数

返回响应

接口说明