Kwalifikujący się deweloperzy mogą oferować użytkownikom w niektórych krajach alternatywny system rozliczeniowy w aplikacji i zgłaszać Google wynikające z tego transakcje. W zależności od miejsca dystrybucji aplikacji i spełnienia wymagań możesz utworzyć 2 wersje rozliczeń alternatywnych:
- Rozliczenia alternatywne z opcją wyboru przez użytkownika: Twoja aplikacja oferuje rozliczenia alternatywne oprócz systemu rozliczeniowego Google Play.
- Rozliczenia alternatywne: Twoja aplikacja oferuje rozliczenia alternatywne, które mogą obejmować Płatności w Google Play (zgodnie z warunkami programu).
Ten przewodnik dotyczy interfejsów API, które należy używać w przypadku każdego z tych oferowanych rozwiązań. Przed użyciem tych interfejsów API zapoznaj się ze stronami programów i zarejestruj się w odpowiednich programach.
Słowniczek terminów
Konwencje terminologiczne stosowane w tym przewodniku:
- Interfejsy API do rozliczeń alternatywnych: interfejsy API używane do wyświetlania użytkownikom odpowiednich ekranów i umożliwiające deweloperom raportowanie transakcji zrealizowanych w alternatywnym systemie rozliczeniowym dewelopera.
- Alternatywny system rozliczeniowy: alternatywny system rozliczeniowy dewelopera, który może być oferowany oprócz systemu rozliczeniowego Google Play lub samodzielnie (zgodnie z wymaganiami).
- Transakcja zewnętrzna: transakcja, która ma miejsce poza systemem rozliczeniowym Google Play.
- Token transakcji zewnętrznej: token przekazywany deweloperowi przez Bibliotekę płatności w Play, którego deweloper może użyć, gdy użytkownik zrealizuje transakcję za pomocą alternatywnego systemu rozliczeniowego. Ten token służy do powiadamiania Google Play o udanym zakupie.
- Zewnętrzny identyfikator transakcji: unikalny identyfikator wygenerowany przez dewelopera w celu identyfikacji transakcji.
Oferowanie rozliczeń alternatywnych z opcją wyboru przez użytkowników
W tej sekcji opisujemy, jak oferować użytkownikom rozliczenia alternatywne z możliwością korzystania z systemu rozliczeniowego Google Play. Zanim zaczniesz korzystać z tych interfejsów API, upewnij się, że:
- Sprawdź wymagania kwalifikacyjne dotyczące odpowiednich programów i wykonaj czynności wstępne opisane w artykule System rozliczeniowy oparty na wyborze użytkownika w Google Play.
- Zintegruj Bibliotekę płatności w Play w wersji 5.2 lub nowszej.
Pozostałe zalecane moduły integracji z płatnościami w Google Play są takie same jak te, które deweloperzy mają już w przypadku obecnej integracji.
Zalecamy też przygotowanie integracji z interfejsem Google Play Developer API, ponieważ będzie ona wykorzystywana przez integrację backendu.
Konfigurowanie w Konsoli Play
Deweloperzy, którzy zarejestrowali się w odpowiednim programie rozliczeń alternatywnych z wyborem użytkownika i przeprowadzili integrację z interfejsami API do rozliczeń alternatywnych, mogą zarządzać ustawieniami rozliczeń alternatywnych w Konsoli Play:
- W przypadku każdej kwalifikującej się aplikacji możesz zdecydować, czy chcesz oferować alternatywny system rozliczeniowy.
- Prześlij logo form płatności zgodnie z wytycznymi, przestrzegając wszystkich specyfikacji formatu. Obrazy, które nie są zgodne z tymi wytycznymi, nie będą wyświetlane w przypadku Twojego alternatywnego systemu rozliczeniowego na ekranie wyboru użytkownika. (Uwaga: umieszczenie logo form płatności jest opcjonalne, ale zdecydowanie zalecane).
- Jeśli oferujesz subskrypcje, podaj wymagany link do zarządzania subskrypcjami.
Interfejs użytkownika
Interfejsy API po stronie klienta umożliwiają te funkcje:
- Google Play renderuje odpowiednie ekrany informacyjne i ekrany wyboru użytkownika oraz nimi zarządza.
- Jeśli użytkownik zdecyduje się skorzystać z systemu rozliczeniowego Google Play, proces rozliczeniowy będzie kontynuowany przy użyciu standardowego interfejsu rozliczeniowego Google Play.
Aplikacja dewelopera. |
Ekran wyboru płatności. |
Przykład służy wyłącznie do celów ilustracyjnych.
Ekran wyboru użytkownika
Na ekranie wyboru użytkownik może wybrać alternatywny system rozliczeniowy dewelopera lub system rozliczeniowy Google Play.
Anatomia opcji rozliczeń alternatywnych
Opcja rozliczeń alternatywnych na ekranie wyboru użytkownika zawiera te elementy interfejsu:
- Ikona aplikacji.
- Nazwa aplikacji.
- Element graficzny zawierający formy płatności oferowane przez dewelopera.
- Dodatkowy wskaźnik (element interfejsu i inne nie jest częścią komponentu z obrazem).
Komponent z obrazem dla form płatności
Pojedynczy komponent z obrazem składa się z wielu kart form płatności i musi spełniać specyfikacje określone w tych wytycznych.
Wymiary |
192 dp × 20 dp |
Odstępy między kartami |
8 dp |
Format pliku |
PNG, przezroczyste tło |
Warianty form płatności
Deweloperzy mogą wybrać liczbę ikon dostępnych form płatności, które chcą uwzględnić w komponencie z obrazem (maksymalnie 5).
Obraz nie powinien zawierać żadnych innych obrazów ani tekstu.
Specyfikacje karty
Karty form płatności uwzględnione w pliku z obrazem muszą być zgodne z tymi wytycznymi dotyczącymi rozmiaru, odstępów i stylu.
| Wymiary karty | 32 dp X 20 dp |
| Wewnętrzna wyściółka | 3 dni |
| Kontur | 1 dp (wewnętrzna linia jest uwzględniona w wymiarach), promień 2 dp, #E0E0E0 |
| Tło karty | Jednolity kolor (najlepiej biały) |
Dalsze kroki
Aby rozpocząć integrację interfejsów API rozliczeń alternatywnych z opcją wyboru przez użytkowników, zapoznaj się ze szczegółowymi przewodnikami dotyczącymi integracji w aplikacji i integracji backendu.
Oferowanie tylko rozliczeń alternatywnych
W tej sekcji opisujemy, jak oferować użytkownikom rozliczenia alternatywne. Zanim zaczniesz korzystać z tych interfejsów API, musisz spełnić te wymagania wstępne:
- Zapoznaj się z wymaganiami i zarejestruj się w jednym z programów rozliczeń alternatywnych.
- Zintegruj Bibliotekę płatności w Play w wersji 6.2.1 lub nowszej.
Zalecamy przygotowanie integracji z interfejsem Google Play Developer API, ponieważ na niej będzie opierać się integracja backendu.
Konfigurowanie w Konsoli Play
Deweloperzy, którzy ukończyli rejestrację i przeprowadzili integrację z interfejsami API do rozliczeń alternatywnych, mogą zarządzać ustawieniami rozliczeń alternatywnych w Konsoli Play:
- W przypadku każdej kwalifikującej się aplikacji możesz włączyć lub wyłączyć oferowanie wyłącznie rozliczeń alternatywnych (bez opcji wyboru przez użytkowników) w każdym dostępnym kraju.
Ekran z informacjami dla użytkowników
Ekran informacyjny pomaga użytkownikom zrozumieć, że w kwalifikującej się aplikacji oferowany jest tylko alternatywny system rozliczeniowy. Ekran informacyjny będzie wyświetlany użytkownikom na początku pierwszego zakupu w aplikacji po włączeniu rozliczeń alternatywnych. Ta wiadomość nie będzie wyświetlana przy kolejnych zakupach dokonywanych przez tego samego użytkownika w Twojej aplikacji na tym samym urządzeniu. Uwaga: w niektórych sytuacjach okno może być ponownie wyświetlane użytkownikowi, np. gdy wyczyści on pamięć podręczną na urządzeniu.
Dalsze kroki
Aby rozpocząć integrację interfejsów API do rozliczeń alternatywnych, zapoznaj się ze szczegółowymi przewodnikami dotyczącymi integracji w aplikacji i integracji backendu.