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 Canadahttps://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.
- Review the
- 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.
Updated about 1 month ago