Capturas y anulaciones

Cuando tu gateway está configurado en modo authorize (retiene fondos, captura después) en lugar de modo sale (captura inmediata), tienes dos acciones de seguimiento: capture o void.

Capture

POST /api/v1/payments/{transaction_id}/capture

Captura una transacción previamente autorizada. Tras la captura, los fondos se liquidan al comerciante. Dispara payment.completed.

Void

POST /api/v1/payments/{transaction_id}/void

Libera la retención de autorización. La tarjeta del cliente queda libre del cobro pendiente. No hay movimiento de dinero. Sin evento payment.refunded — la transacción simplemente termina en estado voided.

Cuándo usar cuál

Situación	Acción
Pedido enviado, listo para liquidar	Capture
Pedido cancelado antes del envío, transacción aún autorizada	Void
Pedido cancelado después de capturar	Refund
Cliente disputó una autorización no capturada	Void

Configuración modo authorize

Establece el modo de captura en el panel del comerciante en Gateways → Configure → Capture Mode → authorize. Una vez establecido, cada cobro a través de ese gateway retiene fondos hasta que llames a capture o void.