Etapa 2: Autentificarse
Objetivo
- Proteger la transferencia de datos.
I. Recuperación de claves
Haga clic en Más acciones desde el
Back Office Vendedor . Se abre la siguiente ventana:
- desde el menú Configuración > Tienda , seleccione su tienda y vaya a la pestaña **Claves de la API REST**.
Tabla de claves de la API REST :
Para cada uso existe una clave para el modo TEST y otra para el modo PRODUCTION.
NÚMERO | NOMBRE DE LAS CLAVES | Descripción |
---|---|---|
1 | Usuario | Para las llamadas al Web Services REST |
2 | contraseña | Para las llamadas a los Web Services REST y para verificar las autenticidad de los datos enviados en la IPN |
3 | Clave pública. | Para crear un formulario de pago en el navegador del cliente |
4 | Clave HMAC-SHA-256 | Para verificar la autenticidad de los datos enviados de vuelta durante la devolución del formulario de pago al navegador |
Esta acción la realizar un usuario habilitado para administrar claves y algoritmos de firma. Para acceder a la pestaña Claves de la API REST debe activar una funcionalidad específica. Contacte al
Más información: Claves de la API REST.
II. Fase de autentificación
- Cree una cadena con el usuario y la contraseña separados por dos puntos (:)
- el nombre de usuario es el ID de la tienda: N° 1: usuario de la tabla de claves de la API REST
- elContraseña, por ejemplo, para la tienda de prueba.testpassword_DEMOPRIVATEKEY23G4475zXZQ2UA5x7M : #2: Contraseña de la tabla de claves de la API REST
Codificar la cadena obtenida en base64
Agregue a su solicitud el encabezado “Authorization” que contenga “Basic” seguido de la cadena codificada en base64:
Authorization: Basic Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN
Por ejemplo, para el lenguaje PHP , el header Authorization se calcula de la siguiente manera:
$header = "Authorization: Basic " . base64_encode($username . ':' . $password);
Este es un ejemplo de solicitud: Desde el Playground, puede acceder al SDK de TEST para testear su integración.
La solicitud HTTP completa se presenta así: Desde el Playground, puede acceder al SDK de TEST.
{ "value": "my testing value" }
III. Ejemplos de código
Hay ejemplos de código en diferentes lenguajes disponibles en Github.
IV. Ejemplo simplificado de PHP
En la carpeta sample
, el archivo de esta etapa es config.php. Permite definir el número de claves de autentificación.
Para más información, Archivo de ejemplo: config.php.