销售订阅内容

本主题介绍了如何处理订阅生命周期事件，如续订和到期。此外，还介绍了其他订阅功能，如提供促销活动以及允许用户管理他们自己的订阅。

在阅读本主题之前，请确保您已阅读将 Google Play 结算库集成到您的应用中，了解有关如何在您的应用中销售和管理商品的一般说明。

如果您还没有为您的应用配置订阅商品，请参阅创建和配置您的商品。

订阅概览

订阅代表用户在指定时间段内可以享受的一系列权益。例如，订阅可授予用户使用某项音乐在线播放服务的权利。

您可以在同一个应用中提供多项订阅；这些订阅可以分别代表一组不同的权益，也可以代表同一组权益的不同层级（例如，“白银”层级和“黄金”层级）。

您可以通过基础方案和优惠，为同一订阅商品创建多个配置。例如，您可以针对从未订阅过您的应用的用户创建初次体验优惠。同样，您也可以针对已经订阅的用户创建升级优惠。

如需详细了解订阅商品、基础方案和优惠，请参阅 Play 管理中心帮助中心内的相关文档。

处理订阅生命周期

购买的订阅在其整个生命周期内可能经历多种状态变化，您的应用需要响应各种变化。如需检查订阅的状态，您的应用可以使用 Google Play 结算库中的 BillingClient.queryPurchasesAsync() 或 Google Play Developer API 中的 Purchases.subscriptionsv2:get 进行查询。

如果您的应用将订阅状态存储在安全的后端服务器上，您应使用实时开发者通知监听状态变化，以确保状态保持同步。系统会针对影响订阅状态的事件（如续订和取消）发送 SubscriptionNotification。

您的应用需要处理下面几部分中介绍的状态变化。

新订阅

请务必遵循我们在处理新购买交易方面给出的建议。用户购买订阅后，BillingClient.queryPurchasesAsync() 会返回订阅，并且系统会发送类型为 SUBSCRIPTION_PURCHASED 的 SubscriptionNotification。当您收到此通知时，您应查询 Google Play Developer API，以获取最新的订阅状态。订阅资源与以下示例类似：请注意，在您确认购买交易之前，资源的 acknowledgementState 为 ACKNOWLEDGEMENT_STATE_PENDING：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_PENDING", // need to acknowledge new purchases
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

续订

如果续订成功，BillingClient.queryPurchasesAsync() 会继续返回订阅。

当订阅续订时，系统也会发送 SUBSCRIPTION_RENEWED 通知。您的应用应确保用户仍有权使用相应的订阅内容，然后使用从 Google Play Developer API 返回的订阅资源中提供的新 expiryTime 来更新订阅状态。订阅资源与以下内容类似：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ]
}

到期

订阅到期后，BillingClient.queryPurchasesAsync() 不会再返回订阅，并且用户应失去对订阅的访问权限。

当订阅到期时，系统也会发送类型为 SUBSCRIPTION_EXPIRED 的 SubscriptionNotification。当您收到此通知时，应查询 Google Play Developer API，以获取最新的订阅状态。订阅资源与以下内容类似：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_EXPIRED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time_in_past,
      ...
    }
  ],
}

取消

用户可以主动从 Play 商店取消订阅，也可以让订阅自动取消（如果在处于帐号保留状态后没有恢复）。用户取消订阅后，会保有对相关内容的访问权限，直到当前结算周期结束为止。结算周期结束后，访问权限会被撤消。

如果订阅被取消但尚未到期，BillingClient.queryPurchasesAsync() 仍会返回订阅。取消订阅会触发 SUBSCRIPTION_CANCELED 通知。当您收到此通知时，从 Google Play Developer API 返回的订阅资源会把 subscriptionState 设置为“SUBSCRIPTION_STATE_CANCELED”，并且 expiryTime 包含用户失去订阅访问权限的日期。如果 expiryTime 是过去的日期，则用户会立即失去访问权限。否则，用户应保有访问权限，直到订阅到期。订阅资源与以下内容类似：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_CANCELED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time,
      ...
    }
  ],
}

您的应用可以查看从 Google Play Developer API 返回的订阅资源中的 cancelReason，以了解取消订阅的原因（例如，客户取消了订阅或遇到了结算问题）。如果订阅被用户取消，您可以查看 cancelSurveyResult 字段，以了解用户取消订阅的原因。

您的应用可能需要显示一条消息，告知用户其订阅已被取消，如“您的订阅将于 some_date 到期”。此外，您的应用还可以深层链接到 Google Play 商店，让用户能够恢复其订阅。

如果显示此消息，还应让用户能够永久关闭此消息。

另请注意，取消消息可能会令用户反感，尤其是手动取消了订阅而不是因付款过期而导致订阅被取消的用户。您可以选择不通知手动取消了订阅的用户。

撤消

系统可能会出于各种原因撤消用户的订阅，包括您的应用使用 Purchases.subscriptions:revoke 撤消订阅或购买交易被退款。在这种情况下，您的应用应立即撤消用户的访问权限。撤消的订阅不再从 BillingClient.queryPurchasesAsync() 返回。当发生这种情况时，系统也会发送类型为 SUBSCRIPTION_REVOKED 的 SubscriptionNotification。当您收到此通知时，从 Google Play Developer API 返回的订阅资源会把 subscriptionState 设置为 "SUBSCRIPTION_STATE_EXPIRED"，并且 expiryTime 包含用户失去订阅访问权限的日期。订阅资源与以下内容类似：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_EXPIRED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time,
      ...
    }
  ],
}

帐号保留功能

帐号保留是一种订阅状态，当通过用户的付款方式扣款失败且任何关联的宽限期都已结束而没有付款解决方案时，订阅开始进入这种状态。当订阅进入帐号保留状态后，您应阻止用户访问您的内容或服务。帐号保留期最多持续 30 天。

在帐号保留期间，订阅不会由 BillingClient.queryPurchasesAsync() 返回。

在帐号保留期间，您应根据需要处理订阅的任何取消、恢复或重新购买。

