SmartOperation
Una SmartOperation es la representación visual de un conjunto de datos que agrupa información relevante de la operación

Beneficios del modelo SmartOperationpara Operación y Soporte
SmartOperation es el modelo de cupones estandarizado de SUGA que unifica la representación de las operaciones de pago en una estructura común, independientemente del adquirente, procesante, canal o dispositivo desde el cual se haya originado la transacción.
Este modelo actúa como una capa de abstracción sobre las diferencias técnicas entre proveedores, permitiendo que toda transacción sea interpretada y operada bajo un mismo esquema.
SmartOperation aporta beneficios directos a los equipos operativos y de atención a comercios:
- Vista única y centralizada de la información de cada operación.
- Estructura de datos consistente en todos los escenarios.
- Eliminación de dependencias de formatos específicos por proveedor.
- Reducción de tiempos de análisis y resolución de incidencias.
- Mayor trazabilidad y auditabilidad.
Al normalizar los datos en SmartOperation con una estructura común, SUGA permite que:
- Los equipos trabajen siempre sobre el mismo modelo de información.
- Las herramientas de soporte utilicen una lógica única de visualización.
- Los procesos operativos sean consistentes a escala.
Como resultado, cualquier pago —sin importar si fue procesado por distintos adquirentes, procesantes, canales (online, presencial, in-app) o dispositivos— se presenta bajo un formato homogéneo, simplificando la operación diaria y mejorando la experiencia de atención al comercio.
Aplicabilidad a SmartOperation y Transacciones
- Cada smartOperation puede contener uno o más transacciones.
- Cada transacción posee su propio estado dentro de este mismo modelo.
- El estado general de la operación se determina a partir del estado agregado de sus transacciones.
Esto permite representar correctamente escenarios como:
- Pagos parciales.
- Devoluciones parciales.
- Split de pagos.
- Diferencias de estado entre transacciones de un mismo Operation
y se compone de tres grandes bloques:
Entidad:
Es el comercio interviniente que recibe el pago. Cada entidad está compuesta por un ID y una referencia donde, ID es el identificador único del comercio dentro de la plataforma adquirente y la Referencia es un campo que se puede asignar un dato que se necesite para cruzar con otros sistemas.
Cliente:
Es el Tarjetahabiente (pagador) y consta de Nombre de Usuario, Mail, Teléfono y ID (DNI, Cedula o pasaporte). Estos campos solo vienen completos si durante el proceso de la transacción el checkout, el SmartPOS o el QR reciben los campos completos del "Cutomer" definido en la documentación técnica
Detalles de la operación
1) Datos del tarjetahabiente
- Número de tarjeta (enmascarado): 65008700****6748
- Nombre tarjetahabiente: CASTELLINA BRUNO
- ID tarjetahabiente: 39824169
2) Datos operativos de la transacción
- ID transacción: 0R2LHAH3MGBA35FFHUY9OH
- ´Estado:
- Referencia:
- Canal:
- Dispositivo:
- S/N del dispositivo:
- Monto:
- Medio de pago:
- Cuotas
- Plan Elegido
- Monto de las cuotas
- Fecha de creación
- Fecha de actualización
- Código de autorización: 711870
- RRN: 000000000004
- ARN:
- Número de lote: 1
- Número de ticket: 1
- ID plan: 1
- UID plan: ~JZx17kwe
- ID medio de pago: 674a350a21872575df8e54b6
- Nombre medio de pago: Cabal Débito
- Tipo medio de pago: card
- ID comercio/MID: 89760000011
- Adquirente: Mobbex Argentina
- Procesante: Cabal
- Fecha
- Fecha de Pago
Esto permite un modelo consistente para soporte, conciliación y auditoría, independientemente del canal o adquirente/procesante.
Acceso e Integración de Smartcupon/transacciones
Las transacciones gestionadas por la Plataforma Adquirente SUGA pueden ser consumidas e integradas por sistemas externos a través de distintos mecanismos, según las necesidades de cada caso de uso:
APIs: Permiten la consulta, búsqueda y obtención de detalle de transacciones y SmartCupones bajo demanda.
Webhooks: Permiten la notificación en tiempo real de eventos transaccionales relevantes, como creación de transacción, cambios de estado, autorizaciones, rechazos, devoluciones o conciliaciones.
SUGA QL: Lenguaje de consulta de SUGA que habilita exploración flexible, filtrado avanzado y análisis de información transaccional sobre el modelo unificado de datos.
Este enfoque garantiza que las transacciones puedan ser accedidas tanto de forma sincrónica, asíncrona o analítica, manteniendo siempre el mismo modelo de información.