Wszystkie artykuły
Poradnik8 min czytania

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.

Mosiężny klucz na ciemnym biurku obok laptopa i telefonu, symbolizujący uprawnienia konta usługi Google Play, które kontrolują zwroty

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 ConsoleNa co pozwala według GoogleCzy może oddać pieniądze kupującym
View financial data, orders, and cancellation survey responsesWyświetlanie raportów finansowych, raportów sprzedaży i zamówień, dostęp do Purchases API, pobieranie odpowiedzi z ankiety o anulowaniuNie
Manage orders and subscriptionsWyświetlanie zamówień, zwracanie pieniędzy za zamówienia, anulowanie subskrypcjiTak
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 kluczKonto usługi Google Play z Manage orders and subscriptionsApple In-App Purchase key
Zwrócić pieniądze za zamówienieTak, za zamówienia do 3 lat wsteczNie, zwroty wystawia tylko Apple
Odciąć kupującemu dostępTak, przez revoke przy zwrocieNie
Anulować lub przedłużyć subskrypcjeAnulować, takPrzesunąć datę odnowienia o maksymalnie 90 dni, nieodwracalnie
Czytać dane o zakupachTak, z uprawnieniem do wyświetlaniaTak, historię transakcji i zwrotów
Odpowiadać na wnioski o zwrotTak, orders.reviewrefundTak, Send Consumption Information
Ograniczyć do jednej aplikacjiTak, przez uprawnienia na poziomie aplikacjiNie, 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.

Programista przy biurku odbiera dostęp na laptopie, na ścianie rząd kluczy na haczykach i jeden pusty haczyk, co ilustruje usuwanie uprawnień konta usługi Google Play

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.

ZadanieKonto usługi Google PlayApple In-App Purchase key
Kto może go utworzyćTworzone w Google Cloud, potem zapraszane w Play Console przez Users and permissionsAccount Holder lub Admin
Czy można ponownie pobrać sekretTworzysz nowy kluczNie, tylko jedno pobranie
Domyślne wygaśnięcieBrakBrak, dopóki go nie unieważnisz
Jak szybko odciąć dostępUsuń klucz w IAM albo usuń konto w Play ConsoleUnieważnij klucz w App Store Connect
Skutki uboczne odcięcia dostępuKażde narzędzie używające tego konta przestaje wywoływać APIOferty 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

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ć.