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 的退款自動駕駛