---
updatedAt: 2026-03-24T12:11:43.000Z
agentTools:
  projectIndex: https://docs.clover.com/dev/llms.txt
---

# Use test merchant identifier and API token

[block:html]
{
  "html": "<meta name=\"description\" content=“Learn how to locate your test merchant identifier (merchantId) and create a test API token on the Developer Dashboard—important for testing interactions with Clover REST API and Android development.”>"
}
[/block]

[block:html]
{
  "html": "<div class=\"container-top\">\n  <!-- North America -->\n  <div class=\"container-reg\">\n    <div class=\"pill-reg\">\n      <div class=\"label-reg\">North America</div>\n    </div>\n  </div>\n\n  <!-- Europe -->\n  <div class=\"container-reg\">\n    <div class=\"pill-reg\">\n      <div class=\"label-reg\">Europe</div>\n    </div>\n  </div>\n\n  <!-- Latin America -->\n  <div class=\"container-reg\">\n    <div class=\"pill-reg\">\n      <div class=\"label-reg\">Latin America</div>\n    </div>\n  </div>\n</div>\n\n<!-- CSS moved to global stylesheet-->\n"
}
[/block]

Test API tokens generated from the sandbox Merchant Dashboard are intended for development and testing only. The merchant identifier `merchantId` and the test API token are required for you to test interactions with Clover REST API and for Android development. Production apps must use API tokens generated using the relevant [OAuth flow](https://docs.clover.com/docs/oauth-flows-in-clover) or the [Clover Android SDK](https://docs.clover.com/docs/setting-android-sdk-versions). In production environments, test API tokens have additional restrictions with [rate limits](https://docs.clover.com/docs/api-usage-rate-limits).

The following procedures are for app development and testing in the sandbox environment.

# Locate the test merchant identifier (merchantId)

Clover assigns a universally unique identifier (**UUID**) known as the <<glossary:merchantId>> to every merchant business. You can search for and view merchantId in both the sandbox and production environments. This merchantId is needed when you make [Clover REST API](https://docs.clover.com/docs/making-rest-api-calls) calls.

To locate the merchantId:

1. Log in to the <<glossary:Developer Dashboard>>.
2. From the Developer Account drop-down list, select a merchant name under Businesses. The Merchant Dashboard for the selected merchant appears.
3. From the top-right menu, click **Settings** > **View all settings**. The Settings page appears.
4. In the About Your Business section, click **Merchants**.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/f59770a2c74cd4be5b4d687d2b7dbb0517a29e10291649fcdbef8d1119b5ab37-Dash3-Settings-Merchants.png",
        "Merchants.png",
        1608
      ],
      "align": "center",
      "sizing": "100% ",
      "border": true,
      "caption": "Merchant Dashboard—Settings"
    }
  ]
}
[/block]

The User Settings page displays the merchantId for the selected merchant. The merchantId is the 13-alphanumeric identifier below the merchant name in the Merchant column. The same id displays in the browser URL for the selected merchant's Merchant Dashboard, for example: `https://clover.com/merchants/3D19QN31ANYR5`

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/0379ce25ffca5d899c8f769bcf17d1a21dfa2b62196c65dd35dc6df4667c3e24-Dash3-User-Settings.png",
        "MID.png",
        3266
      ],
      "align": "center",
      "sizing": "100% ",
      "border": true,
      "caption": "Merchant Dashboard—User Settings"
    }
  ]
}
[/block]

5. To view another merchantId, enter search criteria in the Search merchants by name, ID, city field, and click **Search**. The merchant information displays in the search results grid.

***

# Generate a merchant-specific test API token in sandbox

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

## Prerequisites

* [Create a sandbox developer account](https://docs.clover.com/docs/create-a-sandbox-account).
* [Create test merchant account](https://docs.clover.com/docs/use-test-merchants-dashboard).

## Steps

1. Log in to the <<glossary:Developer Dashboard>>.
2. From the left navigation menu, in the bottom panel, click **Test Merchants**. The Test Merchants page displays the list of test merchants.
3. From the Actions column, click the **Launch Dashboard** icon next to a merchant name. The Merchant Dashboard appears.
4. From the top-right menu, click **Settings** > **View all settings**. The Settings page appears.
5. In the Business Operations section, click **API tokens**. A Welcome to Clover API Tokens pop-up appears.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/f330c10fe630bf8a01b07938da95560361b0c8b5e46c5a89df03395472e967b5-image.png",
        null,
        "Welcome to Clover API Tokens pop-up"
      ],
      "align": "center",
      "sizing": "43% ",
      "border": true,
      "caption": "Merchant Dashboard: Welcome to Clover API Tokens pop-up"
    }
  ]
}
[/block]

7. Review the information and click **Get Started**. The *URL* wants to Know your Location pop-up appears.
8. Click **Allow** to let the dashboard access your location. The API Tokens page appears.

   * If you have previously generated an API token, it displays on the page. You can create as many merchant-specific test API tokens as required.
   * If you have not created any API tokens, the Tokens section on the page is blank.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/824387f1dc4de6843296199316821846ec69c07f3a2aa8a336b46c93505c13d9-Dash3-APITokens-Create.png",
        "",
        "Merchant Dashboard: API Tokens page"
      ],
      "align": "center",
      "sizing": "80% ",
      "border": true,
      "caption": "Merchant Dashboard: API Tokens page"
    }
  ]
}
[/block]

9. Click **Create new token**. The Create new token pop-up displays app permissions that map to platform API endpoints.
10. Enter a token name.
11. Select checkboxes to set permissions based on the test merchant information you want to manage. API tokens are scoped to grant specific permissions to make sure that apps only have access to the resources they need.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/eb54d7192cea2a61d72476444348c2421a3cabd4f5aabdbb480c29584d2145f0-Dash3-CreateNewToken-Permissions.png",
        "",
        "Merchant Dashboard: Create new token (permissions)"
      ],
      "align": "center",
      "sizing": "50% ",
      "border": true,
      "caption": "Merchant Dashboard: Create new token (permissions)"
    }
  ]
}
[/block]

12. Click **Create Token**. The new token displays in the Tokens section.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/ef26ca47a8e8557a04951d9b70725bcdc89476dabd5434aaf25560a3036e5c56-Dash3-Tokens.png",
        "",
        "Merchant Dashboard: API Tokens"
      ],
      "align": "center",
      "sizing": "90% ",
      "border": true,
      "caption": "Merchant Dashboard: API Tokens"
    }
  ]
}
[/block]

13. Expand the Permissions section to view or edit the permissions associated with the API token.