所有文章
深度解析阅读需 7 分钟

Google Play 的每次更新现在都必须使用 Play Billing Library 8,退款追踪也随之转到你的服务器上

Google 为 Play Billing Library 7 提供的延期已于 2026年11月1日到期,新应用和更新必须使用版本 8 或更高版本。版本 8 移除了 queryPurchaseHistory(),这意味着已退款和已消耗的购买必须在服务器端追踪。本文说明有哪些变化,以及迁移拖延的代价。

晨光中一位 Android 开发者的办公桌,桌上有笔记本电脑和手机,墙上日历圈出了一个日期,正是 Play Billing Library 8 成为 Google Play 更新最低要求的那一周

要点

  • Google 的弃用时间表将 2026年8月31日定为使用 Play Billing Library 7 发布新应用和更新的最后一天,延期于 2026年11月1日结束,因此现在任何 Google Play 更新都需要 Play Billing Library 8 或更高版本。
  • 已经在线上运行 Play Billing Library 7 的应用可以继续正常工作,因为 Google 表示弃用只会阻止新应用和更新,不影响现有安装。
  • Play Billing Library 8 移除了 queryPurchaseHistory(),Google 给出的替代方案在服务器端:在你自己的后端追踪已消耗的购买,并通过 Voided Purchases API 获取已退款或已取消的购买。
  • Google Play Voided Purchases API 只显示过去 30 天内的作废购买,每个应用每天最多 6,000 次查询,任意 30 秒内最多 30 次查询。
  • 如果应用在三天内没有确认某笔购买,Google Play 仍会自动退款并收回权益。一次失败的 Play Billing Library 8 迁移可能让每一笔销售都触发这一规则。
  • Google Play 的拒付审核是唯一会向开发者索取证据的 Android 退款流程,开发者需在收到 PendingRefundReviewNotification 后 24 小时内通过 orders.reviewrefund 作答。
  • 对于 2026年8月3日之后下的 Google Play 订单,每次拒付败诉,开发者都要承担购买价格(扣除 Play 的服务费)以及银行收取的拒付费用。

所有通过 Google Play 销售的 Android 应用,下一次更新现在都必须搭载 Play Billing Library 8 或更高版本。版本 7 针对新应用和更新的截止日期是 2026年8月31日,最后的延期也已于 2026年11月1日到期。这些日期列在 Google 弃用常见问题的一张表格中,提醒则以警告的形式出现在 Play Console 的“政策状态”页面上。

对大多数团队来说,这只是升级一个依赖,再改几个方法名。但对退款而言,影响不止于此。Play Billing Library 8 删除了唯一一个能让应用回看过往购买的客户端调用。从现在起,如果你想知道用户买了什么、消耗了什么、哪些被退款,就只能靠你的服务器记录。

Play Billing Library 8 截止日期实际阻止了什么

Google 给每个库版本两年的生命周期。弃用只会阻止新应用和更新。Google 的常见问题说明,现有应用仍可正常运行,不再维护的 APK 也无需更新。所以,对于你已经不再改动的应用,今天什么都不会坏。真正出问题的那天,是你想发布一个修复、一个新价格或一个新付费墙的时候。

库版本新应用和更新截止日期延期截止日期
62025年8月31日2025年11月1日
72026年8月31日2026年11月1日
82027年8月31日2027年11月1日
92028年8月31日2028年11月1日

版本 8.0.0 于 2025年6月30日发布。版本 9.0.0 于 2026年5月19日跟进。如果你现在开始迁移,直接升到 9 比停在 8 多出一年时间。

为什么 Play Billing Library 8 对退款很重要

最主要的移除是 queryPurchaseHistory()。它在版本 7 中被弃用,在版本 8.0.0 中被移除。Google 的迁移说明把它原来的职责拆成三部分,其中只有一部分留在设备上。

你以前用 queryPurchaseHistory() 做什么Google 现在建议用什么在哪里运行
有效和待处理的购买queryPurchasesAsync()设备上
已消耗的一次性购买你自己的记录你的服务器
已退款、已取消或被拒付的购买Voided Purchases API你的服务器
用户的完整购买历史你自己的记录你的服务器

在 Android 上还能恢复消耗型购买吗?

客户端做不到。queryPurchasesAsync() 只返回有效的购买,所以已消耗的点数包或用完的宝石礼包永远不会通过它返回。如果用户重装应用后问金币去哪了,答案只能来自购买发生时你留下的账本。那些把购买历史当作免费备份的应用,已经失去了这份备份。

现在怎么得知退款?

有两个服务器端渠道。实时开发者通知会发送 VoidedPurchaseNotification,其中包含购买令牌、订单 ID、商品类型,以及退款类型,退款类型要么是全额退款,要么是按数量的部分退款。Voided Purchases API 则可以按时间范围拉取同样的事件,作为补漏的后备手段。

