请求分账
更新时间:2025.09.29微信订单支付成功后,由服务商发起分账请求,将结算后的资金分给分账接收方。
注意:
微信订单支付成功后,服务商代特约商户发起分账请求,将结算后的钱分到分账接收方。
对同一笔订单最多能发起50次分账请求,每次请求最多分给50个接收方。
此接口采用异步处理模式,即在接收到商户请求后,会先受理请求再异步处理,最终的分账结果可以通过查询分账接口获取。
服务商需确保向微信支付传输用户身份信息和账号标识信息做一致性校验已合法征得用户授权
接口说明
支持商户:【普通服务商】
请求方式:【POST】/v3/brand/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 包体参数
brand_mchid 必填 string(32)
【品牌主商户号】 品牌主商户号,填写微信支付分配的商户号。详情见:品牌-门店关系管理
sub_mchid 必填 string(32)
【特约商户号】 订单收款方商户号,填写微信支付分配的商户号,可以是品牌主商户号,也可以是门店商户号
appid 选填 string(32)
【公众账号ID】 APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处,可以填写这三种类型中的任意一种APPID,但请确保该appid与mchid有绑定关系。详见:开发必要参数说明。分账接收方类型包含PERSONAL_OPENID时必填
sub_appid 选填 string(32)
【品牌主公众账号ID】 APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处,可以填写这三种类型中的任意一种APPID,但请确保该sub_appid与sub_mchid有绑定关系。详见:开发必要参数说明。分账接收方类型包含PERSONAL_SUB_OPENID时必填
transaction_id 必填 string(32)
【微信订单号】 微信支付订单号
out_order_no 必填 string(64)
【商户分账单号】 商户系统内部的分账单号,在商户系统内部唯一(单次分账、多次分账、完结分账应使用不同的商户分账单号),同一分账单号多次请求等同一次。只能是数字、大小写字母_-|*@
receivers 必填 array[object]
【分账接收方列表】 分账接收方列表,可以设置出资商户作为分账接受方,最多可有50个分账接收方
| 属性 | |
type 必填 string(32) 【接收方类型】
account 必填 string(64) 【接收方账号】
amount 必填 integer 【分账金额】 分账金额,单位为分,只能为整数,不能超过原订单支付金额及最大分账比例金额。调整最大分账比例:品牌主登录商户平台,进入以下页面:品牌专区-品牌交易-品牌供应链分账-供应链分账管理 description 必填 string(80) 【分账描述】 分账的原因描述,会在查询分账结果接口和分账账单中原样返回 name 选填 string(10240) 【分账个人接收方姓名】 * 分账接收方类型是MERCHANT_ID时,是商户全称(必传),当商户是小微商户或个体户时,是开户人姓名
|
finish 必填 boolean
【是否分账完成】
如果为true,则该笔订单剩余未分账的金额会解冻回分账方商户
如果为false,则该笔订单剩余未分账的金额不会解冻回分账方商户,可以对该笔订单再次进行分账
请求示例
POST
应答参数
200 OK
brand_mchid 必填 string(32)
【品牌主商户号】 品牌主商户号,微信支付分配的商户号。
sub_mchid 必填 string(32)
【特约商户号】 订单收款方商户号,填写微信支付分配的商户号,可以是品牌主商户号,也可以是门店商户号
transaction_id 必填 string(32)
【微信订单号】 微信支付订单号
out_order_no 必填 string(64)
【商户分账单号】 商户系统内部的分账单号,在商户系统内部唯一(单次分账、多次分账、完结分账应使用不同的商户分账单号),同一分账单号多次请求等同一次,只能是数字、大小写字母_-|*@。
order_id 必填 string(64)
【微信分账单号】 微信分账单号,微信系统返回的唯一标识
receivers 必填 array[object]
【分账接收方列表】 分账接收方列表
| 属性 | |
type 必填 string(32) 【接收方类型】
account 必填 string(64) 【接收方账号】
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(已关闭)时,返回该字段,具体处理方案请参考分账失败处理指引。
detail_id 必填 string(64) 【分账明细单号】 微信分账明细单号,每笔分账业务执行的明细单号,可与资金账单对账使用,对应资金账单中的“业务凭证号” |
status 选填 string
【分账单状态】 分账单状态(每个接收方的分账结果请查看receivers中的result字段)
可选取值
PROCESSING: 非终态,分账结果存在非终态,可稍后再次查询,直到状态为FINISHED。FINISHED: 终态,仅代表分账动账执行完毕,每个接收方的分账结果请查看receivers中的result字段
应答示例
200 OK
错误码
以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

