Payment Capture Modes

Overview

The Sylius Adyen Plugin supports two distinct capture modes for payment processing, each designed for different business needs and operational workflows. Understanding these modes is essential for configuring your payment methods correctly and ensuring smooth transaction processing.

• Automatic Capture: Payments are immediately marked as paid upon authorization

• Manual Capture: Delayed fund capture requiring explicit admin action

The capture mode is configured on a per Sylius payment method basis, allowing you to offer different capture strategies for different payment scenarios or customer segments. This setting is separate from the Adyen merchant account capture mode configuration.

Configuration Requirements

Set your Adyen merchant account's capture mode to either "Immediate" or "Delayed". Choosing "Manual" can cause issues since Sylius requests captures explicitly depending on the setting of the given payment method.

Automatic Capture Mode

Automatic capture mode provides a streamlined payment flow where funds are marked as paid immediately upon successful authorization. This mode is ideal for minimizing management requirements.

Payment State Flow

authorized -> paid

• authorized: Payment approved by Adyen (transient state)

• paid: Funds immediately captured and available

How It Works

1. Customer completes checkout

2. Payment authorization request sent to Adyen

3. Upon successful authorization, the payment is marked as paid in Sylius

4. Order ready for immediate fulfilment

Benefits

• Simplified workflow with no manual intervention

• Reduced administrative overhead

Manual Capture Mode

Manual capture mode separates authorization from fund capture, providing a control point for order verification or inventory checks. This mode requires explicit admin action to capture funds after authorization.

Payment State Flow

authorized -> processing -> paid

• authorized: Payment approved by Adyen

• processing: Capture initiated, awaiting confirmation

• paid: Capture successful, funds transferred

How It Works

1. Customer completes checkout

2. Payment authorization request sent to Adyen

3. Payment remains in authorized state

4. Admin reviews the order and triggers capture

5. Payment moves to processing state and awaits the CAPTURE webhook event

6. CAPTURE webhook confirms successful fund transfer

7. Payment marked as paid in Sylius

Benefits

• More control over the transaction

• Provides time for order evaluation, stock validation, and other tasks.

• Allows for partial refunds