Référence client

Cette référence décrit les méthodes du client JavaScript à utiliser pour implémenter l'API Google Pay dans vos applications Web.

Constructeur

Initialise l'objet PaymentsClient. Vous devez appeler ce constructeur avant d'appeler les méthodes membres.

new PaymentsClient(paymentOptions)

Arguments

Propriété Description
paymentOptions

Objet contenant des paires clé/valeur de données de configuration de l'API Google Pay. Consultez PaymentOptions pour connaître les différentes propriétés configurables.

Exemple : {environment:'PRODUCTION'}

Réponses

Type Description
google.payments.api.PaymentsClient L'objet PaymentsClient.

Plaids

Type Description
Error

La valeur de la propriété d'environnement transmise n'est pas acceptée.

Méthodes d'objet

createButton(options)

La méthode pratique permet de générer un bouton de paiement Google Pay stylisé avec la dernière identité visuelle Google Pay pour l'insertion dans une page Web.

Le HTMLElement généré inclut un CSS inséré de manière dynamique et une image SVG hébergée sur le CDN de Google.

Consultez nos Consignes relatives à la marque pour savoir comment choisir la couleur et le type de bouton adaptés à la conception de votre site. Vous devrez peut-être modifier les dimensions du bouton pour qu'il corresponde aux boutons ou éléments de paiement similaires sur votre page. Utilisez notre outil Personnaliser votre bouton pour configurer un bouton adapté à votre cas d'utilisation.

Arguments

Nom Description
options

Objet contenant des paires clé/valeur pour la configuration d'un bouton. Pour connaître les propriétés configurables, consultez ButtonOptions.

Exemple : {onClick:onGooglePaymentButtonClicked}

Réponses

Type Description
HTMLElement Un <button> HTML dans un conteneur de contenu de flux générique tel qu'un <div>.

Plaids

Type Description
Error

Une propriété obligatoire n'est pas définie.

isReadyToPay(isReadyToPayRequest)

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

Si le navigateur est compatible avec Google Pay, isReadyToPay renvoie true. Pour déterminer si l'utilisateur est connecté à un compte Google ou s'il a déjà enregistré un mode de paiement dans Google Pay, définissez IsReadyToPayRequest.existingPaymentMethodRequired sur true et vérifiez que paymentMethodPresent renvoie true dans la promesse résolue. Pour en savoir plus, consultez IsReadyToPayResponse.

Si PaymentsClient est initialisé avec une propriété d'environnement TEST, paymentMethodPresent renvoie toujours true.

Arguments

Nom Description
isReadyToPayRequest Objet contenant les modes de paiement acceptés par le marchand. Pour en savoir plus sur les différentes propriétés configurables, consultez IsReadyToPayRequest.

Réponses

Type Description
Promise

Resolved : objet contenant des informations sur la capacité de paiement de l'utilisateur. Pour en savoir plus, consultez IsReadyToPayResponse.

Refusé : objet d'erreur contenant plus d'informations sur le motif du refus. Pour en savoir plus, consultez PaymentsError.

Erreurs

statusCode Description
DEVELOPER_ERROR
  • L'objet IsReadyToPayRequest transmis n'était pas correctement mis en forme, il manquait les paramètres minimaux requis pour déterminer la capacité de paiement d'un utilisateur ou il contenait un paramètre et/ou une valeur non valides.
  • La requête a été initiée à partir d'un contexte de sécurité que l'agent de paiement ou le navigateur ont choisi de ne pas traiter. Il s'agit le plus souvent d'une erreur de contexte de navigateur non sécurisé.

loadPaymentData(paymentDataRequest)

Cette méthode présente une feuille de paiement Google Pay qui permet de sélectionner un mode de paiement et des paramètres éventuellement configurés.

Cette méthode doit être appelée pendant que le navigateur traite un comportement d'activation à la suite d'un événement de clic. Une fenêtre pop-up peut s'afficher pour permettre à l'utilisateur de sélectionner un mode de paiement ou d'autres données requises spécifiées dans le paramètre de requête transmis.

Arguments

Nom Description
paymentDataRequest Objet contenant des paires clé/valeur de configuration complète de l'API Google Pay. Pour connaître les propriétés configurables, consultez PaymentDataRequest.

Réponses

Type Description
Promise

Résolu : objet contenant les données demandées sur l'acheteur. Pour en savoir plus, consultez PaymentData.

Refusé : objet contenant un code d'erreur et des informations supplémentaires sur le motif du refus. Pour en savoir plus, consultez PaymentsError.

Erreurs

statusCode Description
CANCELED
  • Le navigateur actuel ou l'utilisateur Google connecté ne sont pas compatibles.
  • L'acheteur a fermé la feuille de paiement Google Pay sans autoriser le paiement.
  • La requête a été lancée à partir d'un contexte de sécurité que l'agent de paiement ou le navigateur ont choisi de ne pas traiter. Le plus souvent, il s'agit d'un contexte de navigateur non sécurisé.
  • La méthode a été appelée alors que la feuille de paiement Google Pay était déjà affichée.
  • L'objet PaymentDataRequest transmis a été refusé par la feuille de paiement Google Pay. Les paramètres PaymentMethodTokenizationSpecification manquants ou incomplets pour votre passerelle, ou les valeurs de paramètres non valides sont une cause fréquente.
DEVELOPER_ERROR L'objet PaymentDataRequest transmis n'était pas correctement mis en forme, il manquait les paramètres minimaux requis ou il contenait un paramètre et/ou une valeur non valides.

prefetchPaymentData(paymentDataRequest)

Utilisez cette méthode pour prérécupérer une configuration PaymentDataRequest afin d'améliorer le temps d'exécution loadPaymentData lors d'une interaction ultérieure de l'utilisateur. Aucune valeur n'est renvoyée.

Les optimisations de la prélecture sont disponibles dans Chrome pour Android.

Arguments

Nom Description
paymentDataRequest Objet contenant des paires clé/valeur de configuration complète de l'API Google Pay. Pour connaître les propriétés configurables, consultez PaymentDataRequest. Une modification de la propriété transactionInfo n'affecte pas la valeur de préchargement mise en cache.

onPaymentAuthorized(paymentData)

Cette méthode est appelée lorsqu'un paiement est autorisé dans la feuille de paiement.

Arguments

Nom Description
paymentData Objet contenant les données sur l'acheteur demandées. Pour en savoir plus, consultez PaymentData.

Réponses

Type Description
Promise

Résolu : objet contenant des informations sur les résultats des transactions de paiement. Pour en savoir plus, consultez PaymentAuthorizationResult.

Refusé : objet d'erreur avec une intention et un message d'erreur à afficher dans la feuille de paiement. Pour en savoir plus, consultez PaymentDataError.

onPaymentDataChanged(intermediatePaymentData)

Cette méthode gère les modifications des données de paiement dans la feuille de paiement, telles que l'adresse de livraison et les options de livraison.

Arguments

Nom Description
intermediatePaymentData Objet contenant l'adresse et l'option de livraison sélectionnées dans la feuille de paiement. Pour en savoir plus, consultez IntermediatePaymentData.

Réponses

Type Description
Promise

Résolu : objet contenant des informations sur les nouvelles informations de transaction, les options de livraison et les erreurs liées aux données de paiement. Pour en savoir plus, consultez PaymentDataRequestUpdate.

Refusé : objet d'erreur avec une intention et un message d'erreur à afficher dans la feuille de paiement. Pour en savoir plus, consultez PaymentDataError.