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