Testowanie integracji Biblioteki płatności w Google Play

Integrację należy testować przez cały okres jej tworzenia. Aby przeprowadzić testy w fazie rozwoju, zalecamy skorzystanie z testerów licencjilaboratorium płatności w Google Play w celu przetestowania scenariuszy opisanych w tej sekcji.

Udzielenie licencji testerom

Informacje o konfigurowaniu testerów licencji znajdziesz w artykule Testowanie rozliczeń w aplikacji za pomocą licencjonowania.

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

  • Zwykle Biblioteka płatności Google Play jest blokowana w przypadku aplikacji, które nie są podpisane i przesłane do Google Play. Testerzy licencji mogą pominąć to sprawdzenie, co oznacza, że możesz instalować aplikacje z zewnętrznych źródeł na potrzeby testów, nawet w przypadku aplikacji korzystających z wersji debugowania z sygnaturami debugowania, bez konieczności przesyłania nowej wersji aplikacji. Pamiętaj, że nazwa pakietu musi być zgodna z nazwą aplikacji skonfigurowanej w Google Play, a konto Google musi być kontem testera licencji na koncie Konsoli Google Play.
  • Testerzy licencji mają dostęp do testowych form płatności, które pozwalają uniknąć obciążania ich rzeczywistymi środkami za zakupy. Możesz też używać testowych form płatności, aby symulować określone sytuacje, np. odrzucenie płatności. Na ilustracji 1 widać te testowe formy płatności w procesie 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 co rzeczywiste zakupy.
  • W przypadku zakupów testowych podatki nie są obliczane.
  • Google Play informuje o zakupie testowym, wyświetlając powiadomienie na środku okna zakupu.

Możesz sprawdzić konto, z którego dokonujesz zakupu, rozwijając okno zakupu. Uwaga:

  • Konta testowe muszą być na urządzeniu z Androidem należącym do testera.
  • Jeśli na urządzeniu jest więcej niż jedno konto, zakup jest dokonywany za pomocą konta, z którego pobrano aplikację.
  • Jeśli żadne z kont nie pobrało aplikacji, zakup zostanie dokonany na pierwszym koncie.

Przed udostępnieniem aplikacji możesz skorzystać z ścieżek testów w Google Play, aby przeprowadzić dodatkową weryfikację. Możesz na przykład wykorzystać ścieżki testów, aby zespół ds. kontroli jakości mógł sprawdzić nową wersję.

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

Aby przetestować integrację z Biblioteką płatności w Google Play za pomocą ścieżek testowych, wykonaj te czynności:

  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 będzie ona dostępna dla testerów.
  2. Upewnij się, że każdy tester wyraził zgodę na testowanie aplikacji. Na stronie z adresem URL przystąpienia do testów testerzy zobaczą wyjaśnienie, na czym polega ich zadanie, i będą mogli zgodzić się na udział w teście.

Integrację możesz przetestować na dowolnym urządzeniu z Androidem w wersji 1.6 lub nowszej. Na urządzeniu musi być zainstalowana najnowsza wersja aplikacji Google Play. Ogólne informacje o konfigurowaniu urządzenia do tworzenia aplikacji na Androida znajdziesz w artykule Korzystanie z urządzeń.

Laboratorium Płatności w Play

Laboratorium Płatności w Play to aplikacja na Androida, która pomaga deweloperom testować integrację z systemem rozliczeniowym Google Play. Umożliwia ona deweloperom łatwe i wygodne testowanie funkcji płatności, szybszą integrację i wdrażanie aplikacji z większym poczuciem pewności. Możesz pobrać i zainstalować Play Billing Lab ze Sklepu Play.

Aplikacja Play Billing Lab umożliwia w testach:

Panel Laboratorium Płatności w Play
Rysunek 2. Panel Laboratorium płatności w Play.

Testowanie produktów kupowanych raz

Testowanie produktów konsumpcyjnych

