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łniania kryteriów kwalifikacji aplikacja może korzystać z 2 wersji rozliczeń alternatywnych:
- Rozliczenia alternatywne z wyborem użytkownika: Twoja aplikacja oferuje rozliczenia alternatywne oprócz systemu rozliczeniowego Google Play w regionach, w których jest to możliwe.
- Rozliczenia alternatywne: Twoja aplikacja oferuje alternatywny system rozliczeniowy, który może 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żdej z tych ofert. 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 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 Biblioteką płatności w Google Play są takie same jak w przypadku obecnej integracji deweloperów.
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 ma charakter wyłącznie ilustracyjny.
Ekran wyboru użytkownika
Ekran wyboru użytkownika przedstawia użytkownikom opcję korzystania z alternatywnego systemu rozliczeniowego dewelopera lub systemu rozliczeniowego Google Play.
Anatomia opcji rozliczeń alternatywnych
Opcja rozliczeń alternatywnych na ekranie wyboru użytkownika zawiera te elementy interfejsu:
- Ikona aplikacji.
- Nazwa aplikacji.
- Komponent z obrazem, który zawiera 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ętrzny obrys uwzględniony 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 alternatywnego systemu rozliczeniowego (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.
Ekran z informacjami dla użytkowników |
Przykład ma charakter wyłącznie ilustracyjny.
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.