目录

订阅专有功能说明

配置订阅商品

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

举个例子:

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

促销限制:

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

提供商品对应的服务

在应用提供服务前,始终应该先判断用户已购的订阅型商品的状态,以决定是否应该提供对应的服务。

可通过下面的方式获取购买详情inAppPurchaseData。

本质上,所有的订阅型商品都可以通过这种方式去判断是否应该提供服务。

订阅状态及续期处理

[h2]订阅状态

一般来讲,一个完整的订阅需具备以下几个阶段:

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

[h2]订阅续期处理

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

在订阅周期前24小时,IAP会尝试向用户发起扣款以完成订阅商品续期。若扣费失败,IAP会在一定期限内重复尝试扣费,若失败次数过多,最终会停止重试。

24小时内重试5次,之后如果失败则进入失效期,失效期每天尝试一次,之后结束尝试。

用户变更订阅关系

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

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

修改订阅商品

[h2]调整订阅商品价格

开发者可以为每个订阅商品降低或提高价格。

其他的限制还包括:

[h2]处理订阅商品下架

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

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

提供订阅管理的页面跳转

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

pay.startIapActivity({
   startIapActivityReq: {
     "applicationID": "101315751",
     "type": 2,
     "subscribeProductId":"dy1"
   },
   success: function () {
     prompt.showToast({
       message: "startIapActivity success!"
     })
   },
   fail: function (data, code) {
     console.log("startIapActivity fail data =" + JSON.stringify(data), "code =" + code);
     prompt.showToast({
       message: "createPurchaseIntent fail!"
     })
   }
})

沙盒环境的订阅测试

开发者可以将对应的华为账号添加到HarmonyOS 开发者中心的测试账号里,以实现用该账号购买时进入沙盒环境的订阅测试。

为了帮助开发者快速测试应用的订阅场景,沙盒环境下的订阅续订时间会比正常情况更快。下面是具体的时间转换表:

实际时限

测试时限

1周

3分钟

1个月

5分钟

2个月

10分钟

3个月

15分钟

6个月

30分钟

1年

1小时

在测试过程中,请注意以下几点:

建议沙盒场景下订阅续期处理和正式环境下订阅区分开,减少测试订单数据对正式订单数据的干扰。

接受订阅关键事件的通知

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

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