Payment: Create New (Authorization/Capturing)

Overview

• When you initiate a new payment or disbursement, you must first create an Intent.
• An Intent acts as a container that groups all related transactions—such as payments and/or disbursements—under one business operation.
• This approach ensures all related transactions are easy to track, manage, and reconcile.

Auto-Capture

❗️

Auto-Capture is not supported by all Payment Methods

Before enabling auto-capture, verify whether your selected Payment Method allows automatic settlement. Some methods (e.g. bank transfers or certain wallets) may require manual handling regardless of the configuration

⚙️

What is Auto-Capture?

Auto-Capture is a payment setting that determines when funds are captured (i.e. charged to the payer):

• Enabled – the payment is captured immediately after authorisation.
• Disabled – the payment is only authorised, and must be captured manually within a defined time window.

This setting is essential for handling different payment scenarios — from instant purchases to delayed or conditional fulfilment (e.g. physical goods, fraud checks, inventory confirmation).

Visualisation

Manual Capture Window

⚙️

What is the Manual Capture Window?

The Manual Capture Window is the period after a payment has been authorized, during which you must capture the funds. If you do not capture the payment within this window, the authorisation will expire, and the funds will no longer be available.

This window is defined by the payment method, card scheme, or partner. Once expired, you may need to re-authorise the payment or initiate a new transaction.

Auto-Action at Expiry (Capture or Cancel)

To help prevent missed captures and failed transactions, we offer an auto-action feature: Capture or Cancel

Use Case

How It Works

Endpoints

Possible Results

Full Status Model is available on the page Payment: Overview

Error Reasons

Error codes during transaction creation

Error codes during transaction processing (not creation!)