微信支付-分账

返回上一层文档首页 / 解冻剩余资金API

解冻剩余资金API

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

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

注意：

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

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

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/profitsharing/orders/unfreeze

请求方式：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

分账单状态

state

string[1, 32]

是

分账单状态（每个接收方的分账结果请查看receivers中的result字段），枚举值：
1、PROCESSING：处理中
2、FINISHED：分账完成
示例值：FINISHED

+分账接收方列表

receivers

array

否

分账接收方列表

参数名	变量	类型[长度限制]	必填	描述
分账金额	amount	int	是	分账金额，单位为分，只能为整数，不能超过原订单支付金额及最大分账比例金额示例值：100
分账描述	description	string[1, 80]	是	分账的原因描述，分账账单中需要体现示例值：分给商户1900000110
分账接收方类型	type	string[1, 32]	是	1、MERCHANT_ID：商户号 2、PERSONAL_OPENID：个人openid（由父商户APPID转换得到） 3、PERSONAL_SUB_OPENID: 个人sub_openid（由子商户APPID转换得到）示例值：MERCHANT_ID
分账接收方账号	account	string[1, 64]	是	1、分账接收方类型为MERCHANT_ID时，分账接收方账号为商户号 2、分账接收方类型为PERSONAL_OPENID时，分账接收方账号为个人openid 3、分账接收方类型为 PERSONAL_SUB_OPENID时，分账接收方账号为个人sub_openid 示例值：1900000109
分账结果	result	string[1, 32]	是	枚举值： 1、PENDING：待分账 2、SUCCESS：分账成功 3、CLOSED：已关闭示例值：SUCCESS
分账失败原因	fail_reason	string[1, 64]	是	分账失败原因，当分账结果result为CLOSED（已关闭）时，返回该字段枚举值： 1、ACCOUNT_ABNORMAL : 分账接收账户异常 2、NO_RELATION : 分账关系已解除 3、RECEIVER_HIGH_RISK : 高风险接收方 4、RECEIVER_REAL_NAME_NOT_VERIFIED : 接收方未实名 5、NO_AUTH : 分账权限已解除 6、RECEIVER_RECEIPT_LIMIT : 接收方已达收款限额示例值：ACCOUNT_ABNORMAL
分账创建时间	create_time	string[1, 64]	是	分账创建时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。示例值：2015-05-20T13:29:35+08:00
分账完成时间	finish_time	string[1, 64]	是	分账完成时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。示例值：2015-05-20T13:29:35.120+08:00
分账明细单号	detail_id	string[1,64]	是	微信分账明细单号，每笔分账业务执行的明细单号，可与资金账单对账使用示例值：36011111111111111111111

返回示例

正常示例


{
  "sub_mchid": "1900000109",
  "transaction_id": "4208450740201411110007820472",
  "out_order_no": "P20150806125346",
  "order_id": "3008450740201411110007820472",
  "state": "FINISHED",
  "receivers": [
    {
      "amount": 100,
      "description": "分给商户1900000110",
      "type": "MERCHANT_ID",
      "account": "1900000109",
      "result": "SUCCESS",
      "detail_id": "36011111111111111111111",
      "fail_reason": "ACCOUNT_ABNORMAL",
      "create_time": "2015-05-20T13:29:35+08:00",
      "finish_time": "2015-05-20T13:29:35+08:00"
    }
  ]
}


http://2323weixin.qq.com

错误码公共错误码

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

技术咨询

文档反馈

微信支付合作伙伴平台

解冻剩余资金API

注意：

接口说明

请求参数

请求示例

返回参数

返回示例

错误码公共错误码