--- title: Modelo mapa de estados de smartOperation slug: modelo-mapa-de-estados-de-smartoperation docTags: createdAt: 2026-01-25T13:50:07.525Z --- La Plataforma Adquirente SUGA implementa un **state machine transaccional** que gobierna el ciclo de vida completo de una transacción y de sus cupones asociados, desde su creación hasta su conciliación o resolución final. ::Image[]{src="https://api.archbee.com/api/optimize/wYlzYU9oe8HZjh9BkqeFY/2QAFQCIZkG8dpQYCsTVkb_image.png" size="98" width="2232" height="1718" position="center" showCaption="false"} Este modelo de estados permite: - Representar con precisión la situación operativa de cada operación. - Habilitar acciones consistentes según estado. - Garantizar trazabilidad end-to-end. - Unificar criterios entre canales, adquirentes y procesantes principalmente cuando se utiliza el **switch multiadquirencia.** Una transacción puede atravesar distintos grupos de estados, los cuales se describen a continuación. **Estados Iniciales** 0 – Sin Estado: La transacción aún no ha sido creada en la plataforma. 1 – Pendiente (Interno): Estado interno reservado. No se utiliza para flujos operativos. 2 – En Espera: La transacción fue creada y se encuentra a la espera de un evento externo, por ejemplo: - Confirmación de pago en efectivo. - Captura diferida. - Validaciones de seguridad. **Estados de Preautorización y Evaluación:** 100 – En Revisión: La transacción se encuentra en proceso de validación o análisis previo a la autorización. 3 – Autorizada: La transacción recibió una autorización exitosa por parte del procesante o red. 210 – Retenida: Transacción autorizada que se encuentra retenida (hold), según reglas del mercado o del adquirente. **Estados Aceptados y de Pago** 201 – Aceptada: Transacción aceptada por el sistema como válida. 200 – Paga: Transacción aprobada por el adquirente. **Estados de Liquidación de un cupon ** 299 – Liquidación en Progreso: La transacción ingresó al proceso de liquidación. 300 – Acreditado: Fondos acreditados al comercio. 301 – Liquidado: Transacción incluida en una liquidación cerrada. 302 – Conciliada: La transacción fue conciliada exitosamente. 303 – Liberación / Acreditación Retenida: Liberación de fondos previamente retenidos. 800 – Lista (Sólo Fidelización): Estado utilizado para operaciones de fidelización sin impacto financiero. *Para detalles particulares de liquidaciones a comercios, ir a Modulo de liquidación y conciliación comercios* **** **Estados Recuperables (Reintento posible): **Estados donde el usuario podría intentar nuevamente la operación: 400 – Declinada 403 – Fallida 410 – Denegada: Fondos insuficientes 411 – Denegada: Autorización requerida 412 – Denegada: Comercio inválido 413 – Denegada: Tarjeta inválida 414 – Denegada: Problema en la red 415 – Denegada: Método de pago inválido 416 – Denegada: Operación inválida 417 – Denegada: Tarjeta no vigente o vencida **Estados Cancelados (No recuperables)** 401 – Expirada 402 – Abandonada 600 – Cancelación en Proceso 601 – Cancelada 604 – Transacción Denegada 606 – Cancelado 610 – Cancelada por Operatoria Inválida Estados de Entrega / Post-Proceso Especial 4 – Entregada (Sólo Fidelización): Estado informativo para flujos de fidelización. Solo si el adquirente está integrado a programas de fidelización puede variar segun la integración con la tercera parte. **Estados de Devolución** 602 – Devuelta 605 – Parcialmente Devuelta **Estados Excepcionales** 500 – Error 501 – Error: Entidad inválida 603 – Desconocida ## Consideraciones Operativas - Los cambios de estado generan eventos internos auditables. - Las acciones disponibles dependen del estado actual. - Los estados se preservan históricamente.