微信支付簽約委託代扣文檔 - 月付會員或者定期支付服務 - 公衆號純簽約

微信支付簽約委託代扣文檔 - 月付會員或者定期支付服務 - 公衆號純簽約

---

1、應用場景

商戶可以通過請求此接口喚起微信委託代扣的頁面，頁面樣例見案例與規範。

用戶在微信的頁面中完成代扣簽約後，微信會同時將簽約信息通過異步通知的方式通知給商戶後臺。如果用戶放棄簽約或簽約失敗則不通知。

2、案例與規範

3、接口調用請求說明

請求Url https://api.mch.weixin.qq.com/papay/entrustweb
請求方式 GET

4、請求參數

5、請求示例

https://api.mch.weixin.qq.com/papay/entrustweb?appid=wx426a3015555a46be&contract_code=122&contract_display_account=name1&mch_id=1223816102&notify_url=www.qq.com%2Ftest%2Fpapay&plan_id=106&request_serial=123&timestamp=1414488825&version=1.0&sign=FF1A406564EE701064450CA2149E2514

6、申請簽約常見問題

一、公衆號簽約常見錯誤
1、首先確認支付密鑰KEY是否正確，簽約接口使用的加密密鑰KEY與支付接口是同一個。

2、簽名參數使用的是原值，傳輸時其中一個參數值notify_url需要做encode處理，注意是對參數值encode。

3、對notify_url進行encode後，轉義符（3A%、2F%）需要大寫。

4、請檢查參數格式是否正確，是否符合字段要求。如notify_url參數必須是一個url地址的格式、時間戳是10位數字、int格式的字段出現了字母或特殊字符等。

5、plan_id與商戶號是否對應。

二、常見問題
1、一個微信用戶能否與商戶多次簽約？
—簽約遵循同一個商戶號+同一個模版ID+同一個微信號只能簽約一次的原則。多次簽約可採用多模版ID的方式，同一個商戶號下的每個不同模版ID都可以與同一微信用戶分別簽約一次。

2、申請扣款接口已經返回成功，爲什麼還會扣款失敗？
—申請扣款接口返回成功僅代表申請受理成功，不代表最終的扣款結果，扣款結果應以支付結果通知接口通知的結果爲準，無論扣款是否成功都會返回扣款結果及原因。

3、簽約和解約信息是通過什麼路徑通知給商戶的？
—簽約通知是通過簽約接口上傳的notify_url參數所填寫的地址回調通知的（簽約失敗不通知）。解約信息是通過創建模版ID時填寫的解約通知URL來回調通知的。

7、返回參數（異步返回）說明

簽約成功後，微信會把相關簽約結果異步發送給商戶，返回的url爲調用上述簽約接口時填寫的notify_url字段。商戶在收到簽約結果通知後，需進行接收處理並返回應答

對後臺通知交互時，如果微信收到商戶的應答不是成功或超時，微信認爲通知失敗，微信會通過一定的策略定期重新發起通知,儘可能提高通知的成功率，但微信不保證通知最終能成功。
（通知頻率爲15/15/30/180/1800/1800/1800/1800/3600，單位：秒）

由於存在重新發送後臺通知的情況，因此同樣的通知可能會多次發送給商戶系統。商戶系統必須能夠正確處理重複的通知。
推薦的做法是，當收到通知進行處理時，首先檢查對應業務數據的狀態，判斷該通知是否已經處理過，如果沒有處理過再進行處理，如果處理過直接返回結果成功。在對業務數據進行狀態檢查和處理之前，要採用數據鎖進行併發控制，以避免函數重入造成的數據混亂。

8、返回參數示例

<xml>
	<return_code><![CDATA[SUCCESS]]></return_code>
	<result_code><![CDATA[SUCCESS]]></result_code>
	<sign><![CDATA[C380BEC2BFD727A4B6845133519F3AD6]]></sign>
	<mch_id>10010404</mch_id>	
	<contract_code>100001256</contract_code>
	<openid><![CDATA[onqOjjmM1tad-3ROpncN-yUfa6ua]]></openid>
	<plan_id><![CDATA[123]]></plan_id>
	<change_type><![CDATA[ADD]]></change_type>
	<operate_time><![CDATA[2015-07-01 10:00:00]]></operate_time>
	<contract_id><![CDATA[Wx15463511252015071056489715]]></contract_id>
</xml>

9、商戶需返回參數

<xml>
  <return_code><![CDATA[SUCCESS]]></return_code>
  <return_msg><![CDATA[OK]]></return_msg>
</xml>

10、防火牆配置

微信支付簽約，解約通知出口IP列表
如果商戶側配置了防火牆，需要對商戶回調通知功能開通下面白名單網段：
101.226.233.128/25