Identificarse durante los intercambios

La identificación se efectúa por medio de un encabezado HTTP.

El método utilizado es HTTP Basic Authentication.

En cada solicitud HTTP, el encabezado debe contener las informaciones que permiten al comerciante autentificarse con el Web Service SEPA.

Descripción de los encabezados HTTP:

Tabla 1. Descripción de los encabezados HTTP
Encabezado Descripción Crear un mandato Consultar los datos de un mandato Descargar un mandato Actualizar un mandato
Accept Determinar el formato del contenido que el servidor devolverá.

Arquitectura REST que permite hacer cambios en el formato json

'Accept:application/ json' 'Accept:application/ json'

'Accept:application/octet-stream'

Nota:

En respuesta a la solicitud http se espera una respuesta binaria (pdf)

'Accept:application/ json'
Authorization

Contiene el token de autentificación del usuario.

Se compone de:

  • Site_id; identificador de la tienda (punto de venta objetivo).
  • Certificate: Valor de la clave de TEST o de PRODUCCIÓN.

Estos datos están codificados en base 64.

Nota:

Los valores Site_id y Certificate están disponibles en su Back Office.

  • Site_id: menú Parametrización > Tienda > pestaña Configuración.
  • Certificate: menú Parametrización > Tienda > pestaña Claves.
El valor de la clave determina una solicitud de test o una solicitud de producción.

Ejemplo de token de autentificación codificado sobre base 64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Ejemplo de token de autentificación codificado sobre base 64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Ejemplo de token de autentificación codificado sobre base 64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Ejemplo de token de autentificación codificado sobre base 64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Content-type Determinar el formato del contenido que se envía al servidor.

'content-type:application/json'

'content-type:application/json'

'content-type:application/json'

'content-type:application/json'

Las etapas para construir un encabezado son las siguientes:

  1. Utilizar el método Basic Authentication.
  2. Especificar en el encabezado Autorización el método utilizado: Basic seguido de la representación en Base64 de los valores Site_id y Certificate separados por el carácter ":".
  3. Codificar el resultado obtenido en base 64.
  4. Añadir la cadena en "Basic".

    Nota:
    No olvidar poner un espacio después de Basic.

Transmitir los encabezados con cURL

Para añadir encabezados a su solicitud, utilizar la opción -H o --header .

Ejemplo:

Para especificar el tipo del contenido:

  curl -H "Content-type:application/json" https://secure.lyra.com/sdd			

Para ver los encabezados transmitidos en su solicitud y en la respuesta, utilizar la opción -v .
  curl -H "Content-type:application/json" https://secure.lyra.com/sdd