Podczas testowania produktów konsumpcyjnych sprawdź różne sytuacje, w tym:

  • udany zakup, w którym użytkownik otrzymuje produkt; W przypadku testera licencji możesz użyć formy płatności Test instrument, always approves (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. Jako tester licencji możesz używać formy płatności Instrument testowy, zawsze odrzuca.
  • Upewnij się, że produkty można kupić wiele razy.

Sprawdź, czy zakupy są prawidłowo potwierdzane zgodnie z opisem w sekcji Przetwarzanie zakupów. W przypadku zakupów od testerów licencji zwrot środków nastąpi po 3 minutach, jeśli aplikacja nie potwierdzi zakupu. Otrzymasz e-maila z informacją o anulowaniu. Możesz też sprawdzić, czy zamówienie zostało zwrócone po 3 minutach, na karcie Zamówienia w Konsoli Play Google.

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

Produkty niepodlegające konsumpcji należy testować tak samo jak produkty podlegające konsumpcji, ale musisz sprawdzić, czy nie można ich ponownie kupić w aplikacji. Pamiętaj, aby potwierdzić zakup zarówno w przypadku produktów niepodlegających konsumpcji, jak i podlegających konsumpcji (w stosownych przypadkach), ponieważ logika przetwarzania tych 2 rodzajów zakupów jest różna.

Testowanie oczekujących zakupów

Przetestuj oczekujący zakup, w przypadku którego produkt powinien zostać przyznany, gdy stan zakupu zmieni się na PURCHASED. Testerzy licencji mają dostęp do 2 narzędzi testowych do opóźnionych form płatności, w przypadku których płatność jest automatycznie realizowana lub anulowana po kilku minutach.

  1. Dokonaj zakupu z użyciem opóźnionej formy płatności Powolny test karty, odrzucenie następuje po kilku minutach, jak pokazano na rysunku 3. Uruchom ponownie aplikację i sprawdź, czy zakup nie został przyznany.

    testowanie zakupu za pomocą odrzuconej powolnej karty testowej;
    Rysunek 3. Przetestuj zakup za pomocą odrzuconej powolnej karty testowej.

  2. Dokonaj zakupu z użyciem opóźnionej formy płatności Slow test card, approves after a few minutes, jak pokazano na rysunku 4. Odczekaj kilka minut i sprawdź, czy zakup został przyznany.

    przetestować zakup za pomocą zatwierdzonej karty do testów o niskiej prędkości;
    Rysunek 4. Przeprowadź testowy zakup za pomocą zatwierdzonej powolnej karty testowej.

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

Testowanie funkcji dostępnych w ramach subskrypcji

Procesy zakupu produktów kupowanych raz i subskrypcji są podobne, ale w przypadku subskrypcji występują dodatkowe scenariusze, takie jak udane lub odrzucone odnowienia subskrypcji. Aby przetestować odnowienia, możesz użyć form płatności Karta testowa, zawsze zatwierdzaKarta testowa, zawsze odrzuca, które są dostępne dla testerów licencji, jak pokazano na ilustracji 1. Używaj tych instrumentów płatniczych do testowania scenariuszy innych niż scenariusz udanej subskrypcji.

Podobnie jak w przypadku produktów kupowanych raz, sprawdź, czy zakupy są prawidłowo potwierdzane zgodnie z opisem w sekcji Przetwarzanie zakupów. W przypadku zakupów od testerów licencji zwrot środków następuje po 3 minutach, jeśli aplikacja nie potwierdzi zakupu. Otrzymasz wtedy e-maila z informacją o anulowaniu. Możesz też sprawdzić, czy zamówienie zostało zwrócone po 3 minutach, na karcie Zamówienia w Konsoli Google Play.

Okresy odnowienia

Subskrypcje testowe odnawiają się szybciej niż rzeczywiste subskrypcje i mogą być odnawiane maksymalnie 6 razy, nie licząc bezpłatnych okresów próbnych i okresów wprowadzających.

W tabeli poniżej znajdziesz czasy odnowienia testów w przypadku subskrypcji o różnym czasie trwania. Podane czasy są przybliżone. Możesz zauważyć niewielkie różnice w dokładnym czasie wystąpienia zdarzenia. Aby zrekompensować zmienność, po każdej dacie wygaśnięcia subskrypcji wywołuj interfejs API, aby sprawdzić bieżący stan.

Okres subskrypcji produkcyjnej Odnowienie subskrypcji testowej
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 oparte na czasie, takie jak bezpłatne okresy próbne, są również skracane na potrzeby testów. W tabeli poniżej znajdziesz okresy testowe związane z funkcjami subskrypcji czasowych:

Funkcja Okres testowy
Potwierdzenie zakupu 5 minut
Bezpłatny okres próbny 3 minuty
Okres obowiązywania ceny początkowej Taki sam jak okres testowy subskrypcji
Okres prolongaty 5 minut
Zawieszenie konta 10 minut,
Wstrzymanie (1 miesiąc) 5 minut
Wstrzymanie (2 miesiące) 10 minut,
Wstrzymaj (3 miesiące) 15 minut

Przyspieszenie odnowienia

Możesz też użyć aplikacji Play Billing Lab i testerów licencji, aby przyspieszyć okresy odnowienia subskrypcji testowych, wykonując te czynności:

  1. Na panelu na karcie Ustawienia subskrypcji kliknij Zarządzaj.
  2. Wybierz aktywną subskrypcję, którą chcesz przetestować.
  3. Kliknij Odnów teraz.
odnów subskrypcję testową
Rysunek 5. Testowanie przyspieszenia okresu odnowienia subskrypcji.

Gdy klikniesz przycisk Odnów teraz, subskrypcja testowa zostanie wkrótce odnowiona.

Należy pamiętać, że:

  • Subskrypcje testowe muszą zostać potwierdzone przed użyciem funkcji przyspieszonego odnowienia, w przeciwnym razie zostaną anulowane.
  • Proces odnowienia może potrwać kilka sekund.
  • Przycisk Odnow teraz jest niedostępny, gdy obowiązuje zmiana ceny.
  • Gdy subskrypcja jest odnawiana, funkcja zmiany ceny subskrypcji jest niedostępna.

Oferty dotyczące okresu próbnego

Dzięki funkcji testowania ofert próbnych w Play Billing Lab tester licencji może testować i korzystać z bezpłatnych okresów próbnych lub ofert dla nowych użytkowników nieograniczoną liczbę razy. Wystarczy, że zaznaczy pole wyboru Przetestuj bezpłatny okres próbny lub ofertę dla nowych użytkowników i zastosuje zmianę. Dzięki temu nie musisz tworzyć wielu kont, aby przetestować ofertę próbną dostępną tylko dla nowych subskrybentów.

testować oferty dotyczące okresu próbnego,
Rysunek 6. Testuj oferty okresu próbnego.

zmiany cen.

Możesz też użyć Play Billing Lab i testerów licencji, aby przetestować zmiany cen subskrypcji bez wpływu na innych aktywnych subskrybentów. W tym celu wykonaj te czynności:

  1. Na panelu na karcie Ustawienia subskrypcji kliknij Zarządzaj.
  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.
testowanie zmiany ceny subskrypcji,
Rysunek 7. Przetestuj zmianę ceny subskrypcji.

Po wprowadzeniu zmian cena zostanie zaktualizowana od następnego odnowienia tylko w przypadku testera. Nie wpłynie to na innych aktywnych subskrybentów. Wszystkie reguły testerów licencji mają zastosowanie do subskrypcji testowej. Tester może następnie przetestować aplikację pod kątem procesów podrzędnych wywoływanych przez zmianę ceny, takich jak powiadomienia o zmianie ceny.

Podczas planowania okresów testowych pamiętaj o tych kwestiach:

  • Ze względu na krótki okres odnowienia w przypadku testerów licencji może się zdarzyć, że migracja ceny przeprowadzona w konsoli nie zostanie zarejestrowana w przypadku testerów licencji. Aby można było przetestować powiadomienia i e-maile o zmianie ceny, deweloperzy powinni odłożyć płatność o co najmniej godzinę po wywołaniu zmiany ceny.
  • Obniżki cen nie mają okresu powiadomienia. Użytkownicy zostaną powiadomieni o obniżeniu ceny wkrótce po migracji kohorty. Podczas testowania pozostaje bez zmian.
  • W przypadku podwyżek cen czas wysyłania powiadomień testowych jest obliczany tak samo jak w przypadku rzeczywistych podwyżek:
    • Pierwsza opłata jest pobierana w rocznicę pierwszej płatności po upływie obowiązkowego okresu powiadomienia.
    • Czas powiadomienia jest obliczany wstecz od daty pierwszej płatności.
    • Ostateczne powiadomienie jest zawsze wysyłane na minutę przed obciążeniem, niezależnie od okresu rozliczeniowego.

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

Rzeczywisty okres rozliczeniowy abonamentu podstawowego Testowy okres rozliczeniowy Okres powiadamiania o teście (regiony, w których obowiązuje zasada rezygnacji i włączenia, z 30-dniowym wyprzedzeniem) Okres powiadomienia o teście (regiony, w których można zrezygnować z udziału w teście, z 60-dniowym wyprzedzeniem)
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

Elementy testowania

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

Testowanie transakcji oczekujących

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

  1. Dokonaj zakupu z użyciem opóźnionej formy płatności Slow test card, declines after a few minutes, jak pokazano na rysunku 8. Uruchom ponownie aplikację i sprawdź, czy zakup nie został przyznany.

    testowanie zakupu za pomocą odrzuconej powolnej karty testowej;
    Rysunek 8. Przetestuj zakup za pomocą odrzuconej powolnej karty testowej.

  2. Dokonaj zakupu z opóźnioną formą płatności Powolny test karty, zatwierdzenie następuje po kilku minutach, jak pokazano na rysunku 9. Odczekaj kilka minut i sprawdź, czy zakup został przyznany.

    przetestować zakup za pomocą zatwierdzonej karty do testów o niskiej prędkości;
    Rysunek 9. Przeprowadź testowy zakup za pomocą zatwierdzonej powolnej karty testowej.

Testowanie kodów promocyjnych

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

Przetestuj te scenariusze wykorzystania kodu promocyjnego:

  • Gdy kod promocyjny zostanie wpisany w oknie zakupu, które zostało otwarte w aplikacji.
  • Gdy kod promocyjny zostanie wykorzystany w aplikacji Sklep Google Play.
  • Gdy kod promocyjny zostanie wykorzystany na stronie https://play.google.com/store za pomocą przycisku Wykorzystaj w menu po lewej stronie.

W ramach tych scenariuszy przetestuj wykorzystywanie kodów na jak najwięcej sposobów. Przeprowadź co najmniej te testy:

  • Wykorzystanie przed zainstalowaniem aplikacji.
  • Wykorzystanie podczas działania aplikacji na pierwszym planie. Pamiętaj, że do tego testu potrzebujesz innego urządzenia, na którym możesz przetestować aplikację Sklep Google Play. Sprawdź, czy kody można wykorzystać na różnych ekranach aplikacji.
  • Wykorzystanie w trybie wielu okien, w którym aplikacja i Sklep Google Play są wyświetlane jednocześnie.

W przypadku każdego testu upewnij się, że element jest prawidłowo wykrywany i że użytkownik otrzymuje powiadomienie.

Testowanie procesu zakupu w różnych regionach

Możesz przetestować proces zakupu z użyciem aplikacji Play Billing Lab lub bez niej:

Przetestuj za pomocą

Aplikacja na Androida Play Billing Lab umożliwia testowanie procesu zakupu w dowolnym regionie. Aby jednak korzystać z Play Billing Lab, musisz być testerem licencji. Aby przetestować, wykonaj te czynności:

  1. Zarejestruj użytkownika rozliczeń w aplikacji jako testera licencji.
  2. Zaloguj się w aplikacji Laboratorium Płatności w Play jako ten sam użytkownik.
  3. Wybierz odpowiedni kraj i zastosuj zmianę w Play Billing Lab.
  4. Uruchom proces zakupu w testowanej aplikacji.
testowanie procesu zakupu w różnych regionach,
Rysunek 10. Testowanie procesu zakupu w różnych regionach.

Test bez

Możesz też przetestować proces zakupu w dowolnym regionie bez korzystania z Play Billing Lab. Aby przeprowadzić test:

  1. Utwórz nowe konto Gmail. Konto można utworzyć w dowolnym kraju.
  2. Opcjonalnie możesz skonfigurować użytkownika jako testera licencji.
  3. Połącz się z usługą VPN w wybranym kraju, aby przeprowadzić test.
  4. Uruchom proces zakupu.

Możesz wyczyścić dane i pamięć podręczną Sklepu Play, a następnie powtórzyć kroki 3 i 4 w przypadku dowolnego kraju, który chcesz przetestować. Po przełączeniu się na nowy kraj musisz wyczyścić dane Sklepu Google Play, aby usunąć dane związane z poprzednim krajem.

Obie te metody testowania zakupów umożliwiają testowanie kwalifikowania się oferty w danym regionie i wrażeń użytkowników w dowolnym regionie, niezależnie od tego, gdzie fizycznie przeprowadzasz testy.

Testowanie procesu zakupu przy użyciu rzeczywistych form płatności

Możesz przetestować proces zakupu za pomocą rzeczywistych form płatności w aplikacji na Androida Laboratorium Płatności w Play.

Aby przetestować rzeczywiste formy płatności:

  1. Zarejestruj użytkownika konta Google jako testera licencji.
  2. Zaloguj się w aplikacji Laboratorium Płatności w Play jako ten sam użytkownik.
  3. Włącz rzeczywiste formy płatności w aplikacji Laboratorium Płatności w Play.
  4. Uruchom ponownie przepływ zakupu w testowanej aplikacji.