Flux d'achat 3DS
Gérez l'authentification en attente, présentez l'action suivante et confirmez le statut de paiement final.
Sur cette page
Soumettez le paiement par carte une seule fois, présentez toute action 3DS suivante renvoyée et vérifiez le résultat du paiement sur votre backend. L’expérience d’authentification peut recueillir des signaux du navigateur, se terminer sans défi ou demander au client de s’authentifier auprès de sa banque.
L’authentification peut échouer ou être interrompue à n’importe quelle étape. Le diagramme montre le parcours normal ; le statut actuel du paiement détermine si vous devez attendre, exécuter la commande ou proposer une récupération.
Responsabilités de votre intégration#
Votre backend crée le paiement et vérifie son résultat. Votre checkout présente l’action renvoyée et conserve le contexte de la commande initiale. DEUNA coordonne les vérifications du navigateur, l’authentification et toute autorisation restante avec le prestataire connecté ; l’émetteur contrôle le défi et la décision d’authentification.
Ne construisez pas votre propre séquence d’appels d’authentification au prestataire et ne supposez pas que chaque étape du diagramme nécessite une requête API distincte du marchand. Utilisez l’action renvoyée via l’intégration prise en charge pour votre connexion.
1. Créez le paiement#
Utilisez l'un des modèles de paiement par carte pris en charge :
- Créez une commande avec Créer une commande, puis payez-le avec Créer un paiement.
- Utilisez la requête unique Créer un paiement flux quand cela correspond à votre intégration.
Envoyez des informations complètes sur l'acheteur, la facturation, la commande et l'appareil. Ces signaux aident l'émetteur à décider si l'authentification peut se faire sans friction.
2. Inspectez la réponse de paiement#
Une réponse 3DS en attente peut inclure les champs suivants. Cet exemple montre uniquement les champs nécessaires pour poursuivre le flux :
{
"order": {
"payment": {
"data": {
"status": "pending_3ds",
"next_action": {
"action": "authorization_3ds",
"authorization_3ds": {
"url_challenge": "https://api.deuna.io/transactions/next-action/NEXT_ACTION_ID"
}
}
}
}
}
}Utilisez ces champs comme source de vérité :
| Champ | Signification | Action |
|---|---|---|
order.payment.data.status | pending_3ds signifie que le flux de paiement 3DS n’est pas résolu. | Bloquez l’exécution de la commande et traitez l’action renvoyée. |
order.payment.data.next_action.action | Identifie l’action client requise. | Poignée authorization_3ds avec le SDK DEUNA pris en charge ou les données de défi renvoyées. |
order.payment.data.next_action.authorization_3ds.url_challenge | URL DEUNA pour l’étape d’authentification suivante, qui peut inclure des vérifications du navigateur avant un défi. | Utilisez exactement l’URL renvoyée dans le mode de présentation pris en charge pour la connexion. |
Pour des raisons de compatibilité, certaines intégrations peuvent également recevoir un niveau supérieur authorization_3ds objet. Les nouvelles implémentations devraient préférer next_action.
3. Présentez la prochaine action#
SDK Web
Utilisation initNextAction(...) lorsque vous souhaitez que DEUNA gère le comportement modal, iframe ou de redirection pris en charge. Voir le Référence du SDK Web.
Si un Payment Widget DEUNA gère déjà le parcours de paiement, laissez ce widget traiter l’action renvoyée. N’ouvrez pas une seconde instance de Next Action pour la même tentative. Pour un formulaire de paiement géré par le marchand, consultez le Widget "Prochaine action".
Intégration directe du navigateur
Si vous gérez vous-même la prochaine action :
- Utilisez le retour
url_challenge; ne construisez pas d'URL 3DS. - Suivez le mode de présentation configuré. Ne forcez pas une page d'émetteur dans une iframe lorsqu'une redirection de niveau supérieur est requise.
- Préservez vos URL de succès, d’échec et de retour.
- Traitez une fenêtre fermée, un rappel ou une redirection comme un signal pour récupérer l'état, et non comme un succès de paiement.
Applications natives
Utilisez le SDK DEUNA pris en charge ou un navigateur système/une vue Web sécurisé. Configurez le lien de retour/profond et restaurez le contexte de paiement lorsque l'acheteur revient sur l'application.
Vérifications du navigateur avant un défi
L’expérience renvoyée peut recueillir des signaux du navigateur et de l’appareil avant que l’émetteur décide de demander un défi. Cette étape ne nécessite pas que le client saisisse un code ou approuve un paiement. Gardez l’écran de chargement et l’interface d’authentification disponibles jusqu’à la poursuite du flux.
Si la collecte des données du navigateur ne se termine pas dans son délai d’attente, le flux géré peut continuer avec ce résultat. Cela ne signifie pas, à lui seul, que l’authentification a échoué ou que le paiement a réussi. Ne remplacez pas l’action renvoyée par un échec déclenché par un délai local et ne lancez pas un nouvel achat.
4. Attendez le statut de paiement final#
La fin des vérifications du navigateur, la fin du défi, une URL de retour et un callback du SDK sont des signaux invitant à rapprocher la commande initiale. Aucun ne prouve que les fonds ont été encaissés. L’authentification peut se terminer en même temps que l’autorisation, ou DEUNA peut encore devoir finaliser le paiement ensuite.
Utilisez les deux :
- les webhooks de statut de paiement configurés et vérifiés pour les mises à jour du backend ; et
- Obtenir la commande lorsque le client revient ou lorsque votre système doit rapprocher un résultat incertain.
| Résultat | Signification | Action d'exécution |
|---|---|---|
processed | Achat terminé. | Remplissez une fois vos chèques professionnels réussis. |
authorized | Les fonds ont été autorisés mais n'ont pas été récupérés. | Suivez votre stratégie de capture ; ne pas traiter comme capturé. |
pending_3ds | Le flux 3DS reste non résolu, avec ou sans défi visible. | Gardez l’expérience actuelle disponible ; n’exécutez pas la commande et ne redémarrez pas automatiquement. |
pending, processing, ou authorizing | Le paiement est toujours en cours. | Poursuivez le rapprochement ; n’envoyez pas un nouvel achat pour terminer le 3DS. |
denied, cancelled, ou expired | Le paiement n'a pas été finalisé. | Affichez un résultat récupérable et démarrez une nouvelle tentative uniquement lorsque cela est approprié. |
Voir Flux de travail et statuts de paiement pour chaque état et transition de paiement public.
5. Gérez l’authentification sans friction#
Frictionless signifie que le client n’effectue aucun défi de l’émetteur. L’expérience navigateur renvoyée peut néanmoins être nécessaire pour recueillir les signaux de l’appareil et poursuivre le traitement du paiement. Votre code doit prendre en charge les deux résultats :
- un statut de paiement final ou en cours immédiat ; ou
pending_3dsplus unauthorization_3dsprochaine action.
N'exigez pas la présence d'une URL de défi pour déterminer si 3DS a été évalué.
Un paiement réussi sans défi ne prouve pas, à lui seul, que l’authentification 3DS a réussi. Utilisez les détails d’authentification communiqués lorsque le support ou l’analyse de responsabilité l’exige.
6. Délais d'attente et tentatives#
La collecte des données du navigateur, le chargement de l’écran du défi, l’authentification de l’émetteur et le traitement du paiement ont des délais d’attente différents. Un chargement lent ou un délai local dépassé ne détermine pas le résultat du paiement. Confirmez la fenêtre d’authentification applicable à votre connexion pendant la certification ; ne définissez pas une durée universelle fixe pour les défis.
- Ne réutilisez pas une URL de défi expirée.
- Ne créez pas de tentatives de paiement répétées alors que le premier paiement n’est pas résolu.
- Utilisez le statut final et
allow_retry/guide d'erreur standardisé lorsqu'il est disponible avant de proposer une autre tentative. - Si le routage sélectionne une autre connexion compatible, laissez DEUNA décider si un résultat d'authentification existant peut être réutilisé.
Après la fermeture d’un écran, une interruption réseau ou un délai dépassé, récupérez la commande initiale avant de proposer une nouvelle tentative. Si le paiement reste non résolu, affichez un résultat en attente et poursuivez le rapprochement. En cas d’échec, appliquez l’erreur et les conditions de nouvelle tentative communiquées. Une fermeture côté client ne garantit pas l’annulation du paiement sur le backend.
7. Interprétez les détails d’authentification en toute sécurité#
DEUNA Admin peut afficher les résultats techniques 3DS tels que la version du protocole, le type de flux, l'ECI, le résultat de l'authentification et les identifiants de transaction réseau. Utilisez-les pour l’assistance, la réconciliation et l’analyse des litiges.
Ne stockez pas et n'exposez pas de cryptogrammes bruts, de réponses d'authentification complètes et ne contestez pas le code HTML dans les journaux des commerçants. Un statut de paiement (et non un événement ECI ou de fin de défi) contrôle l'exécution.