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 allows you to configure merchant permissions and URLs needed to retrieve OAuth tokens.

Prerequisites

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

Creating a new app

  1. Log on to the developer dashboard.
  2. Click Create App.
  3. On the Create App window, type an App Name, select one or more countries, and then click Create.
    The app is created and the App Settings page appears.

Setting the app type

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

  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 now shows 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, do the following.

  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 box, 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 allows merchants to 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 box, 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

Because your app needs OAuth tokens to authenticate API calls, you must configure a URL for the OAuth flow. To set this, do the following.

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