Uprawnienia konta usługi Google Play decydują, kto może zwracać pieniądze za Twoje zamówienia, więc nadaj najwęższy zestaw, który działa
Jedno uprawnienie w Play Console pozwala kontu usługi zwrócić pieniądze za dowolne zamówienie i anulować dowolną subskrypcję. Wyjaśniamy, jakich uprawnień konta usługi Google Play naprawdę potrzebują narzędzia do zwrotów, co wyciekły klucz może zrobić w każdym sklepie oraz jak ograniczać, rotować i unieważniać klucze.

Najważniejsze wnioski
- Uprawnienie Google Play Manage orders and subscriptions (zarządzanie zamówieniami i subskrypcjami) pozwala przeglądać zamówienia, zwracać za nie pieniądze i anulować subskrypcje, więc każde konto usługi, które je ma, może oddać pieniądze Twoim kupującym.
- Przewodnik Google po Play Developer API mówi, że Google Play Billing API wymagają dwóch uprawnień Play Console: View financial data, orders, and cancellation survey responses oraz Manage orders and subscriptions.
- Metoda orders.refund w Google Play Developer API może zwrócić pieniądze za każde zamówienie zakupu jednorazowego lub subskrypcji nie starsze niż 3 lata, a przy revoke ustawionym na true natychmiast odcina kupującemu dostęp.
- Klucze kont usługi Google Cloud domyślnie nie wygasają, a Google podaje, że klucz zatwierdzony w repozytorium kodu trzeba usunąć w IAM, bo usunięcie go z repozytorium nie wystarczy.
- In-App Purchase key od Apple nie może wystawiać zwrotów, ale może wywoływać App Store Server API, w tym endpointy, które przesuwają datę odnowienia subskrypcji o maksymalnie 90 dni, a Apple podaje, że takiego przedłużenia nie da się cofnąć.
- Tylko Account Holder lub Admin może wygenerować In-App Purchase key w App Store Connect, klucz prywatny pobiera się tylko raz, a unieważnionego klucza nie można przywrócić.
Daj jednemu kontu usługi dwa uprawnienia w Play Console, a będzie mogło zwrócić pieniądze za dowolne zamówienie w Twojej aplikacji. To nie jest błąd konfiguracji. Dokładnie tak Google zbudował Google Play Developer API i właśnie dlatego klucz JSON Twojego narzędzia do zwrotów zasługuje na taką samą ostrożność jak dane logowania do banku.
Większość zespołów konfiguruje to raz, pod presją terminu, zaznaczając wszystko, co sprawiło, że pierwsze wywołanie API się powiodło. Ten poradnik idzie w drugą stronę. Pokazuje, jakich uprawnień konta usługi Google Play naprawdę wymaga obsługa zwrotów i chargebacków, na co każdy sklep pozwala skradzionemu kluczowi i jak ograniczyć zasięg szkód.
Na co naprawdę pozwalają uprawnienia konta usługi Google Play
Konto usługi to użytkownik-robot. Tworzysz je w Google Cloud, a potem zapraszasz jego adres e-mail w Play Console w sekcji Users and permissions (użytkownicy i uprawnienia), tak jak zaprosiłbyś współpracownika. Od tej chwili może robić wszystko, na co pozwalają te uprawnienia, przez API, o każdej porze i bez drugiego składnika uwierzytelniania.
Dwa uprawnienia, których wymagają API rozliczeniowe
Przewodnik Google po Play Developer API jest tu konkretny. Aby korzystać z Google Play Billing API, nadajesz dwa uprawnienia: View financial data, orders, and cancellation survey responses (wyświetlanie danych finansowych, zamówień i odpowiedzi z ankiety o anulowaniu) oraz Manage orders and subscriptions. Pierwsze pozwala kontu czytać zamówienia i korzystać z Purchases API. Drugie to to, które dotyka pieniędzy.
| Uprawnienie Play Console | Na co pozwala według Google | Czy może oddać pieniądze kupującym |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Wyświetlanie raportów finansowych, raportów sprzedaży i zamówień, dostęp do Purchases API, pobieranie odpowiedzi z ankiety o anulowaniu | Nie |
| Manage orders and subscriptions | Wyświetlanie zamówień, zwracanie pieniędzy za zamówienia, anulowanie subskrypcji | Tak |
| Admin (wszystkie uprawnienia) | Wszystkie pozostałe uprawnienia, a także zapraszanie użytkowników i zmiana ich uprawnień | Tak, i może nadać sobie więcej |
Co może klucz z prawem do zwrotów
Metoda orders.refund w Google Play Developer API zwraca pieniądze za zamówienie subskrypcji lub zakupu w aplikacji. Google podaje, że za zamówienia starsze niż 3 lata nie można zwrócić pieniędzy, co oznacza, że za wszystkie nowsze można. Ustaw revoke na true, a dostęp kupującego zostanie natychmiast odcięty. W przypadku subskrypcji to samo robi purchases.subscriptionsv2.revoke z pełnym zwrotem.
To właściwe narzędzia, gdy używasz ich celowo. Własne wytyczne Google dotyczące oszustw każą zwrócić pieniądze i unieważnić zakup, który nie przeszedł Twoich kontroli, zamiast czekać, aż minie termin. Problemem jest klucz, który może to zrobić dla każdej aplikacji na Twoim koncie, choć potrzebował tylko jednej.
Ile pieniędzy może Cię kosztować wyciek klucza
Policz to, zanim zdecydujesz, ile wysiłku warto w to włożyć. W Google Play klucz z Manage orders and subscriptions może zwracać pieniądze za zamówienia jedno wywołanie po drugim, a każdy zwrot oddaje kwotę sprzedaży kupującemu. Skrypt się nie męczy. Górną granicą jest Twoja historia zamówień z ostatnich 3 lat.
Koszty, które nie wracają razem ze zwrotem
Zwrot cofa sprzedaż. Nie cofa tego, co wydałeś na jej obsługę. Ten wydatek zostaje w Twoich księgach, niezależnie od tego, czy zwrot był decyzją klienta, czy atakującego.
- Już zużyta moc obliczeniowa: czas GPU i serwerów za każdym wygenerowaniem, renderem czy odpowiedzią modelu, które otrzymał kupujący.
- Już opłacone wywołania API: opłaty za zapytanie u dostawców modeli, map, rozpoznawania mowy lub danych.
- Przechowywanie, za które nadal płacisz: pliki i historia, które te konta wciąż trzymają na Twoich serwerach.
- Już wysłane wypłaty: wypłaty dla twórców, partnerów afiliacyjnych lub sprzedawców związane z tymi zakupami nie wracają razem ze zwrotem.
Po stronie Apple wygląda to inaczej
App Store Server API od Apple nie ma endpointu, który wystawia zwrot. O zwrotach decyduje Apple. Ale ten sam In-App Purchase key może przesunąć datę odnowienia subskrybenta o maksymalnie 90 dni, dwa razy w ciągu 365 dni na klienta, albo dla wszystkich aktywnych subskrybentów produktu jednym zbiorczym zapytaniem. Apple podaje, że przedłużenia nie da się cofnąć. Przez te dni subskrybent nie płaci, a nadal korzysta z Twojej aplikacji, więc rachunki za moc obliczeniową, przechowywanie i API rosną bez żadnego przychodu.
| Co może skradziony klucz | Konto usługi Google Play z Manage orders and subscriptions | Apple In-App Purchase key |
|---|---|---|
| Zwrócić pieniądze za zamówienie | Tak, za zamówienia do 3 lat wstecz | Nie, zwroty wystawia tylko Apple |
| Odciąć kupującemu dostęp | Tak, przez revoke przy zwrocie | Nie |
| Anulować lub przedłużyć subskrypcje | Anulować, tak | Przesunąć datę odnowienia o maksymalnie 90 dni, nieodwracalnie |
| Czytać dane o zakupach | Tak, z uprawnieniem do wyświetlania | Tak, historię transakcji i zwrotów |
| Odpowiadać na wnioski o zwrot | Tak, orders.reviewrefund | Tak, Send Consumption Information |
| Ograniczyć do jednej aplikacji | Tak, przez uprawnienia na poziomie aplikacji | Nie, klucz działa we wszystkich aplikacjach Twojego zespołu |
Jak ograniczyć uprawnienia konta usługi Google Play
Play Console rozdziela uprawnienia na poziomie konta od uprawnień na poziomie aplikacji. Uprawnienia na poziomie aplikacji dotyczą tylko wybranych przez Ciebie aplikacji. To jedno ustawienie robi dla Twojego bezpieczeństwa więcej niż cokolwiek innego na tej liście.
Nadawaj uprawnienia do jednej aplikacji, nie do całego konta
Zapraszaj każde konto usługi z uprawnieniami na poziomie aplikacji tylko do aplikacji, które obsługuje. Narzędzie do zwrotów dla jednej gry nie potrzebuje praw do zwrotów w Twojej aplikacji do medytacji. Jedna pułapka: View financial data, orders, and cancellation survey responses istnieje tylko na poziomie konta, a jego odpowiednik na poziomie aplikacji nazywa się View financial data. Ograniczając uprawnienia, wybierz wersję na poziomie aplikacji.
Oddziel odczyt od zwrotów
Nie każde zadanie potrzebuje Manage orders and subscriptions. Analityka, która tylko czyta zamówienia, może działać na koncie z prawami do wyświetlania i niczym więcej. Klucz z prawem do zwrotów trzymaj tylko w tej jednej usłudze, która faktycznie wywołuje orders.refund, orders.reviewrefund lub endpointy revoke.
Nigdy nie dawaj robotowi uprawnienia Admin
Admin nadaje wszystkie uprawnienia, a Google wymienia wśród jego praw zapraszanie użytkowników i zarządzanie ich uprawnieniami. Wyciekły klucz z Admin może poszerzyć własny dostęp albo zaprosić kogoś nowego. Żaden proces zwrotów go nie potrzebuje.
Pytaj dostawców, jak się łączą
Niektóre narzędzia proszą o przesłanie klucza JSON. Inne dają Ci adres e-mail własnego konta usługi do zaproszenia, więc żaden Twój klucz nigdy nie wychodzi spod Twojej kontroli, a ich dostęp usuniesz w Users and permissions jednym kliknięciem. Jeśli dostawca potrzebuje praw do zwrotów, zapytaj, jakich uprawnień, do których aplikacji i dlaczego.

