Dokumentacja klienta

Dokumentacja com.google.android.gms.wallet zawiera pełną dokumentację biblioteki dotyczącą różnych wersji Google Pay API. Poniżej znajdziesz podsumowanie obiektów i metod, których można używać w najnowszej wersji Google Pay API: 2.0

Portfel

Wygeneruj PaymentsClient dla środowiska testowego lub produkcyjnego.

Przykład

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

Klient, który wchodzi w interakcję z interfejsami Google Pay API.

isReadyToPay(IsReadyToPayRequest)

Metoda isReadyToPay(IsReadyToPayRequest) pozwala określić, czy użytkownik może zwrócić formę płatności z Google Pay API.

Jeśli urządzenie obsługuje Google Pay, a użytkownik zapisał już formę płatności lub ją dodał, IsReadyToPay zwraca true. Aby sprawdzić, czy użytkownik zapisał już formę płatności w Google Pay, ustaw IsReadyToPayRequest.existingPaymentMethodRequired na true.

loadPaymentData(PaymentDataRequest)

Wyświetl arkusz płatności Google Pay pozwalający wybrać formę płatności i opcjonalnie skonfigurowane parametry.

IsReadyToPayRequest

Utwórz obiekt Java IsReadyToPayRequest, którego można użyć z PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

Utwórz obiekt Java IsReadyToPayRequest na podstawie ciągu znaków w formacie JSON. Poprawną strukturę tego ciągu znajdziesz w dokumentacji referencyjnej obiektu IsReadyToPayRequest.

PaymentDataRequest

Utwórz obiekt Java PaymentDataRequest, którego można użyć z PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

Utwórz obiekt Java PaymentDataRequest na podstawie ciągu znaków w formacie JSON. Poprawną strukturę tego ciągu znajdziesz w dokumentacji referencyjnej obiektu PaymentDataRequest.

PaymentData

Przetwórz odpowiedź Google Pay API w formacie JSON, której chcesz użyć w Twojej aplikacji.

toJson()

Podaj odpowiedź Google Pay API w formie ciągu znaków JSON. Więcej informacji o strukturze obiektu JSON znajdziesz w dokumentacji referencyjnej obiektu PaymentData.

PayButton

public void initialize(ButtonOption buttonOptions)

Ta wygodna metoda służy do inicjowania przycisku płatności Google Pay zawierającego aktualne elementy marki.

Argumenty

Nazwa	Opis
buttonOptions	Obiekt, który konfiguruje przycisk płatności Google Pay. W sekcji ButtonOptions znajdziesz więcej informacji o właściwościach, które można skonfigurować.

Przykład: inicjowanie przycisku płatności z użyciem konfiguracji niestandardowych:

PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton;
JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod());
googlePayPaymentButton.initialize(
       ButtonOptions.newBuilder()
               .setButtonTheme(ButtonConstants.ButtonTheme.DARK)
               .setButtonType(ButtonConstants.ButtonType.BUY)
               .setCornerRadius(100)
               .setAllowedPaymentMethods(paymentMethods.toString())
               .build()
);

public void setVisibility(View view)

Ta metoda ustawia widoczność przycisku płatności.

Argumenty

Nazwa	Opis
View	View.VISIBLE ustawia przycisk płatności jako widoczny (domyślnie). View.GONE ukrywa przycisk przed użytkownikami.

Przykład:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

Metoda jest wywoływana, gdy użytkownik kliknie przycisk płatności Google Pay.

Argumenty

Nazwa	Opis
listener	Wywołanie zwrotne detektora zdarzeń, które ma być uruchomione, gdy zdarzenie kliknięcia zostanie dostarczone do przycisku płatności Google Pay.