用户进入帐号保留状态时，您应利用实时开发者通知来告知用户为何其对订阅的访问权限被暂停。在您的应用内，应显示一条消息，说明如何修正付款方式并重新获得对订阅的访问权限。您的消息应包含指向 Google Play 订阅设置的链接，以便用户可以修正其付款方式。例如，您可以使用类似下面的消息：

"There is a problem with your subscription. Click here to go to the
Google Play subscription settings to fix your payment method."

如果用户可以在您的应用外访问订阅内容，则您可能需要向用户发送推送通知或电子邮件，告知用户其订阅已失效。

如果用户得以解决其付款问题，您可以在应用中显示一条消息，告知用户其订阅已恢复。例如，您可以使用类似下面的消息：

"Your form of payment was updated, and your subscription has
been recovered."

利用实时开发者通知，当订阅进入帐号保留状态时，您会收到类型为 SUBSCRIPTION_ON_HOLD 的 SubscriptionNotification。从安全的后端服务器调用 Google Play Developer API 可检索新的订阅信息。在帐号保留期间，订阅资源的 expiryTime 会设为过去的时间戳：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ON_HOLD",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_past,
      ...
    }
  ],
}

用户修正其付款方式后，订阅会恢复为活动状态，您随后必须恢复用户对订阅内容的访问权限。

如果您的应用仅依赖于 queryPurchasesAsync() 来确定用户是否有权访问订阅，则应自动处理订阅从帐号保留状态的恢复。

如果您的应用与服务器同步订阅状态，您就应监听类型为 SUBSCRIPTION_RECOVERED 的 SubscriptionNotification，以便在订阅已恢复且用户应重新获得访问权限时收到通知。如果您在收到此通知后查询订阅，expiryTime 现在会设为将来的时间戳：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      ...
    }
  ],
}

如果用户在帐号保留期结束之前未修正付款方式，您会收到 SUBSCRIPTION_CANCELED 实时开发者通知。有关处理取消的说明，请参阅订阅取消。当您查询以这种方式取消的订阅时，返回的 expiryTime 会设为过去的时间戳：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_CANCELED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_past,
      ...
    }
  ],
}

帐号保留权限和恢复订阅

以下示例展示了订阅进入帐号保留状态、然后在用户解决付款方式问题后恢复订阅的时间线。

与上一个示例类似，该示例展示了订阅在进入帐号保留状态之前先进入宽限期的时间线。

请注意以下几点：

• 在宽限期内，用户应能继续享受订阅权益。
• 在订阅进入帐号保留状态前，Google 会额外尝试通过付款方式扣款，最多尝试 24 小时。在此期间，用户能继续享受订阅权益。该重试期结束后，订阅会进入帐号保留状态，用户应失去订阅权益。
• 如果用户在宽限期内恢复订阅，续订日期不会重置。
• 如果用户在帐号保留期间恢复订阅，则续订日期会重置。

宽限期

启用宽限期后，如果在结算周期结束时存在付款问题，订阅就会进入宽限期。在此期间，用户应仍有权访问订阅，同时 Google Play 会尝试续订订阅。您可以从 Google Play 管理中心的应用内商品设置中指定宽限期的长度。

如果您的应用仅依赖于 queryPurchasesAsync() 来检查用户是否有权访问订阅，则应自动处理宽限期，因为 queryPurchasesAsync() 会在购买交易的到期日期之前继续返回已取消的购买交易。

如果您的应用与后端同步订阅状态，您就应监听类型为 SUBSCRIPTION_IN_GRACE_PERIOD 的 SubscriptionNotification，以便在用户进入宽限期时收到通知。当用户处于宽限期时，订阅资源包含 autoRenewEnabled = true。

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_IN_GRACE_PERIOD",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_future,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

当用户进入宽限期时，应在您的应用中显示一条消息，告诉用户如何修正付款方式。否则，当宽限期结束时，用户会失去对订阅的访问权限。此消息可以深层链接到 Google Play 商店，以帮助用户管理订阅。

一旦用户修正了付款方式，订阅就会续订，而您的应用可以按照续订中的说明处理续订。

如果用户在宽限期内未修正其付款方式，那么订阅会进入帐号保留状态。

无帐号保留功能时的宽限期权限和恢复订阅

以下示例展示了订阅进入宽限期、然后在用户解决付款方式问题后恢复订阅的时间线。在此示例中，订阅不支持帐号保留功能，因此宽限期结束后，用户应失去订阅权益。

请注意以下几点：

• 在宽限期内，用户应能继续享受订阅权益。
• 如果用户在宽限期内恢复订阅，续订日期不会重置。

已暂停的订阅

您可以通过让用户能够暂停订阅来防止主动取消订阅的用户流失。在您启用暂停功能后，用户可以选择暂停订阅一段时间（介于一周到三个月之间），具体取决于订阅的续订周期。启用暂停选项后，该选项将显示在订阅中心和取消流程中。请注意，按年订阅无法暂停，并且一周和三个月的暂停限制随时可能更改。

为了让用户能够暂停订阅，请执行以下操作：

1. 登录 Google Play 管理中心。
2. 选择您的应用，然后依次转到商店发布 > 应用内商品 > 订阅。
3. 展开订阅设置部分。
4. 选中启用暂停功能。

只有在当前结算周期结束后，订阅暂停才会生效。订阅暂停后，用户将无法访问订阅。在暂停期结束时，订阅将恢复，并且 Google 会尝试续订订阅。如果恢复成功，订阅将再次变为活动状态。如果由于付款问题导致恢复失败，用户将进入帐号保留状态，如图 1 所示：

用户也可以选择在暂停期内随时手动恢复订阅，如图 2 所示。当用户手动恢复订阅时，结算日期将更改为手动恢复日期。

用户的订阅暂停后，订阅不会由 queryPurchasesAsync() 返回。如果恢复了订阅，订阅随后会由 queryPurchasesAsync() 返回。

如果您的应用与安全的后端服务器同步订阅状态，则应监听实时开发者通知来维护状态。利用这些通知，还可以在您的应用中通知用户他们已暂停订阅，因而无法访问订阅。您还应使用 Google Play 深层链接来为用户提供一种手动恢复订阅的方法。

