Launch app in international markets

Clover is live in multiple countries and expanding. Our current markets include:

• United States (US) and Canada
• United Kingdom (UK)
• Republic of Ireland (ROI)

We support markets by segmenting domains into geographic regions:

• https://www.clover.com for the US and Canada
• https://www.eu.clover.com for the UK and ROI

As we expand into other geographic regions, we will add to our domain set. If you want to deploy apps to multiple markets, you must register as a developer and create apps on multiple domains.

Create a developer account in the region you want to build apps for.

Step 1: Create an app for multiple regions

You can support users in different regions through a single version of your app or multiple versions.

Multiple app versions for each region

For multiple app versions, set up a distinct APK and site link (URL) for each region you will support.

• If you're using the REST API, ensure each version of your app points to the correct API server for the region it will support. See Use the Clover REST API for more information.
• Ensure each app uses the correct App ID and App Secret.
• If you have an Android app, upload a separate APK to the Developer Dashboard for each region.
• If you have a web app, enter a different site URL in the Developer Dashboard for each region.

Single app version for multiple regions

To support multiple regions within a single app, upload a single APK and assign a single site URL for all regions. Logic within the app must determine the merchant's region before proceeding with the proper API, App ID, and App Secret.

• If you have a web app to determine the region:
  • Review the client_id parameter from the OAuth Response. You should know what Clover region each of your app IDs is associated with. This will allow you to make API calls to the correct servers on behalf of your merchants.
  • Review the referrer in the HTTP headers when a merchant lands on your site from Clover.
• If you have a web app and a merchant is signing into Clover from your site through OAuth, we recommend separate Sign in with Clover buttons—one for the US and one for Europe.
• If you have an Android app that communicates with Clover only through the Clover SDK, you do not need to determine the region.
• If you have an Android app that communicates with Clover through the Clover REST API, either from Android or your server, you can determine the Clover region using the Clover account manager base_url. You'll need to save the merchant-region association for making future calls to Clover for that merchant.

Use the REST API

In the US market, your app interfaces with https://api.clover.com to make REST API calls. In the UK and ROI markets, your app interfaces with https://api.eu.clover.com for REST API calls.

For example, an app set up on the Developer Dashboard for Europe should interface with https://api.eu.clover.com.

Step 2: Apply for developer approval

For all markets, you provide information to verify your identity and that of your company, if applicable. Developers from any region may apply for developer approval in any market.

Step 3: Submit your app for approval

You must be an approved developer for the target market before submitting an app for approval.

You must also supply legal and support information for your app for all markets when submitting it for approval. You may customize this data, such as phone numbers if you serve multiple needs. Include a country code in your support phone number if you support international markets.

Step 4: Apply for app pricing

You can apply for pricing for your apps. In the US, this involves providing your US-based bank account for verification. In the UK or ROI, you must provide your home country-based bank account for verification.

Step 5: Set pricing for your app

Once Clover approves your app price request, you can configure price details. App prices are set in US dollars (USD). See the Billing page for more information.

The revenue is issued to your US-based bank in dollars in the US. In the UK and ROI, the payment is issued to your bank account in your local currency. Exchange rates between currencies are applied on the day of deposit.