Checklist d'intégration

Utilisez la checklist suivante pour vous assurer d'avoir effectué toutes les étapes requises dans votre intégration Web.

À propos de l'environnement de test

Une configuration de test de l'API Google Pay ne renvoie pas d'informations de paiement réelles et payantes. Elle vous permet de tester des éléments de votre workflow d'achat. Voici les éléments testables :

  • Pages de confirmation
  • Reçus
  • Adresse de facturation (facultatif)
  • Numéro de téléphone pour la facturation (facultatif)
  • Adresse de livraison (facultatif)
  • Adresse e-mail (facultatif)

Pour utiliser un environnement de test avec un exemple de réponse de données de paiement, initialisez un nouveau PaymentsClient avec un objet JavaScript contenant une propriété d'environnement définie sur TEST.

Voici un exemple de code :
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Tester avec la console développeur de votre navigateur

Testez votre site Web sur la dernière version d'un navigateur compatible. Pour ce faire, ouvrez les outils pour les développeurs de votre navigateur afin d'afficher les messages de la console liés à votre site Web. Les messages incluent des erreurs ou des avertissements de la bibliothèque cliente JavaScript de l'API Google Pay. L'API Google Pay est compatible avec Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera et UCWeb UC Browser.

Des erreurs supplémentaires peuvent s'afficher dans la boîte de dialogue de sélection du mode de paiement Google après l'appel de loadPaymentData(). Lorsque vous cliquez sur Continuer ou OK après avoir consulté le message d'erreur, des informations supplémentaires peuvent s'afficher dans le Promise refusé géré par votre site.

Tester sur un appareil compatible

Bien que l'API Google Pay soit disponible dans de nombreux marchés, les cartes tokenisées ne le sont que dans un sous-ensemble de pays. Si les cartes tokenisées sont définies comme mode de paiement autorisé, testez-les sur un appareil Android équipé de Chrome pour Android version 59 ou ultérieure et des services Google Play version 16.0.0 ou ultérieure. Si votre mode de paiement est accepté dans votre pays et par votre banque émettrice, effectuez un test avec une carte enregistrée dans l'application Google Pay.

Pour afficher les erreurs et les avertissements de la console Chrome pour Android, effectuez des tests avec le débogage à distance depuis Chrome pour ordinateur. Pour en savoir plus sur les erreurs possibles, consultez les journaux de votre appareil Android. Vous pouvez peut-être afficher les journaux d'erreur avec la fenêtre d'outil Logcat dans Android Studio, avec l'outil de ligne de commande adb logcat ou dans un rapport de bug Android. Pour afficher les messages d'erreur liés à l'API Google Pay, recherchez WalletMerchantError.

Voici un exemple de code :

adb logcat -s WalletMerchantError

Tester votre intégration

Avant de soumettre votre intégration à Google pour validation avec un PaymentsClient configuré pour un environnement TEST, assurez-vous d'avoir rempli les critères de sortie pour chacune des vérifications fonctionnelles et de branding suivantes.

1. Généralités

Assurez-vous que vos contrôles et vérifications des risques existants pour les transactions par carte ou par numéro de compte principal (PAN) sont également appliqués aux transactions Google Pay. Les contrôles de validation et de fraude Google Pay ne sont pas destinés à remplacer vos processus de gestion des risques.
Si vous déclenchez sélectivement 3D Secure (authentification renforcée) pour les transactions normales par carte en fonction de critères de risque, veillez à utiliser les mêmes critères de risque pour déclencher 3D Secure pour les transactions PAN_ONLY Google Pay PAN.
Assurez-vous d'avoir lu et d'être prêt à accepter nos Conditions d'utilisation. Pour vous inscrire à l'API Google Pay, votre adresse e-mail doit être associée à un compte Google. Nous vous recommandons d'utiliser une adresse e-mail professionnelle associée à votre domaine d'entreprise, par exemple "admin@mondomaine.com". Sélectionnez Utiliser mon adresse e-mail actuelle à la place dans le processus de création de compte Google pour associer votre adresse e-mail à un compte Google.
N'utilisez les données reçues de l'API Google Pay que pour traiter les transactions. Tous les autres cas d'utilisation nécessitent un consentement explicite distinct de la part de l'utilisateur.
Confirmez les réseaux de cartes et les méthodes d'authentification de carte acceptés par votre processeur de paiement dans votre pays.
Si vous effectuez une intégration DIRECT tokenizationSpecification type, vous devez renouveler votre clé de chiffrement publique chaque année et fournir une attestation PCI à Google à l'aide de la Google Pay & Wallet Console. Une attestation PCI peut être envoyée par un tiers ou un évaluateur de sécurité qualifié certifié par le PCI SSC et approuvé par un fournisseur approuvé ou un évaluateur qualifié.

2. Tests de marque

Utilisez nos assets approuvés et respectez tous les éléments de nos Consignes relatives à la marque.
Assurez-vous que le bouton de paiement Google Pay ne s'affiche qu'une fois que votre site a confirmé la capacité de l'utilisateur à payer via la fonction isReadyToPay().
Vérifiez que les dimensions du bouton de paiement Google Pay affiché correspondent à celles des boutons et éléments similaires sur la page.
Choisissez le bouton approprié en fonction de la couleur d'arrière-plan de la zone où il apparaît.

