接入准备
更新时间:2023.12.21在正式接入委托代扣服务前,您需要进行以下准备步骤:
步骤一:确认资质&确定商户模式
步骤二:申请委托代扣模板
步骤三:申请签约相关权限
# 步骤一:确认资质&确定商户模式
- 若商户号当前无委托代扣权限,需联系对接的运营同学协助评估,评估完成后可按运营同学的指引进行委托代扣权限的申请。
- 商户需判断商户号的接入模式 (opens new window),当前预约扣费仅支持普通直连模式、普通服务商模式。
# 步骤二:申请委托代扣模板
- 在开始接口开发前,需要先申请委托代扣模板,委托代扣模板管理需要在商户平台 (opens new window)后台的高级业务栏目下开通操作入口。请联系对接您的运营同学协助申请,如图所示:
- 新增模板时,模板类型需选择预约扣费;每个模板对应一个商品,模板的标准价格为该模板对应商品可进行预约扣费的金额。
- 模板需要审核通过后才可用于预约扣费的接口开发,解约地址可以在商户后台进行修改。
# 步骤三:申请签约相关权限
# App
纯签约 OpenBusinessWebview权限申请
- 若是
App
拉起签约页,该接口需要额外申请OpenBusinessWebview权限,请联系对接您的运营同学协助申请,如未申请而请求接口,会遇到如以下图报错。
- 申请权限邮件模板如下:
- 标题:OpenBusinessWebview权限申请_
App
纯签约 - 正文:
- 说明使用背景
appid
、mchid
(appid
和mchid
需要有绑定关系)
- 标题:OpenBusinessWebview权限申请_
# H5纯签约 签约发起域名权限申请
- 若是H5拉起签约页,该接口需要额外申请签约发起域名权限,签约发起的域名商户可以通过HTTP请求头header里的referer信息获取,请联系对接您的运营同学协助申请(可以申请多个域名,不区分生产和测试)。如未申请而请求接口,会遇到如以下图报错。
- 申请权限邮件模板如下:
- 标题:委托代扣H5纯签约配置-xxx公司
- 正文:
- 说明使用背景
- 商户号、商户主体、模板ID、签约发起域名
- 注:配置的签约域名需要完整,例如A商户发起签约的页面是:
https://weixin.qq.com/wx/contract
,则需要配置的域名为weixin.qq.com
;例如B商户发起签约的页面是:https://qq.com/wx/contract
,则需要配置的域名为qq.com
。
# H5纯签约 签约页面结束后返回App权限申请
该接口可以额外申请签约页面结束后返回App的权限,申请后可通过H5场景预签约接口指定jump_control.jump_appid
参数,控制跳转的路径。如果不指定且签约发起时的来源UA可被微信识别,则跳转到UA对应的App应用,否则留在微信。请联系对接你的运营同学协助申请。
以下两种情况需要申请此权限,否则会导致流程异常:
情况一:商户App内嵌H5时发起H5纯签约时,若商户不传jump_control.jump_appid
,用户点击签约完成后,若来源UA无法被微信识别,会停留在微信页面。
情况二:商户浏览器发起H5纯签约时,若商户在没有申请返回App权限的情况下传了jump_control.jump_appid
,将会报错。
申请规则与跳转规则描述:
1,商户App内嵌H5时,目前支持微信无法识别UA来源的App或发起App跟跳转App不一致的场景申请,商户可以申请多个跳转App,在预签约时指定对应的App对应的AppID即可跳转。
2,商户申请权限时填写URL-Scheme支持两种格式:
a.格式一:xxx://;例如:weixin://;微信会拼接referer,实际跳转链接是xxx://+referer;
b.格式二:xxx://xxx;例如weixin://pay.weixin.qq.com/page;微信不会拼接referer,实际跳转链接是商户配置的完整URL-Scheme地址weixin://pay.weixin.qq.com/page
申请邮件模板如下:
配置类型 | 商户号 | 商户名称 | URL-Schema | UA关键词 | App对应的AppID |
---|---|---|---|---|---|
H5纯签约后返回App | 1245XXX | XX公司 | weixin://XXX | XXX | wx1245XXX |
(注意:URL-Schema的格式为:xxx://)
文档是否有帮助