应用联运订阅接入注意点更新时间: 2024-10-18 15:06:00
由于订阅涉及不同支付平台的扣费逻辑,较为复杂,
目前接入过程中遇到的问题较多,特将常见问题&逻辑整理汇总,便于接入。
一、订阅接入流程
二、接入注意点
1、接入前准备
1.1【商品配置】
商品需在开发者后台单独配置,配置流程可见:自动续期订阅配置说明。
【群组和商品】
- 商品分为群组和商品两个等级,一个群组内包含多个商品,一个群组只能订阅一款商品。
- 订阅是以商品为单位扣费,同个商品如果仍在订阅周期内,不支持二次购买,将会报错-连续订阅支付失败,
- 用户在购买了某个群组内的其中一个商品后,若想再买其他商品,需再次进行密码支付,支付成功后,原来的商品默认关闭订阅,新的商品以购买日来重新计算购买日期;新商品的权益从旧商品权益到期的下一秒开始计算。
- e.g 红钻、绿钻分别代表一个群组,红钻月度、红钻年度分别代表两个商品,先建群组再建群组下的商品。用户购买红钻月度,支付成功开启订阅,订阅周期内,无法第二次购买;用户购买红钻月度后,又购买了红钻年度,支付成功后,红钻月度将不再被订阅,月度权益到期后,开始计算红钻年度的权益周期。
【促销活动】
- 自动续费订阅商品可以提供限定时间内的促销手段:折扣价格。
- 折扣价格只对新订阅用户生效,且折扣周期跟随开发者站后台配置周期,
- 当用户购买订阅商品时,他们会看到折扣价格和标准订阅价格,标准订阅价格是用户在折扣时限结束之后自动付费时收取的价格。
1.2【支付方式】
- 订阅分为仅支付宝订阅、微信和支付宝订阅。
- 根据开发者站选择的支付方式,收银台展示对应支付方式,
- 微信订阅需单独申请模板id。
1.3【模板id申请】
- 接入时注意微信订阅需要单独申请微信模板id,详细可见:微信订阅申请流程。
- 支付宝无需单独申请。
2、接入中
2.1 【订阅】
- 微信和支付宝的订阅规则不同。
- 目前微信不支持包天订阅,最小测试周期为包周订阅。
- 订阅成功小米侧将给用户发送短信。
- 发送时机:第一次扣费、自动续费完成、扣费失败。
2.2 【扣款】
- 发起扣款时间
- 每天上午10:00发起扣款,
- 根据第一次或上一次扣款时间,由小米支付服务端控制,主动发起下一次扣费,
- eg.第一次购买时间为1号则按照后续每个月底最后一天扣费,其余都是A-1。31号购买的话其余月都有30,2月就是最后一天,28或者29,时间截止为购买时间的下个扣费周期的同日上一秒时间,数据库拆分收入算前不算后,
- 比如1月31号 16:57:30首次购买,那结束时间就是2月29号 16:57:29。
- 不同支付方式扣款时间不同
- 微信支付提前2天发起扣款,发起扣款后24小时扣款,
- 支付宝提前1天发起扣款,发起后立即扣款。
- 扣款结果通知
- 若直接扣款成功,返回结果:
- 若第一次扣款不成功时,以下为扣款失败情况及处理方式:
- 未知异常+系统繁忙,当日可重试调用,最多重试3次;若当日(当天23:59之前)内重试3次依旧失败,通知当天扣款失败;用户扣款则进入宽限期,在宽限期内每天主动调用扣款,扣款逻辑同上,
- 宽限期内依旧扣款失败,则不再尝试,返回扣款失败,关闭订阅功能(以第一次服务端调用扣款为准记录宽限期时间,是指宽限期之前的第一次扣款时间),若只是宽限期内扣款失败,推送至用户,提示用户扣款失败,让用户去处理,用户若在宽限期内都扣款失败的话,则默认该用户关闭订阅功能,在宽限期之后的30天内用户不再重新续费,则向支付方式申请关闭该商品的免密支付权限。
- 自动续费扣费前短信提醒注意事项
- 根据国家市场监管局发布的《网络交易监督管理办法》第十八条规定,为用户提供自动续费能力,必须在扣费前5日以显著的方式提醒消费者。因此,请开发者接入订阅服务能力的同时,务必做到以短信或站内消息的形式在扣款前5天和扣款前1天分别通知用户。如因开发者自身原因在扣费前未通知用户,引起的所有法律风险均由开发者自行承担。
- 通知周期及内容建议如下:
短信发送内容 |
【XXXXXX会员】您的XXX服务将于5日后到期,我们会在到期前一日尝试扣款XX元为您自动续费并延长您的会员有效期。您可以在支付宝或微信APP“我的”页面“支付设置”-“续费管理”内进行管理。 |
【XXXXXX会员】您的XXX服务将于2日后到期,我们会在今日尝试扣款XX元为您自动续费并延长您的会员有效期,您可以在支付宝或微信APP“我的”页面“支付设置”-“续费管理”内进行管理。 |
2.3 【解约】
- 用户在客户端申请时,由开发者发起,关闭订单后,向支付宝和微信通知关闭免密支付。
- 用户从支付宝、微信发起关闭订阅,同意关闭后,通知开发者。
- 联运合作终止时,小米侧将无法继续支持自动扣费;请务必与小米商务沟通,与小米侧申请订阅解约,届时将由小米侧发起解约。
三、测试注意点
- 测试周期
请放宽到一周及以上,微信订阅最小测试周期为一周。
- 测试账号
订阅测试时,请勿使用同一账号重复订阅同一商品或同一群组商品,逻辑见商品配置处。
四、常见Q&A
Q:为什么订阅的时候,用微信支付没有签约成功?
A:微信模板ID使用失败;先检查有没有申请,若有申请,请与小米产品联系,看审核是否被驳回;若有驳回,小米将为你重新发起申请。
Q:为什么签约成功,一直没有扣款?
A:没到扣款时间;原因是购买了统一群组的订阅商品,将在原有订阅商品权益到期时,发起新的扣费,请在支付方式(微信/支付宝)中查看自己的签约状态。
Q:不想接微信订阅怎么办?
A:方式一,与小米侧申请,接入旧SDK;方式二,与小米侧申请,由服务端过滤微信订阅请求(该方式耗时长且需单独测试,请尽量优先第一种)。
Q:换设备,同一个账号的权益能使用吗?
A:可以。权益和订阅均跟随账号。