3. Tests fonctionnels

Vérifiez que loadPaymentData() est appelé de manière synchrone lorsque vous cliquez sur le bouton de paiement Google Pay, et qu'il maintient le comportement d'activation de l'utilisateur du navigateur qui permet à l'API Google Pay d'afficher une feuille de paiement. Vérifiez que la feuille de paiement Google Pay n'est pas bloquée par des bloqueurs de pop-up.

Lorsque vous demandez le type de mode de paiement CARD avec l'authentification de carte PAN_ONLY, suivez les étapes ci-dessous pour effectuer le test des cartes enregistrées :

  1. Le cas échéant, supprimez toutes les cartes enregistrées dans pay.google.com.
  2. Revenez à votre intégration.
  3. Cliquez sur Google Pay.
  4. Vérifiez que l'option d'ajout d'une carte s'affiche.
  5. Ajoutez une carte d'un réseau compatible, comme défini dans parameters.allowedCardNetworks.
  6. Vérifiez que la carte ajoutée s'affiche avec le logo du réseau dans le sélecteur.

Le test suivant ne s'applique qu'à Chrome sur Android.

Lorsque vous demandez le type de mode de paiement CARD avec l'authentification de carte CRYPTOGRAM_3DS, procédez comme suit pour effectuer le test du jeton d'appareil Android :

  1. Vérifiez que l'émetteur de votre carte est accepté, puis ajoutez une carte éligible dans l'application Android Google Pay.
  2. Revenez à votre intégration.
  3. Cliquez sur le bouton de paiement Google Pay.
  4. Vérifiez que la carte ajoutée s'affiche dans le sélecteur, avec l'illustration de la carte.

Si vous confirmez que votre processeur est compatible avec l'authentification de carte 3D-Secure, vous pouvez continuer, même si vous n'avez pas de jeton d'appareil Android en tant qu'utilisateur Android ou titulaire de carte.

Si vous avez besoin d'une adresse de livraison, testez le traitement de l'adresse de livraison dans différents états d'achèvement, par exemple :

  • Variances sur un nom complet à analyser dans des champs structurés, tels que "John", "John Doe" et "Jane Doe Smith".
  • Analysez précisément toutes les lignes d'adresse renvoyées par l'API Google Pay, qui peuvent dépasser le nombre total de lignes d'adresse généralement collectées dans votre parcours de paiement standard.
  • Vérifiez que le pays indiqué dans l'adresse correspond aux destinations de livraison acceptées sur votre site. Si vous avez spécifié des restrictions de livraison, testez-les : saisissez une adresse de livraison non prise en charge et non autorisée dans notre feuille de paiement, puis vérifiez si les restrictions fonctionnent.

Si vous avez implémenté la prise en charge d'Authorize Payments, vérifiez les points suivants :

  • Lorsqu'une authentification de paiement échoue, elle renvoie un ERROR transactionState et PaymentDataError avec l'intention PAYMENT_AUTHORIZATION.

Si vous avez implémenté la prise en charge des mises à jour dynamiques des prix, procédez comme suit :

  1. Ajoutez les informations d'une carte et d'une adresse dans la feuille de paiement.
  2. Mettez à jour les options de livraison, la liste des commandes et le prix total.
  3. Important : Assurez-vous que le prix total correspond au montant de la transaction. Sinon, cela peut avoir un impact sur la valeur de l'indicateur de commerce électronique (ECI) et sur la partie responsable.
  4. Ajoutez et sélectionnez une adresse de livraison.
  5. Mettez à jour les options de livraison, la liste des commandes et le prix total.
  6. Sélectionnez une option de livraison.
  7. Mettez à jour la liste des commandes et le prix total.
  8. Validez vos résultats :
    • Si aucune option de livraison n'est disponible pour l'adresse de livraison, vérifiez que vous obtenez PaymentDataError avec l'intention SHIPPING_ADDRESS.
    • Si l'option de livraison sélectionnée n'est pas valide, vérifiez que vous obtenez PaymentDataError avec l'intention SHIPPING_OPTION.
    • Si l'authentification du paiement échoue, vérifiez que vous obtenez ERROR transactionState et PaymentDataError avec l'intention PAYMENT_AUTHORIZATION.
Si vous avez besoin d'un numéro de téléphone, demandez-le à l'adresse de facturation. Ensuite, testez si vous pouvez analyser et stocker le numéro de téléphone selon les normes de données de votre site Web avec différents formats tels que "+8005550100", "18005550100" et "(800) 555-0100".
Assurez-vous que Google Pay est affiché de manière équivalente aux autres modes de paiement tiers.
Pour les utilisateurs qui ont déjà sélectionné Google Pay au moment du règlement et indiqué Google Pay comme mode de paiement préféré sur votre site Web, Google Pay doit être défini comme mode de paiement par défaut pour leur prochain achat.
Un prix final doit être affiché à l'utilisateur avant le traitement de la transaction. Si le montant à facturer a varié en fonction des données reçues de l'API Google Pay, vous devez afficher une page de confirmation avec un prix final.