查詢分賬結(jié)果
應用場景
發(fā)起分賬請求后,可調(diào)用此接口查詢分賬結(jié)果;發(fā)起分賬完結(jié)請求后,可調(diào)用此接口查詢分賬完結(jié)的執(zhí)行結(jié)果。
接口頻率:80QPS
接口說明
請求Url | https://api.mch.weixin.qq.com/pay/profitsharingquery |
---|---|
是否需要證書 | 否 |
請求方式 | post |
簽名方式 | HMAC-SHA256 |
請求參數(shù)
名稱 | 變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
商戶號 | mch_id |
是 |
string(32) |
1900000100 |
微信支付分配的商戶號 |
微信訂單號 | transaction_id | 是 |
string(32) |
4208450740201411110007820472 |
微信支付訂單號 |
商戶分賬單號 | out_order_no |
是 |
string(64) |
P20150806125346 |
查詢分賬結(jié)果,輸入申請分賬時的商戶分賬單號; 查詢分賬完結(jié)執(zhí)行的結(jié)果,輸入發(fā)起分賬完結(jié)時的商戶分賬單號 |
隨機字符串 | nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機字符串,不長于32位。推薦隨機數(shù)生成算法 |
簽名 | sign |
是 |
string(64) |
C380BEC2BFD727A4B6845133519F3AD6 |
簽名,詳見簽名生成算法 |
簽名類型 | sign_type |
否 |
string(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 |
舉例如下:
<xml>
<mch_id>10000100</mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>?
<out_order_no>P20150806125346</out_order_no>
<transaction_id>4006252001201705123297353072</transaction_id>
<sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
<sign_type>HMAC-SHA256</sign_type>
</xml>
返回結(jié)果
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
string(32) |
SUCCESS |
SUCCESS/FAIL 此字段是通信標識,非交易標識 |
返回信息 |
return_msg |
否 |
string(256) |
參數(shù)格式校驗錯誤 |
返回信息,如非空,為錯誤原因 |
以下字段在return_code為SUCCESS的時候有返回
名稱 | 變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
業(yè)務結(jié)果 | result_code |
是 |
string(32) |
SUCCESS |
SUCCESS:分賬申請接收成功,結(jié)果通過分賬查詢接口查詢 |
錯誤代碼 | err_code |
否 |
string(32) |
SYSTEMERROR |
列表詳見錯誤碼列表 |
錯誤代碼描述 | err_code_des |
否 |
String(128) |
系統(tǒng)超時 |
結(jié)果信息描述 |
商戶號 | mch_id |
是 |
string(32) |
1900000100 |
調(diào)用接口時提供的商戶號 |
隨機字符串 | nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
微信返回的隨機字符串 |
簽名 | sign |
是 |
string(64) |
C380BEC2BFD727A4B6845133519F3AD6 |
微信返回的簽名,詳見簽名算法 |
以下字段在return_code和result_code都為SUCCESS的時候返回
名稱 | 變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
微信訂單號 | transaction_id | 是 |
string(32) |
4208450740201411110007820472 |
微信支付訂單號 |
商戶分賬單號 | out_order_no | 是 |
string(64) |
P20150806125346 |
商戶系統(tǒng)內(nèi)部的分賬單號,商戶系統(tǒng)內(nèi)部唯一,只能是數(shù)字、大小寫字母_-|*@ ,同一分賬單號多次請求等同一次。 |
微信分賬單號 | order_id |
是 |
string(64) |
3008450740201411110007820472 |
微信分賬單號 |
分賬單狀態(tài) | status | 是 |
string(16) |
FINISHED |
分賬單狀態(tài): |
+分賬接收方列表 | receivers | 是 | string(10240) | 示例如下 | 分賬接收方列表,不超過50個json對象,不能設置分賬方作為分賬接受方
點擊行前的+展開字段詳情 |
舉例如下:
<xml>
<mch_id>1900000100</mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>?
<out_order_no>P20150806125346</out_order_no>
<status>FINISHED</status>
<transaction_id>4006252001201705123297353072</transaction_id>
<order_id>3008450740201411110007820472</order_id>
<sign>FE56DD4AA85C0EECA82C35595A69E153</sign>
<receivers>
[
{
"type": "PERSONAL_OPENID",
"account":"190001001",
"amount":100,
"description": "分到商戶",
"result": "SUCCESS",
"finish_time": "20180608170132",
"detail_id": "36011111111111111111111"
},
{
"type": "PERSONAL_OPENID",
"account":"86693952",
"amount":888,
"description": "分到個人",
"result": "SUCCESS",
"finish_time": "20180608170132",
"detail_id": "36011111111111121111111"
}
]
</receivers>
</xml>
錯誤碼列表
名稱 |
描述 |
原因 |
解決方案 |
---|---|---|---|
SYSTEMERROR |
接口返回錯誤 |
系統(tǒng)超時 |
請嘗試再次掉調(diào)用API。 |
ORDERNOTEXIST |
分賬單不存在 |
訂單號錯誤或分賬單號錯誤 |
請檢查訂單號或分賬單號是否有誤 |
INVALID_TRANSACTIONID |
無效transaction_id |
請求參數(shù)未按指引進行填寫 |
請求參數(shù)錯誤,檢查原交易號是否存在或發(fā)起支付交易接口返回失敗 |
PARAM_ERROR |
參數(shù)錯誤 |
請求參數(shù)未按指引進行填寫 |
請求參數(shù)錯誤,請檢查參數(shù)再調(diào)用分賬申請 |
INVALID_REQUEST |
請求不合法 |
參數(shù)中APPID或 MCHID不存在等 |
請檢查請求參數(shù) |