Référence client

La documentation com.google.android.gms.wallet contient la documentation complète de la bibliothèque pour plusieurs versions de l'API Google Pay. Vous trouverez ci-dessous un récapitulatif des objets et des méthodes les plus applicables à la dernière version de l'API Google Pay : version 2.0.

Wallet

Générez un PaymentsClient pour un environnement de test ou de production.

Exemple

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

PaymentsClient

Client permettant d'interagir avec les API Google Pay.

isReadyToPay(IsReadyToPayRequest)

Utilisez la méthode isReadyToPay(IsReadyToPayRequest) pour déterminer si un utilisateur peut renvoyer un mode de paiement à partir de l'API Google Pay.

Si l'appareil est compatible avec Google Pay et que l'utilisateur a déjà enregistré un mode de paiement ou peut en ajouter un, IsReadyToPay renvoie true. Pour déterminer si l'utilisateur a déjà enregistré un mode de paiement dans Google Pay, définissez IsReadyToPayRequest.existingPaymentMethodRequired sur true.

loadPaymentData(PaymentDataRequest)

Présentez une feuille de paiement Google Pay permettant de sélectionner un mode de paiement et des paramètres éventuellement configurés.

IsReadyToPayRequest

Créez un objet Java IsReadyToPayRequest adapté à l'utilisation avec PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

Créez un objet Java IsReadyToPayRequest à partir d'une chaîne au format JSON. Consultez la documentation de référence sur l'objet IsReadyToPayRequest pour connaître la structure attendue de la chaîne au format JSON fournie.

PaymentDataRequest

Créez un objet Java PaymentDataRequest adapté à l'utilisation avec PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

Créez un objet Java PaymentDataRequest à partir d'une chaîne au format JSON. Consultez la documentation de référence sur l'objet PaymentDataRequest pour connaître la structure attendue de la chaîne au format JSON fournie.

PaymentData

Gérez une réponse au format JSON de l'API Google Pay pour l'utiliser dans votre application.

toJson()

Générez une réponse de l'API Google Pay sous forme de chaîne au format JSON. Pour en savoir plus sur la structure de l'objet JSON, consultez la documentation de référence sur l'objet PaymentData.

PayButton

public void initialize(ButtonOption buttonOptions)

La méthode pratique permet d'initialiser un bouton de paiement Google Pay stylisé avec la dernière identité visuelle Google Pay.

Arguments

Nom Description
buttonOptions Objet qui configure le bouton de paiement Google Pay. Pour connaître les propriétés configurables, consultez ButtonOptions.

Exemple : Initialiser le bouton de paiement avec des configurations personnalisées :

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)

La méthode pratique définit la visibilité du bouton de paiement.

Arguments

Nom Description
View

View.VISIBLE définit le bouton de paiement sur "visible" (par défaut).

View.GONE masque le bouton aux utilisateurs.

Exemple :

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

Cette méthode est appelée lorsque l'utilisateur clique sur le bouton de paiement Google Pay.

Arguments

Nom Description
listener Rappel de l'écouteur d'événements à appeler lorsqu'un événement de clic est transmis au bouton de paiement Google Pay.