Étapes de test
Des tests minutieux sont la pierre angulaire du développement de logiciels, car ils permettent de s'assurer qu'ils fonctionnent comme prévu. Vous ne pouvez pas passer à un environnement de production (Live) et traiter des paiements réels tant que vous n'avez pas confirmé que votre intégration fonctionne comme vous le souhaitez dans tous les scénarios.
Conditions préalables
Avant de commencer le test de votre intégration Hosted Checkout, vous devez avoir terminé :
- L'intégration de base utilisant la Hosted Payment Page pour recueillir les détails de paiement.
- L'intégration de toutes les opérations ultérieures que vous souhaitez gérer dans le cadre du cycle de vie de vos commandes.
- Toutes les personnalisations liées aux modes de paiement que vous souhaitez prendre en charge.
- Toutes les fonctionnalités et fonctions liées à la sécurité supplémentaires dont vous avez besoin.
Test de votre intégration
Couvrez au moins les étapes suivantes dans vos tests :
- Pour les modes de paiement que vous prenez en charge, testez toutes les opérations individuelles que vous souhaitez utiliser dans votre intégration lorsque l'interaction avec le payeur est nécessaire sur la Hosted Payment Page.
Testez le processus depuis la création de la session de paiement jusqu'à l'affichage de la Hosted Payment Page au payeur et la gestion des rappels du processus de la page de paiement. - Pour les modes de paiement que vous prenez en charge, déterminez les flux de paiement (combinaisons de transactions initiales et ultérieures) que vous souhaitez pouvoir utiliser dans votre intégration. Testez tous les flux avec toutes les combinaisons possibles de transactions ultérieures.
- Testez toutes les caractéristiques supplémentaires et les fonctionnalités liées à la sécurité que vous utilisez.
- Vérifiez que votre système réagit de manière appropriée et surmonte tous les scénarios d'erreur courants liés aux demandes non valides et aux problèmes de serveur.
Pour obtenir des exemples de scénarios d'erreur à prendre en compte, voir Échecs de transaction courants. - Déterminez les réponses aux transactions qui nécessitent des actions supplémentaires de votre part et vérifiez que votre intégration prend les mesures attendues.
Outils de test
Pour tester votre intégration, American Express Payment Gateway propose quelques outils très utiles :
Simulateurs
Vous pouvez tester vos demandes à l'aide de différents simulateurs, auxquels vous accédez depuis votre compte de commerçant de test. Pour confirmer que vous utilisez votre compte de commerçant de test, vérifiez que l'ID du commerçant fourni par votre your payment service provider porte le préfixe « TEST ». Toutes les demandes envoyées avec l'ID de commerçant de test sont considérées comme des demandes de test et traitées par les simulateurs. Elles ne sont pas transmises aux prestataires, émetteurs et acquéreurs réels.- Si vous avez déjà reçu un ID de commerçant portant le préfixe « TEST », il s'agit de votre compte de commerçant de test. Votre prestataire de services de paiement vous envoie un autre ID de commerçant lorsque vous êtes prêt à traiter des transactions en direct.
- Le compte de commerçant de test est un compte totalement distinct, avec un mot de passe ou des certificats d'API différents de ceux de votre compte habituel. Lorsque vous passez de l'un à l'autre, veillez à modifier à la fois votre identifiant de commerçant et vos données d'authentification.
Pour les modes de paiement qui nécessitent que le payeur donne son approbation sur le site Web du prestataire de services de paiement, la passerelle fournit un simulateur de paiement interactif. Pour plus d'informations sur les fonctionnalités et options spécifiques du simulateur, voir les instructions de test dans les modes de paiement et la rubrique Intégration des paiements dans les navigateurs courants.
Cartes de test
Si vous prenez en charge les paiements par carte comme modes de paiement, la passerelle fournit des cartes de test pour vous permettre de tester différents scénarios, notamment l'authentification 3-D Secure. Pour plus d'informations, voir Cartes de test et Test de votre intégration pour l'authentification 3DS.Résultats de réponse prévisibles
Le simulateur de test est configuré pour générer des résultats prévisibles en fonction de la demande de transaction et des détails de la carte que vous fournissez. Pour plus d'informations, voir Cartes de test et Intégration des paiements dans les navigateurs courants.
Vous pouvez déclencher des réponses de transaction contenant un code de réponse American Express Payment Gateway ou un résultat de validation du cryptogramme visuel de la carte, ainsi qu'un code de réponse de vérification d'adresse, et vous assurer que votre intégration réagit de manière appropriée à chacun d'entre eux. Vous pouvez également recevoir des réponses spécifiques pour des fonctionnalités telles que les portefeuilles.
Échecs courants des transactions
Lorsque vous testez votre intégration, envisagez les scénarios d'échec de transaction suivants et assurez-vous que votre système y réagit de manière appropriée :
Autorisation de paiement refusée ou type de carte non accepté
Siresponse.gatewayCode
dans votre réponse de la transaction a une valeur commençant par DECLINED, l'autorisation de paiement n'a pas été approuvée par la banque émettrice ou le payeur tente d'utiliser un type de carte qui n'est pas accepté par la passerelle.
Étudiez le code exact de la passerelle et d'autres détails de la transaction pour déterminer plus précisément pourquoi le paiement a été refusé. Il se peut que vous deviez demander au payeur d'utiliser un autre mode de paiement pour résoudre le problème.Informations de la carte non valide
Siresponse.gatewayCode
dans la réponse de la transaction est défini surINVALID_CSC
,EXPIRED_CARD
ou une valeur similaire, le problème vient des détails de la carte du payeur. Soit le payeur les a mal saisis, soit la carte n'est plus valide. Vous devez demander au payeur de vérifier les détails de sa carte ou éventuellement d'utiliser une autre carte.Fonds insuffisants
Siresponse.gatewayCode
dans la réponse de la transaction est défini surINSUFFICIENT_FUNDS
, le compte du payeur ne dispose pas de fonds suffisants pour couvrir la transaction. Vous devez demander au payeur d'utiliser un autre mode de paiement ou une autre carte.Expiration de la transaction
Siresponse.gatewayCode
dans la réponse de la transaction est défini surTIMED_OUT
, la passerelle n'a pas reçu de réponse de l'acquéreur. Par conséquent, la transaction a été automatiquement interrompue. Vous devez réessayer plus tard.