Andorpay
Retour au blog

Publié le · Mis à jour le

Tests Redsys : guide pour WooCommerce et API

Plan de tests Redsys pour WooCommerce et API : cartes sandbox, 3DS, refus, webhooks et renouvellements. Vérifiez vos commandes avant la production.

Ordinateur avec un formulaire de paiement et des repères pour tester confirmation, attente et retour.

Pour tester Redsys, commencez par le sandbox et les scénarios d’autorisation, de 3DS et de refus. Si vous cherchez une carte de test Redsys avec expiration et CVV, consultez le tableau des cartes et la configuration du sandbox. Ce guide présente le plan de tests complet pour WooCommerce ou une intégration API, y compris les renouvellements d’abonnements.

Tester une intégration de paiement consiste à vérifier que l'acheteur, le système d'encaissement et votre entreprise aboutissent au même résultat. Voir une page « paiement effectué » ne suffit pas. Il faut aussi savoir ce qui se passe lorsque la banque refuse l'opération, que le client ferme l'onglet ou qu'une confirmation arrive deux fois.

Pour une entreprise en Andorre qui connecte son terminal de paiement virtuel (TPV) à AndorPay, l'objectif est concret : encaisser au bon moment, livrer une seule fois et retrouver le déroulement d'une opération grâce à ses références. Ce guide organise les tests par scénarios et résultats vérifiables, pour une application sur mesure comme pour WooCommerce.

Ce qu'un test de paiement doit démontrer

Chaque test doit avoir un résultat attendu à trois niveaux : l'écran de l'acheteur, l'état du paiement et celui de la commande ou du service. Si le paiement est confirmé mais que la commande reste en attente, il reste un problème à résoudre.

Ajoutez une quatrième vérification : l'action déclenchée dans votre entreprise. Préparer un colis, ouvrir un accès ou envoyer une confirmation doit respecter la règle prévue, sans doublon. Un état correct en base de données ne suffit pas si l'entrepôt reçoit deux demandes de préparation.

Prenons l'achat d'une ressource numérique. Vous attendez un paiement confirmé, une commande payée et un seul accès actif. Si la notification arrive de nouveau, cet accès doit rester unique. Vous remplacez ainsi un vague « ça fonctionne » par un critère précis.

Préparez un environnement distinct des ventes réelles

Utilisez les identifiants de sandbox, l'environnement de test. Chez AndorPay, une clé commençant par ap_test_ détermine l'environnement de test de la session ; les clés de production commencent par ap_live_. Une fois la session créée, son environnement ne change plus.

Vérifiez aussi les identifiants du commerçant et du terminal Redsys utilisés pour les essais. Une bonne clé d'application ne corrige pas une mauvaise configuration bancaire. Pour le paiement par carte avec inSite, l'origine HTTPS exacte sur laquelle le formulaire se charge doit être autorisée.

Préparez une commande facilement identifiable, un acheteur fictif et une adresse de retour valide. Évitez qu'un essai déclenche une véritable expédition ou un courriel ambigu à un client. Le point de réception des notifications doit être accessible en HTTPS et utiliser le secret de signature du bon environnement.

Notre guide des tests AndorPay présente les données et conditions en vigueur. Pour les cartes, consultez aussi les environnements officiels de Redsys. Les données de test ne permettent pas de payer en production.

Choisir les outils selon ce que vous cherchez à vérifier

Vous n'avez pas besoin d'accumuler les logiciels. Vous devez pouvoir observer la requête, la réponse, le parcours de l'acheteur et le résultat dans votre activité.

Outil Ce qu'il permet de vérifier Ce qu'il ne prouve pas à lui seul
Client HTTP ou cURL Authentification, données transmises et réponse de l'API Que l'acheteur a payé
Navigateur et outils de développement Redirection, messages, erreurs et affichage mobile L'état bancaire définitif
Journaux du serveur Réception des événements et application des règles Ce que l'acheteur a vu
Consultation de la commande et du paiement Correspondance des références et des états Que tous les incidents sont couverts
Test automatisé Répétition de scénarios contrôlés Le fonctionnement réel avec tous les appareils et banques

Commencez par une requête minimale qui fonctionne, puis intégrez-la à votre application. Vous distinguerez plus facilement une erreur d'identifiants d'un problème introduit par votre code. Conservez les références qui permettent de suivre l'opération d'un système à l'autre.

Lorsqu'un test échoue, modifiez un seul élément à la fois. Changer simultanément les identifiants, le domaine et les données de commande rend le diagnostic incertain. Rejouez ensuite le scénario initial et notez la version effectivement testée.

Créer une session ne signifie pas avoir encaissé

Dans l'intégration REST, une création réussie renvoie l'adresse de la page de paiement hébergée. Ouvrez cette adresse telle que l'API la fournit. Ne reconstituez pas une URL et ne traitez pas la création de la session comme une vente payée.

