• Francia
Back Office Vendedor
asistencia
FAQcontacte el soporte tecnico
Buscar
Categoria
Tags
Colombia
Colombia
Página principal
Casos de uso
Crear un pago
Crear un pago en cuotas
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
API REST PCI-DSS
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Medios de pago
Módulos de pago
Guías Back Office

3DS2 - Autentificación con challenge y time-out

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

Al momento de introducir el código de autentificación, no ingrese nada y espere 10 minutos hasta que expire la sesión de pago.

Secuencia de los intercambios

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

{  
 "amount": "990",
 "currency": "COP",
 "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.payty.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.payty.com/api-payment/V4/Charge/Public/Authenticate/Payment/Session/30641640cba14eab8e6766094fd201da;JSESSIONID=7A4beEA2d5fdbFeA7389F3B91a7bDBaBc8DA9df5.nombre de host predeterminado"

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

2. El servidor de la plataforma de pago devuelve el resultado del pago (pago rechazado).

{
"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":"https://api.payty.com",
"_type":"V4/WebService/Response",
"answer":{
  "shopId": "12345678",
  "orderCycle": "CLOSED",
  "orderStatus": "UNPAID",
  "serverDate": "2023-05-24T14:59:00+00:00",
  "orderDetails": {
    "orderTotalAmount": 990,
    "orderEffectiveAmount": 990,
    "orderCurrency": "COP",
    "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": "bb545a28a42645ce9e8694576c5e003a",
      "amount": 990,
      "currency": "COP",
      "paymentMethodType": "CARD",
      "paymentMethodToken": null,
      "status": "UNPAID",
      "detailedStatus": "REFUSED",
      "operationType": "DEBIT",
      "effectiveStrongAuthentication": "DISABLED",
      "creationDate": "2023-05-24T14:48:42+00:00",
      "errorCode": "PSP_539",
      "errorMessage": "3D Secure refusal for the transaction",
      "detailedErrorCode": "39",
      "detailedErrorMessage": "3D Secure refusal for the transaction.",
      "metadata": null,
      "transactionDetails": {
        "liabilityShift": null,
        "effectiveAmount": 990,
        "effectiveCurrency": "COP",
        "creationContext": "CHARGE",
        "cardDetails": {
          "paymentSource": "EC",
          "manualValidation": "NO",
          "expectedCaptureDate": "2023-05-24T14:48:42+00:00",
          "effectiveBrand": "VISA",
          "pan": "497011XXXXXX1003",
          "expiryMonth": 11,
          "expiryYear": 2023,
          "country": "FR",
          "issuerCode": 17807,
          "issuerName": "Banque Populaire Occitane",
          "effectiveProductCode": null,
          "legacyTransId": "914178",
          "legacyTransDate": "2023-05-24T14:48:42+00:00",
          "paymentMethodSource": "NEW",
          "authorizationResponse": {
            "amount": null,
            "currency": null,
            "authorizationDate": null,
            "authorizationNumber": null,
            "authorizationResult": null,
            "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": "c758e4ad-deb4-4547-89dd-30a48f305f22",
            "operationSessionId": "16f664d226b04cb49cfd43da1cfb62cf",
            "protocol": {
              "name": "THREEDS",
              "version": "2.1.0",
              "network": "VISA",
              "challengePreference": "NO_PREFERENCE",
              "simulation": true,
              "_type": "V4/Charge/Authenticate/Protocol"
            },
            "value": {
              "authenticationType": "CHALLENGE",
              "status": "FAILED",
              "extension": {
                "authenticationType": "THREEDS_V2",
                "requestorName": "SITE1 / SITE 2 /SITE 3",
                "_type": "V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
              },
              "reason": {
                "code": "AUTHENTICATION_ERROR",
                "message": "Challenge timeout",
                "_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": null,
          "productCategory": "DEBIT",
          "nature": "CONSUMER_CARD",
          "_type": "V4/PaymentMethod/Details/CardDetails"
        },
        "paymentMethodDetails": {
          "id": "497011XXXXXX1003",
          "paymentSource": "EC",
          "manualValidation": "NO",
          "expectedCaptureDate": "2023-05-24T14:48:42+00:00",
          "effectiveBrand": "VISA",
          "expiryMonth": 11,
          "expiryYear": 2023,
          "country": "FR",
          "issuerCode": 17807,
          "issuerName": "Banque Populaire Occitane",
          "effectiveProductCode": null,
          "legacyTransId": "914178",
          "legacyTransDate": "2023-05-24T14:48:42+00:00",
          "paymentMethodSource": "NEW",
          "authorizationResponse": {
            "amount": null,
            "currency": null,
            "authorizationDate": null,
            "authorizationNumber": null,
            "authorizationResult": null,
            "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": "c758e4ad-deb4-4547-89dd-30a48f305f22",
            "operationSessionId": "16f664d226b04cb49cfd43da1cfb62cf",
            "protocol": {
              "name": "THREEDS",
              "version": "2.1.0",
              "network": "VISA",
              "challengePreference": "NO_PREFERENCE",
              "simulation": true,
              "_type": "V4/Charge/Authenticate/Protocol"
            },
            "value": {
              "authenticationType": "CHALLENGE",
              "status": "FAILED",
              "extension": {
                "authenticationType": "THREEDS_V2",
                "requestorName": "SITE1 / SITE 2 /SITE 3",
                "_type": "V4/Charge/Authenticate/AuthenticationResultExtensionThreedsV2"
              },
              "reason": {
                "code": "AUTHENTICATION_ERROR",
                "message": "Challenge timeout",
                "_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": null,
          "_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": "L14491417801",
        "useCase": null,
        "wallet": null,
        "_type": "V4/TransactionDetails"
      },
      "_type": "V4/PaymentTransaction"
    }
  ],
  "subMerchantDetails": null,
  "_type": "V4/Payment"
}
© 2025 Todos los derechos reservados de Payty
25.17-1.11