Jak przechowywać, rotować i unieważniać klucze
Oba sklepy mówią to samo innymi słowami. Nie trzymaj kluczy w repozytorium kodu i nie dołączaj ich do aplikacji. Różnice zaczynają się wtedy, gdy coś pójdzie nie tak.
Klucze Google Cloud same nie wygasają
Wytyczne Google Cloud zaznaczają, że klucze kont usługi domyślnie nie mają daty wygaśnięcia. Google zaleca regularną rotację i wyłączanie kluczy, których już nie używasz. Jeśli klucz trafi do repozytorium, Google każe jak najszybciej usunąć go w IAM, bo usunięcie go z repozytorium nie wystarczy. Google Cloud może też automatycznie wyłączać wykryte wyciekłe klucze, gdy ograniczenie Service Account Key Exposure Response jest ustawione na DISABLE_KEY, ale nie gwarantuje, że wychwyci każdy wyciek.
Klucze Apple pobiera się raz i unieważnia na zawsze
Tylko Account Holder lub Admin może wygenerować In-App Purchase key. Apple przechowuje część publiczną, Ty pobierasz prywatny plik .p8 tylko raz, a Apple nie zachowuje kopii. Jeśli podejrzewasz, że klucz został przejęty, Apple każe natychmiast unieważnić go w App Store Connect w sekcji Users and Access, Integrations, In-App Purchase. Unieważnionego klucza nie można przywrócić, a unieważnienie wstrzymuje też realizację ofert promocyjnych nim podpisanych, więc zaktualizuj te oferty przed unieważnieniem lub zaraz po nim.
| Zadanie | Konto usługi Google Play | Apple In-App Purchase key |
|---|---|---|
| Kto może go utworzyć | Tworzone w Google Cloud, potem zapraszane w Play Console przez Users and permissions | Account Holder lub Admin |
| Czy można ponownie pobrać sekret | Tworzysz nowy klucz | Nie, tylko jedno pobranie |
| Domyślne wygaśnięcie | Brak | Brak, dopóki go nie unieważnisz |
| Jak szybko odciąć dostęp | Usuń klucz w IAM albo usuń konto w Play Console | Unieważnij klucz w App Store Connect |
| Skutki uboczne odcięcia dostępu | Każde narzędzie używające tego konta przestaje wywoływać API | Oferty promocyjne nim podpisane przestają być realizowane |
Krótka lista kontrolna
- Jedno konto usługi na jedno zadanie, zaproszone z uprawnieniami na poziomie aplikacji tylko do aplikacji, które obsługuje.
- Manage orders and subscriptions tylko na koncie, które naprawdę zwraca pieniądze, unieważnia zakupy lub odpowiada na wnioski o zwrot.
- Żadnego uprawnienia Admin na żadnym koncie-robocie.
- Klucze w menedżerze sekretów, nigdy w repozytorium, logu kompilacji ani aplikacji mobilnej.
- Spisana lista wszystkich kluczy, kto je utworzył i która usługa ich używa, aby unieważnienie nie zepsuło Twoich odpowiedzi w sprawie zwrotów.
- Przegląd Users and permissions w Play Console i kluczy w App Store Connect za każdym razem, gdy ktoś odchodzi z zespołu lub rezygnujesz z dostawcy.
Często zadawane pytania
- Jakich uprawnień Play Console potrzebuje konto usługi do obsługi zwrotów i chargebacków?
- Potrzebuje Manage orders and subscriptions, aby zwracać pieniądze za zamówienia, anulować subskrypcje i pracować z zamówieniami, a także dostępu do wyświetlania zamówień. Przewodnik Google po Play Developer API wymienia View financial data, orders, and cancellation survey responses oraz Manage orders and subscriptions jako dwa uprawnienia wymagane przez Google Play Billing API.
- Czy konto usługi Google Play może zwracać pieniądze za zamówienia?
- Tak, jeśli ma uprawnienie Manage orders and subscriptions. Strona pomocy Google podaje, że to uprawnienie pozwala przeglądać zamówienia, zwracać za nie pieniądze i anulować subskrypcje, a metoda API orders.refund zwraca pieniądze za każde zamówienie nie starsze niż 3 lata.
- Czy ktoś z moim In-App Purchase key z App Store może zwrócić pieniądze moim klientom?
- Nie. App Store Server API nie ma endpointu do zwrotów, bo o zwrotach decyduje Apple. Skradziony klucz nadal może jednak czytać historię transakcji i zwrotów, wysyłać informacje o wykorzystaniu i przesuwać daty odnowienia subskrypcji o maksymalnie 90 dni, czego według Apple nie da się cofnąć.
- Czy klucze kont usługi Google Play wygasają?
- Domyślnie nie. Wytyczne Google Cloud mówią, że utworzone i pobrane klucze nie mają daty wygaśnięcia, chyba że ją skonfigurujesz, i zalecają regularną rotację kluczy oraz wyłączanie tych, których już nie używasz.
- Co zrobić, jeśli klucz JSON mojego konta usługi trafił na GitHub?
- Natychmiast usuń klucz w Google Cloud IAM i utwórz nowy. Google podaje, że usunięcie klucza z repozytorium nie wystarczy, bo każdy, kto go skopiował, może go używać, dopóki sam klucz nie zostanie usunięty.
Źródła i materiały dodatkowe
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
RefundHalt
Autopilot zwrotów dla App Store i Google Play
Czytaj dalej
Brazylia sprawdza, które gry wciąż sprzedają lootboksy dzieciom, a rachunek trafia do zwrotów za lootboksy
Brazylijskie ministerstwo sprawiedliwości poprosiło organ ochrony danych o monitorowanie sześciu gier, które sprzedają lootboksy bez weryfikacji wieku. Oto czego wymaga prawo, czego już wymagają Apple i Google oraz jak wyceniać i obsługiwać zwroty za lootboksy, gdy skrzynka jest już otwarta.
Przypadkowe zakupy w aplikacji to zwroty, których nie wygrasz. Rozwiązanie należy do ekranu zakupu
Przypadkowe zakupy w aplikacji wracają w obu sklepach jako zwroty, a żadne dane o użyciu nie dowodzą, że dotknięcie było zamierzone. Wyjaśniamy, jak Apple i Google je oznaczają, ile kosztują Cię w mocy obliczeniowej i wypłatach oraz jaki projekt ekranu zakupu zatrzymuje je, zanim powstanie obciążenie.