Interfejsy API do rozliczeń alternatywnych

Kwalifikujący się deweloperzy mogą oferować użytkownikom w określonych krajach alternatywny system rozliczeniowy w aplikacji i zgłaszać wynikające z nich transakcje do Google. W zależności od miejsca rozpowszechniania aplikacji i tego, czy aplikacja spełnia kryteria, dostępne są 2 wersje rozliczeń alternatywnych:

W tym przewodniku omawiamy interfejsy API, których należy używać w każdej z tych ofert. Zanim zaczniesz korzystać z tych interfejsów API, zapoznaj się ze stronami programu i zarejestruj się w odpowiednich programach.

Słowniczek terminów

Konwencje terminów, których należy przestrzegać w tym przewodniku:

  • Interfejsy API do rozliczeń alternatywnych: interfejsy API służące do wyświetlania użytkownikom odpowiednich ekranów i umożliwiające deweloperom zgłaszanie transakcji zrealizowanych w alternatywnym systemie rozliczeniowym.
  • Alternatywny system rozliczeniowy: alternatywny system rozliczeniowy dewelopera, który może być oferowany obok systemu rozliczeniowego Google Play lub samodzielnie (w zależności od wymagań).
  • Transakcja zewnętrzna: transakcja realizowana poza systemem rozliczeniowym Google Play.
  • Zewnętrzny token transakcji: token udostępniany deweloperowi przez Bibliotekę płatności w Play, którego deweloper może wykorzystać, 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.

Udostępnianie alternatywnego systemu rozliczeniowego z opcją wyboru przez użytkowników

Z tej sekcji dowiesz się, jak oferować użytkownikom alternatywny system rozliczeniowy w ramach korzystania z systemu rozliczeniowego Google Play. Przed użyciem tych interfejsów API upewnij się, że:

Pozostałe zalecane moduły integracji z Płatnościami w Google Play są takie same jak w przypadku obecnej integracji deweloperów.

Zalecamy też przygotowanie konfiguracji integracji interfejsu Google Play Developer API, ponieważ będzie z niej korzystać integracja backendu.

Konfiguruję w Konsoli Play

Deweloperzy, którzy ukończyli rejestrację w przypadku odpowiednich rozliczeń alternatywnych z programem 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ącej się aplikacji możesz wybrać, czy chcesz oferować alternatywny system rozliczeniowy.
  • Prześlij logo form płatności zgodnie ze wskazówkami i ze wszystkimi specyfikacjami formatu. Obrazy niezgodne z tymi wytycznymi nie będą wyświetlane w przypadku alternatywnego systemu rozliczeniowego na ekranie wyboru użytkownika. (Uwaga: dodanie logo form płatności jest opcjonalne, ale zdecydowanie zalecane).
  • Jeśli oferujesz subskrypcje, podaj wymagany link do zarządzania subskrypcjami.
Przykładowy interfejs, do celów poglądowych, może ulec zmianie.

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, proces płatności będzie nadal realizowany przy użyciu standardowego interfejsu płatności Google Play.

Aplikacja dewelopera.

Ekran wyboru płatności.

Przykład tylko do celów ilustracyjnych.

Ekran wyboru użytkownika

Na ekranie wyboru użytkownika użytkownicy mogą wybrać alternatywny system rozliczeniowy dewelopera lub system rozliczeniowy Google Play.

Składnia opcji rozliczeń alternatywnych

Opcja rozliczeń alternatywnych na ekranie wyboru użytkownika zawiera te elementy interfejsu:

  1. Ikona aplikacji.
  2. Nazwa aplikacji.
  3. Komponent z obrazem zawierający formy płatności oferowane przez dewelopera.
  4. Dodatkowy wskaźnik (i inne elementy interfejsu nie są częścią komponentu z obrazem).

Komponent z obrazem do form płatności

Komponent z jednym obrazem składa się z wielu kart form płatności i musi być zgodny ze specyfikacją określoną w tych wytycznych.

Wymiary

192 dp × 20 dp

Odstępy między kartami

8dp

Format pliku

PNG, przezroczyste tło

Odmiany formy płatności

Deweloperzy mogą wybrać maksymalną liczbę dostępnych ikon form płatności, które chcą umieścić w komponencie z obrazem.

Grafika nie może zawierać żadnych innych obrazów ani tekstu.

Specyfikacja karty

Karty form płatności zawarte w komponencie z obrazem muszą być zgodne z poniższymi wskazówkami dotyczącymi rozmiaru, odstępów i stylu.

Wymiary karty 32 dp × 20 dp
Dopełnienie wewnętrzne 3dp
Konspekt 1 dp (przekreślenie wewnętrzny 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żytkownika, postępuj zgodnie ze szczegółowymi przewodnikami dotyczącymi integracji w aplikacji i integracji backendu.

oferowanie tylko alternatywnego systemu rozliczeniowego.

Z tej sekcji dowiesz się, jak zaoferować użytkownikom alternatywny system rozliczeniowy bez konieczności używania systemu rozliczeniowego Google Play. Przed użyciem tych interfejsów API upewnij się, że:

Zalecamy przygotować konfigurację integracji interfejsu Google Play Developer API, ponieważ będzie z niej korzystać integracja backendu.

Konfiguruję w Konsoli Play

Deweloperzy, którzy ukończyli rejestrację i są zintegrowani z interfejsami API 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 alternatywnego systemu rozliczeniowego (bez opcji wyboru przez użytkowników) w każdym dostępnym kraju
Przykładowy interfejs, do celów poglądowych, może ulec zmianie.

Ekran z informacjami dla użytkowników

Ekran z informacjami pomaga użytkownikom zrozumieć, że w odpowiedniej aplikacji dostępny jest tylko alternatywny system rozliczeniowy. Ekran z informacjami będzie się wyświetlać użytkownikom na początku pierwszego zakupu w Twojej aplikacji po włączeniu rozliczeń alternatywnych. Ta wiadomość nie będzie widoczna przy kolejnych zakupach przez tego samego użytkownika w Twojej aplikacji na tym samym urządzeniu. Pamiętaj, że okno może wyświetlić się ponownie użytkownikowi w sytuacjach, np. gdy użytkownik 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 dotyczącymi integracji w aplikacji i integracji backendu.