Limiting Available Payment Methods

By default, the Adyen Drop-in component displays all payment methods enabled in your Adyen merchant account.

This plugin introduces an additional filtering layer, allowing you to control which methods are available in Sylius.

Why is this useful?

• Development / testing – you can restrict the checkout to only a few selected payment methods (e.g. test cards, wallets).

• Granular control – you can explicitly whitelist payment methods, regardless of the configuration in your Adyen account.

Default configuration

The plugin provides a curated list of overall supported methods, as well as a list of methods supported while using the manual capture mode.

To check the current configuration, run:

bin/console debug:config sylius_adyen

Example output

sylius_adyen:
    payment_methods:
        allowed_types:
            - ach
            - alipay
            - alipay_hk
            - alma
            - scheme
            - bcmc
            - bcmc_mobile
            - blik
            - googlepay
            - ideal
            - klarna
            - klarna_account
            - klarna_paynow
            - paypal
            - onlineBanking_PL
            - twint
            - wechatpayWeb
        manual_capture_supporting_types:
            - ach
            - alma
            - googlepay
            - klarna
            - klarna_account
            - klarna_paynow
            - scheme

The manual_capture_supporting_types option works in tandem with the allowed_types by further filtering the available payment methods. Only methods that support separate capture should be included. To determine which payment methods support this setting, consult Adyen's Payment Methods.

Customization

To override the defaults, update your project configuration (e.g. config/packages/sylius_adyen.yaml) and specify the allowed payment method types:

sylius_adyen:
    payment_methods:
        allowed_types:
            - scheme
            - paypal
            - googlepay
        manual_capture_supporting_types:
            - scheme
            - googlepay

With this setup, only the explicitly listed payment methods will be shown at checkout, even if more methods are enabled in your Adyen account.