这个拉取 API 有硬性限制。它只显示过去 30 天内的作废购买。每个应用每天 6,000 次查询,任意 30 秒内 30 次查询。而且,开发者发起但未勾选收回选项的退款根本不会返回。服务器宕机五周,就会丢失永远拉不回来的退款记录。

一位工程师拿着平板电脑站在安静的服务器机房过道里,Play Billing Library 8 移除客户端购买历史之后,已退款和已消耗的 Google Play 购买都必须记录在这里

哪些退款开发者仍有发言权

把退款追踪移到服务器上,并不会让你对退款有更多控制权。几乎所有 Google Play 退款都无需你参与就已决定:自助退款、客服退款、取消,以及未确认购买的自动退款。你只能事后通过作废购买通知得知。

例外是拒付审核。当买家提出一笔需要你提供意见的拒付时,Google 会发送 PendingRefundReviewNotification。Google 表示,你应在 24 小时内调用 orders.reviewrefund,给出退款建议和使用证据。这些证据正是来自新库迫使你保留的那些服务器记录。一个为恢复购买而维护账本的团队,已经具备了作答所需的一切。

迁移拖延在钱上的代价

直接风险是三天规则。如果你的应用在三天内没有确认某笔购买,Google Play 会自动退款并收回权益。对于待处理的购买,计时从购买状态由 PENDING 变为 PURCHASED 时开始。一次迁移如果破坏了连接逻辑、新的 queryProductDetailsAsync() 监听器或待处理购买的设置,就可能在销售照常进行的同时让确认停止。这段空窗期内的每一笔订单都会被全额退款,而用户已经拿到了他们付费购买的东西。

这才是痛处。被退款的图片点数包,每次生成背后的 GPU 时间已经烧掉了。被退款的 AI 套餐,付费 API 调用已经跑完了。被退款的存储档位,已经占满了你付费的磁盘。被退款的打赏,已经作为创作者分成发了出去。退款把收入还给买家,却把这些账单留给了你。

拒付的成本也更高了。Google 帮助中心表示,对于 2026年8月3日之后下的订单,开发者要承担购买价格(扣除 Play 的服务费),外加银行收取的拒付费用。Google 只继续承担它自己的服务费。一个无法在 24 小时内用真实使用数据回应拒付审核的应用,每次都要付清这整笔账单。

一份保护收入的迁移清单

  • 将依赖升级到 Play Billing Library 8 或 9,并移除 queryPurchaseHistory()、querySkuDetailsAsync() 以及无参数的 enablePendingPurchases()。
  • 更新你的 queryProductDetailsAsync() 监听器。从版本 8 开始,它还会返回无法获取的商品,并附带状态码。
  • 开启 enableAutoServiceReconnection(),这样计费连接断开时不会卡住购买处理。
  • 在 onResume() 中调用 queryPurchasesAsync(),让应用关闭期间完成的购买也能在三天内得到确认。
  • 在你的服务器上记录每个购买令牌、订单 ID 和消耗,并与你自己的账户 ID 关联。
  • 订阅实时开发者通知,并同时处理 VoidedPurchaseNotification 和 PendingRefundReviewNotification。
  • 每天运行一次 Voided Purchases API 同步作为安全网,确保远在 30 天窗口和每日 6,000 次查询配额之内。

RefundHalt 监听 Google Play 的作废购买和拒付审核通知,在 24 小时窗口内用你的真实使用数据通过 orders.reviewrefund 回应每一次审核,并保存你的应用再也无法向设备索取的退款历史。

常见问题解答

我现在必须使用 Play Billing Library 8 吗?
是的,任何通过 Google Play 结算销售的新应用或更新都必须使用。Google 的弃用时间表将 2026年8月31日定为版本 7 的截止日期,延期于 2026年11月1日结束。你可以使用版本 8,或更新的版本 9。
如果我的现有应用仍在使用 Play Billing Library 7,它会停止运行吗?
不会。Google 表示现有应用仍可正常运行,不再维护的 APK 也无需更新。弃用只会阻止你发布使用不受支持版本的新应用或更新。
在 Play Billing Library 8 中,queryPurchaseHistoryAsync 被什么取代了?
设备上没有任何调用能完成同样的工作。Google 建议用 queryPurchasesAsync() 处理有效和待处理的购买,在你自己的服务器上追踪已消耗的购买,并用 Voided Purchases API 处理已取消或已退款的购买。
Google Play Voided Purchases API 能回溯多久?
30 天。Google 表示该 API 只能显示过去 30 天内发生的作废购买,并限制每个应用每天 6,000 次查询,任意 30 秒内 30 次查询。
如果我的应用没有确认某笔购买,Google Play 会退款吗?
会。如果一笔购买在三天内未被确认,用户会自动获得退款,Google Play 也会收回该购买。对于待处理的购买,三天从状态由 PENDING 变为 PURCHASED 时开始计算。

来源和延伸阅读

RefundHalt

App Store 和 Google Play 退款自动驾驶

继续阅读

下一项退款请求已经在路上。

读完又一封关于未能申辩退款的支持邮件所需的时间,足够您完成 RefundHalt 设置。