AUTENTICACIÓN

Antes de generar el proceso de peticiones y comunicación a la pasarela de Simplex, es requisito indispensable poder establecer una comunicación segura mediante una autenticación en un contexto de transacción HTTP.

El cliente debe enviar solicitudes HTTP con el encabezado Authorization que contiene la palabra Bearer seguida de un espacio y una cadena codificada en Base64 con el usuario y clave separados por un carácter de dos puntos “:”, las credenciales son proporcionadas desde la plataforma de administración.

Ejemplo de credenciales:

Usuario	:	demo
Clave	:	abcdef0123456789abcdef0123456789

Codificación a Base64:

Texto a codificar	:	demo:abcdef0123456789abcdef0123456789
Texto codificado	:	ZGVtbzphYmNkZWYwMTIzNDU2Nzg5YWJjZGVmMDEyMzQ1Njc4OQ==

Encabezado HTTP con Autenticación:

GET /version.api HTTP/1.1
Authorization: Bearer ZGVtbzphYmNkZWYwMTIzNDU2Nzg5YWJjZGVmMDEyMzQ1Njc4OQ==
Host: api.simplex.com.py

Cuando se realiza cualquier tipo de petición a la API, es requerido autenticarse mediante el método antes indicado, luego de lo cual puede confirmarse la conexión, pero en caso que no sea una autenticación satisfactoria, se responderá con un error HTTP 401 “Unauthorized”.

Respuesta HTTP con error 401:

HTTP/1.1 401 Unauthorized
Server: nginx/1.14.2
Date: Sat, 15 Ago 2020 12:34:56 GMT
Content-Type: application/json