Launch app in international markets
Clover point of sale (POS) and the open platform for developers are available in multiple countries and are expanding. Our current markets include:
- North America: United States (US) and Canada
- Europe: United Kingdom (UK), Republic of Ireland (ROI), Austria, Germany, and the Netherlands
- Latin America: Argentina
To begin creating apps and integrations for Clover devices, you need to create a developer account in the region for which you want to build apps.
Step 1: Create a developer account
Create a developer account based on region:
- North America—Create a global developer account and get access to both the sandbox and the production environment with a single developer account.
- Europe and Latin America—Create a sandbox developer account.
Step 2: 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.
| API/SDK | Requirement |
|---|---|
| REST API | Make sure: - Each regional 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. - Each app uses the correct App ID and App Secret. |
| Android app | Upload a separate APK to the Developer Dashboard for each region. |
| 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. The app's logic must determine the merchant's region before proceeding with the proper API, App ID, and App Secret.
| API/SDK | Requirement |
|---|---|
| REST API | Your app set up on a region-based Developer Dashboard interfaces with the following URLs based on the region: - North America: https://api.clover.com- Europe: https://api.eu.clover.com- Latin America: https://api.la.clover.com |
| Android app | - You can determine the Clover region using the Clover account manager base_url for your Android app that communicates with Clover through the Clover REST API, either from Android or your server. You need to save the merchant-region association for making future calls to Clover for that merchant.- You do not need to determine the region for your Android app that communicates with Clover only through the Clover SDK. |
| Web app | For your web app, determine the region as follows: - Review the client_id parameter from the OAuth Response. You should know what Clover region each of your app IDs is associated with. This lets you make API calls to the correct servers on behalf of your merchants. For more information, see OAuth flows in Clover.- Design separate Sign-in with Clover buttons—one for the US and one for Europe—if your merchant is signing into Clover from your site through OAuth. - Review the referrer in the HTTP headers when a merchant navigates to your website from Clover. |
Step 3: Apply for developer approval
For all markets, you need to submit your developer account for approval and 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 4: Submit your app for approval
You can submit an app for approval only after you have an approved developer account for the target market. You need to submit all legal and support information for your app for approval in all markets. You can customize region-specific information, such as phone numbers; include a country code in your support phone number if you support international markets. For more information, see Understand the app approval process.
Step 5: Apply for app pricing
You can apply for pricing for your apps. You need to add bank account details to your verified Clover developer account to receive disbursements from Clover. You can add or update account bank details on the Developer Settings page on your production Developer Dashboard. For more information, see Manage developer bank account information.
Step 6: 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).
The revenue is issued to your US-based bank in dollars. In the United Kingdom and Ireland, the payment is issued to your bank account in your local currency. Exchange rates between currencies are applied on the day of deposit. For more information, see View billing transactions and lifecycle.
Updated 4 months ago