Integración estándar de POS

El flujo básico de Pago detalla los mensajes necesarios que su POS debe gestionar para funcionar eficientemente:

  1. Login: inicia una sesión operativa con el terminal, permitiendo procesar transacciones desde el POS.

  2. Payment: transacción de venta, utilizando una tarjeta u otro instrumento para completar una compra en el Punto de Venta.

  3. Abort: detiene y cancela inmediatamente una transacción en curso antes de que se inicie la autorización.

  4. TransactionStatus: verifica el resultado final o el último estado conocido de procesamiento de una transacción previa, típicamente activado después de una pérdida de comunicación entre el POS y el POI.

  5. Reversal: deshace una transacción recientemente aprobada acreditando los fondos de vuelta a la cuenta o tarjeta del cliente antes de que la transacción haya sido liquidada financieramente.

  6. Refund: devuelve fondos a un cliente después de una venta que ya ha sido liquidada, normalmente debido a una devolución de producto.

  7. Logout: Esta solicitud cierra la sesión operativa activa en el terminal, concluyendo el turno del cajero o el periodo de uso.

Con estos 7 mensajes, su POS cubrirá el alcance estándar de integración. Encontrará los detalles de estos mensajes a continuación. Ofrecemos funcionalidades adicionales que también pueden interesarle para aportar valor o seguridad adicional a sus clientes.

1. Login

La Solicitud de Login es el primer paso obligatorio para iniciar la comunicación con el Terminal de Pago (POI) y establecer una sesión operativa.

Esta operación debe ser activada al iniciar la aplicación o cada vez que el cajero inicia sesión en el sistema de Punto de Venta (POS). Su propósito principal es transmitir la identidad del sistema (detalles del software POS) y el contexto operativo (ID del Operador, Fecha/Hora) al POI, asegurando que todas las transacciones posteriores se registren y autoricen correctamente.

Haga clic para ver: Diagrama de secuencia de Solicitud/Respuesta de Login

Este diagrama ilustra el intercambio sincrónico obligatorio utilizado para establecer la sesión:

Login Flow (login) - Synchronous.png

A. Solicitud de Login

Encabezado

El objeto estándar SaleToPOIRequest.MessageHeader , con MessageClass establecido en Service y MessageCategory establecido en Login.

Cuerpo

Esta tabla detalla los campos requeridos dentro del objeto LoginRequest, que identifica el software POS y el operador para la nueva sesión.

Nombre del campo Tipo Requerido Descripción
DateTime Cadena Sí La fecha y hora actual del sistema POS en el momento en que se abre la sesión, en UTC siguiendo ISO 8601.
OperatorID Cadena No Identificación del cajero u operador específico (por ejemplo, "Cashier001").
OperatorLanguage Cadena Sí Define la preferencia de idioma del cajero/operador (por ejemplo, EN, PL), en códigos ISO 639-1, usando dos caracteres alfabéticos.
SaleSoftware.ApplicationName Cadena Sí El nombre de la aplicación POS que envía la solicitud (por ejemplo, "POS Simulator").
SaleSoftware.ProviderIdentification Cadena Sí Identificación del proveedor de software (por ejemplo, "POS Provider ID").
SaleSoftware.SoftwareVersion Cadena Sí El número de versión de la aplicación POS (por ejemplo, "22.1.1.0").