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

要点
- 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 也无需更新。所以,对于你已经不再改动的应用,今天什么都不会坏。真正出问题的那天,是你想发布一个修复、一个新价格或一个新付费墙的时候。
| 库版本 | 新应用和更新截止日期 | 延期截止日期 |
|---|---|---|
| 6 | 2025年8月31日 | 2025年11月1日 |
| 7 | 2026年8月31日 | 2026年11月1日 |
| 8 | 2027年8月31日 | 2027年11月1日 |
| 9 | 2028年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 次查询。而且,开发者发起但未勾选收回选项的退款根本不会返回。服务器宕机五周,就会丢失永远拉不回来的退款记录。

哪些退款开发者仍有发言权
把退款追踪移到服务器上,并不会让你对退款有更多控制权。几乎所有 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 时开始计算。
来源和延伸阅读
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
App Store 和 Google Play 退款自动驾驶