Skip to main content
A Clover developer account is required. You must be able to create apps in the Clover Developer Dashboard.

​
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.

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

After creation, the App Settings page displays your credentials.

  • Navigate to Your Apps > App name > App Settings.
  • Copy the App ID. The App Secret is not needed for this authentication method.
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: the Callback URL from your Connector Profile
  • Default OAuth Response: select Code.
  • Click Save.

​
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.

​
Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.