Manage test merchant accounts and information

North America—US and Canada
Latin America—Brazil and Mexico
Global developer platform

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.

To access the Clover global developer platform:

🚧

Global developer platform update: Multi-factor authentication (MFA)

In September 2024, Clover is enhancing global developer account security to improve the user experience on its global developer platform. See Action required: Multi-factor authentication (MFA) set up for set-up steps.

If you created a new global developer account in mid-September 2024, you may experience a delay in access to your developer account while the migration is underway. We are migrating accounts in waves and do not expect more than a 12-hour delay for any individual developer. If you cannot login, try again the next day. Migration will be complete by September 30.

Create additional test merchants

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.

To create an additional test merchant:

  1. Log in to the Global Developer Dashboard. The sandbox environment appears by default.

  2. Click the Sandbox toggle icon to go to either the sandbox or the production environment.

  3. From the left navigation menu, click Test Merchants. The Test Merchants page lists the default test merchant account.

    Global developer Production Test Merchants page

    Global Developer Dashboard: Test Merchants

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

Create your Test Merchant page

Create your Test Merchant page

  1. Add information in the following fields:
FieldDescription
Merchant NameName of the merchant that displays on the Test Merchants page and Dev Kits associated with 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 LengthPasscode of 4- or 6-digits that employees of the merchant business must use to log on to the test device.
  1. Click Create Account. The added merchant name displays in the merchants list on the Test Merchants page.

Update test merchant business information

When you sign up to create a global developer account, a default test merchant account is automatically created for the sandbox and production environments. You can also create additional test merchants. You can update the test merchant settings only in the sandbox environment in the Merchant Dashboard, such as updating business details, adding employees, setting up taxes, and building an inventory.

To change your test merchant's business information:

  1. Log in to the Global Developer Dashboard.

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

  3. From the Actions column, click the Launch icon next to a test merchant.

    Global Developer Dashboard: Test Merchants

    Global Developer Dashboard: Test Merchants

    The Merchant Dashboard appears.

  4. From the top menu, click the Settings icon.

    Merchant Dashboard: Settings icon

    Merchant Dashboard: Settings icon

    The Settings side panel appears.

    Merchant Dashboard: Settings side panel

    Merchant Dashboard: Settings side panel

  5. Click Business Information. The Business Information page appears.

    Merchant Dashboard: Business Information page

    Merchant Dashboard: Business Information page

  6. Enter information in the fields, such as business name and address, currency, timezone, privacy policy, and business hours, and upload the business logo.

  7. 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 Account & Setup page. For more information, see Clover Help for merchants.

Switch between 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.

  1. Log in to the Global Developer Dashboard.
  2. From the left navigation menu, click Test Merchants. The Test Merchants page displays a list of test merchants.
  3. From the Actions column, click the Launch icon next to a test merchant. The Merchant Dashboard appears.
  4. Next to the merchant name, click the Switch Your Business icon. The Switch your Business pop-up appears.
Switch your business pop-up

Switch your business pop-up

  1. Select a merchant name or developer name to go to the relevant dashboard.