完结分账API

最新更新时间:2020.04.30 版本说明


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

注意:

• 调用分账接口后,需要解冻剩余资金时,调用本接口将剩余的分账金额全部解冻给特约商户。

• 此接口采用异步处理模式,即在接收到商户请求后,会先受理请求再异步处理,最终的分账结果可以通过查询分账接口获取


接口限频:

1、单个分账接收方商户(分账完结) 60QPS,如果超过频率限制,会报错FREQUENCY_LIMITED,请降低频率请求。同时,建议拆分多个分账接收方商户号进行分账收款,避免集中分账到单个商户。

接口说明

适用对象:电商平台

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

请求方式:POST

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path指该参数需在请求URL传参

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 分账的原因描述,分账账单中需要体现。
示例值:分账完结

请求示例


{
 "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 NOT_ENOUGH 分账金额为0 分账已完成,无需再请求分账完结
403 NO_AUTH 商户无权限 请开通商户号分账权限

版本说明

关闭
V1.1
2020.04.30
1. 新增NOT_ENOUGH错误码
V1.0
2019.09.11
1. 完结分账接口上线

技术咨询

反馈有奖