• 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

Guía de integración

Casos de uso

Utilice el Web Service V4.1/PCI/Charge/CreatePayment en función del protocolo de autentificación y del resultado de la autentificación.

  • Para la red CB
  • Para la red VISA/Mastercard/AMEX
  • Autentificación desactivada

autentificación 3-D Secure v2

Testear

Testee el Web Service V4.1/PCI/Charge/CreatePayment desde nuestro playground.

Datos de autenticación

Récupérez les données suivantes :

Protocolo de autentificación

APELLIDO Descripción
name Nombre del protocolo de autentificación con el valor THREEDS
VERSIÓN Versión del protocolo de autenticación. Valores posibles:
  • 2
  • 2.1.0
  • 2.2.0
directoryServer Nombre del Directory Server (DS) utilizado durante la autentificación. Valores posibles:
  • AMEX
  • CB
  • DINERS
  • DISCOVER
  • VISA
  • MASTERCARD
ChallengePreference Preferencia 3DS transmitida al DS si la autentificación de titular es satisfactoria y su estado es 'SUCCESS' o 'ATTEMPT'.

El resultado del pago depende del estado de la autentificación.

  1. Si el estado de la autentificación tiene el valorSUCCESSoATTEMPT, récupérez ces informations :
</tbody>
APELLIDO Descripción
authenticationType Nombre del protocolo de autenticación. Valor requerido:
  • CHALLENGE
  • FRICTIONLESS
authenticationValue Referencia generada por el emisor para validar todos los datos de la transacción. Según el Directory Service utilizado,
  • CAVV pour VISA
  • AAV pour Mastercard
  • AEVV pour AMEX Safekey.

Ejemplo: +kAr/o8S0DxgGYkz7QQHZCw8V5k=

commerceIndicator Indicador de comercio electrónico (ECI). Valor que devuelve el ACS tras la autentificación en función del estado de la autentificación y del tipo de tarjeta.

Ex: 05

dsTransID Identificador único de la transacción generado por el DS 3DS2.

Ejemplo: d6706a0d-c48d-4cf4-a1d2-d4a401a3143e

exemption Se aplica la exención. Requerido para FRICTIONLESS, valor del campo 'authenticationType' . Ver:Motivos de la desactivación y exenciones.

Ejemplo: LOW_VALUE

requestorName Nombre del vendedor utilizado durante la autentificación del titular.
acsTransID Identificador único de la transacción generado por el ACS.

Ej: d727ebfe-de4c-4682-85fa-e60ca00a9cff

authValueAlgorithm Algoritmo utilizado para verificar la autenticación del portador. Valores posibles:
  • 0 pour HMAC
  • 1 pour CVV
  • 2 pour CVV_ATN
  • 3 pour MASTERCARD_SPA
  • A pour AV-CB
dsScore Puntuación de autenticación.

Ex : 31

  1. Si le statut de l'authentification est en échec avec les valeurs suivantes :
  • DISABLED
  • ENROLLED_UNAVAILABLE
  • FAILED
  • NOT_ENROLLED
  • UNAVAILABLE

Dans ce cas, récupérez ces informations :

APELLIDO Descripción
challengeCancelationIndicator Nombre del protocolo de autenticación. Valor requerido: Indicador de la cancelación del challenge recibido en el mensaje RReq. Valor que devuelve el DS en caso de anulación de la autentificación.

Ex: 01

transactionStatusReason Motivo del fallo de la autentificación devuelta por el DS en caso de fallo de autentificación.

Ex: 82

Para la red CB

Solicitud

Campos obligatorios
  • Monto
  • Moneda

Datos de la tarjeta

  • Tipo del medio de pago:CARDS
  • Número principal de la tarjeta: pan.
  • Mes de vencimiento.
  • Año de vencimiento.

Datos de autenticación

  1. En el protocolo
  • nombre:THREEDS
  • Número de versión:
  • directorioServidor: CB
  • ChallengePreference: Ej: NO_CHALLENGE_REQUESTED en caso de éxito durante la autenticación (estadoSUCCESSoATTEMPT).
  1. Datos de test
