Multi-Merchant accounts for PSPs

Many Payment Service Providers(PSPs) allow their customers to have multiple merchant accounts. For example, organizations may use separate merchant accounts for different geographic regions.

For PSPs where this is available, each merchant account is defined as a separate account (Target) in the given payment extension settings.

Enable multi-merchant support

Most payment extensions support multi-merchant accounts by default. However, older installations may require you to manually enable support

If you have an older installation and want to start using multiple merchant accounts, here is the basic procedure, using Mollie as an example:

1. Create a new name for your current target (which is often just called "Main" in single-account setups).
2. Update the Target field on existing records with the new name. This includes Installment, Payment, Payment Schedule, Recurring Payment, Recurring Payment Schedule, and source-specific records for objects like Recurring Donation (NPSP) or Gift Transaction (NPC).
3. Launch the FinDock app and click the (classic) Setup tab.
4. Scroll to the Payment Extensions section and click on the PSP tile.
5. Click the Multi-merchant subtab (if present).
6. Toggle on multi-merchant support and enter the new name for your existing target.
7. Click Save.

Once enabled, use the enhanced FinDock Setup to add accounts.

If you have more than one account for a PSP payment extension, keep in mind that you need to set one of those accounts as the default. The default is used to process payment intent calls to the Payment API that do not include a target value.