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