Chargement de vos clés API…

Cartes de test

Numéros de cartes bancaires acceptés en mode sandbox. Aucun débit réel, aucun risque.

Regles globales

Date d'expiration
N'importe quelle date future 12/30.
CVV
123 pour Visa/Mastercard/Maestro, 1234 pour American Express.
Titulaire
N'importe quel nom (ex : M. TEST).
Mode sandbox uniquement
Cles sk_test_*. En production, ces numéros sont refusés.

Cartes 3D-Secure

Selon la carte, le paiement déclenche soit un challenge (saisie d'un code par l'acheteur), soit un parcours frictionless (authentification silencieuse). Couvrir les deux est obligatoire pour passer en production (PSD2).

NuméroRéseau3DSComportementCVV
CB / VisaChallenge3DS avec challenge (saisie d'un code recu)123
CB / VisaFrictionless3DS frictionless (sans challenge)123
CB / VisaFrictionlessFrictionless succes (Y/C)123
VisaPaiement reussi standard123
MastercardToujours succes123
MastercardFrictionlessFrictionless Y/C (succes)123
MastercardChallenge3DS Challenge123
American ExpressChallenge3DS Challenge1234
American ExpressFrictionlessFrictionless Y (succes)1234
American ExpressFrictionlessFrictionless R (refus emetteur)1234
MaestroChallenge3DS Challenge123

Simuler un refus, un plafond ou des fonds insuffisants

Deux méthodes pour déclencher un code retour spécifique. La plus simple : choisir un montant dans la grille ci-dessous.

Méthode 1 : par le montant

3,3300000

Succes

333,0501100

Refus generique

333,0801108

Fonds insuffisants

333,1601116

Plafond depasse

333,1901119

Refus emetteur

Méthode 2 : par le numéro de carte

Remplacer le 10e chiffre par 9, inserer le code retour, puis recalculer le dernier chiffre via l'algorithme de Luhn. Exemple pour code 01206 : .

Tester un parcours complet

  1. 1

    Créer une session de paiement

    Appelez POST /api/v1/payments/sessions avec un montant et une référence.

  2. 2

    Ouvrir l'URL de paiement

    L'API retourne checkoutUrl. Redirigez le client (ou ouvrez dans un navigateur pour tester).

  3. 3

    Saisir une carte de test

    Numéro ci-dessus + date future (ex: 12/30) + CVV de la carte.

  4. 4

    Si 3DS Challenge : valider

    Suivre le parcours d'authentification (code OTP factice ou cliquer sur OK).

  5. 5

    Vérifier la redirection

    Le client revient sur votre redirectUrl avec le statut du paiement.

  6. 6

    Recevoir le webhook

    Événement payment.succeeded ou payment.failed sur votre endpoint configuré.

Ces numéros sont valables uniquement en environnement sandbox. Pour toute question, contactez le support.