Subskrypcje i zakupy w aplikacji mobilnej — co sprawdzić przy przejęciu i utrzymaniu

Zakupy w aplikacji psują się bez awarii: płacący bez dostępu, dostęp bez płacenia, automatyczne zwroty w Google Play. Co sprawdzić w przejętej aplikacji, jakie terminy wycofania Billing Library i API sklepów obowiązują w 2026–2027 i ile kosztuje naprawa.

Zespół Mobilesoft· Engineering team· 21 listopada 2026· 9 min czytania

„Zapłaciłem za premium, a aplikacja dalej pokazuje wersję darmową”. „Anulowałam subskrypcję pół roku temu, a wszystko działa”. „Google zwrócił mi pieniądze, choć nic nie zgłaszałem”. Takie zgłoszenia rzadko trafiają do raportów awarii, bo aplikacja się nie zawiesza. Mimo to oznaczają realną stratę: albo klient płaci i nie dostaje usługi, albo dostaje usługę i nie płaci.

Zakupy w aplikacji i subskrypcje to część, która w przejmowanych projektach psuje się najciszej. Działa w niej kilka stron naraz: aplikacja, sklep, backend i powiadomienia wysyłane przez sklep. Błąd w jednym miejscu nie wywołuje awarii, tylko rozjazd między tym, co sklep wie o płatnościach, a tym, co aplikacja daje użytkownikowi. W tym tekście opisujemy, co sprawdzić w istniejącej aplikacji z płatnościami w sklepie, jakie terminy wycofania obowiązują w 2026 i 2027 roku i ile kosztuje doprowadzenie tej części do porządku.

Tekst dotyczy mechanizmów sklepów — Apple In-App Purchase i Google Play Billing — czyli sprzedaży treści i funkcji cyfrowych. Kiedy ich użycie jest obowiązkowe, a kiedy można wpiąć BLIK albo inną bramkę, opisaliśmy w artykule o płatnościach w aplikacji mobilnej.

Jak powinien wyglądać poprawny przepływ zakupu

Żeby ocenić, co jest zepsute, warto wiedzieć, jak wygląda wersja wzorcowa:

  1. Aplikacja uruchamia zakup przez Google Play Billing Library albo StoreKit.
  2. Sklep zwraca potwierdzenie transakcji — w Google Play jest to token zakupu, w StoreKit 2 podpisana transakcja w formacie JWS.
  3. Aplikacja wysyła je do backendu, który weryfikuje zakup w sklepie: przez Google Play Developer API albo App Store Server API (podpisaną transakcję z StoreKit 2 da się też zweryfikować lokalnie, sprawdzając podpis).
  4. Backend przyznaje dostęp i — w Google Play — potwierdza zakup (acknowledge).
  5. Sklep wysyła powiadomienia o odnowieniu, nieudanej płatności, anulowaniu i zwrocie: Google przez Real-time developer notifications (RTDN, przez Google Cloud Pub/Sub), Apple przez App Store Server Notifications. Backend na ich podstawie aktualizuje dostęp.
  6. Aplikacja umie przywrócić zakupy na nowym telefonie albo po reinstalacji.

Aplikacje bez własnego backendu robią kroki 3–5 wyłącznie na urządzeniu. Da się tak działać przy tanich, jednorazowych zakupach, ale przy subskrypcjach oznacza to, że aplikacja nie dowie się o zwrocie ani anulowaniu, dopóki użytkownik jej nie otworzy, a weryfikację na urządzeniu łatwiej obejść.

Co najczęściej znajdujemy w przejmowanych aplikacjach

Objaw Typowa przyczyna Skutek Użytkownik zapłacił, nie ma dostępu Błąd weryfikacji, brak przywracania zakupów, backend nie zapisał tokenu Złe oceny, zwroty, praca supportu Google Play sam zwraca pieniądze za zakupy Zakup nie został potwierdzony (acknowledge) w ciągu 3 dni Utracony przychód, zwykle niezauważony Dostęp działa po anulowaniu lub zwrocie Backend sprawdza status tylko przy zakupie, nie obsługuje powiadomień Usługa za darmo dla części użytkowników Nie da się wydać aktualizacji z płatnościami Nieobsługiwana wersja Google Play Billing Library Blokada wydań, także pilnych poprawek Powiadomienia nie dochodzą Adres w App Store Connect lub temat Pub/Sub wskazuje serwer poprzedniego wykonawcy Statusy subskrypcji przestają się aktualizować Nikt nie ma kluczy Klucze API sklepów i konto usługi Google Cloud założone na prywatnym koncie byłego dewelopera Nie da się zmienić weryfikacji bez odtwarzania dostępów

Szczególnie zdradliwy jest wiersz drugi. Google wymaga potwierdzenia każdego zakupu w ciągu trzech dni — inaczej zakup jest automatycznie zwracany, a uprawnienie cofnięte. Jeśli po aktualizacji biblioteki albo zmianie backendu potwierdzanie przestało działać, przychód znika bez żadnego błędu w aplikacji. Widać to dopiero w raportach finansowych w Play Console.