当用户发起订阅暂停时，系统会发送类型为 SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED 的 SubscriptionNotification。此时，用户应保持对订阅的访问权限，并且订阅资源包含 autoRenewing = true、paymentState = 1（付款已接收），以及 expiryTime 和 autoResumeTimeMillis 的将来日期值。

当暂停生效时，系统会发送类型为 SUBSCRIPTION_PAUSED 的 SubscriptionNotification。此时，用户应失去对订阅的访问权限，并且订阅资源包含 autoRenewing = true 和 paymentState = 0（待处理），以及 autoResumeTimeMillis 的将来日期值和 expiryTime 的过去日期值。

如果在暂停期结束时自动恢复了订阅或用户选择了手动恢复订阅，系统会发送类型为 SUBSCRIPTION_RENEWED 的 SubscriptionNotification。应按照续订中的说明来处理此事件。

如果尝试恢复订阅时付款失败，系统会发送类型为 SUBSCRIPTION_ON_HOLD 的 SubscriptionNotification。应按照帐号保留部分中的说明来处理此事件。

恢复

已取消的订阅会在到期日期之前继续显示在 Play 商店应用中。用户可以通过在 Google Play 商店应用的订阅部分中点击重新订阅（以前称为恢复），在已取消的订阅到期之前恢复订阅。您还可以允许用户在到期之后重新订阅自动续订型基础方案，方法是使用“重新订阅”选项进行相应配置。

到期之前恢复

如果您的应用仅依赖于 queryPurchasesAsync() 来确定用户是否有权访问订阅，则应自动处理恢复，因为 queryPurchasesAsync() 会在购买交易的到期日期之前继续返回已取消的购买交易。已恢复的订阅会继续续订，就像未取消过一样。

如果您的应用与后端同步订阅状态，您就应监听类型为 SUBSCRIPTION_RESTARTED 的 SubscriptionNotification。收到该通知后，您的应用可以对其做出响应，记录订阅现已设为续订，并停止在您的应用中显示恢复消息。订阅资源与下面的内容类似：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date
      ...
    }
  ],
}

到期之后重新订阅

如果订阅商品配置为允许在到期之后重新订阅，用户可能会通过 Play 商店应用开始购买。在这种情况下，Google Play 会发布全新的购买令牌，您的后端将收到 SUBSCRIPTION_PURCHASED 实时开发者通知。对于此类购买交易，其购买状态不会包含 linkedPurchaseToken，也不会包含与原始购买交易关联的经过混淆处理的帐号标识符，因为原始购买交易已完全过期。

到期之后重新订阅会要求用户打开应用，而您处理此类购买交易的方式与处理其他应用外购买相同。

升级、降级和重新订阅

当用户升级、降级或在订阅过期之前重新注册应用时，旧订阅会变为无效，并且系统会使用一个新的购买令牌创建新订阅。

此外，从 Google Play Developer API 返回的订阅资源将包含一个 linkedPurchaseToken，用来指示用户升级、降级或重新订阅时所基于的旧购买交易。您可以使用 linkedPurchaseToken 查询旧订阅并识别现有用户帐号，以便将新购买交易与同一帐号关联。

在应用中提供升级、降级或重新注册选项之前，您必须确认现有订阅。如果旧订阅正在等待确认，任何方案变更或重新注册都会被阻止。

在方案变更或重新注册后，我们还要求您确认新的订阅购买交易。建议您使用 Google Play Developer API 确认购买交易，以免购买交易被取消。订阅资源与下面的内容类似：

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "linkedPurchaseToken": old_purchase_token,
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

预付费方案集成

预付费方案到期后不会自动续订。如需延长订阅内容使用权而不出现中断，用户必须给同一项订阅内容的预付费方案充值。

对于充值，请按照与原始购买交易相同的方式启动结算流程。您无需指明购买交易是充值。

预付费方案充值始终使用 IMMEDIATE_AND_CHARGE_FULL_PRICE 按比例计费模式，您无需明确设置此模式。系统会立即向用户收取整个结算周期的费用，并按充值时指定的时长延长其使用权。

充值后，Purchase 结果对象中的以下字段会更新，以反映最新的充值交易：

• 订单 ID
• 购买时间
• 签名
• 购买令牌
• 已确认

以下 Purchase 字段中包含的数据始终与原始购买交易中的数据相同：

• 软件包名称
• 购买状态
• 商品
• 自动续订

预付费购买交易确认

与自动续订订阅内容类似，您必须在购买交易完成后确认预付费方案。初始购买交易和所有充值都需要进行确认。如需了解详情，请参阅处理购买交易。

由于预付费方案的时长有可能比较短，因此请务必尽快确认购买交易。

时长为一周或更长时间的预付费方案必须在三天内确认。

对于时长不到一周的预付费方案，其确认时间不得晚于方案时长过半之时。例如，开发者必须在 1.5 天内确认时长为三天的预付费方案。

使用深层链接让用户能够管理订阅

作为开发者，您必须让客户能够轻松地管理订阅。您的应用应在设置或偏好设置屏幕上添加一个链接，让用户能够管理订阅。此链接的示例如图 4 所示。

在此链接的点击处理程序中，添加逻辑以确定用户在您的应用中是否有任何未到期的订阅，其中 expiryTime 是将来的日期，或者 autoRenewing 设置为 true。

每个订阅的 productId 都与您在 Play 管理中心创建它时为其分配的商品 ID 相匹配。如需以编程方式确定现有订阅的 productId，请在应用的后端查询与特定用户关联的订阅列表。

如果用户有未到期的订阅，您可以将其转到与下面类似的网址，应将“your-sub-product-id”和“your-app-package”替换为订阅 ID 和应用软件包信息：

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

如果用户在您的应用中没有任何未到期的订阅，请使用以下网址将用户转到显示其所有其他订阅的页面，如图 5 和图 6 所示：

https://play.google.com/store/account/subscriptions

您可以在 Classy Taxi 示例应用中找到订阅链接逻辑的示例代码。

允许用户升级、降级或更改订阅

您可为用户提供不同的订阅层级，例如基本层级和高级层级。图 7 显示了一个提供两个订阅层级的屏幕：

