微信支付-分账

返回上一层文档首页 / 查询分账结果API

查询分账结果API

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

发起分账请求后，可调用此接口查询分账结果

注意：

• 发起解冻剩余资金请求后，可调用此接口查询解冻剩余资金的结果

接口说明

适用对象：直连商户

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

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名	变量	类型[长度限制]	必填	描述
微信订单号	transaction_id	string[1, 32]	是	query微信支付订单号示例值：4208450740201411110007820472
商户分账单号	out_order_no	string[1,64]	是	path查询分账结果，输入申请分账时的商户分账单号；查询分账完结执行的结果，输入发起分账完结时的商户分账单号。示例值：P20150806125346

请求示例


https://api.mch.weixin.qq.com/v3/profitsharing/orders/P20150806125346?&transaction_id=4208450740201411110007820472


｛
JAVA示例代码
｝

返回参数

参数名

变量

类型[长度限制]

必填

描述

微信订单号

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转换得到） openid获取方法示例值：MERCHANT_ID
分账接收方账号	account	string[1, 64]	是	1、分账接收方类型为MERCHANT_ID时，分账接收方账号为商户号 2、分账接收方类型为PERSONAL_OPENID时，分账接收方账号为个人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：超出用户月收款限额 7、PAYER_ACCOUNT_ABNORMAL：分出方账户异常 8、INVALID_REQUEST: 描述参数设置失败示例值：ACCOUNT_ABNORMAL
分账明细单号	detail_id	string[1,64]	是	微信分账明细单号，每笔分账业务执行的明细单号，可与资金账单对账使用示例值：36011111111111111111111
分账创建时间	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+08:00

返回示例

正常示例


{
  "transaction_id": "4208450740201411110007820472",
  "out_order_no": "P20150806125346",
  "order_id": "3008450740201411110007820472",
  "state": "FINISHED",
  "receivers": [
    {
      "amount": 100,
      "description": "分给商户1900000110",
      "type": "MERCHANT_ID",
      "account": "1900000109",
      "result": "SUCCESS",
      "fail_reason": "ACCOUNT_ABNORMAL",
      "detail_id": "36011111111111111111111",
      "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	请求参数符合参数格式，但不符合业务规则	请根据返回的错误信息确认违反的业务规则
404	RESOURCE_NOT_EXISTS	记录不存在	请检查请求的单号是否正确

技术咨询

文档反馈

微信支付商户平台