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. 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 page in the Developer Dashboard, you can:

• Create and access multiple test merchant accounts.
• Manage your login credentials to access test merchants' information.
• View and manage your test merchant business information. You can click the Settings icon next to the merchant name. See Manage test merchants for more information.

Create your first test merchant

On the Global Developer Dashboard, a Default Test Merchant account is created when you create your global developer account. However, on the sandbox Developer Dashboard, when you create a sandbox developer account, you need to create your first test merchant.

Create additional test merchants

You can create additional test merchants for each country in a region where you want to publish 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 you create processes test transactions using the correct gateway for that region.

1. Log in to the Developer Dashboard.
2. 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 page displays the list of test merchants.

3. Click Add Test Merchant. The Create your Test Merchant page appears.

4. Add information in the following fields:
5. Click Create Account. The merchant you added displays in the test merchants list.

Update test merchant settings

You can update settings only for test merchants in the United States (US) region.

1. Log into the Developer Dashboard.

2. From the left navigation menu, in the bottom panel, click Test Merchants. The Test Merchants page displays the list of test merchants.

3. From the Actions column, click the Settings icon next to a merchant name. The Settings pop-up appears.

Note: If the Settings page fails to load, add a new test merchant for the US region to use this feature.

4. Update the following information:

4. Click Save. The Test Merchants page displays a confirmation message.

Use test cards for surcharging

Use the following cards to test the surcharging feature:

Update test merchant business information

You can update the merchant's business information only on the Developer Dashboard and not through the Setup app on a Clover device. To change your test merchant's business information:

1. Log into the Developer Dashboard.
2. From the left navigation menu, in the bottom panel, click Test Merchants. The Test Merchants page displays the list of test merchants.

3. From the Actions column, click the Launch Dashboard icon next to a merchant name. The Merchant Dashboard appears.
4. From the left navigation menu, click Account & Setup. The Account & Setup page appears.
5. In the About Your Business section, click Business Information. The Business Information page appears.

6. Update the relevant information.
7. Click Save.