查询分账结果

更新时间：2025.01.07

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

1. 接口说明

适用对象：直连模式机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/{out_order_no}

请求方式：GET

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	Query 微信支付分配的商户号，请与微信支付订单的二级商户号保持一致。（直连商户不需要，服务商/机构模式下必填）示例值：1900000109
微信支付订单号	transaction_id	string[1, 32]	是	Query 微信支付订单号示例值：4208450740201411110007820472
商户分账单号	out_order_no	string[1, 64]	是	Path 商户系统内部的分账单号，在商户系统内部唯一（单次分账、多次分账、完结分账应使用不同的商户分账单号），同一分账单号多次请求等同一次。只能是数字、大小写字母_- 示例值：P20150806125346

请求示例

URL

1https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/P20150806125346?sub_mchid=1900000109&transaction_id=4208450740201411110007820472

3. 返回参数

参数名

变量

类型[长度限制]

必填

描述

二级商户号

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

是

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

分账接收方列表

receivers

array

是

分账接收方列表
商户在发起分账请求或解冻剩余资金请求时，对同一笔订单可分给多个接收方（包括解冻给出资方），分账明细描述了每笔分给一个接收方的资金的状态。

分账接收方列表

参数名	变量	类型[长度限制]	必填	描述
分账币种	currency	string[3, 3]	是	分账币种，同请求入参。示例值：CNY
分账金额	amount	int	是	分账金额，同请求入参。示例值：100
分账描述	description	string[1, 80]	是	商户传入的分账描述，同请求入参。示例值：分给商户1900000110
接收方类型	type	string	是	接收方类型，同请求入参。 MERCHANT_ID：商户号， PERSONAL_OPENID：个人OpenID，由商户APPID转换得到 PERSONAL_SUB_OPENID：是个人Sub_OpenID，由二级商户APPID转换得到示例值：MERCHANT_ID
接收方账号	account	string[1, 64]	是	接收方账号，同请求入参。示例值：1900000109
分账明细结果	result	string	是	每一笔分账明细转账的结果。 PENDING：待分账， SUCCESS：分账成功， CLOSED：已关闭，示例值：SUCCESS
分账明细失败原因	fail_reason	string	否	分账明细失败原因。在分账明细结果为"CLOSED"时才会被设置。 NO_RELATION：分账关系已解除， SUB_MERCHANT_FRONEN：二级商户被冻结， MCH_CONTRACT_SETTLE_OFF：商户结算合同为关闭结算状态， MCH_CONTRACT_FROZEN：商户结算合同被冻结， ACCOUNT_ABNORMAL：分账接收账户异常， RECEIVER_HIGH_RISK：高风险接收方， RECEIVER_REAL_NAME_NOT_VERIFIED：接收方未实名， NO_AUTH：分账权限已解除， DEFAULT_ERROR：默认错误，示例值：ACCOUNT_ABNORMAL
分账明细创建时间	create_time	string[1, 64]	是	分账明细创建时间，遵循RFC3339标准格式示例值：2015-05-20T13:29:35.120+08:00
分账明细完成时间	finish_time	string[1, 64]	否	分账明细完成时间，遵循RFC3339标准格式。在分账明细结果为"SUCCESS"或"CLOSED"时才会被设置。示例值：2015-05-20T13:29:35.120+08:00
分账明细单号	detail_id	string[1, 64]	是	微信分账明细单号，每笔分账业务执行的明细单号。示例值：36011111111111111111111
分账明细类型	detail_type	string	是	分账明细分为两类，包括分出给其他接收方和解冻给出资方。可由该字段来区分，若明细类型为UNFREEZE_TO_SPONSOR(解冻给出资方)时，分账明细中还会返回出资方结算币种、结算金额、汇率值等信息。 DISTRIBUTE_TO_OTHERS：分出给其他接收方， UNFREEZE_TO_SPONSOR：解冻给出资方出境，示例值：DISTRIBUTE_TO_OTHERS
出资方结算币种	settlement_currency	string[3, 3]	否	出资方的结算币种，明细类型为UNFREEZE_TO_SPONSOR(解冻给出资方)时该字段才会被设置。示例值：HKD
出资方结算金额	settlement_amount	int	否	该笔明细通过换汇后最终结算给出资方的金额，采用最小币种单位。示例值：110
汇率值	rate	int	否	分账币种与结算币种的兑换比例乘以10的8次方即为此值。若分账币种与结算币种均为人民币，则兑换比值为1，汇率值为100,000,000; 若结算币种为美元，假设美元兑换人民币的比例为6.5，则汇率值为650,000,000。示例值：81000000

返回示例

正常示例

1{
2    "order_id": "7100000751202203238026613597498",
3    "out_order_no": "MCH13SFDG234155321146",
4    "receivers": [
5      {
6        "account": "999952224",  # 注：该账户为出资方商户号
7        "amount": 797,
8        "create_time": "2022-03-23T17:10:13+08:00",
9        "currency": "CNY",
10        "description": "Unfreeze the remaining funds to sponsor",
11        "detail_id": "7200000751202203238026613597602",
12        "detail_type": "UNFREEZE_TO_SPONSOR",
13        "rate_value": 83640300,
14        "result": "PENDING",
15        "settlement_amount": 952,
16        "settlement_currency": "HKD",
17        "type": "MERCHANT_ID"
18      },
19      {
20        "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
21        "amount": 99,
22        "create_time": "2022-03-23T17:10:13+08:00",
23        "currency": "CNY",
24        "description": "分给xxx用户-10%",
25        "detail_id": "7200000751202203238026613597699",
26        "detail_type": "DISTRIBUTE_TO_OTHERS",
27        "result": "PENDING",
28        "type": "PERSONAL_OPENID"
29      },
30      {
31        "account": "2480248971",
32        "amount": 99,
33        "create_time": "2022-03-23T17:10:13+08:00",
34        "currency": "CNY",
35        "description": "分给xxx商户-10%",
36        "detail_id": "7200000751202203238026613597767",
37        "detail_type": "DISTRIBUTE_TO_OTHERS",
38        "result": "PENDING",
39        "type": "MERCHANT_ID"
40      }
41    ],
42    "state": "PROCESSING",
43    "sub_mchid": "999968479",
44    "transaction_id": "4200000012202203235765130087"
45}

4. 错误码

状态码	错误码	描述	解决方案
404	NOT_FOUND	分账指令不存在，请检查外部指令单号(out_order_no)是否填写正确	请检查外部指令单号(out_order_no)是否填写正确
400	INVALID_REQUEST	查询分账结果时商户信息与原指令不一致	请检查外部指令单号(out_order_no)/微信支付单号(transaction_id)/二级商户号(sub_mchid)是否填写正确
400	INVALID_REQUEST	查询分账结果时微信支付订单与原指令信息不一致	请检查外部指令单号(out_order_no)/微信支付单号(transaction_id)是否填写正确
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确