Documentation pour les développeurs
Cartes de test Redsys et guide du sandbox
Validez votre intégration avec les cartes de test Redsys et vos propres identifiants sandbox. Vérifiez le résultat bancaire, la commande et la livraison, ainsi que le parcours de l’acheteur.
Cartes de test Redsys : numéro, expiration et CVV
| Scénario | Carte | Expiration | CVV |
|---|---|---|---|
| VISA générique · EMV3DS 2.2 | 4548810000000003 | 12/49 | 123 |
| Autorisation sans challenge · EMV3DS 2.1 | 4548814479727229 | 12/49 | 123 |
| Autorisation avec challenge · EMV3DS 2.1 | 4548817212493017 | 12/49 | 123 |
| Refus · réussir l’authentification dans le simulateur | 4548810000000003 | 12/49 | 999 |
12/49 est un exemple de date d’expiration ; Redsys accepte une date future. Le CVV 999 simule un refus avec la carte générique. Réussissez l’authentification dans le simulateur pour vérifier ce refus.
Cartes et environnements de test officiels Redsys
Testez aussi l’abandon du challenge, le rechargement et le retour tardif. Si le résultat est incertain, consultez l’opération existante avant de demander un autre débit.
Préparer l’environnement de test
- 1
Configurez votre compte Redsys de test
Enregistrez le FUC, le terminal et le secret sandbox fournis pour votre TPV. Les identifiants de production sont différents. Le compte de démonstration générique Redsys ne remplace pas l’activation d’inSite pour votre commerce. - 2
Générez une clé ap_test_
La clé API fixe l’environnement du checkout lors de sa création. Ne réutilisez pas une clé ap_live_ pendant les tests. - 3
Autorisez le domaine
Redsys inSite doit autoriser l’origine HTTPS exacte où le formulaire de carte est chargé. - 4
Configurez le webhook
Utilisez une URL HTTPS publique et conservez le secret de signature sandbox sur le serveur.
Tester Bizum
Dans le sandbox utilisé par notre intégration, utilisez le numéro 700 000 000 (+34700000000). Un montant inférieur à 5 € est autorisé, entre 5 € et 10 € il est refusé, et au-delà de 10 € le test n’est pas pris en charge. Confirmez les conditions de l’environnement attribué à votre terminal.
Vérifiez l’autorisation dans l’application bancaire, le refus, l’abandon et le callback tardif. Bizum nécessite l’activation de RTP par la banque ; AndorPay ne passe pas automatiquement à une redirection classique si RTP n’est pas disponible.
Tester Apple Pay et Google Pay
Apple Pay
Apple Sandbox permet de vérifier la feuille de paiement, l’éligibilité et la session du commerce dans Safari sur un appareil compatible. Le sandbox Redsys standard peut refuser X-PAY. Une autorisation complète nécessite l’environnement de certification convenu avec Redsys ou votre banque.
Google Pay
Dans Configuration → Rails → Redsys, sélectionnez Test, activez Google Pay et enregistrez. Le choix est conservé par environnement : une activation en test ne l’active pas en production.
L’intégration utilise Google TEST et gateway=redsys. La feuille peut s’ouvrir sans merchant ID de production, mais l’autorisation nécessite X-PAY sur le terminal et une carte compatible avec CRYPTOGRAM_3DS.
Tester les webhooks et éviter les effets en double
| Cas | Résultat attendu |
|---|---|
| Signature valide | L’endpoint accepte le corps exact et renvoie 2xx. |
| Signature modifiée | Renvoie 400 avant d’interpréter ou d’appliquer l’événement. |
| Horodatage ancien | Rejette un écart supérieur à 5 minutes. |
| Réponse 500 | AndorPay conserve event.id et programme une nouvelle livraison. |
| Événement répété | Reconnaît event.id sans répéter l’effet métier. |
| Événements désordonnés | Décide selon le contenu et l’état, pas seulement selon l’ordre d’arrivée. |
Tester les paiements récurrents Redsys
Un premier paiement réussi ne valide pas un abonnement complet. Avec la tokenisation et la récurrence activées sur le terminal de test, vérifiez aussi ces scénarios :
| Cas | Résultat attendu |
|---|---|
| Souscription et première opération | Reliez le client, son consentement, la référence de paiement et l’abonnement. |
| Renouvellement ultérieur | Vérifiez une opération MIT et la période correspondante, sans répéter l’achat initial. |
| Renouvellement refusé ou en attente | Ne prolongez pas l’accès comme si le paiement était confirmé ; résolvez l’état avant un autre débit. |
| Notification répétée | Un paiement ne prolonge pas deux fois la période et ne duplique pas la livraison. |
| Résiliation | Vérifiez sa date d’effet et l’absence de débit programmé après la résiliation effective. |
Conditions et fonctionnement des paiements récurrents en Andorre
Critères pour terminer les tests
Une autorisation et un refus doivent produire des états cohérents dans Redsys, AndorPay et votre application. Le webhook valide déclenche une seule fois l’effet attendu ; une signature invalide ne le déclenche pas ; un paiement en attente n’entraîne pas un second débit à l’aveugle.
Répétez le parcours sur ordinateur et mobile. Conservez request_id, event.id et la référence interne de commande, sans enregistrer les clés API, secrets, PAN, dates d’expiration ou CVV.
Étapes suivantes
Documentation technique complémentaire en espagnol : Signature et nouvelles tentatives des webhooks · Passage en production