authValueAlgorithm : 2 authenticationType : FRICTIONLESS
authenticationValue : +kAr/o8S0DxgGYkz7QQHZCw8V5k= commerceIndicator : 05
challengePreference : NO_CHALLENGE_REQUESTED dsTransID : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e
exemption : LOW_VALUE acsTransID : d727ebfe-de4c-4682-85fa-e60ca00a9cff
requestorName : DEMO STORE dsScore : 31

Ejemplo de solicitud

/es/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "1230",
    "currency": "EUR",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "4970110000001029",
     "expiryMonth": "03",
     "expiryYear": "27",
     "securityCode": "123"
      }
    ],
    "customer": {
     "email": "sample@example.com"
    },
    "authenticationDetails":{
     "protocol":{
      "name":"THREEDS",
      "version":"2",
      "directoryServer":"CB",
      "challengePreference":"NO_CHALLENGE_REQUESTED"
     },
     "status":"SUCCESS",
     "authenticationType":"FRICTIONLESS",
     "commerceIndicator":"05",
     "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=",
     "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e",
     "acsTransID":"d727ebfe-de4c-4682-85fa-e60ca00a9cff",
     "authValueAlgorithm":"2",
     "dsScore":"31",
     "exemption":"LOW_VALUE",  
     "requestorName":"DEMO STORE"
    }
   }

Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)

Para la red VISA/Mastercard/AMEX

Solicitud

Campos obligatorios
  • Monto
  • Moneda

Datos de la tarjeta

  • Tipo del medio de pago:CARDS
  • Número principal de la tarjeta: pan.
  • Mes de vencimiento.
  • Año de vencimiento.

Datos de autenticación

  1. En el protocolo
  • nombre:THREEDS
  • Número de versión:
  • directoryServer: nombre del DS. Ejemplo:VISAoMASTERCARDoAMEX
  • challengePreference: Ejemplo:NO_CHALLENGE_REQUESTEDen caso de autentificación satisfactoria (estadoSUCCESSoATTEMPT).
  1. Datos de test
authenticationType : FRICTIONLESS dsTransID : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e
authenticationValue : +kAr/o8S0DxgGYkz7QQHZCw8V5k= commerceIndicator : 05
challengePreference : NO_CHALLENGE_REQUESTED exemption : LOW_VALUE

Ejemplo de solicitud para VISA

/es/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "990",
    "currency": "EUR",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "4970110000001029",    
     "expiryMonth": "09",
     "expiryYear": "27",
     "securityCode": "123"
      }
    ],    
    "customer": {
     "email": "sample@example.com"
    },    
    "authenticationDetails":{ 
     "protocol":{
      "name":"THREEDS",
      "version":"2.1.0",
      "directoryServer":"VISA",
      "challengePreference":"NO_CHALLENGE_REQUESTED"
     },   
     "status":"SUCCESS",
     "authenticationType":"FRICTIONLESS",
     "commerceIndicator":"05",
     "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=",
     "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e",  
     "exemption":"OTHER_EXEMPTION",
    }    
   }

Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)

Autentificación desactivada

Le service permet de créer un paiement lorsque l'authentification du porteur a été volontairement désactivée.

Dans ce cas, la raison de cette décision doit être précisée en utilisant le champ exemption (Voir chapitre Motif de débrayage et exemptions).

Campos obligatorios
  • Monto
  • Moneda

Datos de la tarjeta

  • Tipo del medio de pago:CARDS
  • Número principal de la tarjeta: pan.
  • Mes de vencimiento.
  • Año de vencimiento.

Datos de autenticación

  • Estado:DISABLED
  • Exención: Ver: Motivos de la desactivación y exenciones.

Ejemplo de solicitud

/es/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "1230",
    "currency": "EUR",
    "paymentForms": [
      {
      "paymentMethodType": "CARD",
      "pan": "4970100000000022",			 
      "expiryMonth": "09",
      "expiryYear": "27",
      "securityCode": "123"
      }
    ],		  
    "customer": {
      "email": "sample@example.com"
    },		  
    "authenticationDetails":{				
      "status":"DISABLED",
      "exemption":"OTHER_EXEMPTION"		
    }		  
  }

Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)

Jobs
Legal
GDPR
2.93.0-doc-1.11