Capture
Capture all or part of a prior authorization. Use this when you separate authorize and capture — the classic example is authorizing at order placement and capturing when the goods ship.
Capture converts a prior authorize into a settle-bound charge. You can capture the full authorized amount, a lesser amount (common for partial shipments), or in some processor configurations capture more than once against the same authorization.
Authorizations expire on a timeline set by the card network — typically around 7 days for Visa/MC, longer for some card types. If you need to capture after the hold lapses, you may need to re-authorize first. Plan your flows around this.
Path parameters
| Parameter | Description |
|---|---|
transactionId | ID of the authorize transaction you are capturing against. |
Body
| Field | Type | Description |
|---|---|---|
amount | integer | Amount in cents. Defaults to the full authorized amount if omitted. |
tax_amount | integer | Tax in cents (included within amount). |
shipping_amount | integer | Shipping in cents (included within amount). |
order_id | string | Populate or override the order ID on capture. |
po_number | string | Purchase order number. |
Example
fetch("https://sandbox.fluidpay.com/api/transaction/txn_abc123/capture", {
method: "POST",
headers: {
"Authorization": "YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
amount: 1299,
tax_amount: 99,
shipping_amount: 500
})
})Partial capture
If you captured less than the authorized amount, the remaining authorization is typically released automatically, though behavior varies by processor. Some processors allow multiple captures against a single authorization up to the authorized total — check with support if that flow applies to you.
Common errors
- Transaction already captured — you are trying to capture a transaction that has already been fully captured.
- Transaction expired — the authorization hold has lapsed. Re-authorize.
- Amount exceeds authorization — you asked to capture more than the original authorization. Re-authorize the difference or capture only what was held.