Testowanie integracji Biblioteki płatności w Google Play

Integrację należy testować na etapie programowania. Jeśli chcesz przeprowadzać testy na etapie programowania, skorzystaj z pomocy testerów licencji i Laboratorium płatności w Google Play, aby przetestować scenariusze opisane w tej sekcji.

Udzielenie licencji testerom

Aby skonfigurować testerów licencji, przeczytaj artykuł Testowanie rozliczeń w aplikacji z użyciem licencjonowania aplikacji.

Korzystanie z testerów licencji przynosi te korzyści:

  • Zwykle Biblioteka płatności w Google Play jest blokowana w przypadku aplikacji, które nie są podpisane ani przesłane do Google Play. Testerzy licencji mogą pominąć tę kontrolę, co oznacza, że możesz instalować aplikacje z innego urządzenia do testowania, nawet jeśli używasz kompilacji do debugowania z podpisami debugowania bez konieczności przesyłania ich do nowej wersji aplikacji. Pamiętaj, że nazwa pakietu musi odpowiadać nazwie aplikacji skonfigurowanej na potrzeby Google Play, a konto Google musi mieć przypisaną licencję na konto w Konsoli Google Play.
  • Testerzy licencji mają dostęp do testowych form płatności, które pozwalają im uniknąć pobierania prawdziwych pieniędzy za zakupy. Testowych form płatności możesz też używać do symulowania pewnych sytuacji, takich jak odrzucenie płatności. Rysunek 1 przedstawia testowe formy płatności, które pojawiają się w trakcie procesu zakupu.
  • Testerzy licencji mogą szybko testować funkcje subskrypcji.
testerzy licencji mają dostęp do testowych form płatności
Rysunek 1. Testerzy licencji mają dostęp do testowych form płatności.

Oto dodatkowe informacje o procesie zakupu testowego:

  • Zakupy testowe korzystają z tego samego procesu zakupu w aplikacji, który jest używany w przypadku rzeczywistych zakupów.
  • W przypadku zakupów testowych podatki nie są obliczane.
  • Google Play wskazuje zakup testowy, wyświetlając powiadomienie na środku okna zakupu.

Aby potwierdzić konto, na którym dokonano zakupu, rozwiń okno zakupu. Uwaga:

  • Konta testowe muszą być zarejestrowane na urządzeniu z Androidem, z którego korzysta test.
  • Jeśli na urządzeniu jest więcej niż 1 konto, zakupu dokonujesz za pomocą konta, z którego pobrano aplikację.
  • Jeśli aplikacja nie została pobrana na żadne z tych kont, zakup jest dokonywany na pierwszym koncie.

Zanim zaczniesz rozpowszechniać aplikację, możesz przeprowadzić dodatkową weryfikację za pomocą ścieżek testowych w Google Play. Za pomocą ścieżek testów możesz na przykład umożliwić swojemu zespołowi ds. kontroli jakości kwalifikowanie nowej wersji.

Dzięki ścieżkom testów użytkownicy mogą zainstalować aplikację z Google Play i przetestować jej wersję, która nie jest jeszcze dostępna publicznie. Użytkownicy mogą dokonywać prawdziwych zakupów, korzystając z dowolnej formy płatności w Google Play.

Aby przetestować integrację Biblioteki płatności w Google Play za pomocą ścieżek testów:

  1. Opublikuj aplikację na ścieżce testów. Pamiętaj, że po opublikowaniu aplikacji na ścieżce testów może minąć kilka godzin, zanim stanie się ona dostępna dla testerów.
  2. Upewnij się, że każdy tester zgodził się na udział w testach aplikacji. Pod adresem URL przystąpienia do testów testerzy widzą wyjaśnienie, na czym polega rola testera, wraz z linkiem do modułu zgody na udział w teście.

Możesz przetestować integrację na dowolnym urządzeniu z Androidem 1.6 lub nowszym. Na urządzeniu musi być zainstalowana najnowsza wersja Google Play. Ogólne informacje o konfigurowaniu urządzenia pod kątem tworzenia aplikacji na Androida znajdziesz w sekcji Korzystanie ze sprzętu.

Laboratorium płatności w Play

Laboratorium płatności Play to aplikacja na Androida, która pomaga deweloperom w testowaniu integracji z systemem rozliczeniowym Google Play. Umożliwia deweloperom łatwe i wygodne testowanie funkcji płatności, szybszą integrację i większą pewność uruchomienia aplikacji. Laboratorium płatności w Play możesz pobrać i zainstalować ze Sklepu Play.

