1. First Payment or Payment Method Creation
When a customer does not yet have a Stripe Customer ID, the first time a payment or payment method is created, Kolleno automatically selects a Stripe account based on the settings.
2. Stripe Account Configuration in Settings
In the settings, Stripe accounts can be assigned to customer portfolios:
Available to all customer portfolios:
The Stripe account can be used by all customers, regardless of which portfolio they belong to.
Specific portfolios only:
The Stripe account can only be used by customers in the specified portfolios.
3. Account Selection Rules
When multiple Stripe accounts are possible, Kolleno applies the following rules:
Account for a specific portfolio takes priority
If a customer belongs to a portfolio that has a specific Stripe account assigned, Kolleno chooses that account over an account marked as “available to all customer portfolios”.
If both accounts are tied to the customer’s portfolio
When two or more Stripe accounts are assigned to the same portfolio, Kolleno will use the account that was added to the system first.
4. Existing Stripe Customer ID Overrides
If the customer already has a Stripe Customer ID saved in the settings (including the associated account ID and customer ID), this information will always be used to determine the Stripe account.
In this case, the portfolio-based settings do not apply.
These portfolio settings only determine the account for new customers who have not yet been linked to Stripe.
Summary Table
Scenario | Stripe Account Used |
New customer, no Stripe ID | Selected based on portfolio settings |
Multiple accounts: one “available to all” & one for a specific portfolio | Account for the specific portfolio |
Multiple accounts for the same portfolio | Account added to the system first |
Customer already has a Stripe Customer ID | The Stripe account linked to that existing Stripe Customer ID |
Account Takeaways
Kolleno ensures the correct Stripe account is chosen automatically, based on customer portfolio assignments and existing Stripe links.
Once a Stripe Customer ID is assigned, it always takes precedence over portfolio settings.
This logic guarantees that payments and payment methods are processed through the appropriate Stripe account with no manual intervention required.