数字商品服务为接入应用内购买的应用提供了[展示数字商品](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-distribute-query)、[购买数字商品](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-distribute-purchase)、[发放数字商品权益](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-distribute-delivering)的功能。

## 数字商品类型介绍

|  |  |  |
| --- | --- | --- |
| **商品类型** | **描述** | **示例** |
| 消耗型商品 | 只可使用一次的产品，使用之后即失效，需要再次购买的商品。 | 游戏内货币、游戏内道具、应用内点券等。 |
| 非消耗型商品 | 只需购买一次，不会过期或随着使用而减少的商品。 | 游戏中额外的游戏关卡、应用中无时限的高级会员等。 |
| 自动续期订阅商品 | 用户购买后在一段时间内允许访问增值功能或内容，周期结束后自动续期购买下一期的服务。 | 应用中有时限的高级会员，如视频月度会员。 |
| 非续期订阅商品 | 用户在有限时间内允许访问增值功能或内容。此类订阅不会自动续期购买。 | 订阅可观看现场游戏内容，时限为一年。 |

## 数字商品购买场景

在应用购买场景中，用户会以一次性付款方式购买消耗型商品或非消耗型商品。请结合实际业务场景选择对应的商品类型。

订阅是指用户在购买自动续期订阅商品后，可以在一段时间访问应用的增值功能或内容，并且会在订阅周期结束后自动续期购买下一期服务的能力。如果期间用户取消订阅，则订阅在当期结束后将不再自动续期。

|  |  |
| --- | --- |
| **图1** 用户购买消耗型商品或非消耗型商品 | **图2** 用户购买自动续期订阅商品后 |
|  |  |

## 配置自动续期订阅商品

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

当前自动续期订阅商品的续费周期可选值有1周、30天、31天、1个月、2个月、3个月、6个月和12个月，具体配置方法请参见[配置数字商品](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-product-agc)。

## 订阅状态及变更

订阅有如下几个状态：

展开

| 订阅状态 | 说明 |
| --- | --- |
| 续期 | 订阅处于生效状态，即用户可以享受商品对应的服务，其下一次续期也将按期进行扣费以续期。 |
| 到期 | 订阅处于生效状态，用户仍可以享受商品对应的服务，但订阅续期已被用户取消，将不会进行下一次的续期扣费。 |
| 已到期 | 订阅处于失效状态，用户无法享受商品的服务。最近一次的续期扣费没有成功、用户取消订阅、用户不同意涨价或者是扣款账户发生了异常等均可导致订阅进入该状态。  失效的订阅最长有180天的保留期，在保留期内，用户无法享受自动续期订阅商品的服务，但可以在恢复订阅后再次享受应用提供的服务。 |
| 待生效 | 订阅还未开始生效，用户暂时还无法享受该自动续期订阅商品的服务。  当用户在订阅组内进行切换订阅时，如果切换到一个下周期生效的订阅时，则新切换的商品处于待生效状态，需要等原订阅到期后才生效。在用户的切换操作完成后，原订阅会变为到期状态，而新切换的商品为待生效状态，并且会在原自动续期订阅商品的编辑订阅页内显示新切换商品的开始时间。 |

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2d/v3/Kn5TY-zTRYy7qfKhBm3G0w/zh-cn_image_0000002492216497.png?HW-CC-KV=V1&HW-CC-Date=20260414T025123Z&HW-CC-Expire=86400&HW-CC-Sign=F0FD37161FFF41B78769C768A6C03872CC5BE508DFA1413E57FA5F3117033515 "点击放大")

用户在成功购买自动续期订阅商品后，订阅会变为续期状态。当发生如下操作时，订阅的状态会随之改变：

* 取消订阅：对已购自动续期订阅商品进行取消操作。取消成功，则订阅将不会进行下一周期的续费，但不影响当期订阅的使用。
* 恢复订阅：对于处于到期、已到期的订阅，用户可以恢复订阅，以再次享受订阅对应的服务。
* 切换订阅：对已购自动续期订阅商品，进行同一个订阅组不同自动续期订阅商品的切换操作，有如下两种切换效果：
  + 立即生效的切换订阅（原订阅无保留期）：用户原订阅的剩余金额将折算成新订阅的天数，延长新订阅的有效期。 目前这种切换效果的触发场景为：
    - 订阅升级：新订阅的订阅等级高于原订阅。
    - 新订阅与原订阅的订阅等级相同，且原订阅的续费周期和新订阅的续费周期相同。
  + 下周期生效的切换订阅：原订阅设置为到期状态，新订阅为待生效状态，新订阅会在原订阅的失效日期开始扣费并生效。目前这种切换效果的触发场景为：
    - 订阅降级：新订阅的订阅等级低于原订阅。
    - 新订阅与原订阅的订阅等级相同，且原订阅的续费周期和新订阅的续费周期不同。

## 让用户管理订阅

