接入流程

更新时间:2024.11.14

申请委托代扣模板

在开始接口开发前,需要先申请模板ID,委托代扣模板管理需要在商户后台的高级业务栏目下开通操作入口,请联系对接您的运营同学协助申请,如图所示:

 

业务类型说明:

1、免密支付:可以实现对存在签约协议的用户进行小额立即扣款的功能,扣费时间无延迟,无扣费前通知,商户只需调用【申请扣款】接口发起扣款即可

2、自动续费:扣费时间有延迟,需有扣费前通知,具体参看【 周期扣费】说明文档,目前支持通知后【24小时自动扣费】或【预扣费通知】两种模式,商户只能选择申请其中一种模式实现扣费,一般申请后为【24小时自动扣费】模式,如需使用另种模式,请联系对接您的运营同学协助申请修改模式

3、授权扣款:可以实现对存在签约协议的用户进行大额立即扣款的功能,扣费时间无延迟,无扣费前通知,商户只需调用【申请扣款】接口发起扣款即可

 

 

:模板ID需要审核通过后才可用于委托扣款的接口开发,解约地址商户可以随时在商户后台进行修改

模板名称说明:

此项配置的模板名称字段会展示在消息模板中的签约成功通知里的签约项目里,如下图

 

APP纯签约 OpenBusinessWebview权限申请

一、该接口需要额外申请OpenBusinessWebview权限,请联系对接您的运营同学协助申请,如未申请而请求接口,会遇到如以下图报错。

     邮件模板如下:

     标题:OpenBusinessWebview权限申请_APP纯签约

     正文:

      (1)说明使用背景

      (2)appid、mchid(appid和mchid需要有绑定关系)

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

一、该接口需要额外申请签约发起域名权限,签约发起的域名商户可以通过http请求头header里的referer信息获取,请联系对接您的运营同学协助申请(可以申请多个域名,不区分生产和测试),如未申请而请求接口,会遇到如以下图报错

标题:委托代扣H5纯签约配置-xxx公司

正文:商户号、商户主体、模板ID、签约发起域名
(注意:配置的签约域名是否完整,例如1商户发起签约的页面是:“https://weixin.qq.com/wx/contract”,则需要配置的域名为“weixin.qq.com”;例如2商户发起签约的页面是:“https://qq.com/wx/contract”,则需要配置的域名为“qq.com”)

H5纯签约 签约页面结束后返回app权限申请

一、该接口可以额外申请签约页面结束后返回app的权限,接口需传入如下图参数,否则配置返回app权限后以下跳转规则不生效,请联系对接你的运营同学协助申请

 

以下两种情况需要申请此权限,否者会遇到如下图报错:

情况一:商户app内嵌h5时发起h5纯签约时,商户不传return_appid,签约点击完成后,微信会跳转回referer(是我们中间页拿到的referer),由于无法识别商户的app,需商户手动配置Schema url,微信进行跳转,否者会遇到如下图报错

情况二:商户浏览器发起h5纯签约时,商户传了return_appid,由于商户没申请返回app权限,会遇到如下图报错

 

配置情况与跳转规则描述:

1,商户app内嵌h5时,目前支持发起签约的app以外的其他app申请,商户可以申请多个appid,在不同app内签约时传对应的appid可以返回对应的app

2,商户配置权限时填写URL Scheme支持两种格式:
a.格式一:xxx://;例如:weixin://;微信会拼接referer,实际跳转链接是xxx://+referer;
b.格式二:xxx://xxx;例如weixin://pay.weixin.qq.com/api/page;微信不会拼接referer,实际跳转链接是商户配置的完整URL Scheme地址weixin://pay.weixin.qq.com/api/page

 

邮件模板如下:

配置类型

商户号

商户名称

URL Schema

UA关键词

APP的appid

H5纯签约后返回APP

1245XXX

XX公司

weixin://XXX

XXX

wx1245XXX

(注意:schema的格式为:xxx://)

相关参数:

 

回调应用appid

return_appid

string[1,32]

用来控制签约页面结束后的返回路径。
当指定该字段时,且商户模板标注商户具有指定返回app的权限时,签约成功将返回return_appid指定的app应用,如果不填且签约发起时的浏览器UA可被微信识别,则跳转到浏览器,否则留在微信
示例值:wxcbda96de0b165486

 

申请委托代扣模板的多账号签约能力

一、签约遵循同一个商户号+同一个模板ID+同一个微信号只能签约一次的原则,如需多次签约,则需特殊申请多账号签约权限,此权限有行业等要求,请联系对接您的运营同学协助申请,如未申请而多次签约,会遇到如以下图报错

注意:

商户要实现多账号签约能力还需要在签约请求接口传入多账号签约参数,具体文档请联系对接您的运营同学申请

邮件模板如下:

主题:【委托代扣】业务申请多账号签约能力-公司名称

正文:

Dear :

烦请协助配置【多账号签约能力】,附件为交互图,谢谢~

业务背景:xxx即将上架自动续费的保险产品,计划通过微信授权委托代扣来实现。 但因同一保险产品,可以由同一投保人,可为多个被保人投保,比如:为配偶、子女、父母等直系亲属投保。保单之间是相互独立的,用户可对其中一张保单进行退保,停止单个保单的代扣计划,而不影响其他保单的代扣计划。

使用当前能力的必要性:因现有的微信委托代扣功能,一个模板id只能签约一次,协议号唯一, 因此如果用户用同一协议号购买多张保单,想退其中一张保单,是实现不了的,只能全部退掉, 因此需申请多账户签约能力。

多账号签约交互:见附件

商户号:

模板ID:

用户账号展示规则:带掩码被保人姓名(订单号)

业务预计上线时间:

 

多账号签约交互:

模板ID 委托代扣申请关闭信用卡权限申请

一、为防止洗钱,商户可以申请不能用信用卡支付,请联系对接您的运营同学协助申请

Dear,

烦请协助 委托代扣关闭信用卡 谢谢~

【委托代扣模板ID】

【商户号】

关闭原因:监管要求,客户只能用储蓄卡支付保费,不能用信用卡支付,防止洗钱行为