--- title: Módulo gestión de transacciones slug: modulo-gestion-de-transacciones docTags: createdAt: 2026-01-24T16:39:33.765Z --- ## Definiciones El módulo de **Gestión de Transacciones** provee capacidades operativas y de observabilidad para administrar el ciclo de vida transaccional dentro de la Plataforma Adquirente SUGA y se organiza mediante CUPONES Permite **visualizar transacciones**, acceder a su **detalle completo**, y ejecutar **acciones operativas** según el estado y las políticas definidas (por ejemplo, control, seguimiento, resolución y soporte). Este módulo centraliza la trazabilidad end-to-end de la operación, integrándose nativamente con los componentes de orquestación, medios de pago, prevención de fraude y liquidaciones, formando parte de los flujos de autorización, post-proceso y soporte operativo. ### Capacidades principales - Visualización y búsqueda de cupones con filtros operativos. - Acceso al detalle completo de la transacción dentro del cupón (identificadores, ruteo, medio de pago, estado). - Consulta transacciones asociadas a los cupones (estructura CUPON). - Ejecución de acciones operativas sobre la transacción (según estado, permisos y reglas) como reemprimir un cupon, Devolver una operación, hacer una devolución parcial y acciones de prev de fraude. - Trazabilidad y auditoría de eventos asociados (cambios de estado, acciones, respuestas del procesante/adquirente). ## Ciclo de vida de una transacción La siguiente figura representa el **flujo estándar de una transacción en un esquema adquirente**, desde la инициación del pago por parte del tarjetahabiente hasta su autorización, posible rechazo y posterior liquidación. Este flujo es independiente del canal de origen (POS, Tap on Phone, QR, Link de Pago, Checkout, etc.) y se mantiene consistente para todos los medios de pago soportados. La Plataforma SUGA abstrae este circuito completo y lo refleja dentro del Módulo Gestión de Transacciones a través de los estados, eventos y SmartCupones asociad ![](https://api.archbee.com/api/optimize/wYlzYU9oe8HZjh9BkqeFY/utNz8yjlIcXr740zYCDv9_image.png) ### 1. Circuito de Solicitud de Pago El flujo comienza cuando el **tarjetahabiente inicia un pago** en un comercio. El comercio envía la solicitud de pago hacia el **adquirente** a través de la plataforma SUGA, incluyendo los datos necesarios para procesar la operación. Este circuito representa la creación de la transacción dentro de SUGA. ::::BlockQuote Este tramo es gestionado principalmente por los módulos: :::Paragraph{listStyleType="disc" indent="1"} Canales de aceptación (POS, Checkout, Links, QR, Wallet). ::: :::Paragraph{listStyleType="disc" listStart="2" indent="1"} Orquestación / Procesador Adquirente. ::: :::Paragraph{listStyleType="disc" listStart="3" indent="1"} Gestión de Transacciones (creación y tracking). ::: :::: ### 2. Circuito de Autorización de Pago Una vez creada la transacción, el adquirente procesa los datos de la tarjeta y envía la solicitud de autorización hacia las **marcas (redes de tarjetas)**. Las marcas solicitan autorización al **banco emisor**, quien decide aprobar o rechazar la operación. La respuesta recorre el camino inverso hasta llegar al comercio. Este circuito determina los estados de autorización dentro de la transacción. ::::BlockQuote Este tramo es abordado por los módulos: :::Paragraph{listStyleType="disc" indent="1"} Procesador Adquirente. ::: :::Paragraph{listStyleType="disc" listStart="2" indent="1"} SmartSwitch / Multiadquirencia (si aplica). ::: :::Paragraph{listStyleType="disc" listStart="3" indent="1"} Gestión de Transacciones (actualización de estado). ::: :::Paragraph{listStyleType="disc" listStart="4" indent="1"} Hub de Prevención de Fraude (cuando corresponde). ::: :::: ### 3. Circuito de Rechazo de Pago Si el banco emisor o las marcas rechazan la transacción, la información de rechazo se propaga hacia el adquirente y luego al comercio. El Módulo Gestión de Transacciones registra el estado de rechazo y el motivo asociado. ::::BlockQuote Este tramo es abordado por los módulos: :::Paragraph{listStyleType="disc" indent="1"} Procesador Adquirente. ::: :::Paragraph{listStyleType="disc" listStart="2" indent="1"} Gestión de Transacciones (estado y motivo). ::: :::Paragraph{listStyleType="disc" listStart="3" indent="1"} SmartCupon. ::: :::: ### 4. Circuito de Liquidación Cuando una transacción es aprobada, ingresa en el circuito de **liquidación**. Dependiendo del esquema y acuerdos: - Las marcas pueden liquidar al adquirente en T o T+N. - El adquirente luego acredita al comercio según sus reglas. El Módulo Gestión de Transacciones refleja el avance por los estados de liquidación, acreditación y conciliación. ::::BlockQuote Este tramo es abordado por los módulos: :::Paragraph{listStyleType="disc" indent="1"} Módulo de Liquidaciones a Comercios. ::: :::Paragraph{listStyleType="disc" listStart="2" indent="1"} Módulo de Conciliación. ::: :::Paragraph{listStyleType="disc" listStart="3" indent="1"} Gestión de Transacciones (tracking). ::: :::: ## Rol del Módulo Gestión de Transacciones en este flujo El Módulo Gestión de Transacciones **no ejecuta directamente todos estos pasos**, sino que actúa como la **Capa de observabilidad, control y operación transversal** del ciclo de vida completo. Desde este módulo se puede: - Visualizar en qué punto del flujo se encuentra una transacción. - Acceder a los SmartCupones. - Ver estados, identificadores y ruteo. - Ejecutar acciones operativas permitidas. ## Relación con otros módulos Cada uno de los circuitos descriptos será abordado en profundidad en los módulos específicos de la plataforma: - Canales de Aceptación. - Procesador Adquirente. - Medios de pago - Costos de servicio - Promociones - SmartSwitch Multiadquirencia. - Hub de Prevención de Fraude. - Liquidaciones. - Conciliación. - Gestión de contracargos El Módulo Gestión de Transacciones centraliza la visibilidad de todos ellos. :::BlockQuote Este ciclo de vida se gobierna mediante un modelo de **mapa de estados** que habilita acciones operativas consistentes y auditables. ::: ##