数字商品服务为接入订阅型商品购买能力的应用提供[跳转到订阅页或订阅详情页](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-iap#section39973360502)的能力，让用户管理订阅，包括查看订阅、取消订阅、切换订阅、恢复订阅等。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/80/v3/9wVj-MFUSZSagbQTPYSSdg/zh-cn_image_0000002492136557.png?HW-CC-KV=V1&HW-CC-Date=20260414T025123Z&HW-CC-Expire=86400&HW-CC-Sign=AA527372932B0555BB10A81583EDBBA5002252A26DCE52092F704570EEBE9773 "点击放大") ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9a/v3/bN29k-4kQS6QPikt9_bkWw/zh-cn_image_0000002459017364.png?HW-CC-KV=V1&HW-CC-Date=20260414T025123Z&HW-CC-Expire=86400&HW-CC-Sign=8EE0A5E9C9179FBC76AD4B61A1BAC74E2F38562D065696ECBCFF5B4F0A6473CD "点击放大")

|  |  |
| --- | --- |
|  |  |

## 订阅续期处理

订阅的下一个续期价格（包括原价、涨价和降价）是在续期前10天确定的。对于订阅周期为1周的自动续期订阅商品，在当期续期成功后即开始确认下一次续期的价格，如果在确认价格后调整价格，那么下一次续期时仍然按照原价格进行，再下一期则按新的价格进行续期。

在订阅周期结束前24小时，数字商品服务器会尝试向用户发起扣款以完成自动续期订阅商品的续期。若扣费失败，数字商品服务器会在一定期限内重新尝试扣费，从而恢复订阅。

说明

因扣费失败而失效的订阅，系统将进入为期60天的自动扣费重试。

## 提供优惠

为了提供购买的自动续期订阅商品更有吸引力，自动续期订阅商品提供了两种促销模式。

**推介促销（新用户促销）****：**

* 折扣价格：设置一个低于商品原价的价格，让用户在购买初期以低价享受一段时间的商品服务。
* 免费试用：设置一个免费时间段，让用户在购买初期免费享受一段时间的商品服务。

**推介促销规则****：**

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

**优惠促销（自定义人群促销）**

可以针对用户群体、优惠地域进行自定义选择，支持开发者进行个性化的优惠活动配置。开发者可以在发起购买前，查询该商品的优惠活动信息，在最终发起购买时，将优惠活动信息传递到华为应用内支付，最终将优惠活动信息展示给用户。

**优惠促销规则：**

* 当用户同时符合优惠促销和推介促销时，优惠促销的优先级高于推介促销。
* 当用户历史上享受过优惠促销，仍具备享受推介促销的资格。
* 优惠促销无使用次数限制。

促销具体配置方法请参见[配置数字商品](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-iap-product-agc)。

## 修改自动续期订阅商品

### 调整自动续期订阅商品价格

开发者可以为每个自动续期订阅商品降低或提高价格，具体配置可参见[修改自动续期订阅商品](https://developer.huawei.com/consumer/cn/doc/app/revise-renewal-0000001959074893)。

* 降低价格：对所有用户生效，包括已经订阅的用户和新订阅的用户，在订阅的下一次续费起生效。
* 提高价格：当提高自动续期订阅商品价格时，有两种策略可选。
  + 为已订阅的用户保留原价，对新订阅的用户使用新的价格。
  + 对已订阅的用户生效。数字商品服务器会在下一个续期日提前10天通知已订阅的用户商品价格上涨以及新价格的收费日期。如果在距离下个续期日10天内调整价格， 则下次续期将按照现有价格再续订一个周期，然后在下个周期结束提前10天通知已订阅的用户。其他的限制还包括：
    - 自动续期订阅商品新的价格需要已订阅用户的同意，如果用户不同意，其订阅不会自动续期，直到用户同意涨价。
    - 在价格调整生效后将无法撤销。可以计划新的价格调整从而实现降价，但此前因价格提高而选择停止续订的用户需要重新订阅。
    - 如果用户支付了促销价格的自动续期订阅商品且当前周期为以促销价格购买自动续期订阅商品的周期，则用户下一周期将按照原价进行订阅，再在下一个续费周期按照上述规则执行。

### 处理自动续期订阅商品下架

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

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

## 接收订阅关键事件的通知

如果开发者在[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)申请支付服务时提前配置了通知接收地址，用户购买自动续期订阅商品后，数字商品服务器会在订阅场景的某些关键事件发生时调用此接口通知配置的服务器，具体请参见[服务端关键事件通知](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-key-event-notifications)。主要涉及的场景如下：

* 用户第一次订阅成功。
* 已过期的订阅自动续期成功。
* 用户主动恢复一个已过期的自动续期订阅商品。
* 用户调整自动续期订阅商品降级或跨级且在下个续订生效。
* 用户调整自动续期订阅商品升级/跨级立即生效。
* 用户主动或者App取消一个自动续期订阅商品，已经收费的服务仍然有效，但是后续续期会停止。
* 一个自动续期订阅商品成功续期。
* 一个到期的自动续期订阅商品进入账号保留期。
* 订阅的续期时间已往后调整。
* 订阅的续期时间已往前调整。

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