Laboratorium Płatności w Google Play pozwala na wykonanie tych czynności:

Panel modułu Płatności w Play
Rys. 2. w panelu modułu Płatności w Play.

Testowanie produktów kupowanych raz

Testowanie produktów konsumpcyjnych

Podczas testowania produktów konsumpcyjnych zalecamy przetestowanie różnych sytuacji, między innymi:

  • Udany zakup, w ramach którego użytkownik otrzymuje produkt. Dzięki testerowi licencji możesz użyć formy płatności Instrument testowy, zawsze zatwierdza.
  • Zakup, w przypadku którego nie udało się obciążyć formy płatności, a użytkownik nie powinien otrzymać produktu. Dzięki testerowi licencji możesz użyć instrumentu testowego, który zawsze odrzuca.
  • Upewnij się, że produkty można kupować wiele razy.

Sprawdź też, czy zakupy są prawidłowo potwierdzone, co opisano w sekcji Przetwarzanie zakupów. Jeśli aplikacja nie potwierdzi zakupu, po 3 minutach otrzymasz zwrot środków za zakupy u testerów licencji i otrzymasz e-maila z informacją o anulowaniu. Możesz też sprawdzić na karcie Zamówienia w Konsoli Google Play, czy po 3 minutach zwrócono środki za zamówienie.

Testowanie produktów, które się nie zużywają

Niezużywane materiały należy testować tak samo jak materiały eksploatacyjne, ale pamiętaj, aby sprawdzić, czy produktu nie można ponownie kupić w aplikacji. Potwierdź potwierdzenie zakupu zarówno w przypadku materiałów nieprzeznaczonych, jak i konsumpcyjnych (w odpowiednich przypadkach), ponieważ zasady przetwarzania obu typów zakupów różnią się.

Przetestuj oczekujące zakupy

Musisz przetestować oczekujący zakup, w ramach którego produkt powinien zostać przyznany, gdy stan zakupu zmieni się na PURCHASED. W przypadku opóźnionych form płatności testerzy licencji mają dostęp do 2 narzędzi testowych, przy czym płatność zostaje automatycznie zrealizowana lub anulowana po kilku minutach.

  1. Dokonanie zakupu przy użyciu formy płatności opóźnionej „Karta powolna, odrzuca się po kilku minutach”, jak widać na rysunku 2. Uruchom aplikację ponownie i sprawdź, czy zakup nie został przyznany.

    Testowanie zakupu z odrzuconą, powolną kartą testową
    Rysunek 3. Przetestuj zakup przy użyciu odrzuconej karty testowej.

  2. Dokonanie zakupu przy użyciu opóźnionej formy płatności „Powolny test karty, zatwierdzanie po kilku minutach”, jak widać na rysunku 3. Zaczekaj kilka minut, a potem sprawdź, czy zakup został zrealizowany.

    Testowanie zakupu za pomocą zatwierdzonej karty testu powolnego testu
    Rysunek 4. Przetestuj zakup za pomocą zatwierdzonej karty do spowolnienia testów.

Więcej informacji znajdziesz w artykule Obsługa transakcji oczekujących.

Testowanie funkcji związanych z subskrypcją

Proces zakupu jednorazowych produktów i subskrypcji jest podobny, ale w przypadku subskrypcji istnieją dodatkowe scenariusze, takie jak pomyślne lub odrzucone odnowienie subskrypcji. Aby przetestować odnawianie licencji, możesz użyć opcji Instrument testowy, zawsze zatwierdza i Instrument testowy, zawsze odrzuca formy płatności dostępne dla testerów licencji, jak pokazano na ilustracji 1. Używaj tych instrumentów płatniczych, aby testować scenariusze wykraczające poza skuteczny scenariusz dotyczący subskrypcji.

Podobnie jak w przypadku produktów kupowanych raz, musisz też sprawdzić, czy zakup został prawidłowo potwierdzony, co opisano w sekcji Przetwarzanie zakupów. Jeśli aplikacja nie potwierdzi zakupu, po 3 minutach otrzymasz zwrot środków za zakupy u testerów licencji. Otrzymasz też e-maila z informacją o anulowaniu. Możesz też sprawdzić na karcie Zamówienia w Konsoli Google Play, czy po 3 minutach zwrócono środki za zamówienie.

Okresy odnowienia

Subskrypcje testowe odnawiają się szybciej niż rzeczywiste subskrypcje. Można je odnowić maksymalnie 6 razy (nie wliczając bezpłatnych okresów próbnych ani okresów początkowych).

