Paso a paso de implementación

1. Integración del comercio (ERP) con APIs de pagos

Este es el primer paso y es fundamental para que funcione la solución. El software de caja debe integrarse con las APIs de Geopagos: POS Mode | Geopagos Developers.

Los endpoints a utilizar son:

• Point of sales
• Create intent
• Get intent info

2. Configuración del lector en BackOffice

Registrar el SmartPOS en el BackOffice y asociarlo a una sucursal:

• Registrar el número de serie en ABM de lectores.
• Ingresar a Comercios → Lectores → Vincular lector.
• Ingresar el token generado por el SmartPOS (previamente se debe pushear la app de cobro al dispositivo).
• Confirmar en el dispositivo con Ya vinculé dispositivo.

3. Asignación de punto de venta

El software de caja debe consumir el servicio Point of sales para asociar el POS (asignar el punto de venta al software de caja):

• Consultar el listado de puntos de venta vinculados.
• Seleccionar el punto de venta correspondiente.
• Asociarlo al software de caja.

4. Generar orden de cobro

El software de caja crea la orden usando la API Create intent. Dentro de esta creación de pago, el implementador debe enviar el dato del punto de venta seleccionado para el software de caja. Esta información se envía al backend de Geopagos.

5. Flujo transaccional en la app CajaPOS

El dispositivo queda a la espera de recibir una intención de pago. Al recibirla, muestra en pantalla el monto a cobrar, el usuario inserta o acerca la tarjeta y se procesa el pago.

• Si el comercio tiene habilitada la propina, antes de capturar la tarjeta el usuario puede adicionarla al monto total recibido desde la caja.
• Si aplican cuotas, antes de capturar la tarjeta el usuario puede seleccionar las cuotas disponibles.
• Al finalizar la transacción, el cliente puede imprimir el ticket correspondiente.

6. Consulta de estado

El software de caja consulta el estado final de la orden utilizando el endpoint Get intent info.