--- title: SmatPOS Integration slug: smatpos-integration docTags: createdAt: 2026-03-23T22:03:42.130Z --- ## Definición SmartPOS Integration es un componente del Módulo de Tarjeta Presente de la Plataforma SUGA Adquirencia. Permite integrar los sistemas de caja o puntos de venta del comercio con los dispositivos POS Android, habilitando la ejecución de operaciones de pago con tarjeta presente directamente desde el entorno operativo del comercio. Este componente funciona como una capa de integración entre el sistema de facturación del comercio y el dispositivo POS, utilizando servicios REST sobre la red interna del comercio como protocolo de intercambio de mensajes. De esta forma, el POS deja de operar como un dispositivo aislado y pasa a integrarse dentro del flujo de venta, sincronizando automáticamente el cobro con el registro de la operación. SmartPOS Integration soporta operaciones con tarjeta (crédito, débito y prepaga), pagos por QR (incluido QR PIX), billeteras digitales, ofreciendo al comercio un único punto de integración para múltiples medios de pago presenciales. ```mermaid flowchart LR subgraph Comercio CAJA["Sistema de caja
Punto de venta"] end subgraph Dispositivo POS["SmartPOS
Terminal Android"] end subgraph Plataforma SUGA GW["SmartPOS Gateway"] CORE["Smart Acquiring Core"] FRAUD["Motor de prevención
de fraude"] TX["Gestión de
transacciones"] end subgraph Ecosistema NET["Red de pagos
Marca"] ISS["Banco emisor"] end CAJA -->|"Monto de venta"| POS POS --> GW GW --> CORE CORE --> FRAUD FRAUD --> CORE CORE --> NET NET --> ISS ISS --> NET NET --> CORE CORE --> TX TX --> POS POS -->|"Resultado"| CAJA ``` ## Rol dentro del Módulo de Tarjeta Presente Dentro del Módulo de Tarjeta Presente de SUGA Adquirencia, SmartPOS Integration cumple el rol de integrador operativo entre el sistema del comercio y la infraestructura de pagos del adquirente. No implementa lógica adquirente propia: consume y ejecuta las capacidades del Smart Acquiring Core, el motor de prevención de fraude, la gestión de medios de pago y el módulo de liquidaciones. **Relación con otros componentes del Módulo de Tarjeta Presente:** - **SmartPOS** — dispositivo Android donde se ejecuta la operación física (lectura de tarjeta, chip, contactless, QR). SmartPOS Integration es la capa que conecta el sistema de caja del comercio con este dispositivo. - **Gestión de Terminales / Flota (MDM)** — administración remota de los dispositivos POS donde opera la integración. **Módulos de la plataforma con los que interactúa:** - **Smart Acquiring Core** — orquestación transaccional, enrutamiento y autorización. - **Prevención de Fraude** — evaluación de riesgo en tiempo real antes de la autorización. - **Gestión de Transacciones / SmartCoupon** — registro del ciclo de vida de la operación. - **Gestión de Medios de Pago** — catálogo de tarjetas, billeteras, QR y planes de cuotas habilitados. - **Costos de Servicio** — aplicación de costos según medio de pago y plan. - **Liquidaciones** — distribución de fondos al comercio. :::hint{type="success"} **Abstracción clave:** Dentro del Módulo de Tarjeta Presente, SUGA desacopla **sistema de caja → SmartPOS Integration → dispositivo POS → red de pagos**, permitiendo que el comercio opere los pagos desde su sistema sin depender del funcionamiento manual del dispositivo ni del fabricante del hardware. ::: ## Funcionamiento ### Modelo de Conexión El sistema de caja del comercio se conecta al dispositivo POS Android a través de la red interna del comercio, utilizando protocolo HTTP sobre TCP. Un mismo comercio puede operar múltiples cajas conectadas a un único POS, o bien contar con múltiples terminales según la configuración del punto de venta. La plataforma provee un mecanismo de verificación de conectividad que permite al sistema de caja confirmar que el POS está disponible antes de iniciar una operación, evitando errores por desconexión. ### Tipos de Operación SmartPOS Integration soporta dos modelos de operación según la complejidad del flujo de pago: **Operaciones de dos pasos.** El sistema de caja envía el monto al POS, el POS lee la tarjeta y retorna el BIN (identificador de la tarjeta) al sistema de caja. Esto permite que el comercio aplique descuentos o promociones por tipo de tarjeta antes de confirmar la operación. Una vez determinado el monto final, el sistema envía el segundo paso para procesar el pago. Este modelo aplica a ventas contado, ventas en cuotas y operaciones forzadas por tipo de tarjeta (débito o crédito). **Operaciones directas.** El sistema de caja envía el monto y la operación se procesa en un único paso sin intervención intermedia. Este modelo aplica a pagos por QR, billeteras digitales y canje de puntos. ```mermaid flowchart TD START["Sistema de caja
envía monto"] --> TYPE{"¿Tipo de
operación?"} TYPE -->|"Tarjeta
(2 pasos)"| STEP1["Paso 1: POS lee tarjeta
Retorna BIN + NSU"] STEP1 --> DISCOUNT["Sistema aplica descuento
por BIN si corresponde"] DISCOUNT --> STEP2["Paso 2: Envía monto final
POS procesa el pago"] STEP2 --> RESULT["Resultado de la transacción
al sistema de caja"] TYPE -->|"QR / Billetera
(directo)"| DIRECT["POS procesa operación
completa en un paso"] DIRECT --> RESULT ``` ### Operaciones de Pago Soportadas SmartPOS Integration habilita los siguientes tipos de operación a través de la integración: **Venta contado.** Venta en un solo pago sin discriminar tipo de tarjeta. El POS acepta crédito, débito o prepaga indistintamente. Opera en modelo de dos pasos. **Venta en cuotas.** Venta con plan de cuotas, aplicable solo a tarjetas de crédito. El sistema de caja define la cantidad de cuotas y el plan de pago. Opera en modelo de dos pasos. **Venta forzada por tipo de tarjeta.** Permite forzar que la operación sea exclusivamente con débito o exclusivamente con crédito. Si el cliente presenta un tipo de tarjeta distinto al solicitado, la operación se rechaza. Útil para comercios que necesitan discriminar el medio de pago por reglas de negocio. **Venta QR.** Operación de pago mediante código QR, con soporte para promociones por BIN, código de entidad, marca y producto. Opera en modelo directo. Incluye soporte para operaciones de vuelto (cash-out) sobre la misma transacción QR. **Venta QR PIX.** Operación mediante PIX (Brasil). **Extracción QR.** Operación de extracción de efectivo mediante QR. No aplica descuentos ni promociones. **Venta por billetera digital/PCT/T3.0.** Integración con billeteras digitales mediante código de billetera y número de cuenta o teléfono del cliente. Soporta múltiples proveedores de billetera de forma agnóstica al proveedor. ### Aplicación de Descuentos por BIN El modelo de dos pasos habilita un flujo nativo de descuentos por tipo de tarjeta. Al recibir el BIN en el primer paso, el sistema de caja puede consultar sus reglas internas de descuento, calcular el monto final con la bonificación aplicada y enviar el monto ajustado en el segundo paso. Esto permite que las promociones y descuentos se gestionen desde el sistema del comercio sin requerir configuración adicional en el POS. ### Consulta y Anulación de Operaciones El sistema de caja puede consultar las transacciones realizadas por el POS, ya sea por número de boleta específico o por las últimas operaciones registradas. La anulación se ejecuta mediante referencia al número de boleta de la operación original. ### Medios de Pago y Marcas Soportadas SmartPOS Integration opera con todas las marcas y tipos de tarjeta habilitados por el adquirente en la plataforma SUGA, incluyendo Visa (crédito, débito), Mastercard (crédito, débito), American Express (crédito), Cabal (crédito), Diners Club (crédito), y tarjetas locales según la jurisdicción del adquirente. Cada medio de pago se identifica mediante un código de emisor (Issuer ID) que la plataforma utiliza para el enrutamiento y la conciliación. ## Compatibilidad y Neutralidad de Dispositivo SmartPOS Integration está diseñado para operar de manera agnóstica al fabricante o modelo del POS, siempre que el dispositivo soporte el protocolo de integración definido por la plataforma (Android con extensión CajaPOS habilitada). Esto permite que el adquirente pueda trabajar con distintos dispositivos y proveedores de hardware sin modificar el sistema del comercio ni la lógica de integración. La activación de la extensión de integración en el POS se gestiona mediante el SDK de SmartPOS, permitiendo activar, desactivar y configurar dinámicamente el servicio de integración en el dispositivo sin intervención del comercio. ## Abstracción Lograda ```mermaid flowchart LR A["Sistemas de caja
heterogéneos"] --> B["SmartPOS Integration
API REST unificada"] B --> C["Dispositivos POS
agnósticos a marca"] C --> D["Smart Acquiring Core
Autorización + liquidación"] ``` **Complejidad abstraída:** - Diversidad de sistemas de caja y facturación → API REST unificada con protocolo estandarizado. - Múltiples fabricantes y modelos de POS → Extensión agnóstica al hardware sobre Android. - Variedad de medios de pago presenciales → Interfaz única para tarjeta, QR, billetera y canje. - Flujos de descuento por tipo de tarjeta → Modelo de dos pasos con retorno de BIN para resolución en el sistema del comercio. - Operaciones cross-border → Soporte nativo QR PIX con conversión de moneda. ## Integración Técnica [https://www.sugaway.dev/cp-sdconn](https://www.sugaway.dev/cp-sdconn) ## Beneficios y Valor Operativo **Para el adquirente.** Independencia de fabricante de POS, menor lock-in tecnológico, time-to-market reducido en la habilitación de nuevos comercios, unificación de la experiencia operativa en toda la cartera de comercios. **Para el comercio.** Automatización del proceso de cobro desde el sistema de caja, reducción de errores manuales en el ingreso de montos, sincronización automática entre ventas y pagos, acceso a múltiples medios de pago (tarjeta, QR, billetera, canje) desde un único punto de integración, y soporte nativo para descuentos por tipo de tarjeta sin configuración adicional en el POS. **Para la operación.** Verificación de conectividad pre-operación, feedback estructurado de errores con mensajes descriptivos, consulta y anulación de operaciones desde el sistema de caja, y trazabilidad completa de cada transacción con código de autorización, número de boleta y datos del medio de pago. *SUGA Acquiring Platform — Where Payments Evolve* *Versión 1.1 | Abril 2026 | Documentación de Producto*