Soft Decline

Lors du traitement des transactions en ligne pour les méthodes de paiement de type carte, un contrôle d'authentification 3-D Secure via SCA est généralement obligatoire. Néanmoins, la directive SCA offre également la possibilité de mettre en œuvre cette étape d'authentification en arrière-plan (cinématique d'authentification frictionless ou passive), la rendant imperceptible pour vos clients.

Cependant, il est toujours possible que la banque de votre client requiert une authentification active de sa part (cinématique d'authentification forte), refusant alors la transaction.

Notre mécanisme Soft Decline est un excellent moyen de récupérer ces transactions refusées. Il vous permet de renvoyer de nouveau la transaction à notre plateforme après un premier rejet en raison d'une tentative d'authentification frictionless. Soumettre de nouveau la transaction tout en imposant une cinématique d'authentification forte lors de la deuxième tentative augmentera la probabilité que votre transaction soit finalement acceptée.

Cinématique de paiement

Notre fonctionnalité Soft Decline est disponible pour toutes nos méthodes d'intégration et s'intègre parfaitement dans la cinématique de paiement.

1. Vous adressez une requête de paiement standard CreateHostedCheckout/CreatePayment à notre plateforme, incluant au minimum les données 3-D Secure requises tout en indiquant que vous souhaitez une authentification frictionless. Selon votre méthode d'intégration, des différences peuvent s'appliquer. Consultez le chapitre "Intégration" pour trouver des exemples adaptés à chacun d'entre eux.
2. Notre plateforme transmet la demande à l'établissement émetteur de votre client. Selon la réponse de l'émetteur, deux scénarios sont possibles :
   a): L'émetteur accepte une authentification frictionless. Nous soumettons la transaction financière réelle à l'acquéreur pour la traiter. Nous recevons le résultat de la transaction, mettant fin à la cinématique de paiement.
   b): L'émetteur requiert une authentification challenge. La cinématique se poursuit à l'étape 3).
3. Notre plateforme vous renvoie une réponse. Elle inclut statusOutput.statusCode=2 et statusOutput.errors.code=40001139, vous informant que l'émetteur requiert une authentification challenge.
4. Notre plateforme redirige automatiquement vos clients vers leur émetteur pour l'authentification 3-D Secure.
5. Notre système reçoit le résultat de l'authentification 3-D Secure de la part de l'émetteur.
6. Nous traitons la transaction et recevons le résultat de l'acquéreur.
7. Nous redirigeons votre client vers votre returnUrl.
8. Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou vous recevez le résultat via des webhooks.

Intégration

Ajoutez les paramètres suivants à une requête de paiement standard CreateHostedCheckout/CreatePayment (comprenant les données 3-D Secure requises) :

Selon votre méthode d'intégration, des différences peuvent s'appliquer. Consultez le chapitre "Intégration" pour trouver des exemples adaptés à chacun d'eux.

American Express
MasterCard
Visa

Test

Ajoutez les paramètres suivants à une requête de paiement standard CreateHostedCheckout/CreatePayment (comprenant les données 3-D Secure requises).

Assurez-vous de :

• Renseigner order.amountOfmoney.amount=1602 avec skipAuthentication/exemptionRequest comme décrit ci-dessus.
• Utiliser le numéro de carte 4874970686672022 ou tout autre numéro de carte Visa de nos cas de test déclenchant une cinématique challenge.
• Choisir une devise order.amountOfmoney.currencyCode  possédant seulement deux décimales. 

{
   "cardPaymentMethodSpecificInput":{
      "threeDSecure":{
         "skipAuthentication":true,
         "exemptionRequest":"low-value"
      }
   },
   "order":{
      "amountOfMoney":{
         "amount":1602,
         "currencyCode":"EUR"
      }
   }
}

{
   "cardPaymentMethodSpecificInput":{
      "card":{
         "cardholderName":"Wile E. Coyote",
         "cardNumber":"4874970686672022",
         "cvv":"123",
         "expiryDate":"0529"
      },
      "paymentProductId":1,
      "returnUrl":"https://yourReturnUrl.com",
      "threeDSecure":{
         "skipAuthentication":true,
         "exemptionRequest":"low-value"
      }
   },
   "order":{
      "amountOfMoney":{
         "amount":1602,
         "currencyCode":"EUR"
      },
      "customer":{
         "device":{
            "acceptHeader":"texthtml,application/xhtml+xml,application/xml;q=0.9,/;q=0.8",
            "browserData":{
               "colorDepth":24,
               "javaEnabled":false,
               "screenHeight":"1200",
               "screenWidth":"1920"
            },
            "ipAddress":"123.123.123.123",
            "locale":"en_GB",
            "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1 Safari/605.1.15",
            "timezoneOffsetUtcMinutes":"420"
         },
         "locale":"en_GB"
      }
   }
}