自动结算结果回调

我的收藏

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

使用限制

无

接口说明

回调地址会默认使用开发者在进件时设置的URL，该URL查看步骤如下【开放平台控制台->小程序->能力->支付能力->支付设置】。

支付回调一定要做验签处理，防止收到假通知，回调验签的Token见上图中的Token【开放平台控制台->小程序->能力->支付能力->支付设置】；Token在发生变更时，会以订单在支付时设置的Token为准。
分账成功或者分账失败都会进行回调通知，且仅通知一次。
回调可能存在延时，若实时性要求高，开发者可以通过主动自动结算结果查询接口，获取分账结果。
回调接口最多重试 15 次（共 16 次），重试间隔分别为（15s、15s、30s、3min、10min、20min、30min、30min、30min、60min、3h、3h、3h、6h、6h）
在开发者服务端收到回调且处理成功后，需要按文档中响应示例 json格式返回表示处理成功，否则小程序服务端会认为通知失败进行重试。

回调参数

名称	类型	是否必填	最大长度	描述	示例值
timestamp	string	是	12	Unix 时间戳，字符串类型	1644399124
nonce	string	是	4	随机数	797
msg	string	是	-	订单信息的 json 字符串	{"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	string	是	32	回调类型标记，自动分账结果回调为"settle_finish"	settle_finish
msg_signature	string	是	128	签名，详见签名DEMO	52fff5f7a4bf4a921c2daf83c75cf0e716432c73

msg 参数

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

名称	类型	是否必填	最大长度	描述	示例值
ma_app_id	string	是	64	小程序ID	tt07e3715e98c9aac0
out_order_id	string	是	64	外部支付订单编号	7021447466642032910
auto_settle_list	array	是	-	关联的自动结算订单信息

auto_settle_list 参数

名称	类型	是否必填	最大长度	描述	示例值
created_at	string	是	18	结算单创建时间	2023-01-01 00:00:00
settle_plat_no	string	是	64	自动结算单号	7021447466642032940
settle_no	string	是	64	小程序分账单号	7021447466642032941
settle_info	array	是	-	分账详情
settle_status	string	是	-	分账状态枚举值： SUCCESS：成功 FAIL：失败	SUCCESS
service_charge	number	是	[1,99999999999]	技术服务费	10
cps	number	是	[1,99999999999]	CPS佣金	20
settled_at	string	是	18	结算完成时间	2023-01-01 01:00:00
settle_way	string	是	-	结算渠道枚举值： 1：微信 2：支付宝	1

settle_info 参数

名称	类型	是否必填	最大长度	描述	示例值
merchant_uid	string	是	64	分账方商户号	6891537072713100000
amount	number	是	[1,99999999999]	分账金额	100

回调示例

{
  "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"
}

响应示例

正常示例

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

异常示例

{
  "err_no": 400,
  "err_tips": "business fail"
}

下一篇：小程序文档指引