用户应该能够访问与图 7 类似的屏幕来升级或降级订阅。升级或降级订阅时，您可以设置按比例计费模式，用于确定变更对订阅者有何影响。

下表列出了可用的按比例计费模式：

如果用户更改订阅权利，您必须在运行时指定按比例计费的费率。对于权利变更，您无法通过 Google Play 管理中心指定默认的按比例计费模式。

如果用户未更改订阅权利，您就可以使用通过 Play 管理中心配置的默认按比例计费模式。您也可以通过在 SubscriptionUpdateParams 中指定按比例计费模式来替换此行为。请注意以下限制：

• 从预付费方案或自动续订型方案升级、降级或在同一订阅中切换到预付费方案时，唯一允许使用的按比例计费模式为 IMMEDIATE_AND_CHARGE_FULL_PRICE。如果您指定任何其他按比例计费模式，将导致购买失败，并向用户显示错误消息。
• 在同一订阅中将方案从预付费方案切换到自动续订型方案时，有效的按比例计费模式为 IMMEDIATE_AND_CHARGE_FULL_PRICE 和 IMMEDIATE_WITHOUT_PRORATION。如果您指定任何其他按比例计费模式，将导致购买失败，并向用户显示错误消息。

按比例计费示例

为了理解各种按比例计费模式的工作原理，我们来考虑下面的场景：

Samwise 订阅了 Country Gardener 应用的在线内容。他当前按月订阅第 1 层级的内容，该内容只包含文字。此订阅的费用为每月 2 美元，并且在每月的第一天续订。

在 4 月 15 日，Samwise 选择升级到第 2 层级按年订阅，该内容包含视频更新，费用为每年 36 美元。

升级订阅时，开发者会选择一种按比例计费模式。以下列表说明了各种按比例计费模式对 Samwise 的订阅有何影响：

IMMEDIATE_WITH_TIME_PRORATION

Samwise 的第 1 层级订阅会立即终止。由于他支付了一整个月（4 月 1 日至 30 日）的费用，但在订阅期刚过一半时升级了订阅，因此剩余半个月的订阅费用（1 美元）会应用到新订阅。不过，由于新订阅的费用为每年 36 美元，1 美元的余额只够 10 天（4 月 16 日至 25 日）的费用，因此在 4 月 26 日，他需要为新订阅支付 36 美元的费用，并且此后每年的 4 月 26 日需要再支付 36 美元。

IMMEDIATE_AND_CHARGE_PRORATED_PRICE

可以使用此模式，因为第 2 层级的每时间单位的订阅价格（36 美元/年 = 3 美元/月）大于第 1 层级的每时间单位的订阅价格（2 美元/月）。Samwise 的第 1 层级订阅会立即终止。由于他支付了整个月的费用，但只用了一半，因此剩余半个月的订阅费用（1 美元）会应用到新订阅。不过，由于新订阅的费用为每年 36 美元，剩余 15 天的费用为 1.50 美元，因此他需要为新订阅支付 0.50 美元的差价。在 5 月 1 日，Samwise 需要为新订阅层级支付 36 美元，并且此后每年的 5 月 1 日都需要再支付 36 美元。

IMMEDIATE_WITHOUT_PRORATION

Samwise 的第 1 层级订阅会立即升级到第 2 层级，无需支付额外的费用，而在 5 月 1 日，他需要为新订阅层级支付 36 美元，并且此后每年的 5 月 1 日都需要再支付 36 美元。

DEFERRED

Samwise 的第 1 层级订阅会一直持续到 4 月 30 日到期。在 5 月 1 日，第 2 层级订阅开始生效，Samwise 需要为新订阅层级支付 36 美元。

IMMEDIATE_AND_CHARGE_FULL_PRICE

Samwise 的第 1 层级订阅会立即终止。他的第 2 层级订阅当天开始生效，他需要支付 36 美元。由于他支付了一整个月的费用，但只用了一半，因此剩余半个月的订阅费用（1 美元）会应用到新订阅。由于新订阅的费用为每年 36 美元，因此他的订阅期限会延长一年的 1/36（约 10 天）。这样一来，Samwise 的下一次扣款时间距离现在还有 1 年零 10 天，下次扣款金额为 36 美元。此后，他每年需要支付 36 美元。

选择按比例计费模式时，请务必查看我们的按比例计费建议。

您的应用可以使用与启动购买流程相同的步骤来为用户提供升级或降级。不过，在升级或降级时，您需要提供当前订阅、将来（升级或降级的）订阅以及要使用的按比例计费模式的详细信息，如以下示例所示：

String offerToken = productDetails
                        .getSubscriptionOfferDetails(selectedOfferIndex)
                        .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched via queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldSkuPurchaseToken("old_purchase_token")
            .setReplaceSkusProrationMode(ProrationMode.IMMEDIATE_AND_CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);

// process purchase results from PurchasesUpdatedListener registered with BillingClient
public void onPurchaseUpdated(BillingResult billingResult, @Nullable List<Purchase> purchases) {
  // check BillingResult
  // process returned Purchase list, e.g. grant entitlement
}

对于立即替换按比例计费模式，您的应用会在 PurchasesUpdatedListener 中收到新的购买交易。此外，BillingClient.queryPurchasesAsync() 中也会提供相应的购买交易。当您收到购买令牌时，请遵循与验证新购买令牌相同的验证流程。请务必使用 Google Play 结算库中的 BillingClient.acknowledgePurchase() 或 Google Play Developer API 中的 Purchases.subscriptions:acknowledge 确认这些购买交易。

Google Play Developer API 会在订阅资源中返回一个 linkedPurchaseToken。请务必使在 linkedPurchaseToken 中提供的令牌无效，确保旧令牌不会被用于获取对您服务的访问权限。如需了解如何处理升级购买交易和降级购买交易，请参阅升级、降级和重新注册。

