目录

订阅专用功能说明

配置订阅型商品

订阅型商品用订阅组来管理维护,所以在创建订阅型商品前,需要先创建订阅组,并在创建订阅型商品时指定商品所在的订阅组。订阅组用于承载同类型商品的管理,一个订阅组可以包含多个订阅型商品,且同一个订阅组只有一个商品是处于生效状态。当商品处于生效状态时,您需要为用户提供该商品对应的服务。这样的机制为您提供了便捷方式,让商品服务大致相同但有细微差别的需求得以快速实现。

示例:

您若想提供视频会员的订阅型业务,则需要创建一个订阅组,专门用于承载视频会员类商品。同时,如果您希望提供不同的续费周期供用户选择,那么您可以在刚创建的订阅组里,添加不同续费周期的商品,比如:月度续费商品、半年续费商品、年度续费商品等。当前续费周期可选值有1周、30天、31天、1个月、2个月、3个月、6个月和12个月,您可在配置订阅型商品时按需选择。为了让您的订阅型商品更有吸引力,订阅型商品提供了两种促销手段:

促销限制:

  1. 用户对每个订阅组至多享受一次促销。如果一个订阅组里的多个商品均配置了促销活动,在用户尝试切换该订阅组的其他商品时,用户只能享受在该订阅组第一次遇到的促销。当切换订阅时在该订阅组再次遇到促销,将不再享有促销资格。
  2. 促销价享受的触发方式是新订阅、恢复订阅、切换订阅三种情况。促销的享受资格不受订阅方式影响,无论是新发起的订阅,恢复订阅,还是切换订阅等,均遵从“用户对每个订阅组至多享受一次促销”的原则,只要没有享受过该订阅组的促销,就可以享受促销。

具体配置方法请参见配置商品信息。

订阅状态及续期处理

通常情况下,一个完整的订阅需具备以下几个阶段。

对于用户而言,订阅有如下几个状态:

订阅续期处理

订阅的下一个续期价格(包括原价、涨价和降价)是在续期前10天确定,该时间比1周的订阅周期长。因此对于订阅周期为1周的订阅型商品,价格变化后在下一次续期时仍然按照原价格进行,此后的价格将在10天前确认。

在订阅周期结束前24小时,华为IAP会尝试向用户发起扣款以完成订阅型商品的续期。若扣费失败,华为IAP会在一定期限内重新尝试扣费,从而恢复订阅。

因为扣费失败而进入失效期内的订阅,每天会重试一次扣费,在超过重试时间窗后将结束重试,其中重试时间窗基于配置指定。

用户变更订阅关系

用户可以在HMS Core(APK)的订阅管理页面里,对订阅进行如下操作。

目前的订阅型商品并没有等级的概念,后续将会实现订阅等级的概念。在加入等级后,对于切换订阅场景,切换机制会优先判断新订阅的商品和原商品的等级关系,如果等级相同,则切换效果的触发场景不变。如果从低等级切换到高等级的升级切换订阅,效果为立即生效。如果是从高等级切换到低等级的降级切换订阅,效果为下周期生效。

修改订阅型商品

调整订阅型商品价格

您可以为每个订阅型商品降低或提高价格。

处理订阅型商品下架

在处理订阅型商品的下架时,需要考虑对用户的影响。

在您停止提供订阅服务前,您应该通过下架该商品来防止新用户订阅。建议您将订阅型商品的下架时间与其续费周期相对应。例如,在订阅型商品续费周期为1个月的情况下,您应该提前1个月将您的订阅下架,这可以在停止提供订阅的商品服务之前让用户体验到完整时限的商品服务,并且将不会在下一个订阅续期日期被收取费用。以此类推,对于续费周期为1周的订阅需要提前7天,对于续费周期为6个月的订阅需要提前6个月。当您将某个订阅型商品下架时,您的用户将收到有关订阅终止通知。

提供订阅管理的页面跳转

您的应用可以通过startIapActivity接口跳转到HMS Core(APK)的管理订阅页面和编辑订阅页面。管理订阅页面展示的是当前用户在您的应用内已订阅的商品列表,编辑订阅页展示的是用户已在您的应用订阅的某个商品详情及该商品所在订阅组的其他商品的信息。

使用方式如下:

沙盒环境的订阅测试

您可以将对应的华为帐号添加到AppGallery Connect的测试帐号里,以实现用该帐号购买时进入沙盒环境的订阅测试。沙盒测试允许您在接入华为应用内支付联调过程中无需真实支付即可完成端到端的测试,帮助您快速测试应用的订阅场景,具体请参见测试订阅型商品续订。

接收订阅关键事件的通知

如果您在AppGallery Connect申请支付服务时提前配置了订阅通知地址,用户购买订阅型商品后,华为应用内支付服务器会在订阅场景的某些关键事件发生时调用此接口通知您配置的服务器。 主要涉及的场景如下:

若开发者服务器返回结果为非成功响应(返回的http status code值为200之外的值),将对本次关键事件的通知进行周期性重发。建议在您的服务端收到通知后立即返回成功响应,避免通知消息堆积。

多角色应用接入订阅专项说明

用户购买订阅型商品时使用的帐号是华为帐号,一个华为帐号在同一订阅商品上只能同时存在一笔订阅。如果您的应用存在多角色,可能会存在权益发放错乱的现象。针对这个场景建议的处理方案如下:
  1. 当用户为角色A购买订阅型商品后,该用户的其他角色只允许购买普通包周期商品服务(您可以通过华为消耗型商品自行实现)。
  2. 当用户为角色A购买订阅型商品后,再为角色B购买订阅型商品时,您可以自行设计将角色A的剩余权益转移给角色B。
  3. 建议您配置多个订阅型商品。如游戏不同区服对应不同角色,每个区服创建独立的订阅商品。