Authorize and Capture
Transactions that have the status authorize need a follow-up action to convert the payment state to a PAID (100) transaction. You can do this by capturing the transaction using the Order ID.
For payment methods that allow partial captures, you can also send in the (partial) amount.
Capture: Claiming the reserved money for a pre-authorized payment.
Authorize: Card and BNPL payments allow you to authorize funds for a limited period, after which the authorization must be either captured or voided.
Related Payment Methods
| Group | Examples |
|---|---|
| Card based payments | Visa, Mastercard or American Express |
Supported Operations by Payment Method
| Payment method | Full capture | Partial capture | Overcapture | Full void | Full refund | Partial refund |
|---|---|---|---|---|---|---|
| AMEX | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Visa | ✓ | ✗ | ✗ | ✓ | ✓ | ✓ |
| Mastercard | ✓ | ✗ | ✗ | ✓ | ✓ | ✓ |
Full capture or partial capture
If you send in orderLines, we attempt to capture the amount associated with those order lines. If you provide only an orderId, we capture the full order, including all open order lines. If you provide an orderId and an amount, we perform a partial capture for the specified amount where supported.
For a full capture, use Order:Capture.
For a partial capture, use Order:Amount.
Overcapture
Allowed brands: AMEX
For transactions paid with American Express (AMEX) that are in the AUTHORIZE state, it is possible to perform an overcapture.
An overcapture allows you to capture an amount that is higher than the originally authorized amount. This can be useful in scenarios where the final order amount exceeds the authorized amount, for example due to additional services, tips or order adjustments.
To perform an overcapture, use the standard Capture Amount endpoint and provide the final amount to be captured.
First, you create the order with AMEX:
Then you (over)capture the relevant amount:
Test case: Overcapture of an AMEX Authorization
Create an order with 3 different products.
| Product ID | Quantity | Unit price | Total |
|---|---|---|---|
| 1 | 2 PC | €25,00 | €50,00 |
| 2 | 1 PC | €30,00 | €30,00 |
| 3 | 1 PC | €20,00 | €20,00 |
| Total Authorized Amount | €100,00 |
After the authorization is created, an additional charge of €15.00 needs to be added to the order.
Perform a capture for the final amount using the Capture Amount endpoint, where you send in the Capture Amount.
| Authorized Amount | Additional Charge | Capture Amount |
|---|---|---|
| €100,00 | €15,00 | €115,00 |
The capture amount exceeds the originally authorized amount and is therefore processed as an overcapture.
Note: Overcapture is only supported for transactions with card brand AMEX in the AUTHORIZE state. For all other card brands, the capture amount cannot exceed the authorized amount.