查詢付款
簡介
用于商戶的付款操作進行結(jié)果查詢,返回付款操作詳細結(jié)果。
查詢付款A(yù)PI只支持查詢30天內(nèi)的訂單,30天之前的訂單請登錄商戶平臺查詢。
注意事項
◆ 如果查詢單號對應(yīng)的數(shù)據(jù)不存在,那么數(shù)據(jù)不存在的原因可能是:(1)付款還在處理中;(2)付款處理失敗導(dǎo)致付款訂單沒有落地。在上述情況下,商戶首先需要檢查該商戶訂單號是否確實是自己發(fā)起的,如果商戶確認是自己發(fā)起的,則請商戶不要直接當(dāng)做付款失敗處理,請商戶隔幾分鐘再嘗試查詢(請勿付款和查詢并發(fā)處理),或者商戶可以通過相同的商戶訂單號再次發(fā)起付款(支持2個自然日內(nèi)的單據(jù),超過2個自然日請確認付款失敗后再換單發(fā)起)。如果商戶誤把還在付款處理中的訂單直接當(dāng)付款失敗處理,商戶應(yīng)當(dāng)自行承擔(dān)因此產(chǎn)生的所有損失和責(zé)任。
◆ XML具有可擴展性,因此返回參數(shù)可能會有新增,而且順序可能不完全遵循此文檔規(guī)范,如果在解析回包的時候發(fā)生錯誤,請商戶務(wù)必不要換單重試,請商戶聯(lián)系客服確認付款情況。如果有新回包字段,會更新到此API文檔中。
◆ 因為錯誤代碼字段err_code的值后續(xù)可能會增加,所以商戶如果遇到回包返回新的錯誤碼,請商戶務(wù)必不要換單重試,請商戶聯(lián)系客服確認付款情況。如果有新的錯誤碼,會更新到此API文檔中。
◆ 錯誤代碼描述字段err_code_des只供人工定位問題時做參考,系統(tǒng)實現(xiàn)時請不要依賴這個字段來做自動化處理。
接口調(diào)用請求說明
請求Url | https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo |
---|---|
是否需要證書 | 是(證書及使用說明詳見商戶證書) |
請求方式 | POST |
簽名方式 | MD5 |
接口調(diào)用頻率限制 | 30/s |
請求參數(shù)
字段名 | 字段 | 必填 | 示例值 | 類型 | 說明 |
---|---|---|---|---|---|
隨機字符串 | nonce_str | 是 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | String(32) | 隨機字符串,不長于32位 |
簽名 | sign | 是 | C380BEC2BFD727A4B6845133519F3AD6 | String(32) | 簽名,詳見簽名算法 |
商戶訂單號 | partner_trade_no | 是 | 10000098201411111234567890 | String(32) | 商戶調(diào)用付款A(yù)PI時使用的商戶訂單號 |
商戶號 | mch_id | 是 | 10000098 | String(32) | 微信支付分配的商戶號 |
Appid | appid | 是 | wxe062425f740d30d8 | String(128) | 商戶號的appid |
數(shù)據(jù)示例:
<xml>
<sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>
<partner_trade_no><![CDATA[0010010404201411170000046545]]></partner_trade_no>
<mch_id ><![CDATA[10000097]]></mch_id >
<appid><![CDATA[wxe062425f740c30d8]]></appid>
<nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>
</xml>
返回參數(shù)
字段名 | 變量名 | 必填 | 示例值 | 類型 | 說明 | |
---|---|---|---|---|---|---|
返回狀態(tài)碼 | return_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL 此字段是通信標識,非付款標識,付款是否成功需要查看result_code來判斷 |
|
返回信息 | return_msg | 否 | 簽名失敗 | String(128) | 返回信息,如非空,為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤 |
|
以下字段在return_code為SUCCESS的時候有返回 | ||||||
業(yè)務(wù)結(jié)果 | result_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL ,非付款標識,付款是否成功需要查看status字段來判斷 | |
錯誤代碼 | err_code | 否 | SYSTEMERROR | String(32) | 錯誤碼信息 | |
錯誤代碼描述 | err_code_des | 否 | 系統(tǒng)錯誤 | String(128) | 結(jié)果信息描述 | |
以下字段在return_code 和result_code都為SUCCESS的時候有返回 | ||||||
商戶單號 | partner_trade_no | 是 | 10000098201411111234567890 | String(32) | 商戶使用查詢API填寫的單號的原路返回. | |
Appid | appid | 是 | wxe062425f740d30d8 | String(128) | 商戶號的appid | |
商戶號 | mch_id | 是 | 10000098 | String(32) | 微信支付分配的商戶號 | |
付款單號 | detail_id | 是 | 1000000000201503283103439304 | String(64) | 調(diào)用付款A(yù)PI時,微信支付系統(tǒng)內(nèi)部產(chǎn)生的單號 | |
轉(zhuǎn)賬狀態(tài) | status | 是 | SUCCESS | string(16) | SUCCESS:轉(zhuǎn)賬成功 FAILED:轉(zhuǎn)賬失敗 PROCESSING:處理中 |
|
失敗原因 | reason | 否 | 余額不足 | String(128) | 如果失敗則有失敗原因 | |
收款用戶openid | openid | 是 | oxTWIuGaIt6gTKsQRLau2M0yL16E | String(64) | 轉(zhuǎn)賬的openid | |
收款用戶姓名 | transfer_name | 否 | 馬華 | String(64) | 收款用戶姓名 | |
付款金額 | payment_amount | 是 | 5000 | int | 付款金額單位為“分” | |
轉(zhuǎn)賬時間 | transfer_time | 是 | 2015-04-21 20:00:00 | String(32) | 發(fā)起轉(zhuǎn)賬的時間 | |
付款成功時間 | payment_time | 是 | 2015-04-21 20:01:00 | String(32) | 付款成功時間 | |
付款備注 | desc | 是 | 車險理賠 | String(100) | 付款備注 |
示例:
<xml> // 按照格式補充
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[獲取成功]]></return_msg>
<result_code><![CDATA[SUCCESS]]></result_code>
<mch_id>10000098</mch_id>
<appid><![CDATA[wxe062425f740c30d8]]></appid>
<detail_id><![CDATA[1000000000201503283103439304]]></detail_id>
<partner_trade_no><![CDATA[1000005901201407261446939628]]></partner_trade_no>
<status><![CDATA[SUCCESS]]></status>
<payment_amount>650</payment_amount >
<openid ><![CDATA[oxTWIuGaIt6gTKsQRLau2M0yL16E]]></openid>
<transfer_time><![CDATA[2015-04-21 20:00:00]]></transfer_time>
<transfer_name ><![CDATA[測試]]></transfer_name >
<desc><![CDATA[福利測試]]></desc>
</xml>
錯誤碼
錯誤代碼 | 描述 | 解決方案 |
---|---|---|
CA_ERROR | 請求未攜帶證書,或請求攜帶的證書出錯 | 到商戶平臺下載證書,請求帶上證書后重試 |
SIGN_ERROR | 商戶簽名錯誤 | 按文檔要求重新生成簽名后再重試 |
FREQ_LIMIT | 受頻率限制 | 請對請求做頻率控制 |
XML_ERROR | 請求的xml格式錯誤,或者post的數(shù)據(jù)為空 | 檢查請求串,確認無誤后重試 |
PARAM_ERROR | 參數(shù)錯誤 | 請查看err_code_des,修改設(shè)置錯誤的參數(shù) |
SYSTEMERROR | 系統(tǒng)繁忙,請再試 | 系統(tǒng)繁忙 |
NOT_FOUND | 1、指定單號數(shù)據(jù)不存在 2、指定單號數(shù)據(jù)不存在,單據(jù)查詢超過有效期 | 1、查詢單號對應(yīng)的數(shù)據(jù)不存在,請使用正確的商戶訂單號查詢 2、如需查詢超過有效期的單據(jù),請登錄到商戶平臺進行查詢 |