Use Clover developer environments

The Clover open platform provides tools for developers to design, configure, test, and manage app integrations for Clover merchants. You can use different environments based on specific regions:

RegionPlatformDescription
North America—United States and CanadaGlobal developer platform- Use to develop and launch apps and integrations only in the North America region.
- Create a single developer account and access both the sandbox and production environments on the Global Developer Dashboard.
See Get started with the global developer platform.
Europe and Latin America—ArgentinaDeveloper platform- Use to develop and launch apps and integrations in the Europe and Latin America regions.
- Create two separate developer accounts on the sandbox and the region-based production environments to access the following:
> Sandbox Developer Dashboard for initial setup and testing. See Get started with sandbox environment.
> Production Developer Dashboard to submit integrations for approval and then manage and track app performance. See Get started with production environment.

Global developer platform

North America

The Clover global developer platform offers a consolidated developer experience with access to the Global Developer Dashboard.

To create apps and integrations for the North America region:

  1. Create a global developer account.
  2. Build and test your apps in the sandbox first.
    1. Install your apps on test merchants accounts. When you sign up on the global developer platform to create a developer account, Clover creates a default test merchant account for both sandbox and production environments.
    2. Create additional test merchant accounts with different settings to simulate the effects of regions, time zones, currencies, or permissions.
    3. Test your apps that interact with the Clover payment functions. The sandbox environment is connected to a test payment gateway that checks the validity of test cards and provides realistic responses to payment requests. This lets you build apps that can handle all possible responses when completing a transaction.
  3. Turn off the Sandbox toggle icon to:
    1. Access the production environment.
    2. Complete the developer account verification and approval process.
    3. Re-create your app in the production environment.
    4. Test and submit your app for approval. The Clover team reviews and approves each developer account you create in the production environment. After your app is approved and published, merchants can download and install your app from the Clover App Market.
    5. Monitor the status of your app approval and communicate with the Clover team from the production Developer Dashboard. For more information, see Understand the app approval process.

📘

NOTE

If you have an existing developer platform account in North America, note the following when signing up on the global developer platform:

  • You cannot use an email address that you previously used to create your sandbox or production accounts.
  • You cannot invite members to your global developer platform account with email addresses that were previously associated with a sandbox or product account.

Developer platform

Europe
Latin America

Sandbox environment

You can use the sandbox environment as a testbed to experiment with the Clover platform capabilities.

  1. Create a sandbox developer account.
  2. Use the sandbox Developer Dashboard to:
    1. Build and test your apps.
    2. Install your apps on test merchants accounts before you create a production developer account and submit your app for approval.
    3. Create additional test merchants for each region with different settings to simulate the effects of regions, time zones, currencies, or permissions.
    4. Test your apps that interact with the Clover payment functions. The sandbox environment is connected to a test payment gateway that checks the validity of test cards and provides realistic responses to payment requests. This lets you build apps that can handle all possible responses when completing a transaction.

Production environment

You must have an approved production developer account before Clover can approve your apps.

  1. Create a separate production developer account for each country or region where you want to create apps:
  1. Complete the developer account verification and approval process.
  2. Re-create your app in the production environment.
  3. Submit your app for approval after you test your app. The Clover team reviews and approves each developer account you create in a production environment. After your app is approved and published, merchants can download and install your app from the Clover App Market.
  4. Monitor the status of your app approval and communicate with the Clover team from the production Developer Dashboard. For more information, see Understand the app approval process.