在日常业务中,您可能需要对订阅或单次购买执行管理操作。例如,您的客户服务可能需要为用户发放全额或部分退款,或者您可能需要在某些情况下撤消权益。您可以通过 Play 管理中心管理订单,也可以通过自己的系统进行管理,只需使用 Google Play Developer API 即可。
取消订阅
订阅取消可由用户或开发者发起。
用户发起的取消
用户可以随时通过 Play 商店取消 Google Play 订阅。如果适用,您还必须为用户提供一个在您的应用中和您的网站上取消订阅的选项。
要让用户能够主动取消订阅,最简单的方法是在应用中提供指向 Play 商店的深层链接,用户可以在其中查看和管理其订阅。
开发者发起的取消
作为开发者,您可能还需要从后端触发取消操作。
purchases.subscriptions.cancel API 可让您取消订阅购买交易。例如,您可以使用此方法来停用旧版服务。
取消订阅不会退款,用户在当前结算周期结束前仍可继续访问相关内容。
通过此方法,您可以在 cancellationType 请求正文参数中指定以下类型的取消:
USER_REQUESTED_STOP_RENEWALS:取消订阅,就像用户从 Play 商店取消订阅一样。在当前合约期的剩余时间内,您仍需继续支付所有分期付款。在 Play 商店中,用户可以在订阅到期之前恢复订阅,也可以在订阅到期后重新订阅(如果基础方案启用了此功能)。
DEVELOPER_REQUESTED_STOP_PAYMENTS:取消订阅并阻止任何进一步付款。用户无法通过 Play 商店恢复或重新订阅,但您可以在应用内允许他们重新订阅。
允许用户恢复未到期的订阅
在某些情况下,您可能会发现,在您作为开发者触发取消操作后,允许用户通过 Play 订阅中心恢复未到期的订阅会带来很多好处。例如,您可能希望提供自定义的应用内取消流程。您可以根据自己的业务逻辑,决定哪些由后端触发的取消操作可由用户恢复。
如需指明用户可以恢复取消,请向 purchases.subscriptions.cancel API 发出 POST 请求,并将 cancellationType 请求参数设置为 USER_REQUESTED_STOP_RENEWALS 值。
示例:
- 订阅
1a2b3c4d5e6f7g8h9i0j的购买令牌 - 应用软件包名称
com.your.app - 订阅 ID
your-subscription-product
HTTP POST 请求:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel
请求正文:
{
"cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}
允许用户重新订阅已过期的订阅
如需允许重新订阅已到期的订阅,您必须在订阅的基础方案中启用重新订阅选项,然后通过将 cancellationType 参数设置为 USER_REQUESTED_STOP_RENEWALS 值来取消订阅。
仅允许用户在您的应用中重新订阅
如果您已将 cancellationType 参数设置为 DEVELOPER_REQUESTED_STOP_PAYMENTS 或未设置 cancellationType 参数,用户将无法从 Play 订阅中心恢复其订阅。不过,用户可以根据需要通过您的应用重新注册订阅。
此操作会触发 SUBSCRIPTION_CANCELED 实时开发者通知。按照取消中的说明来处理这些取消事件。
延迟结算
您可以使用 subscriptionsv2.defer 方法延长订阅的权益期。当您推迟包含加购项的订阅时,订阅中的所有内容都会推迟相同的时长。在推迟期内,用户仍会订阅您的内容,但无需为额外的时间付费。当您推迟订阅结算时,状态信息会相应更新,您会在购买状态信息的 expiryTime 字段中看到此更新:
- 对于有效的定期订阅,延期结算会延长下一个续订日期。
- 对于预付费方案,推迟结算会延长到期时间。
下面列举了一些示例,说明如何使用延期结算:
- 将免费访问权限作为一种特别优惠提供给用户,如现有订阅者填写反馈问卷后可免费一周。
- 作为一项客户服务措施,向客户提供免费访问权限,例如在长时间的服务中断可能影响客户使用您的服务之后。
每次调用该 API,结算最短可推迟一天,最长为一年。 如需进一步推迟使用权结束日期,请在新的失效日期到来之前再次调用该 API。
此操作会触发 SUBSCRIPTION_DEFERRED 实时开发者通知。请参阅订阅简介中的为订阅者推迟结算,了解如何处理这些事件。
示例:
FitnessGoals 在线媒体服务希望在 2 月份开展一项促销活动,鼓励用户定期锻炼。
他们决定,如果订阅者在 2 月份使用 FitnessGoals 锻炼至少 10 次,就向其额外提供一个月的服务。
他们会跟踪挑战结果,并在 3 月 1 日为 2 月份完成挑战的用户所拥有的每笔有效订阅购买交易调用 subscriptionsv2.defer 方法。
这些用户可以免费多看一个月的常规健身视频,并且会告诉所有朋友 FitnessGoals 如何帮助他们保持健康!
发放退款和撤销购买交易
在许多情况下,您可能需要针对订阅或单次购买交易发放退款或撤消访问权限。
按订单 ID 为订单全额退款
借助 orders.refund API,您可以针对购买后三年内的任何订单办理全额退款。orders.refund 方法会接收一个撤消参数,该参数用于指明除了提供退款之外,是否还应撤消访问权限。
如果您在针对订阅购买交易发出退款调用时撤消了购买交易,则订阅会立即终止,并会同时触发 SUBSCRIPTION_REVOKED 实时开发者通知和 VoidedPurchaseNotification(记录在 Voided Purchases API 中)。请参阅订阅生命周期管理指南的撤消部分,了解如何处理这些事件。
示例:
为了庆祝新一届世界杯的开始,电子竞技应用 Football-Not-Soccer 决定为所有在前 24 小时内购买新队服的用户抽奖赠送免费虚拟球衣。
Football-Not-Soccer 使用
orders.refundAPI 向获胜者退还球衣购买款项,而不传递撤消参数。
按购买令牌撤消订阅并退款
在某些情况下,您可能需要撤消用户的订阅访问权限并提供退款。Play 结算服务通过 subscriptionsv2.revoke API 提供撤销方法,包括全额退款和按比例退款。通过此端点,您可以指定 revocationContext 来确定退款的计算方式。
执行此操作会同时触发 SUBSCRIPTION_REVOKED 实时开发者通知和 VoidedPurchaseNotification,并记录在 Voided Purchases API 中。您的应用应按照撤消中的说明来处理这些取消事件。
示例:
- 使用购买令牌
1a2b3c4d5e6f7g8h9i0j购买 - 软件包名称为
com.your.app的应用 - 按比例退款的意图
HTTP POST 请求:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke
请求正文:
{
"revocationContext": {
"proratedRefund": {}
}
}
全额退款
如果您需要终止订阅并退还当前结算周期的全额费用,请发放全额退款。使用 purchases.subscriptionsv2.revoke 函数,并将 "fullRefund": {} 设置为退款类型。
示例:
Maria 订阅了 SuperMovies 流媒体按月方案,该方案为自动续订型,有效期为 30 天。Maria 遇到了一些技术问题,导致她无法访问内容。她在结算周期的第 3 天联系客户服务,表示自己从未获得订阅权限。
客服人员在系统中找到 Maria 的订阅购买详情,并触发对
purchases.subscriptionsv2.revoke的调用,请求全额退款。客服人员告诉 Maria,她应该会获得 100% 的订阅价格退款,并且她不再订阅该方案。
按比例退款
如果您需要终止订阅并针对剩余的权利时间进行部分退款,请按比例退款。使用 purchases.subscriptionsv2.revoke 函数,并将 "proratedRefund": {} 设置为退款类型。
对于自动续订型订阅和时长至少为一周的预付费方案,均支持按比例退款。
示例:
Maria 订阅了 SuperMovies 流媒体按月方案,该订阅为自动续订型,有效期为 30 天。她已经愉快地使用这项服务一段时间了。 Maria 在其结算周期的第 15 天联系客户服务,表示她要搬到国外,从第二天起将无法再使用该服务。
客户服务人员在其系统中找到 Maria 的订阅购买详情,并触发对
purchases.subscriptionsv2.revoke的调用,请求按比例退款。客户服务人员告诉 Maria,她应该会收到大约 50% 的订阅价格退款,并且对服务的访问权限会立即终止。