接入准备

更新时间:2023.12.21

在正式接入委托代扣服务前,您需要进行以下准备步骤:

步骤一:确认资质&确定商户模式

步骤二:申请委托代扣模板

步骤三:申请签约相关权限

# 步骤一:确认资质&确定商户模式

  • 若商户号当前无委托代扣权限,需联系对接的运营同学协助评估,评估完成后可按运营同学的指引进行委托代扣权限的申请。
  • 商户需判断商户号的接入模式 (opens new window),当前预约扣费仅支持普通直连模式、普通服务商模式。

# 步骤二:申请委托代扣模板

  • 在开始接口开发前,需要先申请委托代扣模板,委托代扣模板管理需要在商户平台 (opens new window)后台的高级业务栏目下开通操作入口。请联系对接您的运营同学协助申请,如图所示:
Alt text
  • 新增模板时,模板类型需选择预约扣费;每个模板对应一个商品,模板的标准价格为该模板对应商品可进行预约扣费的金额。
  • 模板需要审核通过后才可用于预约扣费的接口开发,解约地址可以在商户后台进行修改。

# 步骤三:申请签约相关权限

# App纯签约 OpenBusinessWebview权限申请

  • 若是App拉起签约页,该接口需要额外申请OpenBusinessWebview权限,请联系对接您的运营同学协助申请,如未申请而请求接口,会遇到如以下图报错。
示例图2
  • 申请权限邮件模板如下:
    • 标题:OpenBusinessWebview权限申请_App纯签约
    • 正文:
      1. 说明使用背景
      2. appidmchidappidmchid需要有绑定关系)

# H5纯签约 签约发起域名权限申请

  • 若是H5拉起签约页,该接口需要额外申请签约发起域名权限,签约发起的域名商户可以通过HTTP请求头header里的referer信息获取,请联系对接您的运营同学协助申请(可以申请多个域名,不区分生产和测试)。如未申请而请求接口,会遇到如以下图报错。
示例图3
  • 申请权限邮件模板如下:
    • 标题:委托代扣H5纯签约配置-xxx公司
    • 正文:
      1. 说明使用背景
      2. 商户号、商户主体、模板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://)