适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/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/ecommerce/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] | 是 | 微信分账单号,微信支付系统返回的唯一标识 示例值: 008450740201411110007820472 |
分账单状态 | status | string[1,32] | 是 | 分账单状态,枚举值: PROCESSING:处理中 FINISHED:分账完成 示例值:FINISHED |
+分账接收方列表 | receivers | array | 否 | 分账接收方列表。当查询分账完结的执行结果时,不返回该字段 |
分账完结金额 | finish_amount | int | 否 | 分账完结的分账金额,单位为分, 仅当查询分账完结的执行结果时,存在本字段。 示例值:100 |
分账完结描述 | finish_description | string[1,80] | 否 | 分账完结的原因描述,仅当查询分账完结的执行结果时,存在本字段。 示例值:分账完结 |
{
"sub_mchid": "1900000109",
"transaction_id": "4208450740201411110007820472",
"out_order_no": "P20150806125346",
"order_id": "3008450740201411110007820472",
"status": "FINISHED",
"receivers": [
{
"receiver_mchid": "1900000110",
"amount": 100,
"description": "分给商户1900000110",
"result": "SUCCESS",
"detail_id": "36011111111111111111111",
"finish_time": "2015-05-20T13:29:35.120+08:00",
"fail_reason": "ACCOUNT_ABNORMAL"
}
],
"finish_amount": 100,
"finish_description": "分账完结"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 商户号未设置 | 请使用正确的参数重新调用 |
429 | FREQUENCY_LIMITED | 频率限制 | 请降低频率后重试 |
404 | RESOURCE_NOT_EXISTS | 记录不存在 | 请检查请求的单号是否正确 |