Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt

Use this file to discover all available pages before exploring further.

A standard deployment runs as a single tenant instance, each with its own 2 environments, sandbox, and production. Within that environment, it’s possible to add additional sub-accounts called merchant accounts. Each merchant account can be used to configure individual connections and flow rules, and process transactions with unique buyers, payment methods, and vaulted cards; routing transactions to distinct connections and using individual Flow rules and anti-fraud services to decline, route, or trigger 3DS.

​
Single merchant environment

By default, each environment in your instance is a single-tenant environment. That means that in your sandbox or production environment your company is the only merchant account using the resources of that instance, including the database, cloud servers, and more This creates a uniquely redundant system.

​
Multi merchant environment

Additional merchant accounts can be generated within an environment to support a few different scenarios.
  • You’re a large merchant with many different sub-entities that have their relationships with payment service providers and each entity wants to manage its own customer support, payment optimization, and/or data analysis.
  • You’re a technology platform offering payment services to businesses and although you could run all of your customers through one environment, the ability to separate each merchant’s transactions provides you with an easy way to provide additional support tools, payment optimization consulting, and peace of mind that each of your customer’s data is fully segregated.
  • You’re a distribution partner offering payment processing to merchants through the platform. The ability to provide each merchant with their separate merchant account provides you with a way to provide additional support tooling, payment optimization advice, and peace of mind that each of your customer’s data is fully segregated.

​
Setup

​
Enable multiple merchant accounts

Support for multiple merchant accounts in one instance is a premium feature. Please contact the account manager for pricing.

​
Create new merchant accounts

Once multiple merchant accounts have been enabled for your instance, log into your environment as an administrator and click the Settings icon in the top bar. The merchant account list is displayed. Click Add merchant to create a new account. To create a new merchant account, provide a display name and a short ID. The display name is used to display a human-friendly name to the merchant account users in the dashboard. The ID is used as the unique identifier for the merchant account and cannot be changed.
Deleting a merchant account is currently not possible as it may affect a lot of existing data. The ability to deactivate merchant accounts is rolling out at a later point.

​
Edit merchant account

To edit a merchant account, log into your environment as an administrator and click the Settings icon in the top bar. The merchant account list is displayed. Click on the three dots next to any merchant and select Edit merchant. The display name can be changed at any time but the ID cannot be changed as it’s the unique identifier used for API calls, internal reporting, and more.

​
Migrate merchant accounts

In some cases, data from different merchants may be associated with the default merchant account because of a setup before multi-merchant was enabled. Please reach out to support for support migrating existing data to different merchant accounts.