查詢分賬結(jié)果API
最新更新時(shí)間：2022.08.04 版本說明
發(fā)起分賬請求后，可調(diào)用此接口查詢分賬結(jié)果；發(fā)起解凍剩余資金的請求后，可調(diào)用此接口查詢解凍剩余資金的結(jié)果。
1. 接口說明
適用對象：直連模式 機(jī)構(gòu)模式
請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/{out_order_no}
請求方式：GET
Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請求JSON傳參
2. 請求參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1, 32] | 否 | Query微信支付分配的商戶號，請與微信支付訂單的二級商戶號保持一致。（直連商戶不需要，服務(wù)商/機(jī)構(gòu)模式下必填） 示例值：1900000109 |
| 微信支付訂單號 | transaction_id | string[1, 32] | 是 | Query微信支付訂單號 示例值：4208450740201411110007820472 |
| 商戶分賬單號 | out_order_no | string[1, 64] | 是 | Path商戶系統(tǒng)內(nèi)部的分賬單號，在商戶系統(tǒng)內(nèi)部唯一（單次分賬、多次分賬、完結(jié)分賬應(yīng)使用不同的商戶分賬單號），同一分賬單號多次請求等同一次。只能是數(shù)字、大小寫字母_- 示例值：P20150806125346 |
請求示例
https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/P20150806125346?sub_mchid=1900000109&transaction_id=4208450740201411110007820472
3. 返回參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1, 32] | 否 | 微信支付分配的商戶號 示例值：1900000109 |
| 微信支付訂單號 | transaction_id | string[1, 32] | 是 | 微信支付訂單號 示例值：4208450740201411110007820472 |
| 商戶分賬單號 | out_order_no | string[1, 64] | 是 | 商戶分賬單號，同請求入?yún)ⅰ?br/> 示例值：P20150806125346 |
| 微信分賬單號 | order_id | string[1, 64] | 是 | 微信分賬單號，微信系統(tǒng)返回的唯一標(biāo)識。 示例值：3008450740201411110007820472 |
| 分賬單狀態(tài) | state | string | 是 | 分賬單狀態(tài)（每個(gè)接收方的分賬結(jié)果請查看receivers中的result字段）。 PROCESSING：處理中， FINISHED：分賬完成， 示例值：FINISHED |
| 分賬接收方列表 | receivers | array | 是 | 分賬接收方列表 商戶在發(fā)起分賬請求或解凍剩余資金請求時(shí)，對同一筆訂單可分給多個(gè)接收方（包括解凍給出資方），分賬明細(xì)描述了每筆分給一個(gè)接收方的資金的狀態(tài)。 |
返回示例
{
"order_id": "7100000751202203238026613597498",
"out_order_no": "MCH13SFDG234155321146",
"receivers": [
{
"account": "999952224", # 注：該賬戶為出資方商戶號
"amount": 797,
"create_time": "2022-03-23T17:10:13+08:00",
"currency": "CNY",
"description": "Unfreeze the remaining funds to sponsor",
"detail_id": "7200000751202203238026613597602",
"detail_type": "UNFREEZE_TO_SPONSOR",
"rate_value": 83640300,
"result": "PENDING",
"settlement_amount": 952,
"settlement_currency": "HKD",
"type": "MERCHANT_ID"
},
{
"account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
"amount": 99,
"create_time": "2022-03-23T17:10:13+08:00",
"currency": "CNY",
"description": "分給xxx用戶-10%",
"detail_id": "7200000751202203238026613597699",
"detail_type": "DISTRIBUTE_TO_OTHERS",
"result": "PENDING",
"type": "PERSONAL_OPENID"
},
{
"account": "2480248971",
"amount": 99,
"create_time": "2022-03-23T17:10:13+08:00",
"currency": "CNY",
"description": "分給xxx商戶-10%",
"detail_id": "7200000751202203238026613597767",
"detail_type": "DISTRIBUTE_TO_OTHERS",
"result": "PENDING",
"type": "MERCHANT_ID"
}
],
"state": "PROCESSING",
"sub_mchid": "999968479",
"transaction_id": "4200000012202203235765130087"
}
4. 錯(cuò)誤碼
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 404 | NOT_FOUND | 分賬指令不存在，請檢查外部指令單號(out_order_no)是否填寫正確 | 請檢查外部指令單號(out_order_no)是否填寫正確 |
| 400 | INVALID_REQUEST | 查詢分賬結(jié)果時(shí)商戶信息與原指令不一致 | 請檢查外部指令單號(out_order_no)/微信支付單號(transaction_id)/二級商戶號(sub_mchid)是否填寫正確 |
| 400 | INVALID_REQUEST | 查詢分賬結(jié)果時(shí)微信支付訂單與原指令信息不一致 | 請檢查外部指令單號(out_order_no)/微信支付單號(transaction_id)是否填寫正確 |
| 403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請參考產(chǎn)品流程和接入準(zhǔn)備，確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請求 |
| 403 | NO_AUTH | 商戶已開通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效) | 開通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請等待第二天后發(fā)起請求 |
| 403 | NO_AUTH | 商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求 | 請檢查二級商戶號(sub_mchid)是否填寫正確 |
頁面導(dǎo)航
