• France
état des services
démonstrations
assistance
FAQContacter le support
Tutoriels vidéo
Rechercher
Catégories
Tags
France
France
Espagne
Europe (Anglais)
Inde
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
SDK Mobile
Échange de fichiers
Mandats SEPA par API REST
Exemples de code
Moyens de paiement
Modules de paiement
Marketplace
Guides
Back Office Marchand
Back Office Expert
Guides fonctionnels

3DS2 - Authentification Challenge, avec 3DS Method

Pour tester ce scénario, utilisez un des numéros de carte ci-dessous :

Carte Date de validité Marque
4970110000001003 Au choix VISA
5100010000000106 Au choix MASTERCARD
375900000010015 Au choix AMEX

Cinématique des échanges

1. Appel au Web Service PCI/Authentication/CreateSession avec une carte enrôlée 3DS2

{
    "amount": "990",
    "currency": "EUR",
    "transactionCategory": "PAYMENT",
    "productType": "GOODS_OR_SERVICE_PURCHASE",
    "merchant": {
        "mid":""
    },
    "paymentForm": {
      "pan": "4970110000001003",
      "expiryMonth": "11",
      "expiryYear": "23",
      "networkPreference": "VISA"
    },
    "customer": {
      "email": "sample@example.com"
    },
    "protocolRequest": {
      "name": "THREEDS",
      "version": "2"
    },
   "ianTargetUrl": "<https://merchant.ian.com>"
}

Réponse

{
  "webService":"PCI/Authentication/CreateSession",
  "version":"V4",
   (...)
  "answer":{
    "operationSessionId":"30641640cba14eab8e6766094fd201da",
    "operationUrl":"https://api.lyra.com/api-payment/V4/Charge/Public/Authenticate/Session/30641640cba14eab8e6766094fd201da;JSESSIONID=7A4beEA2d5fdbFeA7389F3B91a7bDBaBc8DA9df5.default-hostname",
    "_type":"V4/PCI/Authentication/AuthenticationSessionResponse"
  }
}

Dans l'exemple :

  • answer.operationUrl : "https://api.lyra.com/api-payment/V4/Charge/Public/Authenticate/Session/30641640cba14eab8e6766094fd201da;JSESSIONID=7A4beEA2d5fdbFeA7389F3B91a7bDBaBc8DA9df5.default-hostname"

  • Transmettez le champ operationUrl à la méthode d'authentification authenticate de la librairie JS (plus d'infos : Guide d'intégration (mode simple)).

2. Redirection vers l’ACS de la banque du porteur de carte

  • La libraire JS effectue automatiquement toutes les actions nécessaires, sans aucun développement spécifique pour le marchand.

3. Retour du serveur de la plateforme de paiement avec le résultat de l'authentification (3DS Method)

{
"webService":"PCI/Authentication/CreateSession",
"version":"V4",
"applicationVersion":"5.23.0",
"serverDate":"2023-05-05T09:33:32+00:00",
"ticket":"3b68064f80f346919828dee761bd22b5",
"applicationProvider":"",
"metadata":null,
"status":"SUCCESS",
"mode":"TEST",
"serverUrl":"",
"_type":"V4/WebService/Response",
"answer":{
 {
   "id":"18e1a1a0-92f1-4722-b60b-80ec4a1f78d3",
   "operationSessionId":null,
   "protocol":{
      "name":"THREEDS",
      "version":"2.1.0",
      "network":"VISA",
      "challengePreference":"NO_PREFERENCE",
      "simulation":true,
      "_type":"V4/Charge/Authenticate/Protocol"
   },
   "value":{
      "authenticationType":"CHALLENGE",
      "authenticationId":{
         "authenticationIdType":"dsTransId",
         "value":"86cabade-96bb-4cc0-921b-6df6e5bd608f",
         "_type":"V4/Charge/Authenticate/AuthenticationId"
      },
      "authenticationValue":{
         "authenticationValueType":"CAVV",
         "value":"ccvGMhCneJLVi5BlqDOgDtdbvSM=",
         "_type":"V4/Charge/Authenticate/AuthenticationValue"
      },
      "status":"SUCCESS",
      "commerceIndicator":"05",
      "extension":{
         "authenticationType":"THREEDS_V2",
         "challengeCancelationIndicator":null,
         "cbScore":null,
         "cbAvalgo":null,
         "cbExemption":null,
         "paymentUseCase":null,
         "threeDSServerTransID":"18e1a1a0-92f1-4722-b60b-80ec4a1f78d3",
         "dsTransID":"86cabade-96bb-4cc0-921b-6df6e5bd608f",
         "acsTransID":"0bd22c3e-582f-430a-a9d0-8e99fb54b9b4",
         "sdkTransID":null,
         "transStatusReason":null,
         "requestedExemption":null,
         "requestorName":"Lyra SMS",
         "cardHolderInfo":null,
         "dataOnlyStatus":null,
         "dataOnlyDecision":null,
         "dataOnlyScore":null,
         "_type":"V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
      },
      "reason":{
         "code":null,
         "message":null,
         "_type":"V4/Charge/Authenticate/AuthenticationResultReason"
      },
      "_type":"V4/Charge/Authenticate/AuthenticationResult"
   },
   "_type":"V4/AuthenticationResponseData"
  }
}
Nous recrutons
Mentions légales
Charte de Protection des Données Personnelles
25.22-1.11