Avant d'essayer une carte, vérifiez trois cas : identifiants incorrects, données invalides et création valide. Les deux premiers doivent produire une erreur compréhensible et laisser la commande impayée. Le troisième doit conserver le lien entre commande et session avant d'envoyer le client vers la page de paiement.

Respectez le contrat propre à chaque opération. Par exemple, POST /v1/checkouts n'accepte pas l'en-tête Idempotency-Key. L'ajouter systématiquement à toutes les requêtes provoque une erreur. La documentation REST décrit le fonctionnement de cet endpoint.

Si l'application perd la réponse ou reçoit un état en attente, examinez la session et l'opération existantes avant de créer un nouvel encaissement. Réessayer une communication et demander une nouvelle autorisation de paiement sont deux actions distinctes.

Les scénarios essentiels à tester avec une carte

Utilisez les scénarios disponibles dans votre environnement bancaire et les données de test correspondantes. Définissez le résultat attendu avant chaque essai.

Scénario Ce que doit voir l'acheteur Ce que doit vérifier l'entreprise
Paiement autorisé Confirmation et prochaine étape claires Paiement confirmé et livraison unique
Authentification supplémentaire Instructions pour terminer la validation Commande en attente jusqu'au résultat
Paiement refusé Message utile et suite adaptée Aucune livraison ni commande marquée payée
Annulation par le client Retour compréhensible vers l'achat État conforme au résultat réel
Fermeture de l'onglet Possibilité de consulter l'achat plus tard Confirmation indépendante du retour du client
Réponse en attente Message d'attente qui n'incite pas à payer de nouveau Vérification puis résolution de l'opération existante

Pour l'authentification supplémentaire, testez à la fois sa réussite et son abandon. Un parcours rapide réussi ne montre pas comment la boutique se comporte lorsque la banque demande une étape de plus.

Refaites ensuite un achat sur mobile. Vérifiez le clavier, le défilement, le passage à l'application bancaire et le retour au navigateur. L'acheteur doit reconnaître le produit et le montant total tout au long du parcours.

Incluez les options réellement utilisées dans votre boutique : livraison, réduction ou changement de quantité. Le total transmis pour le paiement doit correspondre à la commande que votre équipe préparera, y compris après une modification du panier.

Le retour du navigateur ne confirme pas le paiement

Une adresse de retour après succès sert à poursuivre le parcours de l'acheteur. Elle ne doit pas être la seule condition de livraison. Le client peut fermer l'onglet après l'autorisation ; il peut aussi rouvrir une ancienne adresse sans effectuer un nouvel achat.

Vérifiez que le serveur prend sa décision à partir d'une confirmation vérifiée ou d'une consultation autorisée de l'état du paiement. Rouvrez la page de retour : elle ne doit ni déclencher une seconde livraison ni modifier arbitrairement le résultat.

Faites également l'essai inverse : fermez le navigateur après l'autorisation et observez la commande. Si elle se termine correctement grâce à la notification, vous aurez vérifié que votre activité ne dépend pas du dernier clic du client.

Testez les notifications, y compris leurs échecs

Un webhook est une notification envoyée à votre serveur. Chez AndorPay, sa signature doit être vérifiée avant de déclencher une action. Le guide des webhooks détaille cette vérification sur le corps original du message et la fenêtre temporelle admise.

Préparez ces scénarios dans un environnement contrôlé :

  1. Signature valide : le serveur accepte l'événement et met à jour la bonne opération.
  2. Signature modifiée : il refuse le message sans changer les commandes ou les accès.
  3. Horodatage hors de la fenêtre autorisée : il rejette le message conformément au contrat.
  4. Panne temporaire du récepteur : une livraison ultérieure peut terminer le travail en attente.
  5. Même événement reçu plusieurs fois : son identifiant permet de le reconnaître, sans répéter la livraison.
  6. Événements reçus dans un ordre différent : le système conserve un état cohérent et ne décide pas seulement selon leur ordre d'arrivée.

La détection des doublons doit aussi protéger les actions secondaires. Vérifiez le courriel, l'accès et la tâche de préparation, pas seulement l'enregistrement de la commande. Un événement répété ne doit pas entraîner plusieurs actions commerciales équivalentes.

Simulez une indisponibilité du récepteur sur une installation de test. Notez l'événement resté en attente, sa nouvelle réception et l'action finalement exécutée. N'interrompez pas volontairement la réception des ventes réelles pour réaliser cet essai.

Pour une boutique WooCommerce

Effectuez l'essai dans une fenêtre privée avec un produit identifiable. Vérifiez la configuration de test du plugin, la devise et le parcours réellement utilisé par la boutique. Incluez votre type de page de commande et les extensions qui modifient les champs, les livraisons ou les remises.

Après le paiement, consultez l'état de la commande, ses notes et la référence de transaction. Le message affiché doit correspondre à ces données. Si plusieurs onglets sont ouverts, vérifiez également que l'opération appartient à la bonne commande.

