Create an app in the sandbox environment

The sandbox environment allows you to develop and test your application separate from real merchant accounts and transactions. To integrate your point-of-sale (POS) with a Clover Dev Kit, you need to create a sandbox app that your test merchant can install. The app allows you to configure the required merchant permissions and links (URLs) needed to retrieve OAuth tokens.

Prerequisites

Before completing this task, you need to create a sandbox developer account and test merchant as described in Setting up a sandbox account.

Create a new app

  1. Log in to your sandbox Developer Dashboard.
  2. Click Create App.
  3. On the Create App window, type an App Name.
  4. Select one or more countries.
  5. Click Create. The App Settings page appears.
838838

Set the app type

External POS apps using the REST Pay API are not available on the public Clover app market, but your Clover app is visible to the merchants using your integrated POS.
To set the type of your app:

  1. On the App Settings page, click App Type.
  2. From the REST Clients list, select Web.
  3. At the prompt, "Is this app an integration of an existing point of sale?", select Yes.
    This creates a RAID (Remote Application ID) which is necessary to establish a connection and allows Clover to associate payments with your integration.
  4. Click Save.
    The app settings are saved.

🚧

IMPORTANT

For OAuth to work properly for a REST Pay web app, the app must have a RAID (Remote Application identifier) set.

Set app permissions for card-present transactions

To complete a payment on the Clover device, your app must be authorized to read merchant data from Clover.

  1. On the App Settings page, click Requested Permissions.
  2. On the Edit Requested Permissions page, select the READ checkbox for Merchant.
  3. Click Save.
    The app permissions are updated.

(Optional) Set app permissions for card-not-present transactions

If your app allows merchants to create and use ECOMM_COMPAT card tokens for card-not-present transactions, you also need to configure your app for the Ecommerce API.

  1. On the App Settings page, click Requested Permissions.
  2. On the Edit Requested Permissions page, select the Merchant READ and the Ecommerce Enable online payments checkboxes. In the sandbox environment, you can leave the Reason field blank.
14401440
  1. Click Save.
    The app permissions are updated.
  2. On the App Settings page, click Ecommerce Settings.
  3. On the Edit Ecommerce Settings page, select the API checkbox.
  4. Click Save.

Set the REST configuration

Your app needs OAuth tokens to authenticate API calls, so you must configure a URL (link) for the OAuth flow.

  1. On the App Settings page, click REST Configuration.
  2. On the Edit REST Configuration page, type your app's URL in the Site URL field.
  3. (Optional) If you are integrating with Cloud Pay Display, type your app's domain in the CORS Domain field.
  4. Under Default OAuth Response, select Code.
  5. Click Save.
    The web configuration settings are updated.

For more information about these configuration options, see Setting app URL & CORS.