对于延迟替换模式，您的应用会收到对 PurchasesUpdatedListener 的调用，其中包含对原始订阅方案的购买，以及表明升级或降级是否成功的状态。在替换生效之前，BillingClient.queryPurchasesAsync() 会继续返回原始订阅方案的购买交易。新方案生效后，queryPurchasesAsync() 会返回新订阅的购买交易数据，并且系统会向安全的后端服务器发送 SUBSCRIPTION_RENEWED 通知。对于延迟替换，强烈建议监听此通知，并使用 Purchases.subscriptions:acknowledge 确认购买交易。订阅资源中的 linkedPurchaseToken 可用于确定订阅后端的哪个用户（如果适用）应更新为拥有新的权利。您的应用不应依赖于用户打开应用并通过 BillingClient.acknowledgePurchase() 确认，因为用户在方案变更生效后的三天内可能不会打开应用。

在享受免费试订或初次体验价优惠期间升级

当用户升级或降级时，会应用免费试订资格设置。您可以在 Google Play 管理中心内调整免费试订资格设置。

请注意以下几点：

• 如果对于您的应用中提供的所有订阅，用户只能获得一次免费试订机会，则用户要改用的方案将没有免费试订或初次体验价。
• 如果您针对每种订阅产品提供一次免费试订机会，则用户要改用的方案可以有免费试订或初次体验价。

下表说明了当新方案和旧方案都有免费试订且用户在免费试订期间升级时各种按比例计费模式的行为：

为了理解在每个应用中免费试订一次的默认情况下免费试订过渡的工作原理，我们来考虑下面的场景：

Maria 订阅了 Country Gardener 应用的在线内容。她当前按月订阅第 1 层级的内容，该内容只包含文字。此订阅的费用为每月 10 美元，并且她是在 4 月 1 日订阅的。作为首次订阅者，她可以享受 30 天的免费试订服务，这意味着，她应于 5 月 1 日支付第一笔订阅费用。

在 4 月 15 日，Maria 选择升级到第 2 层级订阅，该内容包含视频更新，费用为 20 美元/月。这第二次订阅也有 30 天的试订服务。

以下列表说明了在各种按比例计费模式下如何进行免费试订过渡：

• IMMEDIATE_WITH_TIME_PRORATION - Maria 会立即升级到第 2 层级。由于 Maria 在订阅期刚过一半时升级了订阅，因此剩余半个月的订阅费用（15 天的金额，按 10 美元/月计算）会应用到新订阅。不过，由于新订阅的费用为 20 美元/月，因此 15 天的余额只够 7.5 天的费用。Maria 没有资格再享受一次第 2 层级的免费试订服务，所以自 4 月 22 日起，她每月需要支付 20 美元。
• IMMEDIATE_AND_CHARGE_PRORATED_PRICE - 可以使用此模式，因为第 2 层级的每时间单位的订阅价格（20 美元/月）大于第 1 层级的每时间单位的订阅价格（10 美元/月）。Maria 的第 1 层级订阅会立即升级到第 2 层级，并且她会失去免费试订资格。由于 Maria 的下一个结算日期是在 5 月 1 日，因此她今天需要支付 10 美元，这是 4 月份下半月的费用，然后自 5 月 1 日起，她每月需要支付 20 美元。
• IMMEDIATE_WITHOUT_PRORATION - Maria 的第 1 层级订阅会立即升级到第 2 层级。Maria 可以免费试订到 4 月 30 日，并且现在可以访问第 2 层级的内容。自 5 月 1 日起，她每月需要支付 20 美元。
• DEFERRED - Maria 的第 1 层级订阅一直持续到下次付款日，即 5 月 1 日。在 5 月 1 日，第 2 层级订阅开始生效，Maria 需要在每月的第一天支付 20 美元。
• IMMEDIATE_AND_CHARGE_FULL_PRICE - Maria 的第 1 层级订阅会立即升级到第 2 层级，并且她会失去免费试订资格。她需要当天支付 20 美元。由于 Maria 的免费试订期还剩 15 天，因此她的下一个结算日期是 1 个月 + 15 天后，也就是 7 月 1 日。自 7 月 1 日起，她每月需要支付 20 美元。

以下列表说明了开发者允许每种订阅产品免费试订一次时的过渡行为：

• IMMEDIATE_WITH_TIME_PRORATION - Maria 会立即升级到第 2 层级。由于 Maria 在订阅期刚过一半时升级了订阅，因此剩余半个月的订阅费用（15 天的金额，按 10 美元/月计算）会应用到新订阅。不过，由于新订阅的费用为 20 美元/月，因此 15 天的余额只够 7.5 天的费用。Maria 有资格再享受一次第 2 层级的免费试订服务，所以她又有 37.5 天免费。自 5 月 22 日起，她每月需要支付 20 美元。
• IMMEDIATE_AND_CHARGE_PRORATED_PRICE - 可以使用此模式，因为第 2 层级的每时间单位的订阅价格（20 美元/月）大于第 1 层级的每时间单位的订阅价格（10 美元/月）。Maria 的第 1 层级订阅会立即升级到第 2 层级，并且她会失去免费试订资格。由于 Maria 的下一个结算日期是在 5 月 1 日，因此她今天需要支付 10 美元，这是 4 月份下半月的费用，然后自 5 月 1 日起，她每月需要支付 20 美元。
• IMMEDIATE_WITHOUT_PRORATION - Maria 的第 1 层级订阅会立即升级到第 2 层级。Maria 可以免费试订到 4 月 30 日，并且现在有权访问第 2 层级。
• DEFERRED - Maria 的第 1 层级订阅一直持续到下次付款日，即 5 月 1 日。在 5 月 1 日，第 2 层级订阅开始生效，Maria 需要在每月的第一天支付 20 美元。
• IMMEDIATE_AND_CHARGE_FULL_PRICE - Maria 的第 1 层级订阅会立即升级到第 2 层级，并且她会失去免费试订资格。她需要当天支付 20 美元。由于 Maria 的免费试订期还剩 15 天，因此她的下一个结算日期是 1 个月 + 15 天后，也就是 7 月 1 日。自 7 月 1 日起，她每月需要支付 20 美元。

按比例计费建议

下表显示了不同的按比例计费场景以及我们针对各种场景给出的建议：

客户管理

使用实时开发者通知，当用户决定取消订阅时，您可以实时检测到。当用户取消了订阅但在订阅到期之前，您可以向他们发送推送通知或应用内消息，让他们重新订阅。

