请求分账
更新时间:2025.09.29微信订单支付成功后,由电商平台发起分账请求,将结算后的资金分给分账接收方。
注意:
微信订单支付成功后,平台商户代平台二级商户发起分账请求,将结算后的钱分到分账接收方。
对同一笔订单最多能发起50次分账请求,每次请求最多分给50个接收方。
此接口采用异步处理模式,即在接收到商户请求后,会先受理请求再异步处理,最终的分账结果可以通过查询分账接口获取。
分账资金的冻结期默认是180天。从订单支付成功之日起,180天内需要发起分账,若180天内未发起分账,待分账资金将会自动解冻给分账方。
电商平台需确保向微信支付传输用户身份信息和账号标识信息做一致性校验已合法征得用户授权
接口支持幂等重入
接口限频:
单个平台商户(请求分账) 2000QPS,如果超过频率限制,会报错FREQUENCY_LIMITED,请降低频率请求。
单个交易收款商户(请求分账) 300QPS,如果超过频率限制,会报错FREQUENCY_LIMITED,请降低频率请求。同时,建议对同一主体的商户拆分多个商户号进行交易,避免交易集中到单个商户。
接口说明
支持商户:【平台商户】
请求方式:【POST】/v3/ecommerce/profitsharing/orders
请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看
请求参数
Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
Content-Type 必填 string
请设置为application/json
Wechatpay-Serial 必填 string
【微信支付公钥ID】或【微信支付平台证书序列号】 请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
body 包体参数
appid 选填 string(32)
【公众账号ID】 APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处,可以填写这三种类型中的任意一种APPID,但请确保该appid与mchid有绑定关系。详见:开发必要参数说明。分账接收方类型包含PERSONAL_OPENID时必填
sub_mchid 必填 string(32)
【电商平台二级商户号】 微信支付分配的电商平台二级商户号,即分账的出资商户号。
transaction_id 必填 string(32)
【微信订单号】 微信支付订单号
out_order_no 必填 string(64)
【商户分账单号】 商户系统内部的分账单号,在商户系统内部唯一(单次分账、多次分账、完结分账应使用不同的商户分账单号),同一分账单号多次请求等同一次。只能是数字、大小写字母_-|*@
receivers 必填 array[object]
【分账接收方列表】 分账接收方列表,可以设置出资商户作为分账接受方
| 属性 | |
type 必填 string(32) 【分账接收方类型】 可选取值:
receiver_account 必填 string(64) 【分账接收方账号】
amount 必填 integer 【分账金额】 分账金额,单位为分,只能为整数,不能超过原订单支付金额及最大分账比例金额。调整最大分账比例:登录合作伙伴商户平台,进入以下页面:产品中心-我的工具箱-电商收付通-供应链分账设置 description 必填 string(80) 【分账描述】 分账的原因描述,会在查询分账结果接口和分账账单中原样返回 receiver_name 选填 string(10240) 【分账个人接收方姓名】
|
finish 必填 boolean
【是否分账完成】
如果为true,则分账接收商户只支持平台商户,且该笔订单剩余未分账的金额会解冻回电商平台二级商户,解冻后不支持对该笔订单再次进行分账;
如果为false,则分账接收商户可以为平台商户或者平台二级商户,且该笔订单剩余未分账的金额不会解冻回平台二级商户,可以对该笔订单再次进行分账;
请求示例
POST
应答参数
200 OK
sub_mchid 必填 string(32)
【电商平台二级商户号】 微信支付分配的电商平台二级商户号,即分账的出资商户号。
transaction_id 必填 string(32)
【微信订单号】 微信支付订单号
out_order_no 必填 string(64)
【商户分账单号】 商户系统内部的分账单号,在商户系统内部唯一(单次分账、多次分账、完结分账应使用不同的商户分账单号),同一分账单号多次请求等同一次。只能是数字、大小写字母_-|*@
order_id 必填 string(64)
【微信分账单号】 微信分账单号,微信系统返回的唯一标识
receivers 必填 array[object]
【分账接收方列表】 分账接收方列表
| 属性 | |
amount 必填 integer 【分账金额】 分账金额,单位为分,只能为整数,不能超过原订单支付金额及最大分账比例金额 description 必填 string(80) 【分账描述】 分账的原因描述,会在查询分账结果接口和分账账单中原样返回 result 必填 string(32) 【分账结果】 可选取值:
finish_time 必填 string 【分账完成时间】 分账完成时间,需遵循 RFC3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。示例:2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。 fail_reason 选填 string(64) 【分账失败原因】 分账失败原因,当分账结果result为CLOSED(已关闭)时,返回该字段,具体处理方案请参考分账失败处理指引。
type 必填 string(32) 【接收方类型】 可选取值:
receiver_account 必填 string(64) 【接收方账号】
detail_id 必填 string(64) 【分账明细单号】 微信分账明细单号,每笔分账业务执行的明细单号,可与资金账单对账使用,对应资金账单中的“业务凭证号” |
status 选填 string
【分账单状态】 分账单状态(每个接收方的分账结果请查看receivers中的result字段)
可选取值
PROCESSING: 处理中,非终态,分账结果存在非终态,可稍后再次查询,直到状态为FINISHED。FINISHED: 处理完成,终态,仅代表分账动账执行完毕,每个接收方的分账结果请查看receivers中的result字段
应答示例
200 OK
错误码
以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

