Guía de integración (modo simple)

1. Añadir la biblioteca JavaScript a su sitio

Para facilitar la integración de la solución, nuestra biblioteca JavaScript recopila datos del equipo y el navegador del cliente, se comunica directamente con el servidor 3DS y gestiona la interacción del titular de la tarjeta durante el reto.

En el HEAD de la página se debe añadir la biblioteca JavaScript en una etiqueta <script>.

<head>
 ...
 <script src="https://static.lyra.com/static/js/authenticate-client/V1.0/kr-authenticate.umd.js"></script>
 ...
</head>

2. Iniciar una solicitud de autentificación del titular

Appelez le service PCI/Authentication/CreateSession en utilisant les champs ci-dessous :

NIVEL	APELLIDO	Descripción	OBLIGATORIO
1	customer	Objeto que contiene los datos del comprador.	NO
1	paymentForm	Objeto que contiene los datos de la tarjeta.	Sí
2	pan	Número de tarjeta.	Sí
2	expiryMonth	Mes de caducidad de la tarjeta.	Sí
2	expiryYear	Año de caducidad de la tarjeta.	Sí
2	networkPreference	Nombre de la red preferida recomendada por el vendedor.	Sí
1	vendedor	Objeto que contiene el número de afiliación.	Sí
2	mid	Número de afiliación del vendedor.	Sí
1	protocolRequest	Objeto que describe el modo de autentificación deseado.	Sí
2	name	Nombre del protocolo de autentificación.	Sí
2	VERSIÓN	Versión del protocolo de autentificación.	NO
1	vendedor	Objeto que contiene los detalles del contrato.	Sí
1	productType	Tipo de producto correspondiente en la transacción.	Sí
1	transactionCategory	Valorizado a PAYMENT.	Sí
1	amount	Monto por el que se solicita la autentificación.	Sí
1	ianTargetUrl	URL obligatoria para la notificación de fin de autentificación	Sí

Existen campos opcionales. Encuentre la descripción de los campos en nuestro Playground.

Ejemplo de solicitud

/es/rest/V4.0/api/kb/authentication.html

https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44

https://api.lyra.com/api-payment/V4/PCI/Authentication/CreateSession

{
  "amount": 1230,
  "currency": "EUR",
  "transactionCategory": "PAYMENT",
  "productType": "GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid": "9876357"
  },
  "paymentForm":{
    "pan": "4970110000000013",
    "expiryMonth": "02",
    "expiryYear": "24",
    "networkPreference": "VISA"
  },
  "protocolRequest": {
    "name": "THREEDS",
    "version": "2",
    "challengePreference": "NO_PREFERENCE"
  },
  "ianTargetUrl": "https://myiantargeturl.com"
}

/**
 * I initialize the PHP SDK
 */
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/keys.php';
require_once __DIR__ . '/helpers.php';

/** 
 * Initialize the SDK 
 * see keys.php
 */
$client = new Lyra\Client();

/**
 * I create a formToken
 */
$store = array("amount" => 250, 
"currency" => "EUR", 
"orderId" => uniqid("MyOrderId"),
"customer" => array(
  "email" => "sample@example.com"
));
$response = $client->post("V4/Charge/CreatePayment", $store);

/* I check if there are some errors */
if ($response['status'] != 'SUCCESS') {
    /* an error occurs, I throw an exception */
    display_error($response);
    $error = $response['answer'];
    throw new Exception("error " . $error['errorCode'] . ": " . $error['errorMessage'] );
}

/* everything is fine, I extract the formToken */
$formToken = $response["answer"]["formToken"];

?>

En el AuthenticationSessionResponse, encontrará los siguientes campos:

answer.operationSessionId: ID de la sesión de autentificación (para mantener)
answer.operationUrl: url para enviar a la biblioteca JavaScript

Encuentre la descripción de los campos en nuestro Playground.

Ejemplo de respuesta

{
  "webService":"PCI/Authentication/CreateSession",
  "version":"V4",
  "applicationVersion":"6.0.0",
  "serverDate":"2023-04-16T11:11:21+00:00",
  "ticket":"839ecda45f6449a8869747a80c26b2d2",
  "applicationProvider":"PAYZEN",
  "metadata":null,
  "status":"SUCCESS",
  "mode":"TEST",
  "serverUrl":"https://api.lyra.com",
  "_type":"V4/WebService/Response",
  "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"
  }
}

En el ejemplo:

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

3. Inicializar el script de autentificación

Una vez creada la sesión de autentificación, debe inicializar la biblioteca de autentificación JavaScript y luego llamar al método "Authenticate". Se recomienda agragar un indicador visual de carga durante la llamada.

// définition de la class javascript
class KrAuthenticate{
  constructor(publicKey,options)
  authenticate(operationUrl)
}

1. Parámetros de inicialización de la clase `KrAuthenticate`

APELLIDO	Descripción	OBLIGATORIO
publicKey	Clave pública de test o de producción de la tienda. Más información: 3ª clave de la tabla de claves de la API REST.	Sí
options	Elemento del DOM en el que se muestra la ventana de autentificación (opcional).	NO

También puede mostrar la ventana de autentificación en otro elemento del DOM utilizando el atributo element del parámetro opcional options.

Sin el elemento DOM ( recomendado ) :

  const krAuthenticate = new KrAuthenticate("69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5");