W tabeli poniżej znajdziesz okresy odnowienia subskrypcji o różnym czasie trwania. Podane czasy są podane w przybliżeniu. Możesz zauważyć drobne różnice w dokładnym czasie zdarzenia. W celu skompensowania odmiany wywołaj interfejs API w celu wyświetlenia bieżącego stanu po upływie każdej daty wygaśnięcia subskrypcji.

Okres subskrypcji produkcyjnej Testuj odnawianie subskrypcji
1 tydzień 5 minut
1 miesiąc 5 minut
3 miesiące 10 minut,
6 miesięcy 15 minut
1 rok 30 minut,

Funkcje subskrypcji zależne od czasu, takie jak bezpłatne okresy próbne, również są skracane do celów testowych. W tej tabeli podano okresy testowania powiązane z funkcjami subskrypcji na podstawie czasu:

Funkcja Okres testowy
Potwierdzenie zakupu 5 minut
Bezpłatny okres próbny 3 minuty
Okres obowiązywania ceny dla nowych subskrybentów Taki sam jak w okresie testowania subskrypcji
Okres prolongaty (3 i 7 dni) 5 minut
Zawieszenie konta 10 minut,
Wstrzymaj (1 miesiąc) 5 minut
Wstrzymaj (2 miesiące) 10 minut,
Wstrzymaj (3 miesiące) 15 minut

Oferty okresu próbnego

Dzięki funkcji testowania oferty w ramach wersji próbnej w Laboratorium płatności w Play testerzy licencji mogą testować i używać bezpłatnych wersji próbnych lub ofert dla nowych użytkowników nieograniczoną liczbę razy. Aby to zrobić, zaznacz pole wyboru „Przetestuj bezpłatny okres próbny lub ofertę dla nowych użytkowników” i zastosuj zmianę. Dzięki temu nie musisz tworzyć wielu kont, aby testować ofertę próbną dostępną tylko dla nowych subskrybentów.

oferty okresu próbnego
Rysunek 5. Przetestuj oferty okresu próbnego.

zmiany cen.

Możesz też używać Laboratorium Płatności w Play i testerów licencji do testowania zmian cen subskrypcji bez wpływu na innych aktywnych subskrybentów. Aby to zrobić:

  1. Kliknij Zarządzaj na karcie Ustawienia subskrypcji w Panelu.
  2. Wybierz aktywną subskrypcję, którą chcesz przetestować.
  3. Wpisz nową cenę.
  4. Zaznacz lub odznacz pole wyboru Rezygnacja użytkownika zgodnie z wymaganiami testu.
  5. Kliknij Zastosuj.
zmiana ceny subskrypcji testowej
Rysunek 6. Zmiana ceny subskrypcji testowej.

Po zastosowaniu zmian cena zostanie zaktualizowana od następnego odnowienia tylko dla testera. Nie będzie to miało wpływu na innych aktywnych subskrybentów. W przypadku subskrypcji testowej będą stosowane wszystkie reguły dotyczące testerów licencji. Tester może następnie przetestować swoją aplikację pod kątem dalszych procesów wywoływanych przez zmianę ceny, takich jak powiadomienia o zmianie ceny.

Planując okresy testów, pamiętaj o tych kwestiach:

  • Ze względu na krótki okres odnowienia testerów licencji migracja cen dokonana za pomocą konsoli może się nie zarejestrować. Aby przetestować powiadomienia i e-maile o zmianie cen, deweloperzy powinni odroczyć płatności co najmniej o godzinę od aktywacji zmiany ceny.
  • O obniżkach cen nie ma okresu powiadomienia. Użytkownicy są powiadamiani o obniżce ceny zaraz po migracji kohorty. Nie zmienia się podczas testowania.
  • W przypadku wzrostu cen czas powiadomień testowych jest obliczany tak samo jak przy rzeczywistych wzrostach:
    • Użytkownik jest po raz pierwszy obciążany w pierwszej rocznicy rozliczenia po upływie obowiązkowego okresu powiadomienia.
    • Czasy powiadomień są obliczane wstecz od daty pierwszego obciążenia.
    • Ostateczne powiadomienie jest zawsze 1 minutę przed obciążeniem, niezależnie od okresu rozliczeniowego.

W tabeli poniżej znajdziesz okresy rozliczeniowe i okresy powiadomień w kilku rzeczywistych okresach rozliczeniowych:

