Manage test merchants

United States
Latin America

Test merchants allow you to simulate merchant interactions with your application. This includes installing your app, granting it needed permissions (see App Permissions), and then testing all the features of your app. These types of merchants are non-billable.

Create your first test merchant

When you sign up to create your production or sandbox developer account, you can create a test merchant after entering your developer and account information. Use the following table to complete the test merchant information. From the Developer Dashboard header, create test merchants, navigate between test merchant dashboards, and manage your dashboard login credentials.

  • Manage test merchant accounts: From the header menu, you can create multiple test merchant accounts, and also toggle between them.
  • Account settings: At the top-right of the Developer Dashboard, you can click Web > Account Settings to view and manage your dashboard login settings.



A specific payment gateway is configured based on the address you enter. For example, if you are a US developer who wants to create an app for use in Canada, create your test merchant using a Canadian address. This test merchant will process test transactions using the correct gateway for that region.

You can also create additional test merchants for each region where your app will be available.

Merchant NameName of the merchant as it displays on the test Merchants Dashboard and on Dev Kits tied to the account.
CountryCountry where the merchant is located.
Zip/Postal CodePostal code for the merchant location.
Address LineStreet and building information for the merchant location.
CityCity of the merchant location.
State/ProvinceState or province of the merchant. If the selected country does not have states or provinces, enter n/a.
Phone NumberPhone number for the merchant.
CurrencyCurrency accepted by the merchant.
TimezoneTimezone for the merchant.
Employee Passcode LengthIndicates whether employees must use a 4- or 6-digit code to log on to the test device.

Once you have completed the form, click Submit.

Create additional test merchants

You may want to create other test merchants with different settings to simulate the effects of different regions, time zones, currencies, or permissions schemes.

To create additional test merchants, click Your Name > Create a new merchant from the header and enter the required information as described in the above table.

Update merchant information

To change your test merchant's business information:

  1. Log in to the Developer Dashboard.
  2. From the header, click Your Name > Merchant Name.
  3. On the test Merchant Dashboard homepage, click Setup.
  4. On the Business Information page, modify the fields as required.
  5. Click Save.



The merchant's business information cannot be changed using the Setup app on a Clover device.