最新更新時(shí)間：2023.11.08 版本說(shuō)明
商戶可以通過(guò)請(qǐng)求此接口喚起微信委托代扣的頁(yè)面。
1、商戶需要在前端跳轉(zhuǎn)到"微信委托代扣的頁(yè)面"，在商戶的前端頁(yè)面<head>處需要添加聲明<meta name="referrer" content="no-referrer-when-downgrade">
2、此外，不能使用window.location.replace(redirect_url)的方式跳轉(zhuǎn)，而要通過(guò)window.location.href = redirect_url的方式跳轉(zhuǎn)。
適用對(duì)象：直連商戶
請(qǐng)求URL： https://api.mch.weixin.qq.com/papay/entrustweb
請(qǐng)求方式：GET
簽名方式：MD5
是否需要證書(shū)： 否
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 應(yīng)用ID | appid | string[1,32] | 是 | 直連商戶申請(qǐng)的公眾號(hào)或移動(dòng)應(yīng)用appid。 示例值：wxcbda96de0b165486 |
| 商戶號(hào) | mch_id | string[1,32] | 是 | 商戶號(hào)是商戶在微信申請(qǐng)微信支付成功后分配的賬號(hào)ID，登錄平臺(tái)為www.tg885.com 示例值：1200009811 |
| 模板id | plan_id | int | 是 | 協(xié)議模板id，設(shè)置路徑見(jiàn)開(kāi)發(fā)步驟。 示例值：12535 |
| 簽約協(xié)議號(hào) | contract_code | string[1,128] | 是 | 商戶側(cè)的簽約協(xié)議號(hào)，由商戶生成，只能是數(shù)字、大小寫(xiě)字母的描述。 示例值：100000 |
| 請(qǐng)求序列號(hào) | request_serial | int 64 | 是 | 商戶請(qǐng)求簽約時(shí)的序列號(hào)，要求唯一性。禁止使用0開(kāi)頭，序列號(hào)主要用于排序，不作為查詢條件，純數(shù)字，范圍不能超過(guò)int64的范圍（9223372036854775807）。 示例值：1000 |
| 用戶賬戶展示名稱 | contract_display_account | string[1,128] | 是 | 簽約用戶的名稱，用于頁(yè)面展示，參數(shù)值不支持UTF8非3字節(jié)編碼的字符，例如表情符號(hào)，所以請(qǐng)勿傳微信昵稱到該字段 示例值：微信代扣 |
| 回調(diào)通知url | notify_url | string[1,256] | 是 | 用于接收簽約成功消息的回調(diào)通知地址，以http或https開(kāi)頭，通知url必須為外網(wǎng)可訪問(wèn)的url，不能攜帶參數(shù)。 請(qǐng)對(duì)notify_url參數(shù)值進(jìn)行encode處理,注意是對(duì)參數(shù)值進(jìn)行encode，例如參數(shù)為notify_url=“https://weixin.qq.com”，則需要encode的內(nèi)容為https://weixin.qq.com。 示例值：https://weixin.qq.com |
| 版本號(hào) | version | string[1,8] | 是 | 固定值1.0 示例值：1.0 |
| 簽名 | sign | string[1,32] | 是 | 詳見(jiàn)簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 時(shí)間戳 | timestamp | string[1,10] | 是 | 系統(tǒng)當(dāng)前時(shí)間，10位 示例值：1414488825 |
| 返回web | return_web | int | 否 | 用來(lái)控制簽約頁(yè)面結(jié)束后的返回路徑（不傳此參數(shù)，則簽約完成后停留在微信內(nèi)）。 1表示返回簽約頁(yè)面的referrer url。如果獲取到的referrer包含路徑，會(huì)通過(guò)window.location.replace()跳轉(zhuǎn)，跳轉(zhuǎn)referrer url時(shí)會(huì)自動(dòng)帶上參數(shù)from_wxpay=1，否則會(huì)通過(guò)window.history.back()返回上一頁(yè)，此時(shí)沒(méi)有參數(shù)from_wxpay=1 示例值：1 |
https://api.mch.weixin.qq.com/papay/entrustweb?appid=wx426a3015555a46be&contract_code=122&contract_display_account=name1&mch_id=1223816102¬ify_url=http%3A%2F%2Fwww.qq.com%2Ftest%2Fpapay&plan_id=106&request_serial=123×tamp=1414488825&version=1.0&sign=FF1A406564EE701064450CA2149E2514