Setting up a sandbox account

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. You can create test merchant accounts to manage merchant data and also to install and test your solutions for these test accounts. You can also create test merchants in other regions where you want to make your app available.

🚧

IMPORTANT

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

📘

NOTE

Creating, updating, and deleting apps in the sandbox environment won't affect your published apps installed by Clover merchants using Clover's 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

To create your sandbox developer account:

  1. On the sandbox account creation page, enter your email address.
  2. In the confirmation email you receive, follow the instructions to verify your email address. You are redirected to the Developer Dashboard to complete your account information.
  3. Fill in the following information about your account:
  • Full Name: Your identification information in the sandbox environment
  • Public Developer Name: Either your developer name or company name. The developer name is displayed to users when viewing your app on the Clover App Market.
  • Create your Test Merchant: Your first test merchant. You can edit this information at a later point and also create more test merchants in the Developer Dashboard. Use the following table to complete the test merchant information.

🚧

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.

Field

Description

Merchant Name

The name of the merchant, which appears in your dashboard and on DevKit's tied to the account

Country

The country where the merchant operates

Zip/Postal/Pin Code

A valid postal code for the merchant

Street Address

The street and building information for the merchant

City

The city of the merchant business

State/Province

The state or province of the merchant business. If the selected country does not have states or provinces, enter n/a.

Currency

The currency accepted by the merchant

Phone Number

A phone number for the merchant

Timezone

The timezone for the merchant

Employee Passcode Length

Select whether employees must use a four- or six-digit code to log on to the test device

  1. After you have entered your account information, select Create Account. You now see the Developer Dashboard for your account in the sandbox environment.

Sample inventory

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

After you log on to your sandbox account, select your test merchant from the drop-down list in the header. Select the Inventory app and then import the sample inventory file.

Clover platform status updates

Sign up on Clover's Status page, https://status.clover.com/, to stay informed about maintenance windows. Using this information you can plan your work so that you don't attempt to connect to Clover's resources when they will be less responsive than usual or down for maintenance.

The URLs 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.


Did this page help you?