Wiersze piąty i szósty to typowy efekt rozstania z wykonawcą. Szerzej o odzyskiwaniu dostępów piszemy w tekście programista zniknął — co z aplikacją.

Terminy wycofania, które warto znać

Stan na listopad 2026 r.:

Element Status Termin Co się stanie Google Play Billing Library 7 i starsze wycofane 31.08.2026, przedłużenie do 1.11.2026 — minął Nowa wersja aplikacji z płatnościami nie zostanie przyjęta Google Play Billing Library 8 obsługiwana do 31.08.2027 (przedłużenie do 1.11.2027) Jak wyżej, za rok Play Developer API: subscriptions.get, refund, revoke (v1) wycofane od maja 2025 wyłączenie 31.08.2027 (przedłużenie do 1.11.2027) Backend przestanie odczytywać status subskrypcji; zamiennik to subscriptionsv2 Play Developer API: subscriptions.cancel, defer wycofane od maja 2026 wyłączenie 31.08.2028 Jak wyżej Apple verifyReceipt i App Store Server Notifications V1 wycofane od 2023 r. brak ogłoszonej daty wyłączenia Działają, ale bez nowych funkcji; zalecane App Store Server API i powiadomienia V2 Oryginalne API StoreKit (StoreKit 1) wycofane od 2024 r. brak daty wyłączenia Działa, ale nowe możliwości trafiają tylko do StoreKit 2 Walidacja paragonów na urządzeniu bez SHA-256 — od 24.01.2025 Walidacja kończy się błędem, aplikacja może odebrać dostęp płacącym

Billing Library ma stały, dwuletni cykl: każda wersja jest obsługiwana około dwóch lat od wydania, a tabelę terminów Google publikuje z wyprzedzeniem. To zwykle nie jest podbicie numeru — między głównymi wersjami zmienia się API i część kodu trzeba przepisać. Więcej o śledzeniu takich terminów piszemy w artykule o wycofanych SDK i API.

Po stronie Apple sytuacja jest spokojniejsza, bo stare API nadal działa. Nie warto jednak budować na nim nic nowego: przy pierwszej większej zmianie w zakupach lepiej od razu przejść na StoreKit 2 i App Store Server API.

Audyt zakupów w przejętej aplikacji — lista kontrolna

Jeśli aplikacja zarabia na subskrypcjach, ten przegląd warto zrobić w pierwszych tygodniach utrzymania, obok punktów z checklisty przejęcia projektu:

  • Produkty. Lista identyfikatorów produktów w App Store Connect i Play Console zgadza się z tym, co jest w kodzie. Nie ma produktów „martwych”, które ktoś wciąż może kupić.
  • Wersje bibliotek. Która wersja Google Play Billing Library, które API StoreKit, czy aplikacja korzysta z zewnętrznego SDK (np. RevenueCat, Adapty) i w jakiej wersji.
  • Miejsce weryfikacji. Na urządzeniu, na backendzie, czy u zewnętrznego dostawcy.
  • Powiadomienia. Dokąd wskazuje adres App Store Server Notifications i temat Pub/Sub dla RTDN. Czy ten serwer istnieje, czy jest Twój i czy faktycznie przetwarza zdarzenia.
  • Klucze i konta. Klucze In-App Purchase / App Store Server API, shared secret, konto usługi Google Cloud z dostępem do Play Console, konto u dostawcy SDK — na czyim koncie są i kto ma do nich dostęp.
  • Potwierdzanie zakupów w Google Play. Czy każdy zakup jest potwierdzany i co się dzieje, gdy backend jest chwilowo niedostępny.
  • Stany subskrypcji. Obsługa okresu karencji (grace period), zawieszenia (account hold), wstrzymania, zwrotu i zmiany planu.
  • Przywracanie zakupów. Działa na nowym urządzeniu i po zalogowaniu na inne konto w aplikacji.
  • Zgodność liczb. Liczba aktywnych subskrypcji w backendzie odpowiada raportom w sklepach. Różnica powyżej kilku procent to sygnał, że część zdarzeń ginie.

Ostatni punkt jest najtańszy i najwięcej mówi. Jeśli liczby się zgadzają, reszta zwykle działa. Jeśli nie — wiadomo, gdzie szukać.

Jak bezpiecznie zmieniać kod płatności

