Wszystkie artykuły
Szczegółowa analiza7 min czytania

Play Billing Library 8 jest teraz wymagana przy każdej aktualizacji w Google Play i przenosi śledzenie zwrotów na Twój serwer

Przedłużenie, które Google dawał dla Play Billing Library 7, wygasło 1 listopada 2026 r., więc nowe aplikacje i aktualizacje potrzebują wersji 8 lub nowszej. Wersja 8 usunęła queryPurchaseHistory(), dlatego zwrócone i zużyte zakupy trzeba śledzić po stronie serwera. Oto co się zmieniło i ile kosztuje powolna migracja.

Biurko programisty Androida w porannym świetle z laptopem, telefonem i kalendarzem ściennym z zakreśloną datą, w tygodniu, w którym Play Billing Library 8 stała się minimum dla aktualizacji w Google Play

Najważniejsze wnioski

  • Tabela wycofywania wersji Google wyznaczyła 31 sierpnia 2026 r. jako ostatni dzień dla nowych aplikacji i aktualizacji z Play Billing Library 7, a przedłużenia skończyły się 1 listopada 2026 r. Każda aktualizacja w Google Play wymaga teraz Play Billing Library 8 lub nowszej.
  • Aplikacje, które już działają na Play Billing Library 7, nadal działają. Google podaje, że wycofanie blokuje tylko nowe aplikacje i aktualizacje, a nie istniejące instalacje.
  • Play Billing Library 8 usunęła queryPurchaseHistory(), a zamiennik zaproponowany przez Google działa na serwerze: śledź zużyte zakupy we własnym backendzie, a zwrócone lub anulowane pobieraj z Voided Purchases API.
  • Google Play Voided Purchases API pokazuje tylko unieważnione zakupy z ostatnich 30 dni i pozwala na 6000 zapytań dziennie oraz 30 zapytań w dowolnym 30-sekundowym okresie na aplikację.
  • Google Play nadal automatycznie zwraca pieniądze za zakup i odbiera uprawnienie, jeśli aplikacja nie potwierdzi go w ciągu trzech dni. Nieudana migracja do Play Billing Library 8 może wywołać to przy każdej sprzedaży.
  • Weryfikacja obciążenia zwrotnego w Google Play to jedyny proces zwrotów na Androidzie, w którym deweloper może przedstawić dowody, przez orders.reviewrefund w ciągu 24 godzin od PendingRefundReviewNotification.
  • Przy zamówieniach w Google Play złożonych po 3 sierpnia 2026 r. deweloper przy każdym przegranym obciążeniu zwrotnym płaci cenę zakupu pomniejszoną o opłatę serwisową Play oraz opłaty banku za obciążenie zwrotne.

Każda aplikacja na Androida, która sprzedaje przez Google Play, musi przy następnej aktualizacji dostarczyć Play Billing Library 8 lub nowszą. Termin wersji 7 dla nowych aplikacji i aktualizacji minął 31 sierpnia 2026 r., a ostatnie przedłużenia wygasły 1 listopada 2026 r. Daty są w tabeli w FAQ Google o wycofywaniu wersji, a przypomnienia pojawiają się jako ostrzeżenia na stronie Stan zgodności z zasadami w Play Console.

Dla większości zespołów to podbicie wersji zależności i kilka metod o nowych nazwach. W przypadku zwrotów to coś więcej. Play Billing Library 8 usunęła jedyne wywołanie po stronie klienta, które pozwalało aplikacji zajrzeć do wcześniejszych zakupów. Od teraz, jeśli chcesz wiedzieć, co użytkownik kupił, zużył albo za co dostał zwrot, musi to zapamiętać Twój serwer.

Co faktycznie blokuje termin Play Billing Library 8

Google daje każdej wersji biblioteki dwa lata życia. Wycofanie zatrzymuje tylko nowe aplikacje i aktualizacje. Według FAQ Google istniejące aplikacje nadal działają, a nieutrzymywane pliki APK nie wymagają aktualizacji. Dla aplikacji, której już nie ruszasz, dziś nic się nie psuje. Psuje się w dniu, w którym chcesz wydać poprawkę, nową cenę albo nowy paywall.

Wersja bibliotekiTermin dla nowych aplikacji i aktualizacjiTermin przedłużenia
631 sierpnia 2025 r.1 listopada 2025 r.
731 sierpnia 2026 r.1 listopada 2026 r.
831 sierpnia 2027 r.1 listopada 2027 r.
931 sierpnia 2028 r.1 listopada 2028 r.

Wersja 8.0.0 ukazała się 30 czerwca 2025 r. Wersja 9.0.0 pojawiła się 19 maja 2026 r. Jeśli migrujesz teraz, przejście od razu na 9 daje Ci rok więcej niż zatrzymanie się na 8.

