设置订单分账信息
接口调用请求说明
接口强制校验来源IP
- 调用本接口前请先检查是否已经添加分账方
- 在订单结算前可以为订单设置分账信息。成功设置订单分账信息后,会在订单结算时统一为分账方进行分账。订单结算时间为售后期结束后。售后期概念见生成订单接口
- 如需修改订单分账信息,可以多次调用本接口,结算时会以最后一次调用时所设置的分账信息为准。但需注意,每次调用本接口会更新该订单下的整个分账列表。设置分账信息成功后可以通过获取订单详情接口得到订单commission_info.
- 每种sku的分账信息需要单独设置,每种sku所设置的总分账比例不能超过sku实付价的30%。
- 如果订单结算时某个sku曾发生过退款(包括部分退款以及全部退款),则该sku不参与分账,该sku下所设置的分账信息无效。
- 每个分账方分账成功后会有一条结算成功回调.收到结算成功回调后可以通过获取订单详情接口在订单settlement_info中找到对应分账记录。
请求参数示例
回包示例
请求参数说明
参数 | 类型 | 是否必填 | 说明 |
order_id | string | 否 | 订单ID |
out_order_id | string | 否 | 商家自定义订单ID,与 order_id 二选一 |
openid | string | 是 | 下单用户的openid |
commission_list | CommissionRecord[] | 是 | 分账信息 |
CommissionRecord
参数 | 类型 | 是否必填 | 说明 |
mchid | string | 是 | 商户号 |
account_type | number | 否 | 账户类型,0:商户,默认值为0 |
out_product_id | string | 是 | 外部商品编号 |
out_sku_id | string | 是 | 外部sku编号 |
amount | number | 是 | sku的总分账金额,单位为分 |
commission_type | number | 否 | 分账类型,1:服务商,默认值为1 |
回包参数说明
参数 | 类型 | 说明 |
errcode | number | 错误码 |
errmsg | string | 错误信息 |
返回码
返回码 | 错误类型 |
-1 | 系统异常 |
48001 | 无权限调用该api |
1010011 | 订单不存在,请检查订单号及openid |
1012004 | 分账方不存在 |
1012005 | 分账商品在订单中不存在 |
1012006 | 商品分账比例不符合要求 |
1012007 | 订单已经开始结算,不可设置分账信息 |
The translations are provided by WeChat Translation and are for reference only. In case of any inconsistency and discrepancy between the Chinese version and the English version, the Chinese version shall prevail.Incorrect translation. Tap to report.