Payment: Capture Authorized Amount
Overview
- Capture Authorised Amount is an API request used to complete a payment that was previously authorised. It instructs the system to collect the held funds from the payer’s account.
- This step is needed when auto-capture is disabled, allowing the merchant to confirm the transaction only after fulfilling conditions like order verification, inventory checks, or price adjustments.
Preconditions
- The payment method used must support manual capture
- The payment must not be already captured or cancelled
- Payment must be authorized
Payment Status = "AUTHORIZED" - The authorisation must still be valid (i.e. within the capture window)
- The amount to capture must not exceed the authorised amount
Use Cases
| Step | Description |
|---|---|
| Step 1 | You initiate a payment with auto-capture OFF |
| Step 2 | The system authorises the amount and holds it on the payer’s account |
| Step 3 | You must send a capture request within the allowed window |
| Step 4 | If you don’t, the payment becomes expired and is marked as cancelled in the system |
How it Works
Endpoints
| Endpoint | Short Name |
|---|---|
PATCH /api/v1/payments/{id} | Initiate the capturing of the authorised amount of a payment transaction |
Possible Results
Full Status Model is available on the page Payment: Overview
Error Reasons
Error codes during transaction processing (not creation!)
| Error Code | Description |
|---|---|
| CODE_PT0000 | Unknown error |
| CODE_PT0001 | Request processing time expired |
| CODE_PT0002 | Invalid payment details |
| CODE_PT0003 | Sender data error |
| CODE_PT0004 | Recipient data error |
| CODE_PT0005 | Internal processing failure |
Updated 5 days ago