适用对象:服务商
请求URL:https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders
请求方式:GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
子商户号 | sub_mchid | string[1,32] | 是 | query
订单收款方商户号,可以是品牌主商户号,也可以是门店商户号,填写微信支付分配的商户号。 示例值:1900000109 |
微信订单号 | transaction_id | string[1,32] | 是 | query
微信支付订单号 示例值: 4208450740201411110007820472 |
商户分账单号 | out_order_no | string[1,64] | 是 | query
查询分账结果,输入申请分账时的商户分账单号; 查询分账完结执行的结果,输入发起分账完结时的商户分账单号。 示例值:P20150806125346 |
https://api.mch.weixin.qq.com/v3/brand/profitsharing/orders?sub_mchid=1900000109&transaction_id=4208450740201411110007820472&out_order_no=P20150806125346
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
子商户号 | 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 |
分账单状态 | status | string[1,32] | 是 | 分账单状态,枚举值: PROCESSING:处理中 FINISHED:处理完成 示例值:FINISHED |
+ 分账接收方列表 | receivers | array | 是 | query 分账接收方列表,支持设置出资商户作为分账接收方,单次分账最多可有50个分账接收方。 |
分账完结金额 | finish_amount | int | 否 | 分账完结的分账金额,单位为分, 仅当查询分账完结的执行结果时,存在本字段 示例值:100 |
分账完结描述 | finish_description | string[1,80] | 否 | 分账完结的原因描述,仅当查询分账完结的执行结果时,存在本字段 示例值:分账完结 |
{
"transaction_id" : "4208450740201411110007820472",
"receivers" : [ {
"result" : "SUCCESS",
"amount" : 10,
"description" : "分帐1900000110",
"type" : "MERCHANT_ID",
"fail_reason" : "NO_RELATION",
"account" : "1900000109",
"detail_id": "36011111111111111111111",
"finish_time" : "2015-05-20T13:29:35.120+08:00"
}, {
"result" : "SUCCESS",
"amount" : 10,
"description" : "分帐1900000110",
"type" : "MERCHANT_ID",
"fail_reason" : "NO_RELATION",
"account" : "1900000109",
"detail_id": "36011111111111111111111",
"finish_time" : "2015-05-20T13:29:35.120+08:00"
} ],
"finish_description" : "分账完结",
"out_order_no" : "P20150806125346",
"sub_mchid" : "1900000109",
"finish_amount" : 100,
"order_id" : "3008450740201411110007820472",
"status" : "FINISHED"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 商户号未设置 | 请使用正确的参数重新调用 |
429 | FREQUENCY_LIMITED | 商户发起分账查询的频率过高 | 请降低频率后重试 |
404 | RESOURCE_NOT_EXISTS | 记录不存在 | 请检查请求的单号是否正确 |