• Francia
página de estado
demo
asistencia
FAQContacte el soporte tecnico
Buscar
Categoria
Tags
España
Francia
España
Europa (Inglés)
India
Página principal
Casos de uso
Crear un pago
Crear un pago en vencimientos
Crear un pago multitarjeta
Crear un pago por token
Crear un enlace de pago
Crear una suscripción
Gestione sus suscripciones
Gestione sus transacciones
Analizar los diarios
Docs API
Formulario incrustado
API REST
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Medios de pago
Plugins
Guías
Back office Experto
Guías funcionales

3DS2 - autentificación con challenge, sin 3DS Method

Para probar este escenario, use uno de los números de tarjeta a continuación:

Tarjeta Fecha de vencimiento. Marca
4970110000000021 A elección VISA
5100010000000049 A elección MASTERCARD
375900000000016 A elección AMEX

Secuencia de los intercambios

1. Llamada al Web Service V4.1/PCI/Charge/CreatePayment con una tarjeta inscrita a 3DS2.

{  
 "amount": "990",
 "currency": "EUR",
 "paymentForms": [
    {
      "pan": "4970110000000021",
      "expiryMonth": 11,
      "expiryYear": 23,
      "securityCode": "123",
      "paymentMethodType": "CARD"
    }
  ],
  "customer": {
    "email": "sample@example.com"
  }
}

Respuesta

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

En el ejemplo:

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

  • Transmite el campo operationUrl al método de autentificación kr-authenticate.js de la biblioteca JS (más información: undefined).

2. Redirección al ACS del banco del titular de la tarjeta.

  • La biblioteca JS realiza automáticamente todas las acciones necesarias, el vendedor no necesita realizar ningún desarrollo específico.

3. Retorno del servidor de la plataforma de pago con el resultado de pago.