Le plugin utilise des notifications et des mécanismes de récupération. Lorsqu'une confirmation tarde, examinez l'accessibilité de l'endpoint et les tâches planifiées avant de conclure à un refus bancaire. Pour le diagnostic technique, les journaux andorpay-card-gateway et le groupe andorpay-card d'Action Scheduler permettent de suivre le parcours.

L'action de synchronisation du paiement consulte l'opération existante. Elle aide à retrouver son état ; elle ne crée pas une nouvelle autorisation et ne justifie pas de marquer manuellement une commande comme payée sans vérification. Suivez le guide WooCommerce pour la configuration actuelle.

Apple Pay, Google Pay et Bizum demandent leurs propres essais

L'affichage d'un bouton ne prouve pas qu'une autorisation complète a réussi. Vérifiez d'abord la compatibilité de l'appareil et du navigateur, puis l'ouverture du moyen de paiement et enfin le résultat de l'opération, lorsque l'environnement le permet.

Avec Apple Pay, un essai peut valider la feuille de paiement et la session du commerçant sans terminer une autorisation dans le sandbox habituel de Redsys. Le test complet dépend de l'environnement de certification convenu et des fonctions activées.

Avec Google Pay, ouvrir la feuille en mode test ne prouve pas non plus une autorisation Redsys. Les conditions concernant le terminal, X-PAY et le type d'identifiant de test doivent correspondre à la documentation.

Pour Bizum, notre intégration utilise RTP. Vérifiez sa disponibilité et les scénarios de l'environnement concerné. Ne supposez pas qu'un échec entraîne automatiquement un passage au parcours classique par redirection. Distinguez clairement la partie testée de celle qui reste à valider.

Abonnements : vérifiez aussi ce qui suit l'inscription

Si vous encaissez des abonnements, un premier achat réussi ne valide pas le renouvellement. Ajoutez un cycle de renouvellement, un échec de paiement et les actions qui suivent dans votre application.

Vérifiez la période à laquelle correspond le paiement et son effet sur l'accès au service. Par exemple, un échec ne doit pas créer un deuxième abonnement identique. Définissez le message adressé au client et les informations accessibles à la personne qui traitera l'incident.

Les opérations disponibles dépendent de la configuration du compte et du contrat documenté. Une fonction non activée doit produire un résultat maîtrisé. Ne transformez pas cette erreur en fausse confirmation pour donner l'impression que le parcours est complet.

Distinguez également les remboursements des encaissements. L'API de remboursement sur Redsys n'est pas activée dans le parcours documenté d'AndorPay. Le test doit vérifier qu'une opération non prise en charge ne marque pas à tort le paiement comme remboursé. La procédure applicable doit être convenue par le canal approprié.

Quelles informations conserver pour comprendre un incident

Préparez une courte fiche pour chaque test. Une autre personne doit pouvoir reconstituer les faits sans relancer un paiement « pour voir ».

Champ Exemple d'information utile
Scénario Authentification terminée, puis navigateur fermé
Environnement Sandbox et version de l'intégration
Références Commande, session, request_id et event.id, lorsqu'ils existent
Résultat attendu Commande payée et accès unique
Résultat observé États du paiement et de la commande, action exécutée
Preuve Heure, réponse pertinente et journal sans secrets
Suivi Erreur corrigée ou limite restant à vérifier

N'y incluez ni clés d'API, ni secrets, ni numéros complets de carte, ni codes de sécurité. Conservez les identifiants et messages utiles au diagnostic. La preuve doit expliquer une opération sans devenir une copie des données de paiement.

Quand considérer les tests comme terminés

Un scénario peut être clôturé lorsque le résultat observé correspond au résultat attendu et que les actions ne sont exécutées qu'une fois. Si vous avez uniquement vérifié l'ouverture d'un portefeuille numérique, notez précisément cette portée. Cela ne valide pas encore le moyen de paiement complet.

Avant la production, vérifiez les identifiants, les domaines autorisés et la réception des événements dans cet environnement. La validation réelle doit avoir un périmètre convenu et une autorisation pour l'opération. Sandbox et production constituent deux vérifications différentes.

Gardez une courte sélection de tests à rejouer après une mise à jour du plugin, une modification de la page de commande ou un changement des règles de livraison. Priorisez l'autorisation, le refus, la confirmation en double et la récupération d'un état : ces cas touchent directement l'encaissement et le service client.

Préparer une intégration utilisable au quotidien

Si vous choisissez encore votre mode de connexion, commencez par la différence entre page de paiement hébergée et API. Pour une application sur mesure, notre guide des SDK pour intégrer les paiements précise ce que l'outil prend en charge et ce qui reste dans votre application.

Chez AndorPay, nous pouvons examiner avec vous le parcours nécessaire à votre entreprise en Andorre et les vérifications de sa connexion. Présentez-nous votre plateforme et votre façon d'encaisser pour préparer une intégration avec des résultats clairs dès le premier test.

WhatsApp