Con el elemento DOM:

  const krAuthenticate = new KrAuthenticate("69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5", {
 element: document.getElementById("id-challenge-element")
  });

En este ejemplo, el id del elemento DOM es : id-challenge-element.

2. Parámetros del método de ejecución de la autentificación `KrAuthenticate.authenticate`

Utilisez le champ operationUrl généré lors de l' appel PCI/Authentication/CreateSession (étape 2).

APELLIDO	Descripción	OBLIGATORIO
operationUrl	URL de inicialización de la autentificación entregada en la respuesta del Web Service PCI/Authentication/CreateSession en el objeto answer/AuthenticationSessionResponse#operationUrl.	Sí

Ejemplo: .

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

3. Código de ejemplo con la clase `KrAuthenticate` y el método `KrAuthenticate.authenticate`

Ejemplo de integración utilizando bootstrap, JQuery y la biblioteca:

<!-- import JS -->
    [...]
    <script src="https://static.lyra.com/static/js/authenticate-client/V1.0/kr-authenticate.umd.js"></script>
    [...]
    
    <form action='javascript:authenticateSession()'>
      <button id='submitButton' type='submit' class='btn btn-primary'>Authenticate</button>
    </form>
    [...]

    <script>
    // instantiate library
    const krAuthenticate = new KrAuthenticate('69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5');

    // Callback removing the overlay
    function myCallback(data){
        document.getElementById('overlay').remove();
    }

    // this is an example of overlay with a bootstrap spinner
    function buildOverlay(){
        let overlay = document.createElement('div');
        overlay.setAttribute('id', 'overlay');
        overlay.style.backgroundColor = '#D3D3D3';
        overlay.style.height = '100%';
        overlay.style.position = 'absolute';
        overlay.style.top = '0';
        overlay.style.opacity = '0.90';
        overlay.style.width = '100%'
        overlay.classList.add('d-flex', 'justify-content-center', 'flex-column', 'align-items-center');
        overlay.innerHTML = `
<div class="spinner-border" role="status">
<span class="sr-only">Loading...</span>
</div>
        `;
        document.body.appendChild(overlay);
    }

    // Main function triggered by button
    function authenticateSession(){
        document.querySelector('#submitButton').disabled = true;
        buildOverlay();
        krAuthenticate.authenticate("https://theUrlFromThePciCall", myCallback);
    }</script>

4. Ejecución de la autentificación

La biblioteca JavaScript ejecuta todas las acciones necesarias para la autentificación. La siguiente lista presenta casos hipotéticos:.

Casos de autentificación	Descripción	Test
3DS2 Frictionless, sans 3DS Method	La autentificación se realiza sin ninguna interacción del usuario.	3DS2 - autentificación frictionless, sin 3DS Method
3DS2 Frictionless, avec 3DS Method	Se ejecuta un script (3DS Method) antes de la autentificación, la que posteriormente se realiza sin ninguna interacción del titular.	3DS2 - autentificación frictionless, con 3DS Method
3DS2 Challenge, sans 3DS Method	La autentificación requiere una acción del titular.	3DS2 - autentificación con challenge, sin 3DS Method
3DS2 Challenge, avec 3DS Method	Se ejecuta un script (método 3DS) antes de las acciones de autentificación del titular.	3DS2 - autentificación con challenge, con 3DS Method

Consulte Tests y casos de uso para ver más ejemplos.

5. 3. Análisis del resultado de la autentificación

El resultado de la autentificación se envía automáticamente a la URL, establecida en el campoianTargetUrldurante la inicialización de la solicitud de autentificación.
Este resultado contiene los datos necesarios para la solicitud de autorización, como elCAVV.

Gestión del "timeout"

La sesión de autentificación dura 10 minutos.
Al final de este período, seRecomendadollamar al Web ServicePCI/Authentication/GetSessionpara obtener el resultado de la autentificación.

Categoria

Tags

Guía de integración (modo simple)

1. Añadir la biblioteca JavaScript a su sitio

2. Iniciar una solicitud de autentificación del titular

Ejemplo de solicitud

Ejemplo de respuesta

3. Inicializar el script de autentificación

1. Parámetros de inicialización de la clase `KrAuthenticate`

2. Parámetros del método de ejecución de la autentificación `KrAuthenticate.authenticate`

3. Código de ejemplo con la clase `KrAuthenticate` y el método `KrAuthenticate.authenticate`

4. Ejecución de la autentificación

5. 3. Análisis del resultado de la autentificación

Gestión del "timeout"

Categoria

Tags

Guía de integración (modo simple)

1. Añadir la biblioteca JavaScript a su sitio

2. Iniciar una solicitud de autentificación del titular

Ejemplo de solicitud

Ejemplo de respuesta

3. Inicializar el script de autentificación

1. Parámetros de inicialización de la clase KrAuthenticate

2. Parámetros del método de ejecución de la autentificación KrAuthenticate.authenticate

3. Código de ejemplo con la clase KrAuthenticate y el método KrAuthenticate.authenticate

4. Ejecución de la autentificación

5. 3. Análisis del resultado de la autentificación

Gestión del "timeout"

1. Parámetros de inicialización de la clase `KrAuthenticate`

2. Parámetros del método de ejecución de la autentificación `KrAuthenticate.authenticate`

3. Código de ejemplo con la clase `KrAuthenticate` y el método `KrAuthenticate.authenticate`