{
"webService":"PCI/Charge/CreatePayment",
"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":{
  "shopId": "12345678",
  "orderCycle": "CLOSED",
  "orderStatus": "PAID",
  "serverDate": "2023-05-24T13:47:48+00:00",
  "orderDetails": {
    "orderTotalAmount": 990,
    "orderEffectiveAmount": 990,
    "orderCurrency": "EUR",
    "mode": "TEST",
    "orderId": null,
    "metadata": null,
    "_type": "V4/OrderDetails"
  },
  "customer": {
    "billingDetails": {
      "address": null,
      "category": null,
      "cellPhoneNumber": null,
      "city": null,
      "country": null,
      "district": null,
      "firstName": null,
      "identityCode": null,
      "identityType": null,
      "language": "FR",
      "lastName": null,
      "phoneNumber": null,
      "state": null,
      "streetNumber": null,
      "title": null,
      "zipCode": null,
      "legalName": null,
      "_type": "V4/Customer/BillingDetails"
    },
    "email": "sample@example.com",
    "reference": null,
    "shippingDetails": {
      "address": null,
      "address2": null,
      "category": null,
      "city": null,
      "country": null,
      "deliveryCompanyName": null,
      "district": null,
      "firstName": null,
      "identityCode": null,
      "lastName": null,
      "legalName": null,
      "phoneNumber": null,
      "shippingMethod": null,
      "shippingSpeed": null,
      "state": null,
      "streetNumber": null,
      "zipCode": null,
      "_type": "V4/Customer/ShippingDetails"
    },
    "extraDetails": {
      "browserAccept": null,
      "fingerPrintId": null,
      "ipAddress": "54.86.50.139",
      "browserUserAgent": "PostmanRuntime/7.32.2",
      "_type": "V4/Customer/ExtraDetails"
    },
    "shoppingCart": {
      "insuranceAmount": null,
      "shippingAmount": null,
      "taxAmount": null,
      "cartItemInfo": null,
      "_type": "V4/Customer/ShoppingCart"
    },
    "_type": "V4/Customer/Customer"
  },
  "transactions": [
    {
      "shopId": "12345678",
      "uuid": "8e0e6596b08849c1a771488547bb7940",
      "amount": 990,
      "currency": "EUR",
      "paymentMethodType": "CARD",
      "paymentMethodToken": null,
      "status": "PAID",
      "detailedStatus": "AUTHORISED",
      "operationType": "DEBIT",
      "effectiveStrongAuthentication": "ENABLED",
      "creationDate": "2023-05-24T13:45:33+00:00",
      "errorCode": null,
      "errorMessage": null,
      "detailedErrorCode": null,
      "detailedErrorMessage": null,
      "metadata": null,
      "transactionDetails": {
        "liabilityShift": "YES",
        "effectiveAmount": 990,
        "effectiveCurrency": "EUR",
        "creationContext": "CHARGE",
        "cardDetails": {
          "paymentSource": "EC",
          "manualValidation": "NO",
          "expectedCaptureDate": "2023-05-24T13:45:33+00:00",
          "effectiveBrand": "VISA",
          "pan": "497011XXXXXX0021",
          "expiryMonth": 11,
          "expiryYear": 2023,
          "country": "FR",
          "issuerCode": 17807,
          "issuerName": "Banque Populaire Occitane",
          "effectiveProductCode": null,
          "legacyTransId": "917160",
          "legacyTransDate": "2023-05-24T13:45:33+00:00",
          "paymentMethodSource": "NEW",
          "authorizationResponse": {
            "amount": 990,
            "currency": "EUR",
            "authorizationDate": "2023-05-24T13:45:33+00:00",
            "authorizationNumber": "3fe944",
            "authorizationResult": "0",
            "authorizationMode": "FULL",
            "_type": "V4/PaymentMethod/Details/Cards/CardAuthorizationResponse"
          },
          "captureResponse": {
            "refundAmount": null,
            "refundCurrency": null,
            "captureDate": null,
            "captureFileNumber": null,
            "effectiveRefundAmount": null,
            "effectiveRefundCurrency": null,
            "_type": "V4/PaymentMethod/Details/Cards/CardCaptureResponse"
          },
          "threeDSResponse": {
            "authenticationResultData": {
              "transactionCondition": null,
              "enrolled": null,
              "status": null,
              "eci": null,
              "xid": null,
              "cavvAlgorithm": null,
              "cavv": null,
              "signValid": null,
              "brand": null,
              "_type": "V4/PaymentMethod/Details/Cards/CardAuthenticationResponse"
            },
            "_type": "V4/PaymentMethod/Details/Cards/ThreeDSResponse"
          },
          "authenticationResponse": {
            "id": "3a18c766-8bc1-46d0-8be4-2d2db20e4725",
            "operationSessionId": "6dbdd98d2fc642ccb7f1913f6bbec92e",
            "protocol": {
              "name": "THREEDS",
              "version": "2.2.0",
              "network": "VISA",
              "challengePreference": "NO_PREFERENCE",
              "simulation": true,
              "_type": "V4/Charge/Authenticate/Protocol"
            },
            "value": {
              "authenticationType": "CHALLENGE",
              "authenticationId": {
                "authenticationIdType": "dsTransId",
                "value": "ba5ea198-38a7-4b6f-b6a4-2432e7915b65",
                "_type": "V4/Charge/Authenticate/AuthenticationId"
              },
              "authenticationValue": {
                "authenticationValueType": "CAVV",
                "value": "x0ehEl4B7o32FRELG5llISDt4qs=",
                "_type": "V4/Charge/Authenticate/AuthenticationValue"
              },
              "status": "SUCCESS",
              "commerceIndicator": "05",
              "extension": {
                "authenticationType": "THREEDS_V2",
                "threeDSServerTransID": "3a18c766-8bc1-46d0-8be4-2d2db20e4725",
                "dsTransID": "ba5ea198-38a7-4b6f-b6a4-2432e7915b65",
                "acsTransID": "be6fd483-2318-4969-a813-db195f980e75",
                "requestorName": "SITE1 / SITE 2 /SITE 3",
                "_type": "V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
              },
              "reason": {
                "_type": "V4/Charge/Authenticate/AuthenticationResultReason"
              },
              "_type": "V4/Charge/Authenticate/AuthenticationResult"
            },
            "_type": "V4/AuthenticationResponseData"
          },
          "installmentNumber": null,
          "installmentCode": null,
          "markAuthorizationResponse": {
            "amount": null,
            "currency": null,
            "authorizationDate": null,
            "authorizationNumber": null,
            "authorizationResult": null,
            "_type": "V4/PaymentMethod/Details/Cards/MarkAuthorizationResponse"
          },
          "cardHolderName": null,
          "identityDocumentNumber": null,
          "identityDocumentType": null,
          "initialIssuerTransactionIdentifier": "2572956932966569",
          "productCategory": "DEBIT",
          "nature": "CONSUMER_CARD",
          "_type": "V4/PaymentMethod/Details/CardDetails"
        },
        "paymentMethodDetails": {
          "id": "497011XXXXXX0021",
          "paymentSource": "EC",
          "manualValidation": "NO",
          "expectedCaptureDate": "2023-05-24T13:45:33+00:00",
          "effectiveBrand": "VISA",
          "expiryMonth": 11,
          "expiryYear": 2023,
          "country": "FR",
          "issuerCode": 17807,
          "issuerName": "Banque Populaire Occitane",
          "effectiveProductCode": null,
          "legacyTransId": "917160",
          "legacyTransDate": "2023-05-24T13:45:33+00:00",
          "paymentMethodSource": "NEW",
          "authorizationResponse": {
            "amount": 990,
            "currency": "EUR",
            "authorizationDate": "2023-05-24T13:45:33+00:00",
            "authorizationNumber": "3fe944",
            "authorizationResult": "0",
            "authorizationMode": "FULL",
            "_type": "V4/PaymentMethod/Details/Cards/CardAuthorizationResponse"
          },
          "captureResponse": {
            "refundAmount": null,
            "refundCurrency": null,
            "captureDate": null,
            "captureFileNumber": null,
            "effectiveRefundAmount": null,
            "effectiveRefundCurrency": null,
            "_type": "V4/PaymentMethod/Details/Cards/CardCaptureResponse"
          },
          "authenticationResponse": {
            "id": "3a18c766-8bc1-46d0-8be4-2d2db20e4725",
            "operationSessionId": "6dbdd98d2fc642ccb7f1913f6bbec92e",
            "protocol": {
              "name": "THREEDS",
              "version": "2.2.0",
              "network": "VISA",
              "challengePreference": "NO_PREFERENCE",
              "simulation": true,
              "_type": "V4/Charge/Authenticate/Protocol"
            },
            "value": {
              "authenticationType": "CHALLENGE",
              "authenticationId": {
                "authenticationIdType": "dsTransId",
                "value": "ba5ea198-38a7-4b6f-b6a4-2432e7915b65",
                "_type": "V4/Charge/Authenticate/AuthenticationId"
              },
              "authenticationValue": {
                "authenticationValueType": "CAVV",
                "value": "x0ehEl4B7o32FRELG5llISDt4qs=",
                "_type": "V4/Charge/Authenticate/AuthenticationValue"
              },
              "status": "SUCCESS",
              "commerceIndicator": "05",
              "extension": {
                "authenticationType": "THREEDS_V2",
                "threeDSServerTransID": "3a18c766-8bc1-46d0-8be4-2d2db20e4725",
                "dsTransID": "ba5ea198-38a7-4b6f-b6a4-2432e7915b65",
                "acsTransID": "be6fd483-2318-4969-a813-db195f980e75",
                "requestorName": "SITE1 / SITE 2 /SITE 3",
                "_type": "V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
              },
              "reason": {
                "_type": "V4/Charge/Authenticate/AuthenticationResultReason"
              },
              "_type": "V4/Charge/Authenticate/AuthenticationResult"
            },
            "_type": "V4/AuthenticationResponseData"
          },
          "installmentNumber": null,
          "installmentCode": null,
          "markAuthorizationResponse": {
            "amount": null,
            "currency": null,
            "authorizationDate": null,
            "authorizationNumber": null,
            "authorizationResult": null,
            "_type": "V4/PaymentMethod/Details/Cards/MarkAuthorizationResponse"
          },
          "cardHolderName": null,
          "identityDocumentNumber": null,
          "identityDocumentType": null,
          "initialIssuerTransactionIdentifier": "2572956932966569",
          "_type": "V4/PaymentMethod/Details/PaymentMethodDetails"
        },
        "acquirerDetails": null,
        "fraudManagement": {
          "riskControl": [
            {
              "name": "SUSPECT_COUNTRY",
              "result": "OK",
              "_type": "V4/PaymentMethod/Details/Risk/RiskControl"
            },
            {
              "name": "SUSPECT_IP_COUNTRY",
              "result": "OK",
              "_type": "V4/PaymentMethod/Details/Risk/RiskControl"
            },
            {
              "name": "IP_FRAUD",
              "result": "OK",
              "_type": "V4/PaymentMethod/Details/Risk/RiskControl"
            }
          ],
          "riskAnalysis": [],
          "_type": "V4/PaymentMethod/Details/FraudManagement"
        },
        "subscriptionDetails": {
          "subscriptionId": null,
          "_type": "V4/PaymentMethod/Details/SubscriptionDetails"
        },
        "parentTransactionUuid": null,
        "mid": "1234567",
        "sequenceNumber": 1,
        "taxAmount": null,
        "preTaxAmount": null,
        "taxRate": null,
        "externalTransactionId": null,
        "nsu": null,
        "tid": "001",
        "acquirerNetwork": "CB",
        "taxRefundAmount": null,
        "userInfo": null,
        "paymentMethodTokenPreviouslyRegistered": null,
        "occurrenceType": "UNITAIRE",
        "archivalReferenceId": "L14491716001",
        "useCase": null,
        "wallet": null,
        "_type": "V4/TransactionDetails"
      },
      "_type": "V4/PaymentTransaction"
    }
  ],
  "subMerchantDetails": null,
  "_type": "V4/Payment"
}
Jobs
Legal
GDPR
25.19-1.11