查詢分賬結(jié)果
應(yīng)用場景
發(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 |
微信支付分配的服務(wù)商商戶號 |
子商戶號 |
sub_mch_id |
是 |
string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。 |
微信訂單號 |
transaction_id |
是 |
string(32) |
4208450740201411110007820472 |
微信支付訂單號 |
商戶分賬單號 |
out_order_no |
是 |
string(64) |
P20150806125346 |
查詢分賬結(jié)果,輸入申請分賬時(shí)的商戶分賬單號; 查詢分賬完結(jié)的執(zhí)行結(jié)果,輸入發(fā)起分賬完結(jié)時(shí)的商戶分賬單號 |
隨機(jī)字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機(jī)字符串,不長于32位。推薦隨機(jī)數(shù)生成算法 |
簽名 |
sign |
是 |
string(64) |
C380BEC2BFD727A4B6845133519F3AD6 |
簽名,詳見簽名生成算法 |
簽名類型 |
sign_type |
否 |
string(32) |
HMAC-SHA256 |
簽名類型,目前只支持HMAC-SHA256 |
舉例如下:
<xml>
<mch_id>10000100</mch_id>
<sub_mch_id>1415701182</sub_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 此字段是通信標(biāo)識,非交易標(biāo)識 |
返回信息 |
return_msg |
否 |
string(256) |
參數(shù)格式校驗(yàn)錯(cuò)誤 |
返回信息,如非空,為錯(cuò)誤原因 |
以下字段在return_code為SUCCESS的時(shí)候有返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 |
result_code |
是 |
string(32) |
SUCCESS |
SUCCESS:分賬申請接收成功,結(jié)果通過分賬查詢接口查詢 |
錯(cuò)誤代碼 |
err_code |
否 |
string(32) |
SYSTEMERROR |
列表詳見錯(cuò)誤碼列表 |
錯(cuò)誤代碼描述 |
err_code_des |
否 |
String(128) |
系統(tǒng)超時(shí) |
結(jié)果信息描述 |
商戶號 |
mch_id |
是 |
string(32) |
1900000100 |
調(diào)用接口時(shí)提供的商戶號 |
子商戶號 |
sub_mch_id |
是 |
string(32) |
1900000109 |
微信支付分配的子商戶號,即分賬的出資商戶號。 |
隨機(jī)字符串 |
nonce_str |
是 |
string(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
微信返回的隨機(jī)字符串 |
簽名 |
sign |
是 |
string(64) |
C380BEC2BFD727A4B6845133519F3AD6 |
微信返回的簽名,詳見簽名算法 |
以下字段在return_code和result_code都為SUCCESS的時(shí)候返回
名稱 |
變量名 |
必填 |
類型 |
示例值 |
描述 |
---|---|---|---|---|---|
微信訂單號 |
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) |
內(nèi)容見下方示例 | 分賬接收方列表,json對象詳細(xì)說明見下文,僅當(dāng)查詢分賬請求結(jié)果時(shí),存在本字段 點(diǎn)擊行前的+展開字段詳情 |
舉例如下:
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<result_code><![CDATA[SUCCESS]]></result_code>
<mch_id>10000100</mch_id>
<nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str>
<sub_mch_id>1415701182</sub_mch_id>
<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": "MERCHANT_ID",
"account":"190001001",
"amount":100,
"description": "分到商戶",
"result": "SUCCESS",
"finish_time": "20180608170132"
"detail_id": "36011111111111111111111"
},
{
"type": "PERSONAL_WECHATID",
"account":"86693952",
"amount":888,
"description": "分到個(gè)人",
"result": "SUCCESS",
"finish_time": "20180608170132"
"detail_id": "36011111111111111111111"
}
]????
</receivers>
</xml>??
錯(cuò)誤碼列表
名稱 |
描述 |
原因 |
解決方案 |
---|---|---|---|
SYSTEMERROR |
接口返回錯(cuò)誤 |
系統(tǒng)超時(shí) |
請嘗試再次掉調(diào)用API。 |
ORDERNOTEXIST |
分賬單不存在 |
訂單號錯(cuò)誤或分賬單號錯(cuò)誤 |
請檢查訂單號或分賬單號是否有誤 |
INVALID_TRANSACTIONID |
無效transaction_id |
請求參數(shù)未按指引進(jìn)行填寫 |
請求參數(shù)錯(cuò)誤,檢查原交易號是否存在或發(fā)起支付交易接口返回失敗 |
PARAM_ERROR |
參數(shù)錯(cuò)誤 |
請求參數(shù)未按指引進(jìn)行填寫 |
請求參數(shù)錯(cuò)誤,請檢查參數(shù)再調(diào)用分賬申請 |
INVALID_REQUEST |
請求不合法 |
參數(shù)中APPID或 MCHID不存在等 |
請檢查請求參數(shù) |