在用户取消订阅后，您可以尝试在应用内或通过 Play 商店赢回他们。下表介绍了各种订阅场景以及相关的赢回操作和应用要求。

订阅到期之前 - 应用内

对于已被取消但尚未过期的订阅，您可以通过应用与新订阅者相同的应用内商品购买流程，允许订阅者在您的应用中恢复他们的订阅。请确保界面中会显示用户的现有订阅。例如，您不妨显示用户当前的到期日期、定期支付的费用以及重新激活按钮。

大多数情况下，建议您向用户提供与已订阅内容相同的价格和 SKU，如下所示：

• 使用同一个 SKU 发起新的订阅购买。
• 新订阅将替换旧订阅，并在同一到期日期续订。旧订阅会立即标记为“已过期”。
• 例如，小张订阅了一款示例音乐应用的内容且订阅的到期日期为 8 月 1 日。在 7 月 10 日，他以相同的每月价格重新订阅了一个月的订阅内容。系统会根据余额按比例计算新订阅的费用，新订阅会立即生效，并且仍在 8 月 1 日续订。

如果您想提供不同的价格（例如，新的免费试订或赢回折扣），则可以改为为用户提供不同的 SKU：

• 使用采用了按比例计费模式 IMMEDIATE_WITHOUT_PRORATION 的不同 SKU 发起升级或降级。
• 新订阅将替换旧订阅，并在同一到期日期续订。在原始到期日期那天，用户会按新 SKU 的价格付费（包括所有初次体验价）。如果旧订阅是使用经过混淆处理的帐号 ID 创建的，则应将同一 ID 传递给 BillingFlowParams，以进行升级和降级。
• 例如，小张订阅了一款示例音乐应用的内容且订阅的到期日期为 8 月 1 日。在 7 月 10 日，他以初次体验价重新订阅了按年订阅的内容。新订阅会立即生效，并且用户将在 8 月 1 日按初次体验价付费。
• 如果您决定在赢回 SKU 中添加免费试订或初次体验价，请确保用户有资格享受这些优惠，方法是在 Google Play 管理中心取消选中允许在每个应用中免费试订一次复选框，选中该复选框会限制用户在每个应用中只能免费试订一次。

当您收到购买令牌时，应该就像处理新订阅一样来处理购买交易。此外，Google Play Developer API 还会在订阅资源中返回一个 linkedPurchaseToken。请务必让 linkedPurchaseToken 中提供的令牌失效，以确保旧令牌不会被用于获取对您服务的访问权限。

订阅到期之前 - Play 商店内

在订阅被取消但仍然处于有效状态时，用户可以通过点击重新订阅（以前称为恢复）在 Google Play 订阅中心恢复订阅。这样会让订阅和购买令牌保持不变。

如需详细了解如何恢复订阅，请参阅恢复。

订阅到期之后 - 应用内

您可以允许订阅已过期的订阅者在您的应用中重新订阅，方法是应用与新订阅者相同的应用内商品购买流程。不过，请注意以下几点：

• 为了给用户提供折扣，您可能需要为您的订阅提供一个具有特殊定价的商品 ID，也称为“赢回 SKU”。您可以在应用中提供优惠，也可以在应用外（如通过电子邮件）通知用户优惠活动。
• 为了开始赢回订阅，请使用 Google Play 结算库在您的 Android 应用中启动购买流程。这与新订阅的流程相同，但您可以确定提供给用户的 SKU。
• 如果您决定在赢回 SKU 中添加免费试订或初次体验价，请确保用户有资格享受这些优惠，方法是在 Google Play 管理中心取消选中允许在每个应用中免费试订一次复选框，选中该复选框会限制用户在每个应用中只能免费试订一次。
• 如果用户重新订阅同一 SKU，便没有资格再享受免费试订或初次体验价。请务必在界面中说明这一点。

当您收到购买令牌时，应该就像处理新订阅一样来处理购买交易。您将不会在订阅资源中收到 linkedPurchaseToken。

订阅到期之后 - Play 商店内

如果您启用了重新订阅功能，用户便可在订阅到期后最长一年时间内，通过在 Google Play 订阅中心点击重新订阅来重新订阅同一 SKU。这样会生成新的订阅和购买令牌。

重新订阅属于应用外购买，因此请务必遵循处理在您的应用外进行的购买交易中介绍的最佳实践。

宣传您的订阅

您可以创建促销代码，让部分用户能够免费试订现有订阅更长时间。如需了解详情，请参阅促销代码。

对于免费试订，Google Play 会在免费试订开始之前验证用户是否具有有效的付款方式。某些用户可能会看到此验证的结果显示为付款方式被暂停或产生扣款。这种暂停或扣款是暂时的，稍后会撤消或退还。

试订期结束后，系统会通过用户的付款方式，按照全价收取订阅费用。

如果用户在免费试订期间的任一时刻取消了订阅，订阅将保持活动状态，直到试订期结束，当免费试订期结束时，用户不会被扣款。

取消、退款或撤消

您可以使用 Google Play Developer API 取消订阅、为订阅退款或撤消订阅。Google Play 管理中心也提供了此功能。

• 取消：用户可以在 Google Play 上取消订阅。您也可为用户提供一个在您的应用中或您的网站上取消订阅的选项。您的应用应按照撤消中的说明来处理这些取消事件。
• 退款：当您退款时，用户可以继续使用订阅内容。例如，如果因技术错误而导致用户无法访问您的商品，但该错误已得到解决，则可以使用退款。请注意，如果要退还的不只是最近一次的付款，或者如果您要办理部分退款，必须使用 Google Play 管理中心。
• 撤消：当您撤消时，用户会立即失去对订阅的访问权限。例如，如果因技术错误而导致用户无法访问您的商品，因而用户不想继续使用该商品，则可以使用此选项。您的应用应按照撤消中的说明来处理这些取消事件。

下表说明了取消、退款和撤消之间的区别。

为订阅者推迟结算

您可以使用 Google Play Developer API 中的 Purchases.subscriptions:defer 将自动续订订阅者的下一个结算日期向前推。在推迟期内，用户会订阅您的内容并且拥有完全访问权限，但不会被扣款。订阅续订日期会更新以反映新的日期。

