Select Actions to adjust the guide

Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Action

Scope(s)

Loading actions...

Dynamic Guide URL

Scopes Selected


          
            Separator

Find your Merchant ID

The Merchant ID is a 13-character alphanumeric identifier unique to your Clover business. It is required for all API operations.

Go to the Clover Merchant Dashboard and sign in with your merchant account credentials.

Once signed in, look at the URL in your browser address bar. The Merchant ID is the 13-character value after `/m/`.

Example URL: `https://www.clover.com/dashboard/m/ABC1DEF2GHI3J`
Merchant ID: `ABC1DEF2GHI3J`
For sandbox: `https://sandbox.dev.clover.com/developer-home/m/ABC1DEF2GHI3J`
Copy this value and paste it into the Merchant ID field.

Create a Clover developer account

A Clover developer account provides access to the Developer Dashboard where you create and manage apps.

Go to the Clover Global Developer Dashboard and create an account.

Enter your email address and click Create Account.
Check your email and click Set a password in the confirmation message.
Enter your name and a Public Developer Name (displayed in the Clover App Market).
Fill in the test merchant details (name, country, address, currency, timezone) and click Create Account.
Note: Clover creates a default test merchant for both sandbox and production environments.

Create and configure an app

Toggle to your desired environment (Sandbox or Production).
Click Create new app.

Complete the app creation form.

App Name: `StackOne Integrations`
Select the target country for your merchants.
App Type: select Web in the Web app section.
Click Create App.

After creation, the App Settings page displays your credentials.

Navigate to Your Apps > App name > App Settings.
Copy the App ID and App Secret values and store them securely for use later.

Set the redirect URI so Clover can redirect merchants back to StackOne after authorization.

In App Settings, click REST Configuration.
Site URL: `https://api.stackone.com/connect/oauth2/clover/callback`
Default OAuth Response: select Code.
Click Save.

Select your region

Your Clover merchant region determines which API endpoints are used.

North America (US & Canada) — default region, no additional configuration needed
Europe — select if your merchants are on the Clover Europe platform
Latin America — select if your merchants are on the Clover Latin America platform
If unsure, check the URL when signed in to the Clover Merchant Dashboard — `clover.com` is North America, `eu.clover.com` is Europe, `la.clover.com` is Latin America.

Configure app permissions

Select the permissions your app needs to access Clover merchant data.

Enables actions: Create A Customer, Create A Discount, Create A Discount On An Order, Create A New Line Item, Create A Phone Number For A Customer, Create A Tax Rate For A Merchant, Create An Address For A Customer, Create An Email Address For A Customer, Create An Employee, Create An Inventory Item, Create An Item Category, Create Custom Orders, Create Shift For An Employee, Delete A Customer, Delete A Single Item Category, Delete A Single Shift, Delete An Employee, Delete An Inventory Item, Delete An Order, Delete An Order Discount, Get A Category, Get A List Of Customers, Get A Merchant's Address, Get A Merchant's Properties, Get A Single Customer, Get A Single Discount, Get A Single Employee, Get A Single Inventory Item, Get A Single Merchant, Get A Single Order, Get A Single Payment, Get A Single Refund, Get A Single Tax Rate, Get All Cash Events, Get All Categories, Get All Devices Provisioned To A Merchant, Get All Discounts, Get All Employees, Get All Inventory Items, Get All Line Items For An Order, Get All Modifiers, Get All Order Types For A Merchant, Get All Payments, Get All Payments For An Order, Get All Refunds For A Merchant, Get All Roles For A Merchant, Get All Shifts For An Employee, Get All Tags, Get All Tax Rates, Get All Tenders For A Merchant, Gets A List Of Orders, Update A Category, Update A Customer, Update A Line Item, Update A Phone Number For A Customer, Update A Single Shift, Update An Address For A Customer, Update An Email Address For A Customer, Update An Employee, Update An Existing Inventory Item, Update An Order, Update Merchant Properties, Update The Stock Of An Inventory Item, Void A Line Item

In App Settings, click Requested Permissions. Select the required Read or Write permissions for each category.

Provide a brief justification for each selected permission describing how the integration uses the data, then click Save.

Note: If merchants have already installed the app, permission changes only take effect after they uninstall and reinstall it.

## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for Clover: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)

Click + Connector Profile
Search for and select Clover
Select Type as OAuth 2.0
Fill out the fields using details retrieved from your provider:
- Merchant ID
- Region (Optional)
- App ID
- App Secret
(Optional) Select Actions to be enabled for this Connector Profile
Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Clover.