Generate a test API token

United States
Latin America

Test API token overview

You can use test API tokens in the sandbox environment. In the production environment, use OAuth expiring access and refresh tokens.

API tokens secure the communication between an app integration and your merchant account. They give permission to access and create merchant data, such as payments, orders, and inventory. API tokens can also be used to integrate online payments with your e-commerce website.



For your Android app, you can generate an API token and query web services using Clover Android SDK.


You need the following information to test apps with an API token:

Client ID (App ID)Client or App ID that uniquely identifies an app on Clover App Market.
Client Secret (App Secret)Client Secret or App Secret is a secret key that Clover assigns to your app. See App ID and App Secret.
Merchant IDMerchant identifier or merchantId that uniquely identifies Clover merchants (including test merchants) on the Clover platform.
Format: 13 characters.
See Locate the test merchant identifier (merchantId).
Authorization CodeAn authorized merchant who has signed into Clover is redirected to your app along with an authorization code. With this code, the Clover server confirms that the merchant authorizes your request for merchant data.
API TokenYour app uses the Authorization Code, Client ID, and Client Secret to negotiate with the Clover server for an API token. With the API token, your app can make REST API calls and access merchant data. See Use Clover REST API.



Test API tokens that you generate in your sandbox Developer Dashboard can only be used when testing the API in the sandbox environment. Do not use these merchant tokens in the production environment.

Generate a test API token

With your test API token, you can make a REST API call and access Clover merchant data. You can create as many test API tokens as required.

To generate a test API token:

  1. Log in to the Developer Dashboard.
  2. From the Developer Account drop-down list, select a merchant name under Businesses. The test Merchant Dashboard appears.
  3. From the left navigation menu, click Account & Setup. The Account & Setup page appears.
  4. In the Business Operations section, click API Tokens.

The API Tokens page appears.

  1. Click Create New Token. A Create new token pop-up appears.
  1. Enter a token name and set permissions based on the test merchant information you want to manage.

The Create new token popup displays app permissions that map to platform API endpoints. See API Reference > Platform API section.

  1. Click Create Token. The new token displays in the Tokens section.
  2. Expand the Permissions section to view the permissions associated with the API token.

For more information about using your API token to access merchant data, see: