Dokumentacja klienta

Dokumentacja com.google.android.gms.wallet zawiera pełną dokumentację biblioteki w różnych wersjach interfejsu Google Pay API. Poniżej znajdziesz podsumowanie obiektów i metod, które najlepiej pasują do najnowszej wersji interfejsu Google Pay API: wersja 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 do interakcji z interfejsami API Google Pay.

isReadyToPay(IsReadyToPayRequest)

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

Jeśli urządzenie obsługuje Google Pay, a użytkownik ma już zapisaną formę płatności lub może ją dodać, IsReadyToPay zwraca true. Aby określić, 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, który umożliwia wybór formy płatności i opcjonalnie skonfigurowanych parametrów.

IsReadyToPayRequest

Utwórz obiekt IsReadyToPayRequest w języku Java, który może być używany z metodą PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

Utwórz obiekt Java IsReadyToPayRequest z ciągu znaków w formacie JSON. Oczekiwana struktura podanego ciągu w formacie JSON jest opisana w dokumentacji obiektu IsReadyToPayRequest.

PaymentDataRequest

Utwórz obiekt Java PaymentDataRequest, który może być używany z PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

Utwórz obiekt Java PaymentDataRequest z ciągu znaków w formacie JSON. Oczekiwana struktura podanego ciągu znaków w formacie JSON jest opisana w dokumentacji obiektu PaymentDataRequest.

PaymentData

Przetwarzanie odpowiedzi z interfejsu Google Pay API w formacie JSON do użycia w aplikacji.

toJson()

Wygeneruj odpowiedź interfejsu Google Pay API jako ciąg znaków w formacie JSON. Więcej informacji o strukturze obiektu JSON znajdziesz w dokumentacji obiektu PaymentData.

PayButton

public void initialize(ButtonOption buttonOptions)

Metoda ułatwiająca służy do inicjowania przycisku płatności Google Pay z najnowszym brandingiem Google Pay.

Argumenty

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

Przykład: inicjowanie przycisku płatności z konfiguracjami niestandardowymi:

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)

Metoda ułatwiająca 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 zostać wywołane, gdy zdarzenie kliknięcia zostanie dostarczone do przycisku płatności Google Pay.

BasePaymentDataCallbacksService

Podstawowa klasa usługi, która obsługuje wywołania zwrotne danych płatności inicjowane przez usługi Google Play w ramach procesu PaymentsClient.loadPaymentData(PaymentDataRequest).

Rozszerz tę usługę w aplikacji i zadeklaruj ją w pliku AndroidManifest.xml z uprawnieniem com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE i filtrem intencji dla com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS.

createPaymentDataCallbacks()

Zwraca implementację interfejsu BasePaymentDataCallbacks do obsługi przychodzących zdarzeń wywołania zwrotnego. Wywoływana raz na zdarzenie wywołania zwrotnego.

BasePaymentDataCallbacks

Abstrakcyjna klasa bazowa zawierająca moduły obsługi wywołania zwrotnego danych karty, które zostały zaimplementowane przez sprzedawcę w celu obsługi dynamicznych aktualizacji cen i autoryzacji płatności.

onPaymentDataChanged(intermediatePaymentData, onCompleteListener)

Ta metoda obsługuje zmiany danych karty w arkuszu płatności, takie jak adres dostawy i opcje dostawy.

Argumenty

cześć
Nazwa Typ Opis
intermediatePaymentData IntermediatePaymentData Obiekt zawierający adres i opcję dostawy wybrane w arkuszu płatności. Więcej informacji: IntermediatePaymentData.
onCompleteListener OnCompleteListener<PaymentDataRequestUpdate> Obiekt nasłuchujący, który ma zostać rozwiązany za pomocą zaktualizowanych informacji o transakcji, opcji dostawy i błędów danych o płatności. Przekaż instancję PaymentDataRequestUpdate do complete().

Przykład

override fun onPaymentDataChanged(
    intermediatePaymentData: IntermediatePaymentData,
    onCompleteListener: OnCompleteListener<PaymentDataRequestUpdate>
) {
    val paymentDataRequestUpdateJson = handlePaymentDataChanged(intermediatePaymentData.toJson())
    val update = PaymentDataRequestUpdate.fromJson(paymentDataRequestUpdateJson.toString())
    onCompleteListener.complete(update)
}

onPaymentAuthorized(paymentData, onCompleteListener)

Ta metoda jest wywoływana, gdy płatność jest autoryzowana w arkuszu płatności.

Argumenty

Nazwa Typ Opis
paymentData PaymentData Obiekt zawierający żądane dane kupującego. Więcej informacji: PaymentData.
onCompleteListener OnCompleteListener<PaymentAuthorizationResult> Detektor, który ma zostać rozwiązany z wynikiem autoryzacji. Przekaż instancję PaymentAuthorizationResult do complete().

Przykład

override fun onPaymentAuthorized(
    paymentData: PaymentData,
    onCompleteListener: OnCompleteListener<PaymentAuthorizationResult>
) {
    val paymentAuthorizationResultJson = handlePaymentAuthorized(paymentData.toJson())
    val result = PaymentAuthorizationResult.fromJson(paymentAuthorizationResultJson.toString())
    onCompleteListener.complete(result)
}

IntermediatePaymentData

Obsługuj pośrednie dane wywołania zwrotnego przekazywane do BasePaymentDataCallbacks.onPaymentDataChanged.

toJson()

Zwraca dane żądania wywołania zwrotnego jako ciąg znaków w formacie JSON. Więcej informacji o strukturze obiektu JSON znajdziesz w dokumentacji obiektu IntermediatePaymentData.

getLastSavedState()

Zwraca obiekt Bundle zawierający stan zapisany podczas poprzedniej iteracji wywołania zwrotnego.

PaymentDataRequestUpdate

Utwórz obiekt Java PaymentDataRequestUpdate, który ma być zwracany w metodzie BasePaymentDataCallbacks.onPaymentDataChanged.

fromJson(java.lang.String)

Utwórz obiekt Java PaymentDataRequestUpdate z ciągu znaków w formacie JSON. Oczekiwaną strukturę podanego ciągu znaków w formacie JSON znajdziesz w dokumentacji obiektu PaymentDataRequestUpdate.

withUpdatedSavedState(Bundle)

Dołącza zaktualizowany stan Bundle, który ma być zachowywany między wywołaniami funkcji zwrotnej.

PaymentAuthorizationResult

Utwórz obiekt Java PaymentAuthorizationResult, który ma być zwracany w metodzie BasePaymentDataCallbacks.onPaymentAuthorized.

fromJson(java.lang.String)

Utwórz obiekt Java PaymentAuthorizationResult z ciągu znaków w formacie JSON. Oczekiwaną strukturę podanego ciągu znaków w formacie JSON znajdziesz w dokumentacji obiektu odpowiedzi PaymentAuthorizationResult.