本主题介绍了如何处理订阅生命周期事件,如续订和到期。此外,还介绍了其他订阅功能,如提供促销活动以及允许用户管理他们自己的订阅。
如果您还没有为您的应用配置订阅商品,请参阅创建和配置您的商品。
订阅概览
订阅代表用户在指定时间段内可以享受的一系列权益。例如,订阅可授予用户使用某项音乐在线播放服务的权利。
您可以在同一个应用中提供多项订阅;这些订阅可以分别代表一组不同的权益,也可以代表同一组权益的不同层级(例如,“白银”层级和“黄金”层级)。
您可以通过基础方案和优惠,为同一订阅商品创建多个配置。例如,您可以针对从未订阅过您的应用的用户创建初次体验优惠。同样,您也可以针对已经订阅的用户创建升级优惠。
如需详细了解订阅商品、基础方案和优惠,请参阅 Play 管理中心帮助中心内的相关文档。
预付费方案集成
预付费方案到期后不会自动续订。如需延长订阅内容使用权而不出现中断,用户必须给同一项订阅内容的预付费方案充值。
对于充值,请按照与原始购买交易相同的方式启动结算流程。您无需指明购买交易是充值。
预付费方案充值始终使用 CHARGE_FULL_PRICE
替换模式,您无需明确设置此模式。系统会立即向用户收取整个结算周期的费用,并按充值时指定的时长延长其使用权。
充值后,Purchase
结果对象中的以下字段会更新,以反映最新的充值交易:
- 订单 ID
- 购买时间
- 签名
- 购买令牌
- 已确认
以下 Purchase
字段中包含的数据始终与原始购买交易中的数据相同:
- 软件包名称
- 购买状态
- 商品
- 自动续订
预付费购买交易确认
与自动续订订阅内容类似,您必须在购买交易完成后确认预付费方案。初始购买交易和所有充值都需要进行确认。如需了解详情,请参阅处理购买交易。
由于预付费方案的时长有可能比较短,因此请务必尽快确认购买交易。
时长为一周或更长时间的预付费方案必须在三天内确认。
对于时长不到一周的预付费方案,其确认时间不得晚于方案时长过半之时。例如,开发者必须在 1.5 天内确认时长为三天的预付费方案。
分期付款订阅集成
分期付款订阅是一种订阅类型,用户需支付 可在同一段时间内分多次分期付款,而不是直接付费订阅 预先支付全部订阅费用
分期付款订阅的其他注意事项:
- 适用的国家/地区:分期付款订阅功能仅适用于 巴西、法国、意大利和西班牙的用户(请查看控制台了解最新的支持情况)。
- 设置价格:设置分期付款订阅价格时 在 Play 管理中心上显示的价格表示每月付款金额。这 与所设置的承诺期相结合后,所得出的金额为 。
- 承诺期:初始订阅的总时长 承诺使用期,期间需要按月付款。例如,如果 基础方案的承诺期为 15 个月,用户每月将获得 15 个月 付款。
- 续订:就分期付款订阅而言,“renewal”表示 承诺期结束,可以是初始承诺期,也可以是 后续承诺期。初次注册后,首次续订 在整个初始承诺期结束后生效。后续 在后续每个承诺期到期后进行续订。通过 分期付款订阅的续订类型可以是“auto-renewsmonthly”或 “自动续期相同时长”。对于“每月自动续订”,没有 此方案的行为类似于按月订阅, 每月的订阅费用构成一次续订。
- 结算周期:就分期付款订阅而言,指 个人付款的周期性周期,以指定 。
- 方案变更与价格变更行为:适用于价格变更和 承诺是坚定的。这意味着,如果用户想要 或开发者想要更改价格,则更改将于以下日期生效: 承诺期结束。对于方案变更,承诺不是确定的。 也就是说,方案变更无需等到 承诺期会立即生效,或在下次付款时生效 替换日期。
- 同订阅方案变更:分期付款基础方案的方案变更 订阅同一订阅商品的非分期付款基础方案 允许。
实时开发者通知 (RTDN):
SUBSCRIPTION_CANCELLATION_SCHEDULED
RTDN 将立即 由用户发起的取消(在承诺期内的付款持续发生)。 正在等待取消,并将仅在 承诺期。然后,如果用户没有恢复,SUBSCRIPTION_CANCELED
和SUBSCRIPTION_EXPIRED
个 RTDN 将在承诺期结束时发送。付款 / 收入实现:开发者付款将随着用户的付款支付给您 用户按月付款,并且需遵守与所有其他订阅相同的条款。 当用户注册分期付款时,开发者不会预先获得付款 订阅。
拖欠款项收款:用户未能办理任何分期付款 订阅付款,Google 和开发者均不会试图 用户未支付或未支付的任何此类款项,除非 Google 可能 在任何适用的宽限期内定期重新尝试付款;或者 账号保留期根据正常的付款重试做法。 如果有任何未付款项,Google 将不向开发者承担 分期付款。
Play 结算库适用范围:
installmentDetails
字段 适用于 PBL 7 或更高版本。对于 PBL 5 及更高版本,分期付款 订阅使用queryProductDetails()
返回,但订阅 不会包含详细的分期付款信息,例如承诺付款金额 方案
使用深层链接让用户能够管理订阅
您的应用应在设置或偏好设置界面上添加一个链接,让用户能够管理订阅,您可将链接与应用的自然外观和风格融为一体。
对于未过期的订阅,您可以添加从您的应用到 Google Play 订阅中心的深层链接,您可以使用订阅资源的 subscriptionState
字段来确定订阅是否未过期。基于此,您可以通过多种方式深层链接到 Play 商店订阅中心。
指向订阅中心的链接
使用以下网址将用户定向到显示其所有订阅的页面,如图 1 和图 2 所示:
https://play.google.com/store/account/subscriptions
![Play 商店“订阅”界面显示了用户通过 Google Play 结算的所有订阅的状态。](https://developer.android.google.cn/static/images/google/play/billing/sub_center_general.png?authuser=9&hl=zh-cn)
![点按某个订阅可查看更多详情。](https://developer.android.google.cn/static/images/google/play/billing/sub_management_mock_general.png?authuser=9&hl=zh-cn)
此深层链接可能有助于用户从 Play 商店订阅中心恢复已取消的订阅。
指向特定订阅的管理页面的链接(推荐)
若要直接链接到一项未过期订阅的管理页面,请指明与购买的订阅关联的软件包名称和 productId
。若要以程序化方式确定一项现有订阅的 productId
,请在应用的后端查询,或针对与特定用户关联的订阅列表调用 BillingClient.queryPurchasesAsync()
。每项订阅都包含相应的 productId
,作为订阅状态信息的一部分。与订阅购买交易关联的每个 SubscriptionPurchaseLineItem
对象都包含与用户在该订单项中购买的订阅关联的 productId
值。
使用以下网址将用户定向到特定订阅的管理界面,并将“your-sub-product-id”和“your-app-package”分别替换为 productId
和应用软件包名称:
https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package
然后,用户就能管理其付款方式并使用取消、重新订阅和暂停等功能。
允许用户升级、降级或更改订阅
您可以为现有订阅者提供各种选项,方便他们更改订阅方案以更好地满足个人需求:
- 如果您销售多个订阅层级(例如“基础”和“付费”订阅),可以允许用户通过购买不同订阅的基础方案或优惠来切换层级。
- 您可以允许用户更改其当前结算周期,例如从包月方案改为包年方案。
- 您还可以允许用户在自动续订和预付费方案之间切换。
您可以通过订阅优惠向符合条件的用户提供折扣,鼓励用户进行上述任何更改。例如,您可以创建一个从包月方案改为包年方案第一年可享 5 折价格的优惠,并将此优惠限制为仅面向订阅了包月方案但尚未购买此优惠的用户。如需详细了解优惠资格条件,请访问帮助中心
图 3 显示了一款提供 3 种不同方案的示例应用:
![此应用有 3 个订阅层级。](https://developer.android.google.cn/static/images/google/play/billing/plan_change_inapp.png?authuser=9&hl=zh-cn)
应用可以显示类似于图 3 的界面,为用户提供更改其订阅的选项。在任何情况下,应用都必须向用户清楚展示当前采用的订阅方案是什么,以及可采用的方案更改选项。
当用户决定升级、降级或更改其订阅时,您可以指定替换模式,确定如何采用目前付费结算周期的按比例计费值,以及任何使用权变更的生效时间。
替换模式
下表列出了可用的替换模式和用法示例。 付款次数和付款次数。
替换模式 |
说明 |
用法示例 |
承诺付款记录为已付款(适用于分期付款订阅替换) |
|
订阅会立即升级或降级。系统会根据差价调整任何剩余时长,并将下一个结算日期往后推延,将剩余时长计入新的订阅。这是默认行为。 |
升级到费用更高的层级,无需立即支付额外费用。 |
0 |
|
订阅会立即升级,结算周期保持不变。用户随后需要补足剩余订阅期的差价。 注意:此选项仅适用于每时间单位的价格会提高的订阅升级。 |
升级到费用更高的层级,无需更改结算日期。 |
1 |
|
订阅会立即升级或降级,并且系统会即刻按全价向用户收取新使用权的费用。如果使用权不变,系统会将之前订阅的剩余价值结转;如果使用权有变化,系统会将剩余价值按比例折算成时间。 注意:如果新订阅提供免费试订或初次体验优惠,则在升级或降级时,用户需支付 0 美元或初次体验价费用(以适用者为准)。 |
从更短的结算周期升级到更长的结算周期。 |
1(注意:如果新订阅提供免费试订,则为 0。) |
|
订阅会立即升级或降级,在订阅续订时将按新价格收取费用。结算周期保持不变。 |
升级到更高的订阅层级,同时保留所有剩余的免费试用期。 |
0 |
|
只有在续订时,订阅才会升级或降级,但新购买的内容会立即发放,新订阅的开始日期在未来某个日期,因此开发者可允许用户按需要进行其他更改。例如,他们可以还原为原始方案或启动新的推迟方案更改。注意:对于分期付款订阅,方案变更会在下一个付款日期开始时进行。 |
降级到费用更低的层级。 |
1 |
如需详细了解如何将升级或降级优惠应用在各种追加销售和客户赢回活动中,请参阅优惠与促销活动指南。
为购买交易设置替换模式
您可以根据自己的偏好设置和业务逻辑,为不同类型的订阅转换采用不同的替换模式。本部分介绍如何针对订阅更改设置替换模式以及适用的限制。
重新订阅或在同一订阅中切换方案
您可以在 Google Play 管理中心内指定默认替换模式。如果当前订阅者购买同一订阅的不同基础方案或优惠,或者在取消订阅后重新订阅,您可以通过此设置选择何时向其收费。可用选项包括“立即收费”(等同于 CHARGE_FULL_PRICE
)和“在下一个结算日收费”(等同于 WITHOUT_PRORATION
)。在同一订阅中切换基础方案时,这些是仅有的相关替换模式。
例如,如果您要在用户取消订阅后、订阅结束前针对同一方案实现赢回优惠,则可以将新购买交易作为常规购买交易处理,无需在 SubscriptionUpdateParams
中指定任何值。系统会使用您在订阅中配置的默认替换模式,并自动处理从旧购买交易到新购买交易的方案转换。
跨订阅切换方案,或替换默认替换模式
如果用户更改订阅产品(即购买其他订阅),或者如果您出于任何原因想要替换默认替换模式,您可在购买流程参数中指定运行时按比例计费费率。
若要在运行时购买流程配置中正确提供 SubscriptionUpdateParams
,请注意以下限制:
- 升级、降级或发起将同一订阅切换到
预付费方案、自动续订型方案或分期付款方案提供的预付费方案
允许的替换模式为
CHARGE_FULL_PRICE
。如果您指定任何其他 替换模式下,购买会失败并向用户显示错误消息。 - 在同一订阅中将方案从预付费方案或自动续订型方案切换到自动续订型方案时,有效的按比例计费模式为
CHARGE_FULL_PRICE
和WITHOUT_PRORATION
。如果您指定任何其他按比例计费模式,将导致购买失败,并向用户显示错误消息。 - 将同一订阅商品中的方案从分期付款方案改换为其他方案 无法将方案转换为非分期付款基础方案。
替换示例和行为
为了理解各种按比例计费模式的运作原理,我们来考虑下面的场景:
李明订阅了 Country Gardener 应用的在线内容。他按月订阅第 1 层级版的内容,该内容只包含文字。此订阅的费用为每月 2 美元,并且在每月的第一天续订。
在 4 月 15 日,李明选择升级到第 2 层级按年订阅,该内容包含视频更新,费用为每年 36 美元。
升级订阅时,开发者会选择一种按比例计费模式。以下列表说明了各种按比例计费模式对李明的订阅有何影响:
WITH_TIME_PRORATION
李明的第 1 层级订阅会立即终止。由于他支付了一整个月(4 月 1 日至 30 日)的费用,但在订阅期刚过一半时升级了订阅,因此剩余半个月的订阅费用(1 美元)会应用到新订阅。不过,由于新订阅的费用为每年 36 美元,1 美元的余额只够 10 天(4 月 16 日至 25 日)的费用,因此在 4 月 26 日,他需要为新订阅支付 36 美元的费用,并且此后每年的 4 月 26 日需要再支付 36 美元。
您应在购买交易成功时调用应用的 PurchasesUpdatedListener
,并且您能通过 queryPurchasesAsync()
调用检索新购买交易。您的后端会立即收到 SUBSCRIPTION_PURCHASED
实时开发者通知。
CHARGE_PRORATED_PRICE
可以使用此模式,因为第 2 层级的每时间单位的订阅价格(36 美元/年 = 3 美元/月)高于第 1 层级的每时间单位的订阅价格(2 美元/月)。李明的第 1 层级订阅会立即终止。由于他支付了一整个月的费用,但只用了一半,因此剩余半个月的订阅费用(1 美元)会应用到新订阅。不过,由于新订阅的费用为每年 36 美元,剩余 15 天的费用为 1.50 美元,因此他需要为新订阅支付 0.50 美元的差价。在 5 月 1 日,李明需要为新订阅层级支付 36 美元,并且此后每年的 5 月 1 日都需要再支付 36 美元。
您应在购买交易成功时调用应用的 PurchasesUpdatedListener
,并且您能通过 queryPurchasesAsync()
调用检索新购买交易。您的后端会立即收到 SUBSCRIPTION_PURCHASED
实时开发者通知。
WITHOUT_PRORATION
李明的第 1 层级订阅会立即升级到第 2 层级,无需支付额外的费用,而在 5 月 1 日,他需要为新订阅层级支付 36 美元,并且此后每年的 5 月 1 日都需要再支付 36 美元。
您应在购买交易成功时调用应用的 PurchasesUpdatedListener
,并且您能通过 queryPurchasesAsync()
调用检索新购买交易。您的后端会立即收到 SUBSCRIPTION_PURCHASED
实时开发者通知。
DEFERRED
李明的第 1 层级订阅会一直持续到 4 月 30 日到期。在 5 月 1 日,第 2 层级订阅开始生效,李明需要为新订阅层级支付 36 美元。
您应在购买交易成功时调用应用的 PurchasesUpdatedListener
,并且您能通过 queryPurchasesAsync()
调用检索新购买交易。您的后端会立即收到 SUBSCRIPTION_PURCHASED
实时开发者通知。您应该处理购买交易,采用与此时处理任何其他新购买交易相同的方式。尤其需要注意的是,请务必确认新的购买交易。请注意,在替换生效时(即旧订阅到期时),系统会填充新订阅的 startTime
。届时,您会收到新订阅方案的 SUBSCRIPTION_RENEWED
RTDN。如需详细了解 ReplacementMode.DEFERRED
行为,请参阅处理延迟替换。
CHARGE_FULL_PRICE
李明的第 1 层级订阅会立即终止。他的第 2 层级订阅当天开始生效,他需要支付 36 美元。由于他支付了一整个月的费用,但只用了一半,因此剩余半个月的订阅费用(1 美元)会应用到新订阅。由于新订阅的费用为每年 36 美元,因此他的订阅期限会延长一年的 1/36(约 10 天)。这样一来,李明的下一次扣款时间距离现在还有 1 年零 10 天,下次扣款金额为 36 美元。此后,他每年需要支付 36 美元。
选择按比例计费模式时,请务必查看我们的替换建议。
在应用内触发订阅更改
您的应用可以使用与启动购买流程相同的步骤来为用户提供升级或降级。不过,在升级或降级时,您需要提供当前订阅、将来(升级或降级的)订阅以及要使用的替换模式的详细信息,如以下示例所示:
Kotlin
val offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken() val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList( listOf( BillingFlowParams.ProductDetailsParams.newBuilder() .setProductDetails(productDetails) .setOfferToken(offerToken) .build() ) ).setSubscriptionUpdateParams( BillingFlowParams.SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode( BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE ) .build() ).build() billingClient.launchBillingFlow( activity, billingParams ) // ...
Java
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 .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE) .build()) .build(); BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams); // ...
替换建议
下表显示了不同的按比例计费场景以及我们针对各种场景给出的建议:
场景 | 建议的替换模式 | 结果 |
---|---|---|
升级到费用更高的层级 | CHARGE_PRORATED_PRICE |
用户会立即获得访问权限,而结算周期保持不变。 |
降级到费用更低的层级 | DEFERRED |
用户已经付费购买了费用更高的层级,因此将保有访问权限,直到下一个结算日期。 |
在免费试订期间升级 - 保留免费试订 | WITHOUT_PRORATION |
用户会保有对免费试订的访问权限,但试订期的剩余时间会升级到更高的层级。 |
在免费试订期间升级 - 终止对免费试订的访问权限 | CHARGE_PRORATED_PRICE |
用户会立即获得对新层级的访问权限,但不能再享受免费试订。 |
处理订阅更改购买交易
就所有条款和用途而言,方案的更改是指新的购买交易,且在结算流程成功完成后应该以此形式处理及确认。除了适当处理新购买交易之外,您还必须停用将被替换的购买交易。
应用内行为与任何新购买交易的行为一样。您的应用会在 PurchasesUpdatedListener
中收到新购买交易的结果,而新购买交易会在 queryPurchasesAsync
中可用。
当购买交易替换现有购买交易时,Google Play Developer API 会在订阅资源中返回一个 linkedPurchaseToken
。请务必使在 linkedPurchaseToken
中提供的令牌无效,确保旧令牌不会被用于获取对您服务的访问权限。如需了解如何处理升级购买交易和降级购买交易,请参阅升级、降级和重新注册。
当您收到购买令牌时,请遵循与验证新购买令牌相同的验证流程。请务必使用 Google Play 结算库中的 BillingClient.acknowledgePurchase()
或 Google Play Developer API 中的 Purchases.subscriptions:acknowledge
确认这些购买交易。
处理延迟替换
通过延迟替换模式,您可允许用户先用完旧方案中的剩余使用权,再开始使用新方案。
当您针对新购买交易使用 ReplaceMode.DEFERRED 时,queryPurchasesAsync()
会在购买流程结束后返回一个新购买令牌,该令牌仍与旧购买交易相关联,直到在下一个续订日期延迟替换模式生效后,系统才会返回新产品。
过去,您可以使用已废弃的 ProrationMode.DEFERRED
实现这种用户体验,但 Play 结算库 6 中废弃了 ProrationMode.DEFERRED
。请参阅下表,了解此行为在哪些方面有所不同:
时间 |
ProrationMode.DEFERRED(已废弃) |
ReplaceMode.DEFERRED |
购买流程成功后立即启动(应用) |
购买交易完成后,系统会调用 您可以保有对旧方案的使用权,直到下一个续订日期为止。为确保应用提供适当的使用权, 新购买令牌尚未显示,因此目前无法处理。 |
购买交易完成后,系统会调用
新购买令牌已显示,考虑到替换的生效时间,应在此时进行处理。 |
购买流程成功后立即启动(后端) |
购买流程结束后,不发送 SUBSCRIPTION_PURCHASED RTDN。后端尚未获知新购买交易。 |
在新购买令牌的购买流程结束后,会立即发送带有旧 product_id 的 SUBSCRIPTION_PURCHASED RTDN。 使用新的购买令牌调用 purchases.subscriptionsv2.get 方法会返回具有“startTime”的购买交易使用两个订单项指明购买时间:
针对旧购买令牌发送 SUBSCRIPTION_EXPIRED。使用旧购买令牌调用 purchases.subscriptionsv2.get 方法时,显示为已过期(旧方案剩余时长的使用权会转移到新购买交易)。 |
替换时 - 购买流程后的首次续订(应用) |
新购买令牌现已显示,因此应该进行处理。 |
新购买交易应在购买流程成功后已处理完毕,因此除了确保正确授予使用权之外,应用不应执行任何特殊操作。 |
替换时 - 购买流程后的首次续订(后端) |
现在,新购买交易可在系统发送第一个 SUBSCRIPTION_RENEWED RTDN 时处理和确认。 订阅资源中的 |
在针对新购买令牌发送 SUBSCRIPTION_PURCHASED RTDN 时处理并确认新购买交易,并记录为“startTime”。 使用 ReplaceMode.DEFERRED 时,首次续订将遵循任何其他续订的标准行为,并且当此事件发生时,您无需针对替换处理特殊逻辑。 使用新购买令牌调用 purchases.subscriptionsv2.get 方法会返回包含两个订单项的购买交易:
|
从现在开始,应使用 ReplaceMode.DEFERRED,而非已废弃的 ProrationMode.DEFERRED,因为前者虽然执行与使用权更改相同的行为,但提供的购买交易管理方式与其他新购买交易的行为更加一致。
客户管理
使用实时开发者通知,当用户决定取消订阅时,您可以实时检测到。当用户取消了订阅但在订阅到期之前,您可以向他们发送推送通知或应用内消息,让他们重新订阅。
在用户取消订阅后,您可以尝试在应用内或通过 Play 商店赢回他们。下表介绍了各种订阅场景以及相关的赢回操作和应用要求。
订阅到期之前 | 订阅到期之后 | |||
应用内 | Play 商店内 | 应用内 | Play 商店内 | |
赢回功能 | 应用内订阅 | 恢复 | 应用内订阅 | 重新订阅 |
用户完成结账流程 | 是 | 否 | 是 | 是 |
用户订阅仍与同一 SKU 关联 | 用户可以注册相同或不同的 SKU | 是 | 用户可以注册相同或不同的 SKU | 是 |
创建新的购买令牌 | 是 | 否 | 是 | 是 |
默认处于启用状态 | 否 | 是,所有开发者都需要支持 | 否 |
未采用结算库 2.0 及以上版本的应用:否 采用结算库 2.0 及以上版本的应用:是。开发者可以在管理中心中选择停用该功能。 |
何时向用户收取费用 |
如果使用相同的 SKU:当前结算周期结束时。 如果使用不同的 SKU:取决于按比例计费模式。 |
当前结算周期结束时 | 立即 | 立即 |
所需实现 | 在应用中提供重新注册界面 |
检测订阅状态的变化 指向 Play 商店的深层链接 |
在应用中提供重新注册界面 | 处理应用外购买 |
订阅到期之前 - 应用内
对于已被取消但尚未过期的订阅,您可以通过应用与新订阅者相同的应用内商品购买流程,允许订阅者在您的应用中恢复他们的订阅。请确保界面中会显示用户的现有订阅。例如,您不妨显示用户当前的到期日期、定期支付的费用以及重新激活按钮。
大多数情况下,建议您向用户提供与已订阅内容相同的价格和 SKU,如下所示:
- 使用同一个 SKU 发起新的订阅购买。
- 新订阅将替换旧订阅,并在同一到期日期续订。旧订阅会立即标记为“已过期”。
- 例如,小张订阅了一款示例音乐应用的内容且订阅的到期日期为 8 月 1 日。在 7 月 10 日,他以相同的每月价格重新订阅了一个月的订阅内容。系统会根据余额按比例计算新订阅的费用,新订阅会立即生效,并且仍在 8 月 1 日续订。
如果您想提供不同的价格(例如,新的免费试订或赢回折扣),则可以改为为用户提供不同的 SKU:
- 使用采用了替换模式
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 订阅中心恢复订阅。这样会让订阅和购买令牌保持不变。
![Google Play 商店应用中的“订阅”部分,其中显示了已取消的订阅以及“重新订阅”按钮](https://developer.android.google.cn/static/images/google/play/billing/resubscribe.jpg?authuser=9&hl=zh-cn)
如需详细了解如何恢复订阅,请参阅恢复。
订阅到期之后 - 应用内
您可以允许订阅已过期的订阅者在您的应用中重新订阅,方法是应用与新订阅者相同的应用内商品购买流程。不过,请注意以下几点:
- 为了给用户提供折扣,您可能需要为您的订阅提供一个具有特殊定价的商品 ID,也称为“赢回 SKU”。您可以在应用中提供优惠,也可以在应用外(如通过电子邮件)通知用户优惠活动。
- 为了开始赢回订阅,请使用 Google Play 结算库在您的 Android 应用中启动购买流程。这与新订阅的流程相同,但您可以确定提供给用户的 SKU。
- 如果您决定在赢回 SKU 中添加免费试订或初次体验价,请确保用户有资格享受这些优惠,方法是在 Google Play 管理中心取消选中允许在每个应用中免费试订一次复选框,选中该复选框会限制用户在每个应用中只能免费试订一次。
- 如果用户重新订阅同一 SKU,便没有资格再享受免费试订或初次体验价。请务必在界面中说明这一点。
当您收到购买令牌时,应该就像处理新订阅一样来处理购买交易。您将不会在订阅资源中收到 linkedPurchaseToken
。
订阅到期之后 - Play 商店内
如果您启用了重新订阅功能,用户便可在订阅到期后最长一年时间内,通过在 Google Play 订阅中心点击重新订阅来重新订阅同一 SKU。这样会生成新的订阅和购买令牌。
![Google Play 商店应用中的“订阅”部分,其中显示了已取消且已过期的订阅,以及相应的“重新订阅”和“移除”按钮](https://developer.android.google.cn/static/images/google/play/billing/resubscribe-remove.jpg?authuser=9&hl=zh-cn)
重新订阅属于应用外购买,因此请务必遵循处理在您的应用外进行的购买交易中介绍的最佳实践。
宣传您的订阅
您可以创建促销代码,让部分用户能够免费试订现有订阅更长时间。如需了解详情,请参阅促销代码。
对于免费试订,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 日。
推迟结算时,您可能需要通过电子邮件或在应用中通知用户,告知用户他们的结算日期发生了变化。
处理付款遭拒问题
如果续订时出现付款问题,Google 将 在取消订阅前,定期尝试续订一段时间。 此恢复期可以由宽限期及账号冻结期组成 。在此期间,Google 会向相关用户发送电子邮件和通知 提示他们更新付款方式。
付款遭拒后,订阅就会进入宽限期 周期(如果其中一个是 配置。在宽限期内,您应确保用户仍拥有访问权限 订阅内容使用权
宽限期结束后,订阅会进入账号 暂停期间。中 您应确保用户无权访问 订阅内容使用权。
您可以指定每个自动续订型基础方案的宽限期时长 账号保留功能。指定的长度小于 提供默认值可能会减少从付款中恢复的订阅数 次数。
为了在付款遭拒期间最大限度提高恢复订阅的可能性,您可以将付款问题告知用户,并请他们解决此问题。
您可以自行执行此操作(如宽限期和账号冻结部分中所述);也可以实现 In-App Messaging API,通过此方法让 Google 在应用中向用户显示消息。
In-App Messaging
如果您使用 InAppMessageCategoryId.TRANSACTIONAL
启用了 In-App Messaging 功能,Google Play 会在宽限期和账号冻结期内每天向用户显示一次消息,并使用户能够无需离开应用即可解决付款问题。
![通知用户解决付款问题的信息提示控件](https://developer.android.google.cn/static/images/google/play/billing/subscriptions-in-app-messaging-snackbar.png?authuser=9&hl=zh-cn)
我们建议您在用户每次打开应用时都调用此 API,以确定是否应该显示此消息。
如果用户成功恢复了订阅,您会收到响应代码 SUBSCRIPTION_STATUS_UPDATED
以及购买令牌。然后,您应使用此购买令牌调用 Google Play Developer API 并刷新应用中的订阅状态。
集成 In-App Messaging 功能
如需向用户显示应用内消息,请使用 BillingClient.showInAppMessages()
。
以下是触发 In-App Messaging 流程的示例:
Kotlin
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. } } })
Java
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. } } });
处理订阅待处理交易
待处理的交易可能发生在初始购买、充值、升级或
降级。订阅购买始于
在转换为 SUBSCRIPTION_STATE_PENDING
状态之前
SUBSCRIPTION_STATE_ACTIVE
。如果交易过期或取消
用户,则会转到 SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED
。您必须
并且应在交易完成后更新用户
已完成。
包含待处理交易的初始购买交易的订阅状态变更为
简单明了。在以下情况下,应用会收到 PENDING
状态的 Purchase
:
用户发起了待处理的交易。交易完成后,您的
应用再次接收 Purchase
,同时状态更新为 PURCHASED
。答
发送了 SubscriptionNotification
条类型为“SUBSCRIPTION_PURCHASED
”的消息
您的 RTDN 客户端。请按照正常流程验证购买交易,
用户访问内容并确认购买交易。如果交易
到期或取消,类型为 SubscriptionNotification
的消息
系统会将 SUBSCRIPTION_PENDING_PURCHASE_CANCELED
发送到您的 RTDN 客户端。在此类
用户根本不应获得内容的访问权限。
对待处理交易的充值、升级或降级涉及状态更改
新旧订阅都适用当用户发起待处理
充值、升级或降级交易时,您的应用会收到针对以下平台的 Purchase
:
包含 PendingPurchaseUpdate
对象的旧订阅。目前,
用户仍然拥有旧订阅,且未获得新订阅
订阅。正在呼叫 getProducts()
和 getPurchaseToken()
PendingPurchaseUpdate
对象会返回以下产品的产品 ID 和购买令牌:
新订阅。当交易完成后,您的应用会收到
将 Purchase
替换为新订阅设置的顶级购买令牌;
状态设置为 PURCHASED
。类型为 SubscriptionNotification
的消息
系统会将 SUBSCRIPTION_PURCHASED
发送到您的 RTDN 客户端。但此时,
应将旧的购买令牌替换为新的购买令牌,并更新
用户对相应内容的访问权限如果交易过期或被取消,
SubscriptionNotification
条带类型的消息
系统会将 SUBSCRIPTION_PENDING_PURCHASE_CANCELED
发送到您的 RTDN 客户端。在此类
在这种情况下,用户应仍有权访问旧订阅的内容。