微信支付境外文檔-委托代扣

WEB預簽約API

最新更新時間：2021.12.08 版本說明

該方式適用于PC等使用瀏覽器的設備場景使用微信簽約扣款。商戶在網站后端通過微信支付WEB簽約接口獲取到簽約鏈接，在網站前端將簽約鏈接生成二維碼，引導用戶掃碼識別該鏈接，用戶訪問該鏈接進入代扣簽約頁面；用戶簽約完成后留在微信。WEB 端等待簽約回調通知，或者定時輪詢查詢用戶簽約狀態(tài)，更新頁面內容。

接口說明

適用對象：直連模式機構模式

請求URL：https://apihk.mch.weixin.qq.com/v3/global/papay/contracts/web-pre-entrust-sign

請求方式：POST

path 指該參數為路徑參數

query 指該參數為URL參數

body 指該參數需在請求JSON傳參

時序圖

請求參數

參數名	變量	類型[長度限制]	必填	描述
應用ID	appid	string[1, 32]	是	body商戶號綁定的AppID 注意：僅適用于直連模式示例值：wxcbda96de0b165486
子商戶號	sub_mchid	string[1, 32]	是	body微信支付分配的子商戶號注意：僅適用于機構模式示例值：10000097
服務商應用ID	sp_appid	string[1, 32]	是	body服務商綁定的AppID 注意：僅適用于機構模式示例值：wxcbda96de0b165486
子商戶應用ID	sub_appid	string[1, 32]	否	body發(fā)起簽約的子商戶號綁定的AppID 注意：僅適用于機構模式示例值：wxcbda96de0b165484
模板ID	plan_id	int	是	body協議模板ID，該模板ID是商戶在向微信支付提交代扣權限申請時由微信支付生成示例值：123
商戶側簽約協議號	out_contract_code	string[1, 32]	是	body商戶請求簽約時傳入的簽約協議號，商戶側須唯一示例值：100001256
用戶賬戶展示名稱	user_display_name	string[1, 32]	是	body簽約用戶的名稱，用于頁面展示,不需要對值進行URL編碼，參數值不支持UTF8非3字節(jié)編碼的字符，例如表情符號，所以請勿傳微信昵稱到該字段示例值：張三
簽約成功通知URL	success_notify_url	string[1, 256]	是	bodyHTTPS開頭的回調通知URL ,不需要對值進行URL編碼示例值：https://yoursite.com
過期時間	expired_time	string[1, 64]	否	body境外代扣簽約會話ID過期時間，遵循rfc3339標準格式，格式為YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出現在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2021-11-20T13:29:35+08:00表示，北京時間2021年11月20日 13點29分35秒。示例值：2021-11-20T13:29:35+08:00

請求示例


{
  "appid": "wxcbda96de0b165486",
  "expired_time": "2021-11-20T13:29:35+08:00",
  "out_contract_code": "100001256",
  "plan_id": 123,
  "success_notify_url": "https://yoursite.com",
  "user_display_name": "張三"
}


{
  "expired_time": "2021-11-20T13:29:35+08:00",
  "out_contract_code": "100001256",
  "plan_id": 123,
  "sp_appid": "wxcbda96de0b165486",
  "sub_appid": "wxcbda96de0b165484",
  "sub_mchid": "10000097",
  "success_notify_url": "https://yoursite.com",
  "user_display_name": "張三"
}

返回參數

參數名	變量	類型[長度限制]	必填	描述
簽約跳轉URL	sign_url	string[1, 512]	是	有效期為10分鐘，跳轉簽約頁面URL，用戶通過跳轉訪問此URL即可進入微信簽約頁面，進行簽約。簽約完成后，按照 return_appid 的描述跳轉回對應的應用示例值：https://api.mch.weixin.qq.com/global/papay/contracts/login?os_session_id=2021120910391616228#wechat_redirect

返回示例

正常示例


{
  "sign_url": "https://api.mch.weixin.qq.com/global/papay/contracts/login?os_session_id=2021120910391616228#wechat_redirect"
}


http://2323weixin.qq.com

錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
403	CONTRACT_NOT_EXIST	Result Empty	查詢的簽約協議不存在，或者傳入正確查詢參數重試
403	CONTRACT_EXISTED	已開通自動扣費服務功能，無需重復開通	已開通自動扣費服務功能，無需重復開通；如需重新簽約，需解約后再發(fā)起簽約
400	PARAM_ERROR	參數錯誤	傳入正確查詢參數
500	SYSTEM_ERROR	系統(tǒng)錯誤	請稍等重試

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

委托代扣API

WEB預簽約API

接口說明

時序圖

請求參數

請求示例

返回參數

返回示例

錯誤碼

版本說明