Skip to main content
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
A Clover developer account is required. You must be able to create apps in the Clover Developer Dashboard.


​
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.
1
Sign in to the Clover Merchant Dashboard
Go to the Clover Merchant Dashboard and sign in with your merchant account credentials.
2
Copy the Merchant ID from the URL
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.
1
Sign up for a developer account
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
Register a new app in the Developer Dashboard to obtain your App ID and App Secret.
1
Sign in to the Developer Dashboard
Sign in to the Clover Developer Dashboard.
  • Toggle to your desired environment (Sandbox or Production).
  • Click Create new app.
2
Fill in app details
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.
3
Copy your App ID and App Secret
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.
4
Configure REST settings
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.
1
Set requested permissions
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.
2
Save permissions
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:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • 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.