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