Kwalifikujący się deweloperzy mogą oferować użytkownikom w określonych krajach alternatywny system rozliczeniowy w swoich aplikacjach i zgłaszać uzyskane transakcje do Google. W zależności od tego, gdzie rozpowszechniasz aplikację i jakie spełniasz wymagania, w aplikacji można utworzyć 2 wersje rozliczeń alternatywnych:
- Płatności alternatywne z możliwością wyboru przez użytkownika: aplikacja oprócz systemu rozliczeniowego Google Play udostępnia też rozliczenia alternatywne.
- Tylko rozliczenia alternatywne (tj. bez opcji wyboru przez użytkownika): aplikacja oferuje alternatywny system rozliczeniowy bez opcji Płatności w Google Play.
W tym przewodniku omawiamy interfejsy API, które powinny być używane w każdej z tych ofert. Zanim skorzystasz z tych interfejsów API, zapoznaj się z stronami programu i zarejestruj się w odpowiednich programach.
Słowniczek terminów
Konwencje terminów stosowane w tym przewodniku:
- Interfejsy API rozliczeń alternatywnych: interfejsy API służące do wyświetlania użytkownikom odpowiednich ekranów i umożliwiania deweloperom raportowania transakcji zrealizowanych w alternatywnym systemie rozliczeniowym dewelopera.
- Alternatywny system rozliczeniowy: alternatywny system rozliczeniowy dewelopera, który może być oferowany jednocześnie z systemem rozliczeniowym Google Play lub jako alternatywny system (w zależności od wymagań).
- Transakcja zewnętrzna: transakcja zrealizowana poza systemem rozliczeniowym Google Play.
- Zewnętrzny token transakcji: token przekazywany deweloperowi z Biblioteki płatności w Play, z którego może on korzystać, gdy użytkownik ukończy alternatywny system rozliczeniowy. Służy on do powiadamiania Google Play o zakupie.
- Zewnętrzny identyfikator transakcji: unikalny identyfikator generowany przez dewelopera do identyfikowania transakcji.
Korzystanie z alternatywnego systemu rozliczeniowego opartego na wyborze użytkownika
W tej sekcji dowiesz się, jak oferować użytkownikom alternatywny system rozliczeniowy oraz system rozliczeniowy Google Play. Przed użyciem tych interfejsów API upewnij się, że:
- Zapoznaj się z wymaganiami 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 5.2 lub nowszą.
Pozostałe zalecane moduły integracji z Płatnościami w Google Play są takie same jak w przypadku obecnej integracji deweloperów.
Warto też przygotować konfigurację integracji interfejsu Google Play Developer API, ponieważ będzie z niej korzystać integracja backendu.
Konfigurowanie w Konsoli Play
Deweloperzy, którzy ukończyli rejestrację w odpowiednim programie rozliczeń alternatywnych w ramach programu wyboru użytkownika i są zintegrowani z interfejsami API rozliczeń alternatywnych, mogą zarządzać ustawieniami rozliczeń alternatywnych w Konsoli Play:
- W przypadku każdej kwalifikujących się aplikacji możesz wybrać, czy chcesz oferować alternatywny system rozliczeniowy.
- Prześlij logo form płatności zgodnie ze wskazówkami i wszystkimi specyfikacjami formatu. Obrazy niezgodne z tymi wytycznymi nie będą wyświetlane w przypadku alternatywnego systemu rozliczeniowego na ekranie wyboru przez użytkownika. (Uwaga: dodawanie logo form płatności jest opcjonalne, ale zdecydowanie zalecane).
- Jeśli oferujesz subskrypcje, podaj wymagany link do zarządzania subskrypcjami.
Z perspektywy użytkownika
Interfejsy API po stronie klienta umożliwiają korzystanie z tych funkcji:
- Google Play renderuje odpowiednie informacje i ekrany wyboru użytkownika oraz nimi zarządza.
- Jeśli użytkownik zdecyduje się na używanie systemu rozliczeniowego Google Play, w procesie płatności nadal będzie stosowany standardowy interfejs rozliczeniowy Google Play.
Przykład ma charakter wyłącznie ilustracyjny.
Ekran wyboru użytkownika
Ekran wyboru użytkownika umożliwia korzystanie z alternatywnego systemu rozliczeniowego dewelopera lub systemu rozliczeniowego Google Play.
Składnia opcji rozliczeń alternatywnych
Opcja rozliczeń alternatywnych na ekranie wyboru użytkownika obejmuje te elementy interfejsu:
- Ikona aplikacji.
- Nazwa aplikacji.
- Komponent z obrazem zawierający formy płatności oferowane przez dewelopera.
- Dodatkowy wskaźnik (i inne element interfejsu nie jest częścią komponentu z obrazem).
Komponent z obrazem do form płatności
Komponent z obrazem składa się z kilku kart form płatności i musi spełniać wymagania określone w tych wytycznych.
Wymiary |
192 dp x 20 dp |
Odstępy na kartach |
8dp |
Format pliku |
PNG, przezroczyste tło |
Odmiany formy płatności
Deweloperzy mogą określić maksymalnie 5 dostępnych ikon formy płatności w komponencie z obrazem.
Obraz nie powinien zawierać żadnych innych obrazów ani tekstu.
Specyfikacja karty
Karty formy płatności uwzględnione w komponencie z obrazem muszą być zgodne z tymi wskazówkami dotyczącymi rozmiaru, odstępów i stylu.
Wymiary karty | 32 dp x 20 dp |
Wypełnienie wewnętrzne | 3dp |
Kontur | 1 dp (kreska wewnętrzna 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 możliwością wyboru przez użytkownika, zapoznaj się ze szczegółowymi przewodnikami na temat integracji w aplikacji i integracji backendu.
oferowanie tylko rozliczeń alternatywnych
W tej sekcji opisujemy, jak oferować użytkownikom rozliczenia alternatywne bez możliwości korzystania z systemu rozliczeniowego Google Play. Przed użyciem tych interfejsów API upewnij się, że:
- Zapoznaj się z wymaganiami i zarejestruj się w programie rozliczeń alternatywnych, postępując zgodnie z instrukcjami podanymi w artykule Udostępnianie alternatywnego systemu rozliczeniowego użytkownikom w Europejskim Obszarze Gospodarczym na potrzeby 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ż będzie z niej korzystać integracja backendu.
Konfigurowanie w Konsoli Play
Deweloperzy, którzy ukończyli rejestrację i są zintegrowani z interfejsami API do rozliczeń alternatywnych, mogą zarządzać ustawieniami rozliczeń alternatywnych w Konsoli Play:
- W przypadku każdej kwalifikującej się aplikacji włącz lub wyłącz oferowanie tylko alternatywnego systemu rozliczeniowego (tj.bez opcji wyboru przez użytkownika) w każdym dostępnym kraju.
Ekran z informacjami dla użytkowników
Ekran z informacjami pomaga użytkownikom zrozumieć, że w odpowiedniej aplikacji oferowany jest tylko alternatywny system rozliczeniowy. Po włączeniu rozliczeń alternatywnych na ekranie z informacjami ekran jest wyświetlany użytkownikom na początku pierwszego zakupu. Ten komunikat nie będzie wyświetlany w przypadku kolejnych zakupów tego samego użytkownika w Twojej aplikacji na tym samym urządzeniu. Pamiętaj, że czasami okno może wyświetlić się ponownie użytkownikowi w sytuacji, gdy np. wyczyści pamięć podręczną na swoim urządzeniu.
Dalsze kroki
Aby rozpocząć integrację interfejsów API rozliczeń alternatywnych, postępuj zgodnie ze szczegółowymi przewodnikami po integracji w aplikacji i integracji backendu.