申請(qǐng)扣款
場(chǎng)景介紹
委托代扣可應(yīng)用于定期扣款或需事后扣款以期提高效率的場(chǎng)景。例如但不限于，會(huì)員制繳費(fèi)、水電煤繳費(fèi)、黃鉆綠鉆增值服務(wù)、打車類軟件、停車場(chǎng)或高速公路無(wú)人繳費(fèi)、理財(cái)通基金定投、信用卡還款等通過(guò)用戶授權(quán)給商戶，進(jìn)行委托扣款的場(chǎng)景。
注：扣費(fèi)請(qǐng)求首先按簽約協(xié)議中記錄的優(yōu)先支付方式扣費(fèi)，否則依次按以下順序扣費(fèi)：零錢、信用卡、借記卡
注意：對(duì)于自動(dòng)續(xù)費(fèi)的代扣申請(qǐng)，微信將延遲24小時(shí)進(jìn)行扣款（首次簽約可在簽約后12小時(shí)內(nèi)立即扣款成功，不受此規(guī)則限制）
同一個(gè)商戶號(hào)+同一個(gè)商戶訂單號(hào)，只會(huì)扣款一次。但如果更換商戶號(hào)，商戶訂單號(hào)不變，會(huì)扣款多次。
接口調(diào)用請(qǐng)求說(shuō)明
| 請(qǐng)求Url | https://api.mch.weixin.qq.com/pay/pappayapply |
|---|---|
| 是否需要證書 | 否 |
| 請(qǐng)求方式 | post |
| 返回參數(shù)說(shuō)明 | 扣款接口請(qǐng)求成功，返回success僅代表扣款申請(qǐng)受理成功，不代表扣款成功。扣款是否成功以支付通知的結(jié)果為準(zhǔn)。 |
請(qǐng)求參數(shù)
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 說(shuō)明 |
|---|---|---|---|---|---|
請(qǐng)求appid |
appid |
是 |
String(32) |
wxcbda96de0b165486 |
appid是商戶在微信申請(qǐng)公眾號(hào)或移動(dòng)應(yīng)用成功后分配的賬號(hào)ID，登錄平臺(tái)為mp.weixin.qq.com或open.weixin.qq.com |
商戶號(hào) |
mch_id |
是 |
String(32) |
10000098 |
商戶號(hào)是商戶在微信申請(qǐng)微信支付成功后分配的賬號(hào)ID，登錄平臺(tái)為www.tg885.com |
隨機(jī)字符串 |
nonce_str |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機(jī)字符串，不長(zhǎng)于32位。推薦隨機(jī)數(shù)生成算法 |
簽名 |
sign |
是 |
String(64) |
C380BEC2BFD727A4B6845133519F3AD6 |
|
商品描述 |
body |
是 |
String(128) |
水電代扣 |
商品或支付單簡(jiǎn)要描述 |
商品詳情 |
detail |
否 |
String(8192) |
水電代扣：A |
商品名稱明細(xì)列表 |
附加數(shù)據(jù) |
attach |
否 |
String(128) |
自定義參數(shù) |
附加數(shù)據(jù)，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數(shù)據(jù) |
商戶訂單號(hào) |
out_trade_no |
是 |
String(32) |
1217752501201407033233368018 |
商戶系統(tǒng)內(nèi)部的訂單號(hào),32個(gè)字符內(nèi)、可包含字母, 其他說(shuō)明見(jiàn)商戶訂單號(hào) |
總金額 |
total_fee |
是 |
int |
888 |
訂單總金額，單位為分，只能為整數(shù)，詳見(jiàn)支付金額 |
貨幣類型 |
fee_type |
否 |
String(16) |
CNY |
符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY |
終端IP |
spbill_create_ip |
是 |
String(16) |
8.8.8.8 |
調(diào)用微信支付API的機(jī)器IP |
商品標(biāo)記 |
goods_tag |
否 |
String(32) |
WXG |
商品標(biāo)記，代金券或立減優(yōu)惠功能的參數(shù)，說(shuō)明詳見(jiàn)代金券或立減優(yōu)惠 |
回調(diào)通知url |
notify_url |
是 |
String |
http://yoursite.com/wxpay.html |
接受扣款結(jié)果異步回調(diào)通知的url |
交易類型 |
trade_type |
是 |
String |
PAP |
交易類型PAP-微信委托代扣支付 |
委托代扣協(xié)議id |
contract_id |
是 |
String |
Wx15463511252015071056489715 |
簽約成功后，微信返回的委托代扣協(xié)議id |
| 電子發(fā)票入口開放標(biāo)識(shí) | receipt | 否 | String(8) | Y | Y，傳入Y時(shí)，支付成功消息和支付詳情頁(yè)將出現(xiàn)開票入口。需要在微信支付商戶平臺(tái)或微信公眾平臺(tái)開通電子發(fā)票功能，傳此字段才可生效 |
數(shù)據(jù)示例：
<xml>
<mch_id>10000098</mch_id>
<appid>wxcbda96de0b165486</appid>
<nonce_str>5K8264ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>
<sign>C380BEC2BFD727A4B6845133519F3AD6</sign>
<body>水電代扣</body>
<out_trade_no>217752501201407033233368018</out_trade_no>
<total_fee>888</total_fee>
<spbill_create_ip>8.8.8.8</spbill_create_ip>
<notify_url>http://yoursite.com/wxpay.html</notify_url>
<contract_id>Wx15463511252015071056489715</contract_id>
返回參數(shù)
| 字段名 | 變量名 | 必填 | 示例值 | 類型 | 說(shuō)明 |
|---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
SUCCESS |
String(16) |
SUCCESS/FAIL |
返回信息 |
return_msg |
是 |
簽名失敗 |
String(128) |
返回信息，如非空，為錯(cuò)誤原因 |
以下字段在return_code為SUCCESS的時(shí)候返回
| 字段名 | 變量名 | 必填 | 示例值 | 類型 | 說(shuō)明 |
|---|---|---|---|---|---|
公眾賬號(hào)id |
appid |
是 |
wxcbda96de0b165486 |
String(32) |
微信支付分配的公眾賬號(hào)id |
商戶號(hào) |
mch_id |
是 |
10000098 |
String(32) |
微信支付分配的商戶號(hào) |
隨機(jī)字符串 |
nonce_str |
是 |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
String(32) |
隨機(jī)字符串，不長(zhǎng)于32位。推薦隨機(jī)數(shù)生成算法 |
簽名 |
sign |
是 |
C380BEC2BFD727A4B6845133519F3AD6 |
String(32) |
生成簽名方式詳見(jiàn)簽名生成詳見(jiàn)簽名生成算法 |
業(yè)務(wù)結(jié)果 |
result_code |
是 |
SUCCESS |
String(16) |
SUCCESS/FAIL |
錯(cuò)誤代碼 |
err_code |
否 |
SIGN_ERROR |
String(32) |
錯(cuò)誤碼 |
錯(cuò)誤代碼描述 |
err_code_des |
否 |
簽名錯(cuò)誤 |
String(32) |
錯(cuò)誤碼描述 |
數(shù)據(jù)示例：
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wxcbda96de0b165486]]></wxappid>?
<mch_id><![CDATA[10000098]]></mch_id>
<nonce_str><![CDATA[IITRi8Iabbblz1Jc]]></nonce_str>
<sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
錯(cuò)誤碼
名稱 |
描述 |
原因 |
解決方案 |
|---|---|---|---|
SYSTEMERROR |
接口返回錯(cuò)誤 |
系統(tǒng)超時(shí) |
系統(tǒng)異常，請(qǐng)使用相同參數(shù)重新調(diào)用接口 |
CONTRACT_NOT_EXIST |
簽約協(xié)議不存在 |
簽約協(xié)議不存在，用戶已解約 |
請(qǐng)檢查簽約協(xié)議號(hào)是否正確,是否已解約 |
PARAM_ERROR |
參數(shù)錯(cuò)誤 |
請(qǐng)求參數(shù)未按指引進(jìn)行填寫 |
請(qǐng)根據(jù)接口返回的詳細(xì)信息檢查您的程序 |
ORDERPAID |
訂單已支付 |
訂單號(hào)重復(fù) |
請(qǐng)確認(rèn)該訂單號(hào)是否重復(fù)支付，如果是新單，請(qǐng)使用新訂單號(hào)提交 |
ORDERCLOSED |
訂單已關(guān)閉 |
該訂單已關(guān) |
商戶訂單號(hào)異常，請(qǐng)重新下單支付 |
SIGN_ERROR |
簽名錯(cuò)誤 |
參數(shù)簽名結(jié)果不正確 |
請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
APPID_MCHID_NOT_MATCH |
appid和mch_id不匹配 |
appid和mch_id不匹配 |
請(qǐng)確認(rèn)appid和mch_id是否匹配 |
ORDER_ACCEPTED |
扣款請(qǐng)求已受理，請(qǐng)勿重復(fù)發(fā)起 |
該訂單已發(fā)起過(guò)扣款申請(qǐng)，無(wú)需再次請(qǐng)求 |
請(qǐng)調(diào)用查詢訂單接口查看訂單最新?tīng)顟B(tài) |
CONTRACTERROR |
協(xié)議已過(guò)期 |
協(xié)議已過(guò)期 |
請(qǐng)檢查簽約協(xié)議號(hào)是否已過(guò)期 |
INVALID_REQUEST |
無(wú)效請(qǐng)求 |
無(wú)效請(qǐng)求，比如不是使用post方法等 |
請(qǐng)檢查請(qǐng)求方式是否是post方法等 |
FREQUENCY_LIMITED |
頻率限制 |
頻率限制 |
請(qǐng)檢查接口請(qǐng)求頻率是否超過(guò)限制 |
RULELIMIT |
該筆交易存在風(fēng)險(xiǎn) |
該筆交易可能因?yàn)轱L(fēng)控策略被攔截 |
請(qǐng)聯(lián)系用戶，明確微信號(hào)是否有違規(guī)操作，如有疑問(wèn)可聯(lián)系微信客服接觸風(fēng)險(xiǎn)控制 |