订阅型商品用订阅组来管理维护,所以在创建订阅型商品前,需要先创建订阅组,并在创建订阅型商品时指定商品所在的订阅组。订阅组用于承载同类型商品的管理,一个订阅组可以包含多个订阅型商品,且同一个订阅组只有一个商品是处于生效状态。当商品处于生效状态时,您需要为用户提供该商品对应的服务。这样的机制为您提供了便捷方式,让商品服务大致相同但有细微差别的需求得以快速实现。
示例:
您若想提供视频会员的订阅型业务,则需要创建一个订阅组,专门用于承载视频会员类商品。同时,如果您希望提供不同的续费周期供用户选择,那么您可以在刚创建的订阅组里,添加不同续费周期的商品,比如:月度续费商品、半年续费商品、年度续费商品等。当前续费周期可选值有1周、30天、31天、1个月、2个月、3个月、6个月和12个月,您可在配置订阅型商品时按需选择。为了让您的订阅型商品更有吸引力,订阅型商品提供了两种促销手段:
促销限制:
具体配置方法请参见配置商品信息。
通常情况下,一个完整的订阅需具备以下几个阶段。
对于用户而言,订阅有如下几个状态:

订阅续期处理
订阅的下一个续期价格(包括原价、涨价和降价)是在续期前10天确定,该时间比1周的订阅周期长。因此对于订阅周期为1周的订阅型商品,价格变化后在下一次续期时仍然按照原价格进行,此后的价格将在10天前确认。
在订阅周期结束前24小时,华为IAP会尝试向用户发起扣款以完成订阅型商品的续期。若扣费失败,华为IAP会在一定期限内重新尝试扣费,从而恢复订阅。
因为扣费失败而进入失效期内的订阅,每天会重试一次扣费,在超过重试时间窗后将结束重试,其中重试时间窗基于配置指定。
用户可以在HMS Core(APK)的订阅管理页面里,对订阅进行如下操作。
目前的订阅型商品并没有等级的概念,后续将会实现订阅等级的概念。在加入等级后,对于切换订阅场景,切换机制会优先判断新订阅的商品和原商品的等级关系,如果等级相同,则切换效果的触发场景不变。如果从低等级切换到高等级的升级切换订阅,效果为立即生效。如果是从高等级切换到低等级的降级切换订阅,效果为下周期生效。
调整订阅型商品价格
您可以为每个订阅型商品降低或提高价格。
处理订阅型商品下架
在处理订阅型商品的下架时,需要考虑对用户的影响。
在您停止提供订阅服务前,您应该通过下架该商品来防止新用户订阅。建议您将订阅型商品的下架时间与其续费周期相对应。例如,在订阅型商品续费周期为1个月的情况下,您应该提前1个月将您的订阅下架,这可以在停止提供订阅的商品服务之前让用户体验到完整时限的商品服务,并且将不会在下一个订阅续期日期被收取费用。以此类推,对于续费周期为1周的订阅需要提前7天,对于续费周期为6个月的订阅需要提前6个月。当您将某个订阅型商品下架时,您的用户将收到有关订阅终止通知。
您的应用可以通过startIapActivity接口跳转到HMS Core(APK)的管理订阅页面和编辑订阅页面。管理订阅页面展示的是当前用户在您的应用内已订阅的商品列表,编辑订阅页展示的是用户已在您的应用订阅的某个商品详情及该商品所在订阅组的其他商品的信息。

使用方式如下:
“Java”
// 创建一个StartIapActivityReq对象
StartIapActivityReq req = new StartIapActivityReq();
req.setType(StartIapActivityReq.TYPE_SUBSCRIBE_MANAGER_ACTIVITY);
// 获取调用接口的Activity对象
final Activity activity = getActivity();
IapClient mClient = Iap.getIapClient(activity);
Task<StartIapActivityResult> task = mClient.startIapActivity(req);
task.addOnSuccessListener(new OnSuccessListener<StartIapActivityResult>() {
@Override
public void onSuccess(StartIapActivityResult result) {
Log.i("startIapActivity", "onSuccess");
// 请求成功,需拉起IAP返回的页面
if (result != null) {
result.startActivity(activity);
}
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.e("startIapActivity", "onFailure");
}
}); “Kotlin”
// 创建一个StartIapActivityReq对象
val req = StartIapActivityReq()
req.setType(StartIapActivityReq.TYPE_SUBSCRIBE_MANAGER_ACTIVITY)
// 获取调用接口的Activity对象
val activity: Activity = getActivity()
val mClient = Iap.getIapClient(activity)
val task = mClient.startIapActivity(req)
task.addOnSuccessListener { result ->
Log.i("startIapActivity", "onSuccess")
// 请求成功,需拉起IAP返回的页面
result?.startActivity(activity)
}.addOnFailureListener { Log.e("startIapActivity", "onFailure") } “Java”
// 创建一个StartIapActivityReq对象
StartIapActivityReq req = new StartIapActivityReq();
req.setSubscribeProductId("XXX");
req.setType(StartIapActivityReq.TYPE_SUBSCRIBE_EDIT_ACTIVITY);
// 获取调用接口的Activity对象
final Activity activity = getActivity();
IapClient mClient = Iap.getIapClient(activity);
Task<StartIapActivityResult> task = mClient.startIapActivity(req);
task.addOnSuccessListener(new OnSuccessListener<StartIapActivityResult>() {
@Override
public void onSuccess(StartIapActivityResult result) {
Log.i("startIapActivity", "onSuccess");
// 请求成功,需拉起IAP返回的页面
if (result != null) {
result.startActivity(activity);
}
}
}).addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.e("startIapActivity", "onFailure");
}
}); “Kotlin”
// 创建一个StartIapActivityReq对象
val req = StartIapActivityReq()
req.setSubscribeProductId("XXX")
req.setType(StartIapActivityReq.TYPE_SUBSCRIBE_EDIT_ACTIVITY)
// 获取调用接口的Activity对象
val activity: Activity = getActivity()
val mClient = Iap.getIapClient(activity)
val task = mClient.startIapActivity(req)
task.addOnSuccessListener { result ->
Log.i("startIapActivity", "onSuccess")
// 请求成功,需拉起IAP返回的页面
result?.startActivity(activity)
}.addOnFailureListener { Log.e("startIapActivity", "onFailure") } 您可以将对应的华为帐号添加到AppGallery Connect的测试帐号里,以实现用该帐号购买时进入沙盒环境的订阅测试。沙盒测试允许您在接入华为应用内支付联调过程中无需真实支付即可完成端到端的测试,帮助您快速测试应用的订阅场景,具体请参见测试订阅型商品续订。
如果您在AppGallery Connect申请支付服务时提前配置了订阅通知地址,用户购买订阅型商品后,华为应用内支付服务器会在订阅场景的某些关键事件发生时调用此接口通知您配置的服务器。 主要涉及的场景如下:
若开发者服务器返回结果为非成功响应(返回的http status code值为200之外的值),将对本次关键事件的通知进行周期性重发。建议在您的服务端收到通知后立即返回成功响应,避免通知消息堆积。