Rzeczywisty okres rozliczeniowy abonamentu podstawowego Testowy okres rozliczeniowy Okres powiadamiania o testach (regiony, w których można udostępniać lub zrezygnować z udostępniania informacji z 30-dniowym wyprzedzeniem) Okres powiadamiania o testach (regiony z możliwością rezygnacji po upływie 60 dni)
1 tydzień 5 minut 5 minut 10 minut,
1 miesiąc 5 minut 5 minut 10 minut,
3 miesiące 10 minut, 3 minuty 6 minut
6 miesięcy 15 minut 2 minuty 4 minuty
1 rok 30 minut, 3 minuty 6 minut

Przypadki testowe

Rozwiń poniższą sekcję, klikając Pokaż/Ukryj, aby wyświetlić scenariusze testowania, których należy użyć do zweryfikowania integracji subskrypcji.

Przetestuj transakcje oczekujące

Musisz przetestować oczekujące transakcje, które są obsługiwane prawidłowo, a uprawnienia są odpowiednio aktualizowane, gdy stan zakupu zmieni się na PURCHASED. Testerzy licencji mają dostęp do 2 narzędzi testowych w przypadku opóźnionych form płatności, przy czym płatność zostaje automatycznie zrealizowana lub anulowana po kilku minutach.

  1. Dokonanie zakupu przy użyciu formy płatności opóźnionej „Karta powolna, odrzuca się po kilku minutach”, jak widać na rysunku 2. Uruchom aplikację ponownie i sprawdź, czy zakup nie został przyznany.

    Testowanie zakupu z odrzuconą, powolną kartą testową
    Rysunek 2. Przetestuj zakup przy użyciu odrzuconej karty testowej.

  2. Dokonanie zakupu przy użyciu opóźnionej formy płatności „Powolny test karty, zatwierdzanie po kilku minutach”, jak widać na rysunku 3. Zaczekaj kilka minut, a potem sprawdź, czy zakup został zrealizowany.

    Testowanie zakupu za pomocą zatwierdzonej karty testu powolnego testu
    Rysunek 3. Przetestuj zakup za pomocą zatwierdzonej karty do spowolnienia testów.

Przetestuj kody promocyjne

W Konsoli Google Play możesz utworzyć kody do własnych testów. Pamiętaj, że możesz utworzyć tylko 500 kodów promocyjnych na kwartał na wszystkie produkty zarządzane w aplikacji.

Przetestuj te scenariusze wykorzystania kodów promocyjnych:

  • gdy wpiszesz kod promocyjny w oknie zakupu otwartym w aplikacji.
  • wykorzystanie kodu promocyjnego w aplikacji Sklep Google Play.
  • Wykorzystaj kod promocyjny na https://play.google.com/store za pomocą przycisku Zrealizuj kod w panelu nawigacyjnym po lewej stronie.

W takich sytuacjach przetestuj wykorzystanie kodów na jak najwięcej sposobów. Zalecamy wykonanie co najmniej tych testów:

  • Wykorzystanie przed zainstalowaniem aplikacji.
  • Wykorzystanie, gdy aplikacja działa na pierwszym planie. Aby przeprowadzić ten test w aplikacji Sklep Google Play, potrzebujesz innego urządzenia. Pamiętaj, by przetestować oferty wykorzystane na różnych ekranach w aplikacji.
  • Wykorzystanie w trybie wielu okien, w którym aplikacja i aplikacja Sklep Google Play wyświetlają się w tym samym czasie.

W przypadku każdego testu upewnij się, że element został poprawnie wykryty, a użytkownik został o tym powiadomiony.

Testowanie wrażeń zakupowych w różnych regionach

Laboratorium Płatności w Play i testerzy licencji umożliwiają też testowanie procesu zakupu w dowolnym regionie bez konieczności posiadania rzeczywistej formy płatności w danym kraju. Aby to sprawdzić:

  1. Zarejestruj użytkownika rozliczeń aplikacji jako testera licencji.
  2. Zaloguj się w Laboratorium płatności w Google Play za pomocą tego samego użytkownika.
  3. Wybierz kraj i zastosuj zmianę w Laboratorium płatności w Play.
  4. Uruchom proces zakupu w testowanej aplikacji.
testowanie procesu zakupu w różnych regionach
Rysunek 7. Przetestuj proces zakupów w różnych regionach.

Ta metoda testowania zakupów pozwala sprawdzić, czy oferta jest dostępna w danym regionie i czy jest odpowiednia dla użytkowników w każdym regionie, niezależnie od miejsca, w którym przeprowadzasz testy.