Manage app settings

You can use the following information to set up a new app or edit the settings of an existing app.

Access settings for your app

1. Log in to your Developer Dashboard.
2. From the left navigation menu, click Your Apps > App name > App Settings. The App name - App Settings page lets you view and configure settings and permissions that your app requires to access Clover merchant data.
3. On the App Settings page, review or edit information in the fields.

Edit the App Name

1. Complete steps to access settings for your app.
2. From the left navigation menu, click Market Listing. The App name - Market Listing page appears.

3. Click the app name. The Edit App Name and Icon window appears.

3. In the App Name field, enter the new app name. You can also upload an image file as the app icon.
4. Click Save.

View App ID and App Secret

App ID and App Secret values uniquely identify your app on the Clover platform. These values are required for you to make authorized and authenticated requests to Clover merchant data.

Select App Type

App Type indicates whether you are building an Android app, web app, or a semi-integration with Clover devices. You can build apps for:

• Clover App Market or Public
• Semi-integration with a Clover device, where a third-party point of sale (POS) system uses Clover for processing payments
• Clover Go
• Private or merchant-specific

You can select multiple app types based on the solution you are building for Clover merchant.

1. Complete the steps to access settings for your app.
2. Click App Type. The App Type page appears.

3. Select an app type:

   App type	Description
   Android app	Select Clover devices only if you want your Android app to run on the Clover device. After you click Save, the App Settings page displays the Android APKs field. Use the field to upload and manage your Android APKs. For more information, see Manage Android app releases.
   Web app	In the REST Clients section, click Web. After you click Save, the REST Configuration field displays on the App Settings page. See Add web app settings.
   Semi-integrated app	For the option - Is this app an integration of an existing point of sale? option - select Yes. After you click Save, the App Settings—App Type section displays a Remote App ID (RAID) that uniquely identifies your semi-integrated app. For more information, see Create your Remote App ID.

Edit Requested Permissions

Define the app permissions for customers, employees, merchants, inventory, orders, payments, and ecommerce. If you change app permissions after a merchant (including your test merchant) downloads your app, the new permissions don't take effect until the merchant uninstalls and reinstalls the app. For more information on app permissions, see Set app permissions.

1. Complete steps to access settings for your app.
2. Click Requested Permissions. The Edit Requested Permission page appears.

3. Review or edit information on the page.
   Note: If you select the Enable online payments checkbox in the Ecommerce section, the Ecommerce Settings section displays on the App Settings page. See Enable online payments for Ecommerce.
4. Click Save to save any edits.

Use webhooks

Webhooks allow your app to receive notifications when merchants who have installed your app perform certain actions. For example, if a merchant has granted you READ_INVENTORY permission and changes their inventory, you'll receive a POST request to the specified for updating the inventory. For more information, see Use webhooks.

Set Merchant Availability

Each Clover merchant subscribes to a software-as-a-service (SaaS) plan that meets their business needs. These SaaS plans provide merchants with access to specific modules or categories of functionality available in each merchant SaaS plan on the Clover platform. Clover recommends that you use the Merchant Availability setting to select only the modules that apply to your app. For more information, see Set modules for merchant plans.

Set Receipt Customizations

Smart receipts allow you to add information to Clover paper and web receipts for the customer. For more information, see Customize receipts.

Add web app settings

1. Select Web app on the App Type page. The REST Configuration displays on the App Settings page.
   See Select App Type.
2. Click REST Configuration. The Edit REST Configuration page appears.

3. Enter information in the fields:

   Field	Description
   Site URL field	Link where a merchant is redirected after they install your app and launch it from the Merchant Dashboard. Example: Link (URL) of your web app homepage.
   Alternate Launch Path (optional)	Link your merchant is redirected to after they install and launch the app from the Merchant Dashboard. This URL uses the expiring authentication tokens to authenticate with APIs.
   CORS Domain (optional)	If you are integrating with Cloud Pay Display, enter a domain link (URL). When you set a Cross-Origin Resource Sharing (CORS) domain URL, your web app can make calls to the Clover REST API without requiring an intermediate app server. For more information, see Set app URL and CORS.
   Default OAuth Response field	Select an option: - Code: Default. When your test merchant is authorized through OAuth 2.0, you receive an authorization code. This code is required for you to request an API token for your app permissions. - Token: When your test merchant is authorized, you directly receive an API token for your app permissions. See Generate an API token

4. Click Example OAuth Request to view a sample OAuth request and response in your browser address bar. Both the request and response is based on the Site URL value.

5. Click Save. The updated values display on the App Settings page.

Enable online payments for Ecommerce (card-not-present) transactions

1. Complete steps to access settings for your app.
2. Click Requested Permissions. The Edit Requested Permission page appears.

3. In the Ecommerce section, select the Enable online payments checkbox. The Ecommerce Settings section displays on the App Settings page.

4. Click Ecommerce Settings. The Edit Ecommerce Setting page appears.

5. Select an option:

   Option	Description
   API	Connect a merchant's ecommerce platform or app to Clover services using ecommerce API-only integration.
   Hosted iFrame	Use the Clover-hosted iframe to integrate secure payment features on your website. See Clover iframe integrations. Turn on the reCAPTCHA setting: When you use the hosted iframe, the Use reCAPTCHA for all transactions made through the iFrame embedded page appears. reCAPTCHA test blocks automated software attacks and prevents transaction spamming. Clover requires all hosted iframe pages to be protected by reCAPTCHA and recommends turning on the reCAPTCHA setting. You can also integrate your own reCAPTCHA test. See Clover Ecommerce vs. Bots: reCAPTCHA Your Website to learn more about implementing CAPTCHA as a security feature in your Ecommerce integration. Enable ApplePay on iframe: If you integrate Apple Pay with your iframe, see Apple Pay for Clover-hosted iframe integration.
   Hosted Checkout	Take payments on the merchant website with Clover. See Hosted Checkout API.

6. Click Save. The selected integration type displays on the App Settings page.