对于预付费方案，您可以使用推迟结算 API 来推迟到期时间。

推迟结算可让您做到以下几点：

• 将免费访问权限作为一种特别优惠提供给用户，如购买电影时免费一周。
• 向客户提供免费访问权限以表达善意。

每次调用该 API，结算最短可推迟一天，最长为一年。如需进一步推迟结算，您可以在新的结算日期到来之前再次调用该 API。

例如，Darcy 按月订阅了 Fishing Quarterly 应用的在线内容。正常情况下，她在每个月第一天都需要支付 1.25 英镑的费用。在 3 月，她参与了应用发布商的在线调查活动。该发布商为她提供了免费六周的奖励，将下一笔付款推迟到 5 月 15 日，也就是在她先前预定结算日期（即 4 月 1 日）的六周后。Darcy 不需要支付 4 月或 5 月初的费用，并且仍能访问相关内容。在 5 月 15 日，她支付了当月 1.25 英镑的正常订阅费用。她的下一个续订日期现在为 6 月 15 日。

推迟结算时，您可能需要通过电子邮件或在应用中通知用户，告知用户他们的结算日期发生了变化。

更改订阅价格

您可以更改订阅基础方案和优惠的价格。 例如，您可能有需要调整价格的数字产品，或者您可能会更改产品的某组福利并希望在价格中反映这些变化。

如需了解如何使用 Play 管理中心更改订阅价格，请参阅 Play 管理中心帮助中心内的相关文档。

管理新购买交易的价格变动

当您更改基础方案或优惠的价格后，新价格将在几个小时内对所有新购买交易生效，而无需您执行任何其他操作。新购买交易可以是以下任何一种：

• 目前在您的应用中没有任何订阅的用户。
• 已购买现有自动续订型方案但目前正在购买其他方案（例如更长的结算周期或更高的服务层级）的用户。
• 已购买预付费方案且在购买充值方案的用户。

您应该像处理其他购买交易一样处理新的购买交易。

管理现有自动续订型订阅方案购买交易的价格变动

您可以随时更改自动续订型基础方案的价格。默认情况下，现有订阅者不会受到影响。这些订阅者会被置于旧价格同类群组中，他们将在续订时继续按原始基础方案价格付费。您可以随时终止该同类群组，并将这些用户调到当前的基础方案价格。

同样，特别优惠和各个定价阶段的价格变动也不会影响现有订阅者。这些订阅者将继续按照购买订阅时所看到的价格付费。

如需详细了解如何使用旧价格同类群组，请参阅 Play 管理中心帮助中心。

使用 Google Play Developer API 更改订阅价格

如需程序化地更改订阅基础方案价格，请使用 monetization.subscriptions.patch 方法。此方法会收到包含要更改的订阅产品配置的 Subscription 对象。在订阅的 basePlans 集合内相应基础方案下的 RegionalBasePlanConfig 对象中设置新价格。如果您的产品清单规模庞大，并且您需要在短时间内更新所有产品，或者有产品清单管理系统在发生更改时自动更改您的 Play 结算服务订阅产品，那么这么设置很有用。

如需在 Play 管理中心内更改基础方案的价格，请参阅 Play 管理中心帮助中心。

停用旧价格同类群组

停用旧价格同类群组后，支付自动续订型基础方案价格的用户将转移到当前基础方案价格。如需在 Play 管理中心内停用旧价格，请参阅 Play 管理中心帮助中心。

使用 Google Play Developer API 停用旧价格同类群组

如需程序化地停用旧价格同类群组，请使用 monetization.subscriptions.basePlans.migratePrices 方法。该方法会将接收历史订阅价格的订阅者迁移到指定地区的当前基础方案价格。该方法将触发价格变更通知，并发送给当前接收早于所提供时间戳的历史价格的用户。不同意新价格的订阅者将在下次续订时终止订阅。

价格变动何时生效

当您停用旧价格同类群组后，系统会开始将这些用户移至当前基础方案价格的流程。如果价格上调和下调，Play 都会通知这些用户价格即将调整。

价格下调

如果当前基础方案的价格较低，Play 会通过电子邮件通知用户，并且用户在下一个续订日期将首先支付更低的基础方案价格。

价格上调

如果当前基础方案的价格较高，Play 会通过电子邮件和推送通知通知用户，并且会在提前通知期（37 天）后的首次续订日期向用户收取更高的费用：等待期初始天数为 7 天，还有 30 天时间用于开始向用户发送通知。

用户必须在首次按新价格支付之前，在提前通知期内通过 Play 商店同意较高的价格。否则，Play 会自动取消订阅。Play 在首次收费前 1 天和 30 天向用户发送电子邮件和推送通知。

通知用户价格变动

每当您更改现有订阅者的基础方案价格或终止其旧同类群组价格时，都应该通知现有订阅者。如果上调价格，您应该提前通知用户，告知他们需要接受价格上调。

如果您上调订阅价格，在您终止旧同类群组后，您有至少七天的时间来通知现有订阅者价格变动，然后 Google Play 才会开始直接通知他们。在此期间，您可以再次改回原始价格，有效取消待处理的价格上调。您也可以在 Play 通知之前通知受影响的用户。

我们建议您在应用内通知受影响的用户，并提供指向 Play 商店订阅界面的深层链接，以便用户轻松接受新价格。

用户可以在 Play 商店订阅界面中查看价格上调情况，该界面上会显示类似于图 13 的对话框。

示例

示例 1（按月订阅）：在 3 月 3 日，SuperStreamz 通过结束旧价格同类群组，上调了付费视频在线播放订阅 SuperStreamz Pro 的价格。他们将旧价格同类群组中的 1 美元用户转移到当前的 2 美元基础方案价格。价格变动的生效日期为 4 月 9 日（3 月 3 日之后的 37 天）。

• Alice 是现有订阅者，下次续订日期为 3 月 5 日。生效日期之后的第一次续订日期为 5 月 5 日，因此她在 3 月 5 日和 4 月 5 日按旧价格（1 美元）续订。当她在 5 月 5 日再次续订时，则按新价格（2 美元）支付费用。Google Play 将于 4 月 5 日（即采用新价格的首次续订日期前 30 天）开始通知 Alice 价格变动。

