Use Test Merchants Dashboard in sandbox
Test merchant accounts allow you to simulate merchant interactions with your application. This includes installing your app, granting permissions, and then testing all the features of your app. When you sign up to create your sandbox developer account, you can create a test merchant after entering your developer and account information.
On the Test Merchants Dashboard, you can:
- Create multiple test merchant accounts and navigate between Test Merchants Dashboards.
- Manage your Test Merchants Dashboard login credentials.
- View and manage your test merchant business information. (Click the Settings icon next to the merchant name.) See Manage test merchants for more information.
Create your first test merchant
You need to create your first test merchant while creating the sandbox developer account. See Create a sandbox developer account for steps on how to create your Sandbox developer account and the first test merchant account. After you create a test merchant, you can access the Test Merchants Dashboard, and create additional test merchants.
Create additional test merchants
You can create additional test merchants for each region where you want to make your app. You can add test merchants with different settings to simulate the effects of different regions, time zones, currencies, or permissions schemes.
A specific payment gateway is configured based on the address you enter for your test merchant. For example, if you want to create an app for use in Canada, create your test merchant using a Canadian address. The test merchant that you create will process test transactions using the correct gateway for that region.
- Log in to the Developer Dashboard.
- Do one of the following:
- From the Dashboard drop-down menu, under Developer Account, click Create test location.
- From the left navigation menu, in the bottom panel, click Test Merchants.
The Test Merchants Dashboard displays the list of test merchants.

2a. On the Test Merchants Dashboard, click Add Test Merchant. The Create your Test Merchants page appears.

- Add information in the following fields:
Field | Description |
---|---|
Merchant Name | Name of the merchant as it displays on the test Merchants Dashboard and on Dev Kits associated to the account. |
Country | Country where the merchant is located. |
Zip/Postal Code | Postal code for the merchant location. |
Address Line | Street and building information for the merchant location. |
City | City of the merchant location. |
State/Province | State or province of the merchant. If the selected country does not have states or provinces, enter n/a. |
Phone Number | Phone number for the merchant. |
Currency | Currency accepted by the merchant. |
Timezone | Timezone for the merchant. |
Employee Passcode Length | Passcode of 4- or 6-digits that employees of the merchant business must use to log on to the test device. |
- Click Create Account. The merchant you added displays in the test merchants list.
Update test merchant settings
-
Log into the Developer Dashboard.
-
From the left navigation menu, click Test Merchants. The Test Merchants Dashboard appears.

- In the table that displays your test merchants, from the Action column, click Settings icon next to a merchant name. The Settings page appears.

Note: If the Settings page fails to load, add a new test merchant for the US region to use this feature. You can update settings for the test merchants created for the US region.
- Update the following information:
Field | Description |
---|---|
Card Entitlements | Select checkboxes for the card types your merchant can use to process payments. Note: You need to select at least one card type to proceed. |
Credit Card Surcharging | Use the toggle icon to turn on the feature and enter the fee in percentage (%) that the merchant can charge a customer for payment using a credit card. A merchant decides the surcharge percentage based on state rules. They can view the credit surcharge fee applied to transactions in the Virtual Terminal, Clover devices, and Receipts. See Clover Credit Card Surcharging policy for more details. |
Smart Tipping | Use the toggle icon to turn on or off the Smart Tipping feature that displays on the Merchant Dashboard. If you turn on the Smart Tipping toggle icon, merchants can add a flat tip amount to the total sales value through their merchant settings. |
Service Plans | Select a service plan from the drop-down list to change it. Default: Standard Merchant Plans for the test merchants in the United States (US) region. |
- Click Save. You are redirected to the Test Merchants Dashboard and a success message appears on the top.
Note: Use these cards to test the surcharging feature:
Card type | Card company | Card number | CVV | Expiry date |
---|---|---|---|---|
Credit | Mastercard | 5405 9800 0000 8303 | 201 | 12/23 |
Credit | Visa | 4005 5192 0000 0004 201 | 201 | 12/23 |

Update test merchant business information
You can update the merchant's business information only on the Test Merchants Dashboard and not using the Setup app on a Clover device. To change your test merchant's business information:
- Log in to the Developer Dashboard.
- From the header, click Your Name > Merchant Name. The dashboard appears.
- From the left navigation menu, click Account & Setup. Account & Setup page appears.
- Click About Your Business > Business Information, The business information page appears.

- Update the relevant information.
- Click Save.
Updated 12 days ago