最新更新時間：2020.11.06 版本說明
發(fā)起分賬請求后，可調(diào)用此接口查詢分賬結(jié)果?;發(fā)起分賬完結(jié)請求后，可調(diào)用此接口查詢分賬完結(jié)的結(jié)果
適用對象：電商平臺
請求URL：https://api.mch.weixin.qq.com/v3/ecommerce/profitsharing/orders
請求方式：GET
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1,32] | 是 | query 分賬出資的電商平臺二級商戶，填寫微信支付分配的商戶號。 示例值：1900000109 |
| 微信訂單號 | transaction_id | string[1,32] | 是 | query 微信支付訂單號。 示例值： 4208450740201411110007820472 |
| 商戶分賬單號 | out_order_no | string[1,64] | 是 | query 商戶系統(tǒng)內(nèi)部的分賬單號，在商戶系統(tǒng)內(nèi)部唯一（單次分賬、多次分賬、完結(jié)分賬應使用不同的商戶分賬單號），同一分賬單號多次請求等同一次。
示例值：P20150806125346 |
https://api.mch.weixin.qq.com/v3/ecommerce/profitsharing/orders?sub_mchid=1900000109&transaction_id=4208450740201411110007820472&out_order_no=P20150806125346
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1,32] | 是 | 分賬出資的電商平臺二級商戶，填寫微信支付分配的商戶號。 示例值：1900000109 |
| 微信訂單號 | transaction_id | string[1,32] | 是 | 微信支付訂單號。 示例值： 4208450740201411110007820472 |
| 商戶分賬單號 | out_order_no | string[1,64] | 是 | 商戶系統(tǒng)內(nèi)部的分賬單號，在商戶系統(tǒng)內(nèi)部唯一（單次分賬、多次分賬、完結(jié)分賬應使用不同的商戶分賬單號），同一分賬單號多次請求等同一次。 示例值：P20150806125346 |
| 微信分賬單號 | order_id | string[1,64] | 是 | 微信分賬單號，微信支付系統(tǒng)返回的唯一標識 示例值： 008450740201411110007820472 |
| 分賬單狀態(tài) | status | string[1,32] | 是 | 分賬單狀態(tài)，枚舉值： PROCESSING：處理中 FINISHED：處理完成 示例值：FINISHED |
| +分賬接收方列表 | receivers | array | 否 | 分賬接收方列表。當查詢分賬完結(jié)的執(zhí)行結(jié)果時，不返回該字段 |
| 關(guān)單原因 | close_reason | string[1,32] | 否 | 關(guān)單原因描述，當分賬單狀態(tài)status為CLOSED（處理失敗，已關(guān)單）時，返回該字段。 枚舉值： NO_AUTH：分賬授權(quán)已解除 示例值：NO_AUTH |
| 分賬完結(jié)金額 | finish_amount | int | 否 | 分賬完結(jié)的分賬金額，單位為分， 僅當查詢分賬完結(jié)的執(zhí)行結(jié)果時，存在本字段。 示例值：100 |
| 分賬完結(jié)描述 | finish_description | string[1,80] | 否 | 分賬完結(jié)的原因描述，僅當查詢分賬完結(jié)的執(zhí)行結(jié)果時，存在本字段。 示例值：分賬完結(jié) |
{
"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",
"finish_time": "2015-05-20T13:29:35.120+08:00",
"fail_reason": "ACCOUNT_ABNORMAL"
}
],
"close_reason": "NO_AUTH",
"finish_amount": 100,
"finish_description": "分賬完結(jié)"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 商戶號未設(shè)置 | 請使用正確的參數(shù)重新調(diào)用 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 請降低頻率后重試 |
| 404 | RESOURCE_NOT_EXISTS | 記錄不存在 | 請檢查請求的單號是否正確 |