Dlaczego Play Billing Library 8 ma znaczenie dla zwrotów

Najważniejsze usunięcie to queryPurchaseHistory(). Metoda została oznaczona jako przestarzała w wersji 7 i usunięta w wersji 8.0.0. Notatki migracyjne Google dzielą jej dawną rolę na trzy części i tylko jedna z nich zostaje na urządzeniu.

Do czego używałeś queryPurchaseHistory()Co Google zaleca terazGdzie to działa
Aktywne i oczekujące zakupyqueryPurchasesAsync()Na urządzeniu
Zużyte zakupy jednorazoweTwoje własne rejestryTwój serwer
Zakupy zwrócone, anulowane lub cofnięte obciążeniem zwrotnymVoided Purchases APITwój serwer
Pełna historia zakupów użytkownikaTwoje własne rejestryTwój serwer

Czy nadal mogę przywracać zakupy jednorazowego użytku na Androidzie?

Nie po stronie klienta. queryPurchasesAsync() zwraca to, co jest aktywne, więc zużyty pakiet kredytów czy wykorzystany zestaw klejnotów nigdy przez nią nie wróci. Jeśli użytkownik przeinstaluje aplikację i zapyta, gdzie są jego monety, odpowiedź musi pochodzić z rejestru, który prowadziłeś w chwili zakupu. Aplikacje, które traktowały historię zakupów jako darmową kopię zapasową, właśnie ją straciły.

Jak teraz dowiaduję się o zwrotach?

Przez dwa kanały po stronie serwera. Real-time developer notifications wysyłają VoidedPurchaseNotification z tokenem zakupu, identyfikatorem zamówienia, typem produktu i typem zwrotu, który oznacza pełny zwrot albo częściowy zwrot zależny od ilości. Voided Purchases API pozwala pobrać te same zdarzenia według przedziału czasu, jako zabezpieczenie na wypadek, gdyby coś Ci umknęło.

API typu pull ma twarde ograniczenia. Pokazuje tylko unieważnione zakupy z ostatnich 30 dni. Każda aplikacja dostaje 6000 zapytań dziennie i 30 zapytań w dowolnym 30-sekundowym okresie. A zwrot wykonany przez dewelopera bez opcji cofnięcia uprawnienia w ogóle się tam nie pojawia. Serwer, który nie działa przez pięć tygodni, traci zwroty, których nigdy już nie pobierze.

Inżynier z tabletem w cichej alejce serwerowni, gdzie zwrócone i zużyte zakupy z Google Play trzeba teraz zapisywać, odkąd Play Billing Library 8 usunęła historię zakupów po stronie klienta

W których zwrotach deweloper ma jeszcze coś do powiedzenia

Przeniesienie śledzenia zwrotów na serwer nie daje Ci większej kontroli nad zwrotami. Niemal każdy zwrot w Google Play zapada bez Twojego udziału: zwroty samoobsługowe, zwroty przez pomoc techniczną, anulowania i automatyczne zwroty za niepotwierdzone zakupy. Dowiadujesz się o nich po fakcie, z powiadomienia o unieważnionym zakupie.

Wyjątkiem jest weryfikacja obciążenia zwrotnego. Gdy kupujący składa wniosek o obciążenie zwrotne, który wymaga Twojego stanowiska, Google wysyła PendingRefundReviewNotification. Według Google należy w ciągu 24 godzin odpowiedzieć sugestią co do zwrotu i dowodami użycia, wywołując orders.reviewrefund. Te dowody pochodzą z tych samych rejestrów na serwerze, które i tak musisz prowadzić przez nową bibliotekę. Zespół, który prowadzi rejestr do przywracania zakupów, ma już wszystko, czego potrzebuje do odpowiedzi.

Ile kosztuje powolna migracja

Bezpośrednim ryzykiem jest zasada trzech dni. Google Play automatycznie zwraca pieniądze za zakup i odbiera uprawnienie, jeśli Twoja aplikacja nie potwierdzi go w ciągu trzech dni. W przypadku oczekujących zakupów czas zaczyna biec, gdy zakup przechodzi z PENDING do PURCHASED. Migracja, która psuje logikę połączenia, nowy listener queryProductDetailsAsync() albo konfigurację oczekujących zakupów, może zatrzymać potwierdzenia, nie zatrzymując sprzedaży. Każde zamówienie w tej luce zostaje zwrócone w całości, a użytkownik już dostał to, za co zapłacił.

