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.