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, for older payment extension installations, you may need to manually enable multi-merchant accounts.

Here is the basic procedure, using Stripe as an example:

1. Launch the FinDock app and click the FinDock Setup tab.
2. Go to Processors & Methods and under the Installed tab, click the Stripe entry.
3. Edit the current account name and give it a new, descriptive name (which is often just called "Main").
4. 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).
5. Go back to the processor settings and click the link to the classic setup in the multi-merchant callout.
6. On the Multi-merchant tab, enable multi-merchant and enter the new name for your existing target.
7. Click Save, then click Save in the target settings popup, then close the tab.
8. Open a new tab and go back to the processor settings in FinDock Setup to add accounts.

When you have more than one account for a payment processor, 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.