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 facturables, mais vous permet de tester des éléments de votre processus d'achat. Voici les éléments testables :

  • Pages de confirmation
  • Reçus
  • Adresse de facturation (facultatif)
  • Numéro de téléphone de 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 les dernières versions de plusieurs navigateurs et systèmes d'exploitation compatibles (y compris sur ordinateur, Android et iOS). 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 sur les plates-formes pour ordinateur et mobile.

Des erreurs supplémentaires peuvent s'afficher dans la fenêtre de dialogue de sélection du paiement Google après avoir appelé loadPaymentData(). Lorsque vous cliquez sur Continuer ou OK après avoir affiché le message d'erreur, des détails supplémentaires peuvent être renvoyés dans le Promise refusé géré par votre site.

Tester sur un appareil compatible

Bien que l'API Google Pay soit disponible sur de nombreux marchés, les cartes tokenisées ne sont disponibles que dans un sous-ensemble de pays. Testez votre intégration sur plusieurs appareils mobiles et systèmes d'exploitation, y compris Android et iOS. Si les cartes tokenisées sont définies comme mode de paiement autorisé, testez-les sur un appareil Android avec Chrome pour Android version 59 ou ultérieure et les services Google Play version 16.0.0 ou ultérieure, ainsi que sur iOS à l'aide de navigateurs compatibles tels que Safari ou Chrome. Si votre mode de paiement est accepté dans votre pays et par votre banque émettrice, testez-le avec une carte enregistrée dans l'application Google Pay.

Pour afficher les erreurs et les avertissements de la console Chrome pour Android, testez le débogage à distance à partir de Chrome pour ordinateur. Pour en savoir plus sur les erreurs possibles, consultez les journaux de votre appareil Android. Vous pouvez afficher les journaux d'erreurs 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 d'envoyer votre intégration à Google pour validation avec un PaymentsClient configuré pour un environnement TEST, assurez-vous de respecter les critères de sortie pour chacune des vérifications fonctionnelles et de marque suivantes.

1. Principes de base

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 vérifications de validation et de fraude Google Pay ne sont pas destinées à remplacer vos processus de gestion des risques.
Si vous déclenchez de manière sélective 3D Secure (authentification renforcée) pour les transactions par carte normales en fonction de critères de risque, veillez à utiliser les mêmes critères de risque pour déclencher 3D Secure pour les transactions Google Pay PAN PAN_ONLY.
Assurez-vous d'avoir lu nos conditions d'utilisation et d'être prêt à les accepter. Pour vous inscrire à l'API Google Pay votre adresse e-mail doit être associée à un compte Google, de préférence une adresse e-mail professionnelle associée à votre domaine d'entreprise, par exemple "admin@myownpersonaldomain.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 exprès distinct de l'utilisateur.
Vérifiez 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. L'attestation PCI peut être envoyée par un tiers ou un évaluateur de sécurité qualifié certifié par le PCI Security Standards Council et approuvé par un fournisseur approuvé ou un évaluateur qualifié.

2. Tests de la 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é que l' utilisateur peut 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 de la page.
Choisissez un bouton approprié en fonction de la couleur d'arrière-plan de la zone dans laquelle il apparaît.

3. Tests fonctionnels

Testez votre intégration sur plusieurs navigateurs Web courants (tels que Google Chrome, Apple Safari, Mozilla Firefox et Microsoft Edge) et systèmes d'exploitation mobiles (Android et iOS) pour vérifier que le rendu des boutons, les pop-up de la page de paiement et les flux de transaction fonctionnent correctement.
Vérifiez que loadPaymentData() est appelé de manière synchrone lorsque vous cliquez sur le bouton de paiement Google Pay et qu'il conserve le comportement d'activation de l'utilisateur du navigateur qui permet à l'API Google Pay d'afficher une page de paiement. Vérifiez que la page de paiement Google Pay n'est pas bloquée par les bloqueurs de pop-up.

Lorsque vous demandez le type de mode de paiement CARD avec PAN_ONLY authentification de carte, procédez comme suit pour effectuer le test des cartes enregistrées :

  1. Le cas échéant, supprimez toutes les cartes enregistrées de pay.google.com.
  2. Revenez à votre intégration.
  3. Cliquez sur Google Pay.
  4. Vérifiez que l'option permettant d'ajouter 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 un logo de 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 votre émetteur de carte est compatible et 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 avec l'illustration de la carte dans le sélecteur.

Si vous confirmez que votre processeur est compatible avec l'authentification de carte 3D Secure, vous pouvez continuer, même si un jeton d'appareil Android n'est pas disponible pour vous 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 :

  • Variations sur un nom complet à analyser dans des champs structurés, tels que « Jean », « Jean Dupont » et « Jeanne Dupont Smith ».
  • Analysez avec précision 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 processus de paiement standard.
  • Vérifiez que le composant de pays renvoyé de l'adresse correspond aux destinations de livraison acceptées par votre site . Si vous avez spécifié des restrictions de livraison, testez-les : saisissez une adresse de livraison non acceptée dans notre page de paiement et vérifiez si les restrictions fonctionnent.

Si vous avez implémenté la compatibilité avec les paiements d'autorisation, vérifiez les points suivants :

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

Si vous avez implémenté la compatibilité avec les mises à jour dynamiques des prix, procédez comme suit :

  1. Ajoutez une carte et des informations d'adresse dans la page de paiement.
  2. Modifiez 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 amount. Sinon, cela peut avoir un impact sur la valeur de l'indicateur de commerce électronique (ICE) et sur la partie responsable.
  4. Ajoutez et sélectionnez une adresse de livraison.
  5. Modifiez les options de livraison, la liste des commandes et le prix total.
  6. Sélectionnez une option de livraison.
  7. Modifiez la liste des commandes et le prix total.
  8. Validez vos résultats :
    • Si l'adresse de livraison ne dispose pas d'options de livraison disponibles, vérifiez que vous obtenez PaymentDataError avec l'intent SHIPPING_ADDRESS.
    • Si l'option de livraison sélectionnée n'est pas valide, vérifiez que vous obtenez PaymentDataError avec l'intent SHIPPING_OPTION.
    • Si l'authentification de paiement échoue, vérifiez que vous obtenez un ERROR transactionState et PaymentDataError avec l'intent PAYMENT_AUTHORIZATION.
Si vous avez besoin d'un numéro de téléphone, demandez-le à l'adresse de facturation. Ensuite, vérifiez 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é au même niveau que les autres modes de paiement tiers.
Pour les utilisateurs qui ont précédemment sélectionné Google Pay lors du paiement et indiqué Google Pay comme mode de paiement préféré sur votre site Web, Google Pay doit être défini par défaut comme mode de paiement pour leur achat suivant.
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.