H5純簽約
應(yīng)用場景
該方式適用于手機、平板電腦等使用H5瀏覽器的設(shè)備場景使用微信簽約扣款。商戶在網(wǎng)站前端通過微信支付H5純簽約接口與用戶簽訂委托扣款協(xié)議，再通過后臺接口申請扣款來完成代扣交易。
如果簽約成功，微信會異步通知給商戶（notify_url為通知路徑），如果簽約失敗則不通知。
特別提醒，H5純簽約接口暫未對外開放，如有需要請咨詢對接的業(yè)務(wù)人員，額外申請開通。
接口調(diào)用請求說明
| 請求Url | https://api.mch.weixin.qq.com/papay/h5entrustweb |
|---|---|
| 是否需要證書 | 否 |
| 請求方式 | GET |
| 簽名方式 | HMAC-SHA256 |
請求參數(shù)
| 字段名 | 字段 | 必填 | 示例值 | 類型 | 說明 |
|---|---|---|---|---|---|
商戶號 |
mch_id |
是 |
10000098 |
String(32) |
微信支付分配的商戶號 |
公眾賬號id |
appid |
是 |
wxcbda96de0b165486 |
String(32) |
微信支付分配的公眾賬號id |
模板id |
plan_id |
是 |
123 |
String（28） |
協(xié)議模板id |
簽約協(xié)議號 |
contract_code |
是 |
100001256 |
String |
簽約協(xié)議號 |
請求序列號 |
request_serial |
是 |
1695 |
int64 |
商戶請求簽約時的序列號，要求唯一性。序列號主要用于排序，不作為查詢條件，純數(shù)字,范圍不能超過int64的范圍（9223372036854775807）。 |
用戶賬戶展示名稱 |
contract_display_account |
是 |
123 |
String |
簽約用戶的名稱，用于頁面展示 |
回調(diào)通知url |
notify_url |
是 |
www.qq.com%2Ftest%2Fpapay |
String |
回調(diào)通知的url,傳輸需要url encode |
版本號 |
version |
是 |
1.0 |
String |
固定值1.0 |
簽名 |
sign |
是 |
130C7B07DD3B8074F7BF8BEF5C9A86487A1C57478F8C55587876B9C782F72036 |
String |
簽名規(guī)則詳見簽名生成算法 |
時間戳 |
timestamp |
是 |
1414488825 |
String(10) |
系統(tǒng)當(dāng)前時間，定義規(guī)則詳見時間戳 |
客戶端 IP |
clientip |
是 |
119.145.83.6 |
String |
用戶客戶端的真實IP地址 |
以下字段為非必填項，用來控制簽約頁面結(jié)束后的返回路徑: |
|||||
回調(diào)應(yīng)用appid |
return_appid |
否 |
wxcbda96de0b165486 |
String(32) |
當(dāng)指定該字段時，且商戶模板標(biāo)注商戶具有指定返回app的權(quán)限時，簽約成功將返回return_appid指定的app應(yīng)用，如果不填且簽約發(fā)起時的瀏覽器UA可被微信識別，則跳轉(zhuǎn)到瀏覽器，否則留在微信 |
數(shù)據(jù)示例：
返回參數(shù)
字段名 |
變量名 |
必填 |
示例值 |
類型 |
說明 |
|---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
SUCCESS |
String(16) |
SUCCESS/FAIL |
返回信息 |
return_msg |
否 |
PARAM_ERROR |
String(128) |
返回信息，如非空，為錯誤原因 |
以下字段在return_code為SUCCESS的時候返回
字段名 |
變量名 |
必填 |
示例值 |
類型 |
說明 |
|---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 |
result_code |
是 |
SUCCESS |
String(16) |
SUCCESS/FAIL |
業(yè)務(wù)結(jié)果描述 |
result_msg |
否 |
SIGN_ERROR |
String |
如非空，為錯誤原因，如簽名錯誤 |
跳轉(zhuǎn)URL |
redirect_url |
否 |
https://api.mch.weixin.qq.com/papay/readentrustwebtemplate?type=index&session_id=17d19a9aa7ce733d00ab921bd81ae3113f0983c6d51ffc43b1daee9aea37c3de&session_sign=041f839e5e60c828128c03f12da26641#/redirect |
String |
跳轉(zhuǎn)簽約頁面url，用戶通過跳轉(zhuǎn)訪問此URL即可進入微信簽約頁面，進行簽約。注意這里請求跳轉(zhuǎn)url的頁面地址必須在微信后臺配置（申請H5簽約權(quán)限時配置）。 |