Creating a production app

To integrate your POS with a production Clover device, you need to create a Clover app that merchants can install. The app lets you configure merchant permissions and URLs needed to retrieve OAuth tokens.

Prerequisites

Before completing this task, create a production developer account as described in Developer account approval.

Creating a new app

  1. Log in to developer dashboard.
  2. Click Create App.
  3. On the Create App page, enter an App Name.
  4. Select one or more countries, and then click Create.
    The app is created and the App Settings page appears.
939939

Setting the app type

External POS apps using the REST Pay API are not available on the public Clover app market, but your Clover apps are visible to 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. For the integration question, select Yes.
    The App Settings page displays your app's RAID.
  4. Click Save.
    The settings are saved.

Setting 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. To configure your app to request this permission:

  1. On the App Settings page, click Requested Permissions.
  2. On the Edit Requested Permissions page, select the READ checkbox for Merchant.
  3. In the reason field, enter Required to connect POS app to Clover device using REST Pay API.
  4. Click Save.
    The app's permissions are updated.

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

If your app lets merchants create and use ECOMM_COMPAT card tokens for card-not-present transactions, your app must also be configured for the Ecommerce API.

  1. On the App Settings page, click Requested Permissions.
  2. On the Edit Requested Permissions page, select the Enable online payments checkbox for Merchant.
  3. In the Reason field, enter Required to process card-not-present transactions using REST Pay API.
  4. Click Save.
    The app's permissions are updated.
  5. On the App Settings page, click Ecommerce Settings.
  6. On the Edit Ecommerce Settings page, select the API checkbox.
  7. Click Save.

Setting the REST configuration

Your app needs OAuth tokens to authenticate API calls. You must configure a URL for the OAuth flow:

  1. On the App Settings page, click REST Configuration.
  2. On the Edit REST Configuration page, enter your app's URL in the Site URL field.
  3. Optional. If you are integrating with Cloud Pay Display, enter your app's domain in the CORS Domain field.
  4. From 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.


Did this page help you?