Pagos
¿Qué es un pago?
Un pago representa la transacción de un cliente procesada a través de la Global API de Getnet, independientemente del método de pago utilizado (tarjeta de crédito, tarjeta de débito, PIX, Boleto, Bizum u otros métodos de pago alternativos).
Los pagos recopilan detalles esenciales de la transacción, incluida la información del cliente, el importe total, la moneda, el método de pago, los detalles del pedido y más. Cada pago puede tener una o más transacciones asociadas que determinan su resultado final. Para una comprensión más profunda de los tipos de transacciones y cómo se relacionan con los pagos, consulte la página Transacciones.
Ciclo de vida del pago
El siguiente diagrama ilustra los posibles estados de pago y sus conexiones a lo largo del ciclo de vida del pago. Todo pago tiene un estado que sigue un flujo estandarizado, lo que garantiza una funcionalidad coherente en todos los métodos de pago. Un pago pasa por una secuencia de estados hasta su finalización. El diagrama a continuación muestra los posibles resultados basados en el procesamiento de la transacción.
[DIAGRAM_PLACEHOLDER: payment-lifecycle-flow.mermaid]
Estados de pago
Cada pago en la Global API de Getnet puede tener uno de los siguientes estados:
| Estado | Descripción |
|---|---|
| PENDING | El pago se está procesando y está a la espera de un estado final. Puede estar esperando la confirmación del proveedor, la verificación 3DS o el análisis de fraude (fraud screening). |
| WAITING | El pago está a la espera de una acción del cliente o de una autenticación externa (por ejemplo, autenticación 3DS, finalización de la redirección). |
| APPROVED | El pago fue procesado con éxito y aprobado por el emisor. Los fondos están capturados o disponibles para su captura. |
| DENIED | El pago fue rechazado por el emisor o procesador de pagos (por ejemplo, fondos insuficientes, tarjeta rechazada, detección de fraude). |
| ERROR | Se produjo un error del sistema durante el procesamiento del pago. |
| EXPIRED | El pago caducó antes de su finalización (por ejemplo, tiempo de espera de autorización agotado, ventana de pago cerrada). |
Una vez que un pago está APPROVED, puede realizar operaciones posventa, como anulaciones (reversiones) o reembolsos (totales o parciales). Estas son operaciones de la API independientes, no estados de pago.
Para obtener más detalles sobre los códigos de estado y los estados a nivel de transacción, consulte la página Transacciones y la Referencia de la API.
Pagos y transacciones
Un pago consta de una o más transacciones que determinan su resultado final. Cuando habilita funcionalidades adicionales para su flujo de pago (como la autenticación 3D Secure, el análisis de fraude o los flujos de autorización y captura), estas crean transacciones adicionales que pasan a formar parte del ciclo de vida del pago.
Relaciones clave:
- Pagos en un solo paso (compra): Una transacción principal que cobra al cliente de inmediato
- Pagos en dos pasos (autorización y captura): Múltiples transacciones: primero reservando los fondos, luego capturándolos
- Operaciones posventa: Transacciones adicionales para anulaciones, reembolsos o ajustes
Cada transacción dentro de un pago tiene su propio estado que contribuye al estado general del pago. Por ejemplo, un pago con estado APPROVED puede contener múltiples transacciones: una autorización aprobada, una verificación de análisis de fraude exitosa y un cargo capturado.
Puede consultar todas las transacciones asociadas a un pago mediante el endpoint Get Transaction. Esto devuelve información detallada sobre cada transacción, incluidos sus estados individuales, marcas de tiempo (timestamps) y detalles de procesamiento.
Consulte también
Para obtener guías de implementación detalladas y ejemplos de código, consulte la sección Guías de pago en la documentación. Para comprender los tipos de transacciones y cómo se relacionan con los pagos, consulte Transacciones. Para conocer las funciones de seguridad y el cumplimiento, consulte Tokenización, Autenticación 3DS 2.0, Verificación de tarjeta y Cumplimiento de PCI.