Integración Avanzada

5 min

Se requiere permisos especiales para poder utilizar este modo de integración del POS, los mismos serán habilitados junto a la aceptación de su operatoria

Solicitar aplicativo local al equipo para integración indicando Sistema Operativo y Arquitectura. Ej. Windows ARM64 o MacOS (ARM / Intel). Esto es importante para compartir el servicio correcto de lo contrario la integración fallará.

Esta integración requiere dos componentes:

Un aplicativo local que funcionará en su computadora y que se encargará de la conexión con el dispositivo

El Dispositivo conectado via USB-C

Es extremadamente importante utilizar el cable USB-C provisto en la caja, si requiere otro USB-C por favor consulte la especificación del mismo.

Configuración del Servicio local

Archivo de Configuración: config.json

serialPort: Puerto Serial configurado para el dispositivo

serialBaudrate: Esta configuración es opcional

port: Esta configuración es opcional y permite definir el puerto local del servicio.

Una vez creada la configuración debe correr el aplicativo provisto por nuestro equipo desde el mismo directorio en el que se encuentra el archivo config.json. Si el mismo se ejecuta de manera normal se añadirá un icono en el Area de Notificaciones del sistema el cual le permitirá ver el puerto en el que corre y salir del proceso.

Antes de Empezar

Para comenzar a procesar en esta modalidad es necesario que coloques al dispositivo en modo PINPAD

Cambio de Modo

Cambiar el modo del dispositivo

PATCH

http://localhost:8484/device/mode

var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
   "id": "String"
});

var requestOptions = {
   method: 'GET',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.cakes.com", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

Realizando una transacción

Para comenzar una operación primero se debe generar un Intent Token para la operatoria

1) Generar IntentToken para el POS Actual: Al generar el intent token guardar el mismo devuelto por el servicio.

2) Iniciar lectura en el dispositivo enviando todo el contenido recibido en el endpoint anterior. Es importante que establezca el Timeout en 120 segundos ya que esta operación es sincrona

Iniciar Lectura

Inicia la lectura en el dispositivo. Sólo para modo PINPAD

POST

http://localhost:8484/payment

var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
   "id": "String"
});

var requestOptions = {
   method: 'GET',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.cakes.com", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

3) Genere la operación invocando el endpoint de operatoria con el IntentToken guardado en el punto 1 y el source recibido en el punto 2. Ver aqui