Skip to main content
Version: march-24-production

Multi-Merchant accounts for PSPs

Multi-Merchant means you can use more than one account with your Payment Service Provider. This is done by defining multiple Targets (merchant accounts) in the PSP extension settings. For example, if you want to collect and keep separate payments from different geographical regions, you can define an account per region.

FinDock does not support multi-merchant for all processors. Check our payment method overview to see for what processors this feature is supported.

Enable Multi-Merchant

If your FinDock implementation predates the February 2020 release update, you need to manually enable Multi-Merchant. Please note that once enabled, this feature cannot be disabled. For new installation after February 2020, this feature is enabled by default: all PSP accounts are handled as Targets. To enable Multi-Merchant support:

  1. Launch FinDock app and open Setup.
  2. Under Payment Extensions, click on the tile of your PSP extension (e.g. Buckaroo).
  3. Click the Multi-Merchant tab and activate the ‘Enable Multi-Merchant’ toggle.
  4. Enter a good, descriptive name for your existing account. This name is added to the Target picklist. multi-merchant_enable

When you first enable Multi-Merchant, FinDock checks if all the objects in your org are in order. If something is not OK, FinDock does not enable Multi-Merchant and provides information on what needs to be corrected, as shown here:

Error message when unable to activate Multi-Merchant

Add merchant accounts

Once enabled, you can add new accounts under the PSP extension settings with the Add Account button. Each account gets its own tab with account-specific settings.

Add new accounts for a Multi-Merchant PSP

One account must be set as the default account. The default account is used in API calls that do not include Target. If a Target is provided, FinDock validates the value by checking if the Target Name exists in the PSP account settings.