Aller au contenu

3D Secure / SCA

Comment Cardencer gère 3D Secure 2 et l'authentification forte du client pour les paiements par carte dans l'UE, avec le SDK de paiement ou l'API.

La DSP2 impose l'authentification forte du client (SCA) pour la plupart des paiements par carte en ligne dans l'UE. Cardencer la prend en charge avec 3D Secure 2 (3DS2) : les exemptions sont appliquées lorsqu'elles sont possibles, et le client n'est invité à s'authentifier auprès de sa banque que si l'émetteur l'exige. 3DS2 est inclus dans votre tarification.

Avec le SDK de paiement#

Rien à développer. Lorsqu'un paiement nécessite une authentification, le SDK ouvre l'authentification de l'émetteur, puis finalise le paiement ou redirige vers votre return_url. Transmettez toujours une return_url lorsque vous créez ou confirmez le paiement.

Contrôlez le déclenchement de 3DS#

Définissez authentication_type à la création du paiement :

Valeur Comportement
three_ds Toujours demander 3D Secure. Si l'émetteur accorde un parcours sans friction (frictionless), le client ne voit rien.
no_three_ds Ne pas demander 3D Secure. Si l'émetteur l'exige malgré tout (soft decline), Cardencer réessaie avec authentification.
curl https://sandbox.cardencer.com/payments \
  -H "api-key: $CARDENCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4900,
    "currency": "EUR",
    "authentication_type": "three_ds",
    "return_url": "https://example.com/checkout/complete"
  }'

Déroulement du flux#

  1. Le client valide sa carte, ce qui confirme le paiement.
  2. Cardencer vérifie si 3DS est requis et contacte l'Access Control Server (ACS) de l'émetteur.
  3. Selon l'émetteur :
    • Non requis (exemption ou frictionless) : le paiement se poursuit et se termine en succeeded.
    • Requis : le paiement passe en requires_customer_action et la réponse contient next_action.
  4. Le client réalise l'authentification (application bancaire, code à usage unique) et revient sur votre return_url.
  5. Le paiement se termine en succeeded si l'authentification a réussi, ou en requires_payment_method en cas d'échec. Demandez une autre carte, ou confirmez à nouveau pour relancer 3DS.

Serveur à serveur : gérez la redirection#

Si vous confirmez depuis votre serveur, examinez next_action lorsque le statut est requires_customer_action :

json
{
  "payment_id": "pay_mbabizu24mvu3mela5njyhpit4",
  "status": "requires_customer_action",
  "next_action": {
    "type": "redirect_to_url",
    "redirect_to_url": "https://sandbox.cardencer.com/payments/redirect/pay_mbabizu24mvu3mela5njyhpit4/merchant_1/pay_mbabizu24mvu3mela5njyhpit4_1"
  }
}

Redirigez le navigateur du client vers next_action.redirect_to_url. Après l'authentification, Cardencer le renvoie vers votre return_url avec des paramètres de requête tels que status et payment_intent_client_secret.

const payment = await confirmResponse.json();
if (payment.status === "requires_customer_action" && payment.next_action?.type === "redirect_to_url") {
  return res.redirect(payment.next_action.redirect_to_url);
}

Les paramètres de requête de la return_url peuvent être falsifiés. Récupérez le paiement avec votre clé secrète (GET /payments/{payment_id}) avant de traiter la commande.

Testez#

Utilisez 4000 0038 0000 0446 dans la sandbox : cette carte déclenche systématiquement une authentification, puis le paiement est accepté. Consultez Environnement de test et cartes de test.