Właśnie tu boli. Zwrócony pakiet kredytów na obrazy i tak zużył czas GPU za każdym wygenerowaniem. Zwrócony plan AI i tak wykonał płatne wywołania API. Zwrócony poziom przestrzeni dyskowej i tak zapełnił dyski, za które płacisz. Zwrócony napiwek i tak trafił do wypłaty dla twórcy. Zwrot oddaje przychód kupującemu, a te rachunki zostawia Tobie.

Obciążenia zwrotne też podrożały. Według centrum pomocy Google przy zamówieniach złożonych po 3 sierpnia 2026 r. deweloper pokrywa cenę zakupu pomniejszoną o opłatę serwisową Play oraz opłaty banku za obciążenie zwrotne. Google płaci już tylko własną opłatę serwisową. Aplikacja, która nie potrafi w ciągu 24 godzin odpowiedzieć na weryfikację obciążenia zwrotnego prawdziwymi danymi o użyciu, za każdym razem płaci cały ten rachunek.

Lista kontrolna migracji, która chroni przychody

  • Podnieś zależność do Play Billing Library 8 lub 9 i usuń queryPurchaseHistory(), querySkuDetailsAsync() oraz bezargumentowe enablePendingPurchases().
  • Zaktualizuj listener queryProductDetailsAsync(). Od wersji 8 zwraca on także produkty, których nie udało się pobrać, wraz z kodem stanu.
  • Włącz enableAutoServiceReconnection(), aby zerwane połączenie z usługą płatności nie wstrzymywało przetwarzania zakupów.
  • Wywołuj queryPurchasesAsync() w onResume(), aby zakupy zakończone przy zamkniętej aplikacji i tak zostały potwierdzone w ciągu trzech dni.
  • Zapisuj na serwerze każdy token zakupu, identyfikator zamówienia i każde zużycie, powiązane z Twoim własnym identyfikatorem konta.
  • Zasubskrybuj Real-time developer notifications i obsługuj zarówno VoidedPurchaseNotification, jak i PendingRefundReviewNotification.
  • Jako zabezpieczenie uruchamiaj codzienną synchronizację z Voided Purchases API, z dużym zapasem w ramach 30-dniowego okna i dziennego limitu 6000 zapytań.

RefundHalt odbiera powiadomienia Google Play o unieważnionych zakupach i weryfikacjach obciążeń zwrotnych, odpowiada na każdą weryfikację przez orders.reviewrefund w 24-godzinnym oknie z Twoimi prawdziwymi danymi o użyciu i przechowuje historię zwrotów, o którą Twoja aplikacja nie może już zapytać urządzenia.

Często zadawane pytania

Czy muszę teraz używać Play Billing Library 8?
Tak, przy każdej nowej aplikacji lub aktualizacji, która sprzedaje przez system płatności Google Play. Tabela wycofywania wersji Google wyznaczyła 31 sierpnia 2026 r. jako termin dla wersji 7, a przedłużenia skończyły się 1 listopada 2026 r. Możesz użyć wersji 8 albo nowszej wersji 9.
Czy moja istniejąca aplikacja przestanie działać, jeśli nadal używa Play Billing Library 7?
Nie. Google podaje, że istniejące aplikacje nadal działają, a nieutrzymywane pliki APK nie wymagają aktualizacji. Wycofanie blokuje tylko publikację nowej aplikacji lub aktualizacji, która używa nieobsługiwanej wersji.
Co zastąpiło queryPurchaseHistoryAsync w Play Billing Library 8?
Nic na urządzeniu nie wykonuje tej samej pracy. Google zaleca queryPurchasesAsync() dla aktywnych i oczekujących zakupów, śledzenie zużytych zakupów na własnym serwerze oraz Voided Purchases API dla zakupów anulowanych lub zwróconych.
Jak daleko wstecz sięga Google Play Voided Purchases API?
30 dni. Według Google API może pokazać tylko unieważnione zakupy z ostatnich 30 dni i ogranicza każdą aplikację do 6000 zapytań dziennie oraz 30 zapytań w dowolnym 30-sekundowym okresie.
Czy Google Play zwraca pieniądze za zakup, jeśli moja aplikacja go nie potwierdzi?
Tak. Jeśli zakup nie zostanie potwierdzony w ciągu trzech dni, użytkownik automatycznie dostaje zwrot, a Google Play cofa zakup. W przypadku oczekujących zakupów trzy dni liczą się od zmiany stanu z PENDING na PURCHASED.

Źródła i materiały dodatkowe

RefundHalt

Autopilot zwrotów dla App Store i Google Play

Czytaj dalej

Kolejny wniosek o zwrot jest już w drodze.

Skonfiguruj RefundHalt w czasie potrzebnym na przeczytanie kolejnej wiadomości od pomocy technicznej o zwrocie, którego nie udało Ci się zakwestionować.