Skip to main content

How Kolleno Chooses the Adyen Account for a Customer

This article explains how Kolleno selects the correct Adyen account when multiple Adyen accounts are connected and configured in your Kolleno settings.

Written by Kolleno Support
Updated this week

If you have not connected Adyen to Kolleno yet, see Connect your Adyen account.

1. First payment or payment method creation

When a customer does not yet have an Adyen customer identifier saved in Kolleno, meaning there is no existing Adyen linkage recorded for that customer, the first time a payment or payment method is created, Kolleno automatically selects an Adyen account based on your settings.

For more details on how payment methods work in Kolleno, see Payment Methods.


2. Adyen account configuration in Settings

In Settings, Adyen accounts can be configured with two types of assignments:

(a) Customer portfolio assignment

Each Adyen account can be configured as either:

  • Available to all customer portfolios: the Adyen account can be used for any customer, regardless of portfolio.

  • Specific portfolios only: the Adyen account can only be used for customers in the selected portfolios.

To learn more about setting up and managing portfolios, see Customer Portfolio Overview.

(b) Currency assignment

Each Adyen account can also be configured with currency settings:

  • Available to all currencies: the Adyen account can be used for payments in any currency.

  • Specific currencies only: the Adyen account can only be used for payments in the selected currencies.

When a payment is initiated with a specific currency, Kolleno will only consider Adyen accounts that support that currency.


3. Account selection rules

When more than one Adyen account could apply to a customer, Kolleno uses the following rules:

  1. Currency filtering is applied first
    If a currency is specified for the payment, only Adyen accounts that support that currency, either explicitly assigned or marked as available to all currencies, are considered.

  2. A portfolio-specific Adyen account takes priority
    If a customer belongs to a portfolio that has a specific Adyen account assigned, Kolleno chooses that account over an account marked as available to all customer portfolios.

  3. If multiple Adyen accounts match
    If two or more Adyen accounts match the customer’s portfolio and currency, Kolleno uses the account that was added to Kolleno first.


Summary table

Scenario

Adyen account used

New customer, no saved Adyen linkage

Selected based on portfolio and currency settings

Payment with a specific currency

Only accounts supporting that currency are considered

Multiple accounts: one available to all portfolios and one for a specific portfolio

The account for the specific portfolio

Multiple accounts: one available to all currencies and one for a specific currency

The account matching the payment currency

Multiple accounts for the same portfolio and currency

The account added to the system first

Did this answer your question?