Aller au contenu

Environnement de test et cartes de test

Testez tous les résultats de paiement dans la sandbox Cardencer : cartes acceptées, refus et authentifications 3D Secure.

La sandbox, disponible sur https://sandbox.cardencer.com, reproduit l'API de production mais achemine les paiements vers un processeur de test. Aucune banque n'intervient et aucun fonds réel n'est déplacé.

Sandbox ou production#

Sandbox Production
URL de base https://sandbox.cardencer.com https://api.cardencer.com
Clé secrète snd_… prd_…
Clé publiable pk_snd_… pk_prd_…
Mouvements de fonds Non Oui

Chaque clé ne fonctionne que dans son propre environnement : une clé snd_ utilisée sur api.cardencer.com, ou une clé prd_ utilisée sur la sandbox, renvoie une erreur 401 avec le code IR_01.

Cartes de test#

Utilisez n'importe quelle date d'expiration future et n'importe quel CVC à 3 chiffres.

Numéro de carte Réseau Résultat
4242 4242 4242 4242 Visa Accepté
5555 5555 5555 4444 Mastercard Accepté
4000 0000 0000 0002 Visa Refusé
4000 0000 0000 9987 Visa Refusé, carte perdue
4000 0000 0000 9979 Visa Refusé, carte volée
4000 0038 0000 0446 Visa Authentification 3D Secure, puis accepté

Envoyez le numéro sans espaces dans payment_method_data.card.card_number, ou saisissez-le dans le SDK de paiement.

Testez 3D Secure#

Créez un paiement avec 4000003800000446, "authentication_type": "three_ds" et une return_url :

curl https://sandbox.cardencer.com/payments \
  -H "api-key: $CARDENCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4900,
    "currency": "EUR",
    "confirm": true,
    "capture_method": "automatic",
    "authentication_type": "three_ds",
    "return_url": "https://example.com/checkout/complete",
    "payment_method": "card",
    "payment_method_type": "credit",
    "payment_method_data": {
      "card": {
        "card_number": "4000003800000446",
        "card_exp_month": "12",
        "card_exp_year": "2030",
        "card_holder_name": "Test Customer",
        "card_cvc": "123"
      }
    }
  }'

Le paiement renvoie "status": "requires_customer_action" avec un next_action.redirect_to_url. Ouvrez cette URL dans un navigateur, réalisez l'authentification de test : vous êtes redirigé vers votre return_url. Récupérez le paiement : son statut est désormais succeeded. Avec le SDK de paiement, l'authentification s'ouvre automatiquement. Consultez 3D Secure / SCA.

Testez les webhooks#

Votre endpoint de webhook reçoit les événements de la sandbox exactement comme il les recevra en production. Exposez un serveur local via un tunnel (par exemple ngrok http 3000), enregistrez l'URL HTTPS comme décrit dans Webhooks, puis lancez le paiement du démarrage rapide.

Ce que la sandbox ne simule pas#

  • Les délais de règlement et les virements vers votre compte bancaire.
  • Les décisions réelles des émetteurs : seules les cartes ci-dessus produisent des résultats déterministes.
  • Les litiges ouverts par les titulaires de carte.

Une fois vos parcours validés dans la sandbox, suivez Passer en production.