Set up a sandbox account

United States
Latin America

The Clover open platform provides tools for you to design and build solutions for Clover merchants. The Clover sandbox environment is a testbed where you can:

  • Experiment with the platform capabilities.
  • Create test merchant accounts to manage merchant data.
  • Create test merchants in other regions where you want to make your app available.
  • Install and test your solutions for these test accounts.
  • Build robust applications. The sandbox is connected to a test payment gateway, which checks the validity of test cards and provides realistic responses to payment requests. For apps that interact with Clover's payment functions, this allows you to build and test robust applications that handle all possible responses when completing a transaction.

The URLs (links) for all sandbox services now have dynamic IP addresses. Any developers using static IP addresses for connecting to sandbox services must support the URLs instead. Learn more about Clover environments.



If you process credit cards, Clover recommends you secure your account with two-factor authentication to protect merchants and their data.



Creating, updating, and deleting apps in the sandbox environment won't affect your published apps installed by Clover merchants using Clover App Market. Solutions used by Clover merchants are built in the Clover production environment. To learn more about the different Clover developer environments and related accounts, see Developer Accounts.

Create a sandbox developer account

  1. Go to Clover sandbox environment.
  1. Click Create a Sandbox Account. The Create your Developer account page appears.
  1. Enter your email address, and click Create Account. A message appears.
  1. Go to your email account and in the confirmation email from Clover, click Set a password.

The Set your Password pop-up appears.

  1. Create a strong password, and click Continue. The Welcome to Clover! pop-up appears.
  2. Enter information about your account, and click Continue.
    Step 1: Full Name—Your identification information in the sandbox environment.
    Step 2: Public Developer Name—Either your developer name or company name. The developer name displays to users when viewing your app on the Clover App Market.

Step 3: Create your Test Merchant—Your first test merchant.


Use the following table to complete the test merchant information. You can edit this information at a later point and also create more test merchants in the Developer Dashboard.

Merchant NameName of the merchant that displays in your Developer Dashboard and on Dev Kits tied to the account.
CountryCountry where the merchant operates.
Zip/Postal/Pin CodeValid postal code for the merchant.
Street AddressStreet and building information for the merchant.
CityCity of the merchant business.
State/ProvinceState or province of the merchant business. If the selected country does not have states or provinces, enter n/a.
CurrencyCurrency accepted by the merchant.
Important: If you are creating a test merchant for any region besides the US, be sure to select the correct currency for testing your app. Some regions, such as Canada, allow processing in more than one currency, and this setting cannot be changed once the test merchant is created.
Phone NumberPhone number for the merchant.
TimezoneTimezone for the merchant.
Employee Passcode LengthSelect whether employees of the merchant business must use a 4- or 6-digit code to log on to the test device.
  1. Click Create Account. The Developer Dashboard for your account is now available in the sandbox environment. You can now create an app.

Use sample inventory to get started with your test merchant

We’ve created a sample inventory file to help you get started with your test merchant.

  1. Download the sample inventory and save to your computer.
  2. Log in to your sandbox Developer Dashboard.
  3. From the Developer Account drop-down list, select a merchant name under Businesses. The Merchant Dashboard for the selected merchant appears.
  4. From the left navigation menu, click Inventory. The Items page appears.
  5. Click Import Your Inventory Spreadsheet. The Import Inventory page appears.
  6. Import the sample inventory spreadsheet. You can either:
  • Navigate to your inventory spreadsheet and drag and drop it into the Import Inventory page.
  • Click Choose File to browse and select the inventory spreadsheet.
    The To be added to inventory page displays the name of the imported sample inventory spreadsheet and count of items in each of the tabs in the imported spreadsheet.
  1. Validate the information on the page and click Continue. A Success message appears.
  2. Click Back to my inventory. The Items page displays the inventory items.

For more details, see Inventory data.

Receive Clover platform status updates

  1. Sign up on Clover's Status page to stay informed about maintenance windows.
  2. Use this information to plan your work, such as not to connect to Clover resources when they will be less responsive than usual or down for maintenance.