应用联运订阅接入注意点更新时间: 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:可以。权益和订阅均跟随账号。