微信支付-开发者文档

返回上一层文档首页 / 完结分账API

完结分账API

最新更新时间：2020.03.18 版本说明

不需要进行分账的订单，可直接调用本接口将订单的金额全部解冻给分账方商户

注意：

• 调用分账接口后，需要解冻剩余资金时，调用本接口将订单剩余的分账金额全部解冻给分账方商户。

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/brand/profitsharing/finish-order

请求方式：POST

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1,32]	是	body 订单收款方商户号，填写微信支付分配的商户号示例值：1900000109
微信订单号	transaction_id	string[1,32]	是	body 微信支付订单号示例值： 4208450740201411110007820472
商户分账单号	out_order_no	string[1,64]	是	body 商户系统内部的分账单号，在商户系统内部唯一（单次分账、多次分账、完结分账应使用不同的商户分账单号），同一分账单号多次请求等同一次，只能是数字、大小写字母_-\|*@。示例值：P20150806125346
分账描述	description	string[1,80]	是	body 分账的原因描述，将体现在资金账单和分账账单中示例值：分账完结

请求示例

JSON


{
 "sub_mchid": "1900000109",
 "transaction_id": "4208450740201411110007820472",
 "out_order_no": "P20150806125346",
 "description": "分账完结"
}

    
｛
JAVA示例代码
｝

返回参数

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[1,32]	是	订单收款方商户号，填写微信支付分配的商户号示例值：1900000109
微信订单号	transaction_id	string[1,32]	是	微信支付订单号示例值： 4208450740201411110007820472
商户分账单号	out_order_no	string[1,64]	是	商户系统内部的分账单号，在商户系统内部唯一（单次分账、多次分账、完结分账应使用不同的商户分账单号），同一分账单号多次请求等同一次，只能是数字、大小写字母_-\|*@。示例值：P20150806125346
微信分账单号	order_id	string[1,64]	是	微信分账单号，微信支付系统返回的唯一标识示例值： 3008450740201411110007820472

返回示例

正常示例


{
 "sub_mchid": "1900000109",
 "transaction_id": "4208450740201411110007820472",
 "out_order_no": "P20150806125346",
 "order_id": "3008450740201411110007820472"
}


    http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用
400	PARAM_ERROR	订单格式不正确	请使用正确的参数重新调用
400	INVALID_REQUEST	非分账订单不支持完结分账	请根据返回的错误信息确认违反的业务规则
429	FREQUENCY_LIMITED	对同笔订单分账频率过高	请降低频率后重试
403	NO_AUTH	商户无权限	请开通商户号分账权限

微信支付合作伙伴平台