Configuration 

Introduction

Le Contrôle des doublons dans Axepta Online est conçue pour détecter et gérer les tentatives de paiement en double sur plusieurs canaux (API, HPP, etc.). Elle garantit que les utilisateurs et les commerçants ne déclenchent pas accidentellement plusieurs paiements avec les mêmes paramètres, y compris les cas où un paiement est déjà en cours.

Objectifs du Contrôle de Duplication

Les paiements en double peuvent provenir de plusieurs causes :

• Erreurs d'interaction utilisateur (par exemple, rafraîchissement, double-clic)
• Problèmes de logique côté commerçant (par exemple, boucles de réessai)
• Latence du réseau ou délais d'attente entraînant une incertitude sur le statut du paiement
• Tentatives de paiement encore **en cours** lorsque une nouvelle demande est soumise

Fonctionnement

1. Vérification Précoce

Les vérifications de duplication sont déclenchées avant l'affichage de la page de paiement :

• Si une duplication est détectée, l'utilisateur est redirigé sur l'url Failure
• Aucun paiement n'est soumis si la demande correspond à une transaction existante ou en cours.

2. Scénarios Couverts

• Erreur Utilisateur
  • Lorsque un client tente de soumettre le même paiement plusieurs fois via une Page de Paiement Hôte (HPP), Axepta Online :
    • Vérifie si la demande est une duplication d'une transaction récente.
    • Affiche un message d'information sur la page de confirmation pour empêcher les soumissions en double.
• Erreur Commerçant
  • Si un commerçant envoie une demande API contenant des paramètres identiques à une transaction existante, Axepta Online :
    • Identifie la tentative comme une duplication.
    • Récupère les détails du paiement original et retourne un statut d'échec sans enregistrer une nouvelle transaction.
    • Dans certains cas, un lien de redirection vers une page d'information peut être fourni.
• Transactions en Cours
  • Transactions qui sont initiées mais non finalisées (par exemple, le porteur de la carte est toujours sur la page de paiement).
    • Le système marque celles-ci comme "en cours" et bloque les nouvelles tentatives avec les mêmes identifiants.
    • Assure une expérience de paiement fluide sans confusion.

Mise en Œuvre Technique

1. Cas d'usage

Paiement réalisé via la Page de choix du moyen de paiement (HPP) ou le formulaire de paiement par carte (payssl)

Il est nécessaire d'ajouter au moins un des paramètres suivants dans l'appel à paymentpage.aspx ou payssl.aspx

• OrderID - ANS..30
• InvoiceID - ANS..30

Vérification de Duplication via API

L'API Axepta Online fournit un endpoint permettant aux commerçants de vérifier si une transaction est une duplication avant de la soumettre :

• Endpoint : `DuplicationCheck.aspx`
• Paramètre :  `OrderID` ou `InvoiceID` (obligatoire), `Amount`, `Currency`.
• Période de Rétention** pour la vérification des transactions en double : configurable (par défaut : 4 jours)
• Suivi en cours**, les seuils de délai d'attente peuvent être configurés (30 minutes).

2. Format de Réponse

L'API retourne un statut indiquant si une transaction est une duplication :

 Si une duplication est détectée, la réponse inclut également les détails de la transaction existante (PayID, TransactionID, Date, etc.).