Zmiany w zakupach to obszar, w którym błąd kosztuje bezpośrednio pieniądze. Kilka zasad, które stosujemy:

  • Osobne wydanie. Aktualizacja Billing Library czy przejście na StoreKit 2 idzie w wersji bez innych zmian, żeby łatwo było wskazać przyczynę problemu.
  • Zgodność wstecz po stronie backendu. Stare wersje aplikacji jeszcze przez miesiące będą wysyłać dane w starym formacie, np. paragony zamiast transakcji JWS. Backend musi przez okres przejściowy obsługiwać oba — zasady opisaliśmy w tekście o zmianach w API a starych wersjach aplikacji.
  • Testy w środowiskach testowych sklepów. Apple Sandbox i StoreKit Testing w Xcode, w Google Play licencjonowani testerzy. W obu sklepach subskrypcje testowe odnawiają się w przyspieszonym tempie (miesięczna co kilka minut), więc da się przejść odnowienie, nieudaną płatność i wygaśnięcie w jedno popołudnie. Jak ułożyć testy w starej aplikacji, piszemy w artykule o testach aplikacji mobilnej.
  • Stopniowe wydanie i obserwacja. Nowa wersja najpierw dla części użytkowników, a w tym czasie porównanie liczby zakupów, odnowień i błędów weryfikacji z poprzednią. Do tego potrzebny jest monitoring awarii i logowanie zdarzeń zakupowych po stronie backendu.
  • Uzgodnienie po wydaniu. Kilka dni po wydaniu ponowne porównanie liczb z backendu i ze sklepów.

Własna integracja czy zewnętrzny dostawca

Część aplikacji korzysta z usług, które przejmują weryfikację, obsługę powiadomień i statystyki subskrypcji, np. RevenueCat czy Adapty. Przy przejęciu aplikacji warto świadomie zdecydować, czy to zostawić, czy zmienić.

Własna integracja Zewnętrzny dostawca Koszt wejścia Wyższy: backend, powiadomienia, obsługa stanów Niższy: SDK i konfiguracja Koszt bieżący Utrzymanie kodu i reagowanie na zmiany API sklepów Opłata, zwykle zależna od przychodu powyżej progu Zmiany API sklepów Po Twojej stronie Głównie po stronie dostawcy, ale SDK też trzeba aktualizować Dane U Ciebie U dostawcy, z eksportem i webhookami Ryzyko Błędy we własnym kodzie Zależność od dostawcy i jego cennika

Dla małej aplikacji z jedną subskrypcją zewnętrzny dostawca często wychodzi taniej. Przy dużym przychodzie albo nietypowych zasadach dostępu (np. subskrypcje firmowe przypisane do kont z panelu) bardziej opłaca się własny backend — o jego utrzymaniu piszemy w tekście backend aplikacji mobilnej: co się psuje. Niezależnie od wyboru konto u dostawcy powinno należeć do firmy, a nie do wykonawcy.

Ile to kosztuje

Zakres Orientacyjny nakład Przy stawce 180 zł netto/h Audyt zakupów i subskrypcji (kod, konfiguracja sklepów, klucze, powiadomienia, uzgodnienie liczb) 8–16 h ok. 1,4–2,9 tys. zł Aktualizacja Google Play Billing Library o jedną–dwie wersje 16–40 h ok. 2,9–7,2 tys. zł Przejście backendu na subscriptionsv2 16–40 h ok. 2,9–7,2 tys. zł Migracja na StoreKit 2 i App Store Server API 40–100 h ok. 7,2–18 tys. zł Weryfikacja na serwerze i obsługa powiadomień od zera, obie platformy 60–160 h ok. 10,8–28,8 tys. zł

Kwoty są orientacyjne i zależą od liczby produktów, rodzajów subskrypcji i stanu kodu. Stawka przykładowa — rzeczywisty koszt ustalamy po przeglądzie projektu. Dla porównania: jeśli potwierdzanie zakupów w Google Play przestanie działać, sklep zwróci pieniądze za każdą nową subskrypcję. Przy 200 nowych subskrypcjach miesięcznie po 30 zł to 6 tys. zł miesięcznie — tracone tak długo, aż ktoś zajrzy do raportów.

Podsumowanie

Zakupy w aplikacji psują się bez awarii, dlatego trzeba je sprawdzać celowo. Najpierw porównaj liczbę aktywnych subskrypcji w backendzie i w sklepach, potem sprawdź wersję Billing Library, miejsce weryfikacji, adresy powiadomień i to, na czyich kontach są klucze. Jeśli aplikacja używa Billing Library 7 lub starszej, nie wydasz już aktualizacji z płatnościami w Google Play — to pierwsza rzecz do naprawy. Następne terminy, wersja 8 i stare API subskrypcji Google, przypadają na sierpień 2027 r., więc najlepiej zaplanować je teraz, a nie w wakacje.

Porządkujemy płatności w przejmowanych aplikacjach w ramach przejęcia aplikacji mobilnej i utrzymania aplikacji mobilnych, a weryfikację po stronie serwera i obsługę powiadomień — w ramach usługi backend i API. Jeśli chcesz sprawdzić, czy Twoja aplikacja korzysta z aktualnych bibliotek i SDK, w tym Billing Library, zamów bezpłatną analizę aplikacji albo skontaktuj się z nami.