Regional considerations
Learn about regional considerations for integrating Terminal in different countries.
For the most part, you’ll be able to use a single Terminal integration in all supported countries. However, due to local payment methods or regulations there are some country-specific requirements. After going through the sample integration, use this guide to learn about country-specific requirements for Terminal.
Note
In order to process Terminal payments, both the Stripe account receiving the funds and the location associated with the reader must be in the same country, accepting local currency only.
Availability![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Refer to the following table to understand which readers and SDK platforms you can use in each country.
Countries | Android** | iOS** | JavaScript | Server-Driven |
---|---|---|---|---|
United States | ![]() Stripe Reader M2 Bluetooth or USB![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay Embedded | ![]() Stripe Reader M2 Bluetooth![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay Embedded | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart |
Canada Italy Netherlands | ![]() WisePad 3 Bluetooth or USB![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay* Embedded | ![]() WisePad 3 Bluetooth![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay* Embedded | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700* Smart![]() WisePOS E Smart |
United Kingdom | ![]() WisePad 3 Bluetooth or USB![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay Embedded | ![]() WisePad 3 Bluetooth![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay Embedded | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700* Smart![]() WisePOS E Smart |
Austria+ Belgium Czech Republic+ Denmark Finland+ Ireland Luxembourg+ Malaysia+ Norway+ Portugal+ Spain Sweden Switzerland+ | ![]() WisePad 3 Bluetooth or USB![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay* Embedded | ![]() WisePad 3 Bluetooth![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700* Smart![]() WisePOS E Smart |
New Zealand+ Singapore | ![]() WisePad 3 Bluetooth or USB![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay Embedded | ![]() WisePad 3 Bluetooth![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700* Smart![]() WisePOS E Smart |
Australia | ![]() WisePad 3 Bluetooth or USB![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay* Embedded | ![]() WisePad 3 Bluetooth![]() Stripe Reader S700 Smart![]() WisePOS E Smart![]() Tap to Pay Embedded | ![]() Stripe Reader S700 Smart![]() WisePOS E Smart | ![]() Stripe Reader S700* Smart![]() WisePOS E Smart |
France Germany | ![]() WisePad 3 Bluetooth or USB![]() Stripe Reader S700 Smart![]() Tap to Pay* Embedded | ![]() WisePad 3 Bluetooth![]() Stripe Reader S700 Smart![]() Tap to Pay* Embedded | ![]() Stripe Reader S700 Smart | ![]() Stripe Reader S700* Smart |
Integrate Terminal in Canada![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe supports Visa, Mastercard, American Express, Discover, and Interac payments in Canada. All transactions must be made in Canadian dollars (CAD). To accept Terminal charges in Canada, either your platform account or connected account must be in Canada.
Use locations![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Create Locations for your business with addresses in Canada and associate your readers to them. This will ensure that they automatically download the configuration needed to properly process charges in Canada.
A valid address for a Location in Canada must contain the line1
, city
, state
, postal_
, and country
properties.
Reader software version![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Verifone P400 readers operating in Canada must use the reader software version 3.
or later. Read about Verifone P400 software updates for details.
Similarly, BBPOS WisePad 3 readers must use the reader software version 4.
or later. Read about BBPOS WisePad 3 software updates for details.
Translation ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Language regulations require that services, including point-of-sale services, be provided in French unless English has been agreed upon by the cardholder and their card issuer. Terminal is built to help you comply with these requirements if they apply to your business.
Default reader language ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
The Verifone P400 interface displays text in French in addition to English if it is registered to a location with an address in Canada.
The BBPOS WisePOS E and Stripe Reader S700 support changing reader language in the Settings panel. Swipe right across the screen to access the Settings panel, and select your language.
The BBPOS WisePad 3 supports changing reader language directly in the reader interface. After you have registered your reader to a Location with an address in Canada, the reader installs a language pack relevant for your region if one isn’t already in place. To view available language options and to select a language, click the Power / Settings button and scroll down using the arrow keys until you reach the language selection menu. Highlight your desired language and press the green Enter key.
Transaction language ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
After the cardholder has presented their card, the reader determines the cardholder’s preferred language. Each screen after that point is translated according to the cardholder’s preferences.
Other translations ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
If you’re required to provide services in or would like to translate text into French in addition to English, ensure that any of your custom reader screens and receipts display the appropriate translations.
Interac payments![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Interac is the interbank network that handles routing of debit payments in Canada. Consumer debit cards in Canada are branded with an Interac logo and might also be co-branded with another payment network’s logo. Even if the card is co-branded, however, all Interac debit transactions must be routed through Interac. To maximize card acceptance, you should build Interac support into your integration.
Note
Interac isn’t supported while operating offline.
Create a PaymentIntent![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To accept Interac transactions you need to create your payments using the interac_
payment method type. Include the card_
payment method type as well if you accept Visa, Mastercard, and American Express payments.
Note
Learn more about the in-person PaymentIntent flow.
Client-side
Create a PaymentIntent
from your client using one of the following options:
Server-side
The JavaScript SDK and the server-driven integration require you to create the PaymentIntent
on your server. For the other client SDKs, you can create the PaymentIntent
on your server if the information required to start a payment isn’t readily available in your app.
Collect and process a payment![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
After you process the payment, the reader determines whether to route the payment across Interac rails based on the profile of the card presented.
In cases where the Interac card is co-branded, the payment_
field on a PaymentIntent’s returned charge reports the co-brand. The type field on the payment_
for an Interac transaction is always interac_
.
There are further Interac requirements that Stripe handles automatically for you, without additional integration work on your side:
- Before a card is presented, on-screen prompts are in the default reader language. After the card information has been collected, the localization is based on the language preference specified by the presented card.
- The reader automatically prompts for PIN in cases where it is required.
- Interac Flash (contactless) payments are limited to 250 CAD and generally up to three consecutive transactions. Transactions higher than 100 CAD or the fourth contactless transaction in a row require the customer to insert their Interac card and enter their PIN.
Capture and reconcile![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Unlike Visa, Mastercard, and American Express transactions, Interac transactions are authorized and automatically captured in a single step. Make sure that your application doesn’t continue to capture the PaymentIntent
. If you attempt to capture an interac_
payment, the Stripe API returns an error. Make sure that you prevent unintended and duplicate payments in your integration; if failures or declines occur while processing Interac, you can attempt to re-use the same PaymentIntent
from the original transaction to safeguard against double-charging.
Refund an Interac payment![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
In-person refunds are mandatory for Interac transactions in Canada. You can’t create refunds in the API or in the Dashboard for these payments. In this flow, the reader prompts the cardholder to present the card used in the original charge. After the card details are read successfully, your application processes the refund. Like online refunds, you can perform partial refunds by passing in an amount less than the transaction value.
The currency and the card used for refund processing must match those of the original charge, otherwise the request fails with an error.
As a fallback, you can offer refunds to different payment methods such as store credit or cash.