Transacciones

¿Qué es una transacción?

Una transacción representa una única operación de pago procesada a través de la Global API de Getnet. Cada pago puede tener una o más transacciones asociadas dependiendo del flujo de pago utilizado. Las transacciones rastrean el ciclo de vida de un pago desde su inicio hasta su finalización, incluyendo cualquier operación posventa como capturas, cancelaciones o reembolsos.

En la Global API de Getnet, las transacciones se dividen en transacciones primarias y secundarias. Cada transacción tiene un estado que indica su etapa de procesamiento actual, y usted puede rastrear todas las transacciones relacionadas con un pago utilizando los endpoints de consulta de transacciones.

Tipos y estados de transacción

Las transacciones en la Global API de Getnet se clasifican por tipo y se rastrean por su estado a lo largo de su ciclo de vida. Comprender los tipos de transacción le ayuda a elegir el flujo de pago adecuado para su caso de uso, mientras que monitorear los estados de las transacciones le permite hacer un seguimiento del progreso del pago y gestionar adecuadamente los diferentes resultados.

Transacciones primarias

Las transacciones primarias son las operaciones de pago iniciales que inician un flujo de pago. Estas pueden ser de uno de los siguientes tipos:

Transacciones de compra

Las transacciones de compra son transacciones de venta estándar que cobran inmediatamente a la tarjeta del cliente:

• CREDIT: Una transacción de compra con tarjeta de crédito que se procesa inmediatamente.
• DEBIT: Una transacción de compra con tarjeta de débito que se procesa inmediatamente.

Transacciones de autorización

Las transacciones de autorización reservan fondos en la tarjeta del cliente sin cobrarlos de forma inmediata. Estos fondos se retienen hasta que usted capture la transacción:

• CREDIT_AUTHORIZATION: Autoriza el importe de un pago con tarjeta de crédito para ser capturado en un momento posterior.
• CREDIT_PRE_AUTHORIZATION: Preautoriza un pago con tarjeta de crédito, normalmente utilizado para escenarios donde el importe final puede variar.

Transacciones de verificación

Las transacciones de verificación validan que un método de pago es válido sin procesar un cargo real:

• Verificación de tarjeta: Verifica si el cliente está utilizando un método de pago válido empleando una autorización de importe cero.

Transacciones secundarias

Las transacciones secundarias son operaciones que afectan a una transacción primaria existente. Estas modifican el resultado final del pago:

Captura

Una captura finaliza una transacción previamente autorizada, deduciendo los fondos de la cuenta del cliente:

• Puede ser total o parcial (si se admite la captura parcial).
• Debe realizarse dentro del período de validez de la autorización.
• Se utiliza en flujos de pago de dos pasos donde la autorización y la captura están separadas.

Reembolsos

Los reembolsos devuelven fondos al cliente por una transacción completada. En el sistema de Getnet, la terminología utilizada depende de cuándo se procesa el reembolso:

• Cancelación: Se utiliza cuando un reembolso se procesa el mismo día (D+0) que la transacción original. En este punto, la transacción aún no se ha enviado a través del flujo de Settlement de la red de tarjetas, por lo que Getnet la procesa como una cancelación. La transacción se anula antes de que ocurra el Settlement.

• Reembolso / Ajuste: Se utiliza cuando un reembolso se procesa en un día posterior (D+1 o posterior) a la transacción original. En este punto, la transacción ya se ha enviado a través del flujo de Settlement de la red de tarjetas, por lo que el reembolso debe procesarse como una transacción de reembolso independiente.

Ambas operaciones logran el mismo resultado (devolver fondos al cliente), pero el momento determina qué proceso y terminología utiliza Getnet. Esta distinción es importante para fines de conciliación y Settlement.

3D Secure (3DS)

La autenticación 3DS verifica la identidad del titular de la tarjeta antes de procesar un pago:

• Mejora la seguridad y reduce la responsabilidad por fraude.
• Puede ser requerida según el importe de la transacción, el emisor de la tarjeta o las normativas regionales.
• Puede realizarse como parte del pago inicial o como un paso de verificación independiente.

Descripción general de los tipos y estados de transacción

El siguiente diagrama muestra todos los tipos de transacciones posibles en la Global API de Getnet y sus posibles estados. Cada tipo de transacción puede pasar por diferentes estados dependiendo del flujo de pago y del resultado del procesamiento.

[DIAGRAM_PLACEHOLDER: transaction-statuses-flow.mermaid]

Estados de las transacciones

Cada transacción puede tener uno de los siguientes estados dependiendo de su etapa de procesamiento y del tipo de transacción:

Estados generales

Estados específicos de la operación

Algunos tipos de transacciones devuelven estados específicos de la operación tras completarse con éxito:

Estados de autenticación 3DS

La autenticación 3D Secure utiliza estados específicos:

Ciclo de vida de la transacción

El ciclo de vida típico de la transacción depende del flujo de pago:

Flujo de pago en un solo paso (Compra)

1. Se envía la petición de pago.
2. Estado de la transacción: PENDING → APPROVED o DENIED.
3. Los fondos se cobran y se procesan en Settlement de inmediato.

Flujo de pago en dos pasos (Autorización y Captura)

1. Se envía la petición de autorización.
2. Estado de la transacción: PENDING → AUTHORIZED o DENIED.
3. Los fondos se reservan pero no se cobran.
4. Se envía la petición de captura (dentro del período de validez).
5. Estado de la transacción: PENDING → CAPTURED o DENIED.
6. Los fondos se cobran y se procesan en Settlement.

Operaciones posventa

• Cancelación (Mismo día / D+0): Revierte un pago antes de que entre en el flujo de Settlement de la red de tarjetas. El estado de la transacción cambia a CANCELED.
• Reembolso (D+1 o posterior): Devuelve los fondos al cliente después de que la transacción haya pasado por el Settlement a través de la red de tarjetas. El estado de la transacción cambia a APPROVED (para la transacción de reembolso).

Identificación de la transacción

Cada transacción en la Global API de Getnet tiene varios identificadores:

• transaction_id: Identificador único asignado por Getnet para la transacción.
• payment_id: Identificador que vincula la transacción con su pago principal.
• order_id: Referencia de pedido del comercio para la transacción. Este es el campo principal que utilizan los comercios para la conciliación, ya que coincide con su sistema de pedidos interno.
• request_id: Identificador único para la petición de la API.
• idempotency_key: Clave utilizada para evitar transacciones duplicadas (debe ser única por petición).

Consulta de transacciones

Puede consultar los detalles de la transacción mediante el endpoint Get Transaction, el cual devuelve información detallada sobre una transacción específica, incluyendo su estado, importe, marcas de tiempo (timestamps) y operaciones relacionadas.

Mejor práctica: Aunque puede consultar transacciones a demanda, recomendamos encarecidamente utilizar Webhooks para recibir actualizaciones del estado de las transacciones en tiempo real. Los Webhooks son más eficientes y escalables que consultar la API repetidamente (polling), ya que envían notificaciones a su sistema automáticamente cuando cambian los estados de las transacciones. Este enfoque reduce la carga de procesamiento tanto en su sistema como en la API de Getnet, asegurando un mejor rendimiento y fiabilidad.

Consulte también

• Para obtener información sobre la creación de pagos, consulte las guías de pago en la documentación.
• Para comprender cómo gestionar las actualizaciones de estado de las transacciones, consulte Webhooks.
• Para obtener detalles sobre el procesamiento seguro de pagos, consulte Tokenization y Autenticación 3DS 2.0.