H5純簽約
應(yīng)用場(chǎng)景
該方式適用于手機(jī)、平板電腦等使用H5瀏覽器的設(shè)備場(chǎng)景使用微信簽約扣款。商戶(hù)在網(wǎng)站前端通過(guò)微信支付H5純簽約接口與用戶(hù)簽訂委托扣款協(xié)議，再通過(guò)后臺(tái)接口申請(qǐng)扣款來(lái)完成代扣交易。
如果簽約成功，微信會(huì)異步通知給商戶(hù)（notify_url為通知路徑），如果簽約失敗則不通知。
特別提醒，H5純簽約接口暫未對(duì)外開(kāi)放，如有需要請(qǐng)咨詢(xún)對(duì)接的業(yè)務(wù)人員，額外申請(qǐng)開(kāi)通。
接口調(diào)用請(qǐng)求說(shuō)明
| 請(qǐng)求Url | https://api.mch.weixin.qq.com/papay/partner/h5entrustweb |
|---|---|
| 是否需要證書(shū) | 否 |
| 請(qǐng)求方式 | GET |
| 簽名方式 | HMAC-SHA256 |
請(qǐng)求參數(shù)
| 字段名 | 字段 | 必填 | 示例值 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|---|---|---|
商戶(hù)號(hào) |
mch_id |
是 |
10000098 |
String(32) |
微信支付分配的商戶(hù)號(hào) |
| 子商戶(hù)號(hào) | sub_mch_id | 是 |
1900000109 | String(32) |
微信支付分配的子商戶(hù)號(hào) |
公眾賬號(hào)id |
appid |
是 |
wxcbda96de0b165486 |
String(32) |
微信支付分配的公眾賬號(hào)id |
| 子商戶(hù)公眾賬號(hào)id | sub_appid | 否 |
wxcbda96de0b165489 | String(32) |
微信分配的子商戶(hù)公眾賬號(hào)id |
模板id |
plan_id |
是 |
123 |
String |
協(xié)議模板id |
簽約協(xié)議號(hào) |
contract_code |
是 |
100001256 |
String |
簽約協(xié)議號(hào) |
請(qǐng)求序列號(hào) |
request_serial |
是 |
1695 |
int(64) |
商戶(hù)請(qǐng)求簽約時(shí)的序列號(hào)，商戶(hù)側(cè)須唯一 |
用戶(hù)賬戶(hù)展示名稱(chēng) |
contract_display_account |
是 |
123 |
String |
簽約用戶(hù)的名稱(chēng)，用于頁(yè)面展示 |
回調(diào)通知url |
notify_url |
是 |
http://yoursite.com |
String |
回調(diào)通知的url,傳輸需要url encode |
版本號(hào) |
version |
是 |
1.0 |
String |
固定值1.0 |
簽名 |
sign |
是 |
130C7B07DD3B8074F7BF8BEF5C9A86487A1C57478F8C55587876B9C782F72036 |
String |
簽名規(guī)則詳見(jiàn)簽名生成算法 |
時(shí)間戳 |
timestamp |
是 |
1414488825 |
String(10) |
系統(tǒng)當(dāng)前時(shí)間，定義規(guī)則詳見(jiàn)時(shí)間戳 |
客戶(hù)端 IP |
clientip |
是 |
119.145.83.6 |
String |
用戶(hù)客戶(hù)端的真實(shí)IP地址 |
以下字段為非必填項(xiàng)風(fēng)控參數(shù)，建議商戶(hù)填寫(xiě)，提高風(fēng)險(xiǎn)控制能力 |
|||||
設(shè)備ID |
deviceid |
否 |
baf04e6bbbd06f7b1a197d18ed53b7f1 |
String |
android填imei的一次md5; ios填idfa的一次md5 |
手機(jī)號(hào) |
mobile |
否 |
18933432355 |
String |
用戶(hù)手機(jī)號(hào) |
郵箱地址 |
否 |
aobama@whitehouse.com |
String |
用戶(hù)郵箱地址 |
|
QQ號(hào) |
否 |
100243 |
String |
用戶(hù)QQ號(hào) |
|
微信open ID |
openid |
否 |
baf04e6bbbd06f7b1a197d18ed53b7f1 |
String |
用戶(hù)微信open ID |
身份證號(hào) |
creid |
否 |
110102199701011000 ??? |
String |
用戶(hù)身份證號(hào) |
商戶(hù)側(cè)用戶(hù)標(biāo)識(shí) |
outerid |
否 |
user123 |
String |
用戶(hù)在商戶(hù)側(cè)的標(biāo)識(shí) |
以下字段為非必填項(xiàng)，用來(lái)控制簽約頁(yè)面結(jié)束后的返回路徑: |
|||||
回調(diào)應(yīng)用appid |
return_appid |
否 |
wxcbda96de0b165486 |
String(32) |
當(dāng)指定該字段時(shí)，且商戶(hù)模板標(biāo)注商戶(hù)具有指定返回app的權(quán)限時(shí)，簽約成功將返回return_appid指定的app應(yīng)用，如果不填且簽約發(fā)起時(shí)的瀏覽器UA可被微信識(shí)別，則跳轉(zhuǎn)到瀏覽器，否則留在微信 |
數(shù)據(jù)示例：
返回參數(shù)（該步驟將返回簽約跳轉(zhuǎn)鏈接redirect_url，商戶(hù)請(qǐng)求該鏈接即可調(diào)起微信支付純簽約頁(yè)面）
字段名 |
變量名 |
必填 |
示例值 |
類(lèi)型 |
說(shuō)明 |
|---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
SUCCESS |
String(16) |
SUCCESS/FAIL |
返回信息 |
return_msg |
否 |
PARAM_ERROR |
String(128) |
返回信息，如非空，為錯(cuò)誤原因 |
以下字段在return_code為SUCCESS的時(shí)候返回
字段名 |
變量名 |
必填 |
示例值 |
類(lèi)型 |
說(shuō)明 |
|---|---|---|---|---|---|
業(yè)務(wù)結(jié)果 |
result_code |
是 |
SUCCESS |
String(16) |
SUCCESS/FAIL |
業(yè)務(wù)結(jié)果描述 |
result_msg |
否 |
SIGN_ERROR |
String |
如非空，為錯(cuò)誤原因，如簽名錯(cuò)誤 |
跳轉(zhuǎn)URL |
redirect_url |
否 |
https://api.mch.weixin.qq.com/papay/readentrustwebtemplate?type=index&session_id=17d19a9aa7ce733d00ab921bd81ae3113f0983c6d51ffc43b1daee9aea37c3de&session_sign=041f839e5e60c828128c03f12da26641#/redirect |
String |
若result_code為SUCCESS，則用戶(hù)瀏覽器或app中webview可通過(guò)此URL進(jìn)入微信客戶(hù)端簽約頁(yè)面，進(jìn)行簽約 |