Payment Intent Status Flow Overview

Automatic capture and manual capture

A PaymentIntent supports two capture modes.

Capture mode	Configuration	Description
Automatic capture	`auto_capture=true`	Funds are captured automatically after successful authorization
Manual capture	`auto_capture=false`	Funds are authorized first and must be captured later

Some payment methods support a payment-method-specific capture setting under payment_method_options.

For Link, use:

{
  "payment_method_options": {
    "link": {
      "auto_capture": false
    }
  }
}

The payment-method-specific setting takes precedence over the top-level auto_capture setting.

If neither setting is provided, automatic capture is used.

Configure capture behavior by payment method

When multiple payment methods are enabled for the same checkout, capture behavior can be configured separately for Link.

For example, the following configuration uses automatic capture by default but manual capture for Link:

{
  "auto_capture": true,
  "payment_method_options": {
    "link": {
      "auto_capture": false
    }
  }
}

In this example:

Link uses manual capture.

Other supported payment methods use the top-level automatic capture setting.

Manual capture status flow

requires_payment_method
        ↓
requires_customer_action
        ↓
pending
        ↓
requires_capture
        ├── Capture → succeeded
        └── Cancel  → canceled

The intermediate requires_customer_action and pending statuses might not appear in every transaction.

`requires_capture`

The requires_capture status means that the payment has been successfully authorized but has not yet been captured.

A PaymentIntent in this status is not a completed payment.

The merchant must perform one of the following actions:

Capture the full authorized amount.

Cancel the PaymentIntent and release the authorization.

Do not fulfill the order until the PaymentIntent reaches succeeded.

UseePay currently supports only one full capture. Partial capture and multiple captures are not supported.

Payment Intent Overview

Payment Intent Status Flow Overview#

Automatic capture and manual capture#

Configure capture behavior by payment method#

Manual capture status flow#

requires_capture#

Payment Intent Status Flow Overview

Automatic capture and manual capture

Configure capture behavior by payment method

Manual capture status flow

`requires_capture`