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 /processing/api/v1/payments/{id}`	Initiate the capturing of the authorised amount of a payment transaction (Send status = CAPTURED).

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