Manage test merchant accounts and information
Test merchant accounts let you simulate merchant interactions with your application. This includes installing your app, assigning permissions, and then testing all the features of your app.
Default test merchant account: When you sign up to create a global developer account, a default test merchant account is automatically created for the sandbox and production environments. Test merchants in the production environment are not billed.
While creating and testing apps for the default test merchant, you can also:
- Create additional test merchants in the sandbox or production environment for the region where you want to make your app available.
- Add test merchants with different settings to simulate the effects of time zones, currencies, or permissions.
- Process test transactions using the correct payment gateway for a region. A specific payment gateway is configured based on the address you enter for your test merchant. For example, if you are a developer who wants to create an app for use in Canada, create your test merchant using a Canadian address.
Create additional test merchants
-
Log in to the Global Developer Dashboard. The sandbox environment appears by default.
-
Click the Sandbox toggle icon to go to either the sandbox or the production environment.
-
From the left navigation menu, click Test Merchants. The Test Merchants page lists the default test merchant account.

Global Developer Dashboard: Test Merchants
-
Click Add Test Merchant. The Create your Test Merchant page appears.

Create your Test Merchant page
- Add information in the following fields:
- Click Create Account. The added merchant name displays in the merchants list on the Test Merchants page.
Access the Settings page for merchants
You can launch the Merchant Dashboard from the Global Developer Dashboard and then view and set a number of settings.
-
Log in to the Global Developer Dashboard.
-
From the left navigation menu, click Test Merchants. The Test Merchants page displays a list of test merchants.
-
From the Actions column, click the Launch Dashboard icon next to a test merchant.

Global Developer Dashboard: Test Merchants
The Merchant Dashboard appears.
-
From the top menu, click the Settings icon.

Merchant Dashboard: Settings icon
The Settings side panel appears.

Merchant Dashboard: Settings side panel
From here, you can:
- Complete initial setup tasks, such as basic settings, adding menu items, updating business hours, adding employees, and confirming the merchant's bank account.
- Click View all settings to go to the Settings page and complete more actions related to business operations, employees, billing and statements, transactions, Ecommerce, and more.
Locate the merchant identifier (merchantId)
Update the merchant's business information
- Access the Settings page on the Merchant Dashboard.
- In the About your Business section, click Business Information. The Business information page appears.

Merchant Dashboard: Business Information page
- Enter information in the fields, such as customer-facing information, doing business as (DBA) name, phone number, and address, privacy policy, and upload the business logo.
- Click Save.
To update other test merchant settings, on the Settings side panel, click View all settings and see all available settings options on the Settings page. For more information, see Clover Help for merchants.
Switch between the developer account and test merchant accounts
You can switch between your test merchant accounts on the Merchant Dashboard and also return to your Global Developer Dashboard.
- Log in to the Global Developer Dashboard.
- From the left navigation menu, click Test Merchants. The Test Merchants page displays a list of test merchants.
- From the Actions column, click the Launch icon next to a test merchant. The Merchant Dashboard appears.
- Next to the merchant name, click the Switch Your Business icon. The Switch your Business pop-up appears.

Switch your business pop-up
- Select a merchant name or developer name to go to the relevant dashboard.
Updated 3 days ago
