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#
- Le client valide sa carte, ce qui confirme le paiement.
- Cardencer vérifie si 3DS est requis et contacte l'Access Control Server (ACS) de l'émetteur.
- Selon l'émetteur :
- Non requis (exemption ou frictionless) : le paiement se poursuit et se termine en
succeeded. - Requis : le paiement passe en
requires_customer_actionet la réponse contientnext_action.
- Non requis (exemption ou frictionless) : le paiement se poursuit et se termine en
- Le client réalise l'authentification (application bancaire, code à usage unique) et revient sur votre
return_url. - Le paiement se termine en
succeededsi l'authentification a réussi, ou enrequires_payment_methoden 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 :
{
"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);
}payment = confirm_response.json()
if payment["status"] == "requires_customer_action" and payment["next_action"]["type"] == "redirect_to_url":
return 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.