Skip to main content

Flujo de Vida del Pago

Este es el camino estándar que sigue una transacción exitosa versus una que no se completa.

Pendiente (PENDING)

La transacción ha sido iniciada. En métodos como transferencias o billeteras, estamos a la espera de la confirmación del usuario.

Autorizado (AUTHORIZED)

El emisor ha aprobado el pago. Los fondos están reservados en la cuenta del cliente pero aún no han sido transferidos a tu cuenta.

Liquidado (SETTLED)

¡Éxito! El dinero ha sido procesado e incluido en el ciclo de liquidación para ser depositado en tu cuenta bancaria.

Glosario de Estados

Utiliza estos estados para mapear la lógica en tus webhooks y base de datos.

Estados de Éxito

EstadoEtiquetaDescripción
AUTHORIZED
Autorizado
success
Aprobada por la marca. Fondos retenidos.
SETTLED
Liquidado
success
Transacción completada y procesada para pago.

Estados Finales de Error

EstadoEtiquetaDescripción
DECLINED
Denegado
error
Rechazada por el banco emisor o reglas del sistema.
INVALID
Inválido
error
Error de procesamiento, fallo de autenticación o bloqueo por prevención de fraude. Siempre muestra el detalle del motivo.
EXPIRED
Expirado
warning
El tiempo límite de pago (TTL) ha caducado.
CANCELLED
Cancelado
neutral
El usuario o el sistema decidieron cancelar la operación.

Estados Post-Venta

EstadoEtiquetaDescripción
VOIDED
Extornado
info
Anulación de una transacción autorizada (antes de liquidar).
REFUNDED
Devuelto
info
Devolución total o parcial de una transacción ya liquidada.

Flujo de estados

Este es el flujo de estados que recorre una transacción en la plataforma:
  • Inicio: Toda operación comienza como Registrado y pasa a Pendiente mientras se procesa.
  • Resolución: Desde pendiente, el pago puede ser Autorizado (éxito), Denegado (rechazo), Cancelado/Expirado(abandono) o Invalido (error de datos).
  • Cierre: Una vez autorizado, el flujo avanza a Liquidado (captura de fondos) y finaliza en Abonado.
  • Post-venta: Permite aplicar un Extornado (anulación antes de liquidar) o Devuelto (reembolso tras la liquidación).
Image