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