Captures & Voids

When your gateway is configured for authorize mode (hold funds, capture later) instead of sale mode (immediate capture), you have two follow-up actions: capture or void.

Capture

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

Captures a previously-authorized transaction. After capture the funds settle to the merchant. Fires payment.completed.

Void

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

Releases the authorization hold. The customer's card is freed of the pending charge. No money moves. No payment.refunded event — the transaction simply ends in voided state.

When to use which

Situation	Action
Order shipped, ready to settle	Capture
Order cancelled before shipment, transaction still authorized	Void
Order cancelled after capture	Refund
Customer disputed an authorized but uncaptured transaction	Void

Authorize-mode setup

Set capture mode in the merchant dashboard under Gateways → Configure → Capture Mode → authorize. Once set, every charge through that gateway will hold funds until you call capture or void.