发起分账
开发环境
开发环境
POST
https://developer.toutiao.com/api/apps/trade/v2/create_settle
使用限制
注意事项
分账规则
举个例子 小程序 A 是核销 D+3 分账，用户的一笔订单 X 买了 5 张团购券 按整单分账时，对于订单 X，其中 3 张先核销，剩余 2 张再退款，最终退款完成的时间就是订单到达终态的时间。订单到达终态 3 天后，则可以发起分账 按券分账时，对于订单 X，其中 1 张券先核销，核销 3 天后可以发起这张券的分账
分账类型
分账发起方
请求示例
| 名称 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| merchant_uid | string | 是 | 进件商户 id（除了卖家以外的其他分账方） | 分账方商户号 1 |
| amount | int64 | 是 | 分账金额，单位[分]，amount>0 | 100 |
curl -X POST '
-H 'Content-Type:application/json'
-H 'Byte-Authorization: SHA256-RSA2048 appid="ttxxx",nonce_str="DC10180A100073E70A48F195DA2AF2E6",timestamp="1623934869",key_version="1",signature="nwd1L3wCX+01/TVTkILeovF1DtYeghC1VHjrcjTHVkh7+gRaONEQkC2Y72Mw8JdSnIyeAtyp/pDHzyKGywjVqv5+JOBEhQG1/pvwNHN49wD26qg3AJL4hXw0fMJSRiTQEV1MszwDLuaabvo/qM9OXL9KyYiEPwVJqYtzmho4cHXT6mYgzNOW1xt5d7RDf4QO74JI3i4dtk9Uj8svJTrrBabML6AUcqcx2OP/7xukdaUgPdPf+IqmMG6GC4n52LUDogcL5n/osLdfHg9l6kW5gDcDjBfNDaggz07QMPHGdVao7pnQ2ub7VqcFIuY6Q3cBL7ndQdDGKrv+WBy5Q90QjQ=="'
--data-raw '{
"out_order_no":"out_order_example_1",
"out_settle_no":"out_settle_example_1",
"settle_desc":"分账描述",
"settle_params":"[{\"merchant_uid\":\"分账方商户号1\",\"amount\":100}]",
"cp_extra":"test",
"notify_url":"https://www.xxxx.com"
}'curl -X POST '
-H 'Content-Type:application/json'
-H 'Byte-Authorization: SHA256-RSA2048 appid="ttxxx",nonce_str="DC10180A100073E70A48F195DA2AF2E6",timestamp="1623934869",key_version="1",signature="nwd1L3wCX+01/TVTkILeovF1DtYeghC1VHjrcjTHVkh7+gRaONEQkC2Y72Mw8JdSnIyeAtyp/pDHzyKGywjVqv5+JOBEhQG1/pvwNHN49wD26qg3AJL4hXw0fMJSRiTQEV1MszwDLuaabvo/qM9OXL9KyYiEPwVJqYtzmho4cHXT6mYgzNOW1xt5d7RDf4QO74JI3i4dtk9Uj8svJTrrBabML6AUcqcx2OP/7xukdaUgPdPf+IqmMG6GC4n52LUDogcL5n/osLdfHg9l6kW5gDcDjBfNDaggz07QMPHGdVao7pnQ2ub7VqcFIuY6Q3cBL7ndQdDGKrv+WBy5Q90QjQ=="'
--data-raw '{
"out_order_no":"out_order_example_1",
"out_settle_no":"out_settle_example_1",
"item_order_id":"ot78318372940872837161",
"settle_desc":"分账描述",
"settle_params":"[{\"merchant_uid\":\"分账方商户号1\",\"amount\":100}]",
"cp_extra":"test",
"notify_url":"https://www.xxxx.com"
}'错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 23000 | 抱歉，出错了！请稍后重试 | 原单号发起重试 |
| 23001 | bad app_id | 检查请求参数 |
| 23002 | 订单id,分账单id至少指定一个 | |
| 23003 | out_order_no不能为空 | |
| 23004 | out_settle_no不能为空 | |
| 23005 | settle_desc不能为空 | |
| 23006 | cp_extra too long | |
| 23007 | settle_param too long | |
| 23008 | 分账方商户号不能为空 | |
| 23009 | 分账方金额不能小于1 | |
| 23010 | settle_desc too long | |
| 23101 | 订单不存在,无法分账 | 检查订单号是否正确，或者订单号与appid是否匹配 |
| 23102 | 订单未支付,无法分账 | 检查订单是否支付 |
| 23103 | 小程序在禁止分账名单中,无法分账 | |
| 23104 | 服务商在禁止分账名单中,无法分账 | |
| 23105 | 支付后不满N天,无法分账 | |
| 23106 | 核销后不满N天,无法分账 | |
| 23107 | 订单未完成,无法分账 | 查询券状态，检查是否每张券都已核销/退款 |
| 23108 | 单笔订单分账次数过多 | |
| 23109 | 分账金额超过授权比例 | |
| 23110 | 服务商无对应小程序分账授权 | |
| 23111 | out_settle_no已存在,请用查询接口查询分账结果 | 查询分账，通过接口查询分账 |
| 23112 | 已无可分账金额 | 检查订单是否已退款或已分账 |
| 23113 | 该订单不允许分账 | |
| 23117 | 该订单属于自动结算订单, 无需请求分账 | 属于自动分账的小程序，可以按订单维度查询分账 |
| 23118 | 不允许整单结算,请按券发起结算 | 一笔订单中已有券结算，其他券也只能按券结算 |
| 23119 | 不允许发起券结算 | 支付D+N结算的小程序不允许发起券结算 |
| 23120 | 券未核销,无法分账 | 查询券状态，检查券是否核销 |
| 23121 | 券结算功能灰度中,请联系运营开通 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/api/apps/trade/v2/create_settle' \
--header 'Content-Type: application/json' \
--data-raw '{
"out_order_no":"out_order_example_1",
"out_settle_no":"out_settle_example_1",
"settle_desc":"分账描述",
"settle_params":"[{\"merchant_uid\":\"分账方商户号1\",\"amount\":100}]",
"cp_extra":"test",
"notify_url":"https://www.xxxx.com"
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_tips": "success",
"data": {
"settle_id": "ot7053723547314981164",
"inner_settle_id": "7115250727504854611"
}
}请求参数
Body 参数application/json
返回响应
修改于 2023-12-04 03:21:52