• Bob 是现有订阅者，下次续订日期为 3 月 29 日。由于价格变动尚未生效，因此他在 3 月 29 日以旧价格（1 美元）续订。当他在 4 月 29 日再次续订时，则按新价格（2 美元）支付费用。 他于 3 月 30 日（即采用新价格的首次续订日期前 30 天）开始收到价格变动通知。

示例 2（3 个月订阅期）：在 3 月 3 日，FindMyLove 结束了旧价格同类群组，将 FindMyLove Premium 的 3 个月费用从 1 美元上调至 2 美元的基础方案价格。价格变动的生效日期为 4 月 9 日（3 月 3 日之后的 37 天）。

• Alice 是现有订阅者，下次续订日期为 3 月 5 日。Alice 以旧价格（1 美元）续订，因为价格变动尚未生效。当她在 6 月 5 日再次续订时，则按新价格（2 美元）支付费用。 她于 5 月 6 日（即采用新价格的首次续订日期前 30 天）开始收到价格变动通知。

• Bob 是现有订阅者，下次续订日期为 4 月 11 日。Bob 会按新价格（2 美元）续订，因为该日期晚于生效日期。他于 3 月 12 日（即采用新价格的首次续订日期前 30 天）开始收到价格变动通知。

示例 3（按周订阅）：在 3 月 3 日，CutePetsNews 结束了旧价格同类群组，将 Weekly Dog Alerts 的每周费用从 1 美元上调至 2 美元。价格变动的生效日期为 4 月 9 日。

• Alice 是现有订阅者，下周续订的时间是 3 月 6 日。她于 3 月 6 日、3 月 13 日、3 月 20 日、3 月 27 日和 4 月 3 日以旧价格（1 美元）续订，因为价格变动尚未生效。当她在 4 月 10 日再次续订时，则按新价格（2 美元）支付费用。她于 3 月 11 日（即采用新价格的首次续订日期前 30 天）开始收到价格变动通知。

示例 4（按月订阅、多次价格变动）：此示例展示了如何处理多次价格变动。

在 3 月 3 日，SuperStreamz 变动了其付费视频在线播放订阅 SuperStreamz Pro，将价格从每月 1 美元上调至 2 美元。在 3 月 10 日，开发者再次触发了价格变动，将价格上调至每月 3 美元。

首次价格变动的生效日期为 4 月 9 日（3 月 3 日之后的 37 天）。 第二次价格变动的生效日期为 4 月 16 日（3 月 10 日之后的 37 天）。

• Alice 的下次续订日期是 3 月 5 日。生效日期之后的首次续订日期为 5 月 5 日，因此她在 3 月 5 日和 4 月 5 日按旧价格（1 美元）续订。当她在 5 月 5 日再次续订时，则按新价格（2 美元）支付费用。由于价格变动发生在 7 天冻结期内，因此她仅会收到第二次价格变动的通知。她于 4 月 5 日（即采用新价格的首次续订日期前 30 天）开始收到价格变动的通知。

处理用户对价格变动的确认

当用户接受订阅价格上调时，您会收到类型为 SUBSCRIPTION_PRICE_CHANGED_CONFIRMED 的 SubscriptionNotification。如果取消价格下调，或者在订阅价格上调后续订，您会收到类型为 SUBSCRIPTION_RENEWED 的 SubscriptionNotification。您应该像其他任何续订一样处理此通知。

处理不接受价格上调的情况

如果用户未在需要以更高价格续订之前接受价格上调，则会自动退订，并且您会收到 SUBSCRIPTION_CANCELED 类型的 SubscriptionNotification。可以按照取消部分的说明来处理此事件。

意外价格变动

如果您意外地更改了订阅价格，应立即撤消更改。只要价格在七天内还原，现有订阅者就不会收到有关意外价格变动的通知。请注意，在第一次价格变动到还原期间，新订阅者可能会收到意外价格。

处理连续两次价格变动的情况

如果您在七天内先后两次更改订阅价格，受影响的用户只需同意最新的价格变动。例如，如果您已在某次价格上调时停用旧价格同类群组，然后您再次更改价格，那么任何符合条件的用户都无需再回应第一次价格变动，因为现在仅第二次价格变动适用。

您应确保在某一时间只做出一次价格变动。您不应出于测试目的更改用户价格。

处理付款遭拒问题

如果结算周期结束时存在付款问题，Google 会在取消订阅前的一段时间内定期尝试续订。此重试期限最长可持续 30 天，外加任何指定的宽限期天数。在此期间，Google 还会向用户发送电子邮件和通知，要求他们更新付款方式。

付款遭拒后，订阅会首先进入宽限期（如果已启用宽限期）。在宽限期内，用户应仍有权访问订阅。

任何宽限期结束后，订阅将进入帐号保留状态，此状态最长为 30 天。在帐号保留期间，您可以阻止用户访问订阅。

为了在付款遭拒期间最大限度提高恢复订阅的可能性，您可以将付款问题告知用户，并请他们解决此问题。

您可以自行执行此操作（如宽限期和帐号保留部分中所述）；也可以实现 In-App Messaging API，通过此方法让 Google 在应用中向用户显示消息。

In-App Messaging

如果您使用 InAppMessageCategoryId.TRANSACTIONAL 启用了 In-App Messaging 功能，Google Play 会在宽限期和帐号保留期内每天向用户显示一次消息，并使用户能够无需离开应用即可解决付款问题。

我们建议您在用户每次打开应用时都调用此 API，以确定是否应该显示此消息。

如果用户成功恢复了订阅，您会收到响应代码 SUBSCRIPTION_STATUS_UPDATED 以及购买令牌。然后，您应使用此购买令牌调用 Google Play Developer API 并刷新应用中的订阅状态。

集成 In-App Messaging 功能

如需向用户显示应用内消息，请使用 BillingClient.showInAppMessages()。

以下是触发 In-App Messaging 流程的示例：

val inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build()

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        object : InAppMessageResponseListener() {
            override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
                if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        })

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        });