连续包月-周期扣款-自动续费业务整理总结

开篇

连续包月-周期扣款-自动续费名字很多, 先简单解释这三个的意思:

• 支付宝官方定义的名称为-周期扣款
• 连续包月是这个模式常用的行为(也可以包天, 包季度),
• 自动续费是在用户的眼里行为, 可以不用手动付款

扣款场景

周期扣款有两种模式:

• 先签约后代扣场景
  • 先跳转到签约页面
  • 用户同意签约
  • 支付宝签约异步回调 && 同步发起扣款
• 支付后签约场景
  • 跳转到支付页面(用户可以手动关闭自动续费)
  • 用户支付
  • 收到两个异步通知, 支付通知 + 签约通知
• 支付后签约场景的模式虽然简单, 但是用户可以手动关闭续费, 所以很多时候我们选择先签约后代扣场景

申请信息

• 了解清楚基本逻辑之后, 就是要申请功能, 支付宝的可以参考此链接https://opendocs.alipay.com/open/20190319114403226822/intro
• 需要注意的是微信周期扣款申请比较复杂, 还需要申请一个额外的模板ID,

签约页面唤起逻辑

• 服务端根据SDK生成签名串(值的注意的https://github.com/go-pay/gopay 这个包没有实现这个功能 我提交了新功能并于2023-01-01合并https://github.com/go-pay/gopay/pull/295)
  • 这个SDK虽然包含了client.UserAgreementPageSign()方法, 但是这个方法实际上会请求支付宝返回一个H5页面唤醒签约页面(但是这个只能给前端使用)
  • 如果是APP签约,我们不能请求支付宝, 必须本地签名 (这里很坑, 支付宝API文档没写,需要在接入指南查看)
  • 官方提供SDK的代码示例如下(如果是PHP,Java,Node可以直接用官方SDK)

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayUserAgreementPageSignRequest request = new AlipayUserAgreementPageSignRequest();
request.setBizContent(参考上面的bizContent值);
//无线端唤起签约
//pageExecute get方式，生成url
AlipayUserAgreementPageSignResponse response = alipayClient.pageExecute(request,"get");

//生成的url地址去除http://openapi.alipay.com/gateway.do
signParams = response.replace("http://openapi.alipay.com/gateway.do?","");

//生成唤起客户端。把signParams使用 UTF-8 字符集整体做一次 encode
return 'alipays://platformapi/startapp?appId=60000157&appClearTop=false&startMultApp=YES&sign_params='+ encode(signParams)

开发

• 由于我使用的是Go, 所以使用这个包 https://github.com/go-pay/gopay
• 值的注意的是, 当前日期2022-12-29由于支付宝V3是还不支持周期扣款的, 所以我们需要用V2
• 首先基于表设计, 这边大致如下(省略部分)

id, no(订单号), tarde_no(商户订单号), user_id(用户), goods_id(商品), contract_code(自定义签约号), contract_id(商户签约号)

订单流程

• 用户下单连续包月产品时候, 创建订单, 订单包含一个随机的contract_code
• 调用生成签约参数时, 把contract_code当做商户签约号参数生成唤醒签约页面链接签名
• 下发订单号no和支付宝唤醒签约页面链接给客户端, 客户端唤醒支付宝签约页面
• 签约成功之后,异步通知回调会把contract_code和contract_id返回给我们(插入签约表)
• 通过contract_code查找到订单, 然后调用支付接口alipay.trade.pay(同步调用),实时获取是否扣费成功
• 客户端返回的时候, 根据订单号no调用服务端, 如果订单未支付, 服务端再去主动扣款一次
• 增加定时任务, 定时查询签约表,找到五天内到期的调用同步支付接口

备注

• 微信连续包月提前两天扣款
  • 比如15号签约, 那么应该13号发起扣款, 14号是微信扣款等待期, 15号微信下发扣款通知(成功还是失败)
• 支付宝连续包月提前五天扣款
  • 比如15号签约, 那么可以10号发起扣款