Interfejsy API do rozliczeń alternatywnych

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 alternatywnego sposobu płatności:

• Rozliczenia alternatywne z opcją wyboru przez użytkownika: Twoja aplikacja oferuje rozliczenia alternatywne oprócz systemu rozliczeniowego Google Play.
• Tylko rozliczenia alternatywne (bez wyboru użytkownika): aplikacja oferuje alternatywny system rozliczeniowy bez możliwości korzystania z systemu rozliczeniowego Google Play.

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 Google 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 alternatywnego systemu rozliczeniowego z opcją wyboru przez użytkowników

W tej sekcji opisaliśmy, 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ź kryteria kwalifikacji w przypadku 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 płatności 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: umieszczanie 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ć system rozliczeniowy dewelopera lub system rozliczeniowy Google Play.

Anatomia opcji rozliczeń alternatywnych

Opcja alternatywnego systemu rozliczeniowego na ekranie wyboru użytkownika zawiera te elementy interfejsu:

1. Ikona aplikacji.
2. Nazwa aplikacji.
3. Komponent z obrazem, który zawiera formy płatności oferowane przez dewelopera.
4. 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 być zgodny ze specyfikacjami określonymi w tych wytycznych.

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.

Dalsze kroki

Aby rozpocząć integrację interfejsów API rozliczeń alternatywnych z opcją wyboru przez użytkowników, skorzystaj z szczegółowych przewodników dotyczących integracji w aplikacji i integracji backendu.

Oferowanie tylko alternatywnego systemu rozliczeniowego

W tej sekcji opisujemy, jak oferować użytkownikom alternatywny system rozliczeniowy bez możliwości korzystania z systemu rozliczeniowego Google Play. Zanim zaczniesz korzystać z tych interfejsów API, upewnij się, że:

• Zapoznaj się z wymaganiami i zarejestruj się w programie dotyczącym wyłącznie rozliczeń alternatywnych, postępując zgodnie z instrukcjami w artykule Jak zaoferować alternatywny system rozliczeniowy użytkownikom z Europejskiego Obszaru Gospodarczego.
• 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 ona wykorzystywana przez integrację 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 alternatywnego systemu rozliczeniowego. Ta wiadomość nie będzie wyświetlana przy kolejnych zakupach dokonywanych przez tego samego użytkownika w Twojej aplikacji na tym samym urządzeniu. Pamiętaj, że w niektórych sytuacjach okno może wyświetlić się ponownie, np. gdy użytkownik wyczyści 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.