Kundenreferenz

Die Dokumentation zu com.google.android.gms.wallet enthält die vollständige Dokumentation für die Bibliothek für mehrere Versionen der Google Pay API. Nachfolgend finden Sie eine Zusammenfassung der Objekte und Methoden, die für die aktuelle Version der Google Pay API, Version 2.0, am relevantesten sind:

Wallet

Generieren Sie eine PaymentsClient für eine Test- oder Produktionsumgebung.

Beispiel

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

PaymentsClient

Ein Client für die Interaktion mit den Google Pay APIs.

isReadyToPay(IsReadyToPayRequest)

Verwenden Sie die isReadyToPay(IsReadyToPayRequest)-Methode, um zu ermitteln, ob ein Nutzer ein Zahlungsmittel aus der Google Pay API zurückgeben kann.

Wenn das Gerät Google Pay unterstützt und der Nutzer entweder bereits eine Zahlungsmethode gespeichert hat oder eine hinzufügen kann, gibt IsReadyToPay den Wert true zurück. Wenn Sie ermitteln möchten, ob der Nutzer bereits eine Zahlungsmethode in Google Pay gespeichert hat, legen Sie IsReadyToPayRequest.existingPaymentMethodRequired auf true fest.

loadPaymentData(PaymentDataRequest)

Ein Google Pay-Zahlungsformular wird angezeigt, in dem eine Zahlungsmethode und optional konfigurierte Parameter ausgewählt werden können.

IsReadyToPayRequest

Erstellen Sie ein IsReadyToPayRequest-Java-Objekt, das für die Verwendung mit PaymentsClient.isReadyToPay() geeignet ist.

fromJson(java.lang.String)

Erstellen Sie ein IsReadyToPayRequest-Java-Objekt aus einem JSON-formatierten String. Informationen zur erwarteten Struktur des bereitgestellten JSON-formatierten Strings finden Sie in der Objektreferenz für IsReadyToPayRequest.

PaymentDataRequest

Erstellen Sie ein PaymentDataRequest-Java-Objekt, das für die Verwendung mit PaymentsClient.loadPaymentData geeignet ist.

fromJson(java.lang.String)

Erstellen Sie ein PaymentDataRequest-Java-Objekt aus einem JSON-formatierten String. Die erwartete Struktur des bereitgestellten JSON-formatierten Strings finden Sie in der Objektreferenz für PaymentDataRequest.

PaymentData

Eine in JSON formatierte Antwort der Google Pay API für die Verwendung in Ihrer App verarbeiten.

toJson()

Gibt eine Google Pay API-Antwort als JSON-formatierten String aus. Weitere Informationen zur Struktur des JSON-Objekts finden Sie in der Objektreferenz für PaymentData.

PayButton

public void initialize(ButtonOption buttonOptions)

Mit der Convenience-Methode wird eine Google Pay-Zahlungsschaltfläche initialisiert, die mit dem neuesten Google Pay-Branding gestaltet ist.

Argumente

Name	Beschreibung
buttonOptions	Ein Objekt, das den Google Pay-Zahlungs-Button konfiguriert. Informationen zu konfigurierbaren Attributen finden Sie unter ButtonOptions.

Beispiel: Zahlungs-Schaltfläche mit benutzerdefinierten Konfigurationen initialisieren:

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)

Mit der Convenience-Methode wird die Sichtbarkeit der Zahlungs-Schaltfläche festgelegt.

Argumente

Name	Beschreibung
View	Mit View.VISIBLE wird die Zahlungsschaltfläche auf „Sichtbar“ gesetzt (Standard). Mit View.GONE wird die Schaltfläche für Nutzer ausgeblendet.

Beispiel:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

Diese Methode wird aufgerufen, wenn der Nutzer auf die Google Pay-Zahlungsschaltfläche klickt.

Argumente

Name	Beschreibung
listener	Ein Event-Listener-Callback, der aufgerufen wird, wenn ein Click-Event an die Google Pay-Zahlungsschaltfläche gesendet wird.