所有文章
深度解析閱讀時間 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。