Clover OAuth 2.0 connector profile – StackOne setup guide

Set up the OAuth 2.0 connector profile for Clover in StackOne. One-time admin setup required before your users can link Clover accounts via Hub.

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

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.

   • MERCHANT_R⧉
   • MERCHANT_W⧉
   • ORDERS_R⧉
   • ORDERS_W⧉
   • INVENTORY_R⧉
   • INVENTORY_W⧉
   • CUSTOMERS_R⧉
   • CUSTOMERS_W⧉
   • EMPLOYEES_R⧉
   • EMPLOYEES_W⧉
   • PAYMENTS_R⧉
   • PAYMENTS_W⧉
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:

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