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.

Integrate Soft Decline

Depending on the integration mode, differences apply. Find an example for all in the "Intégration" tab for the respective payment:

American Express
MasterCard
Visa

Test

Add the following properties to a standard CreateHostedCheckout/CreatePayment request (including mandatory 3-D Secure properties).

Make sure to:

• Set the exact order.amountOfmoney.amount=1604 together with skipAuthentication set to true.
• Use card number 4874970686672022 or any other Visa card number from our test cases triggering a challenge flow.
• Choose a currency for order.amountOfmoney.currencyCode that uses only two decimals. 

CreateHostedCheckout

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

CreatePayment

{
   "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":1604,
         "currencyCode":"AUD"
      },
      "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"
      }
   }
}