Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment Methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Handle multiple currencies
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
    Overview
    Accept in-person payments
    Integration design
    Select your reader
    Design an integration
    Quickstart
    Example applications
    Testing
    Terminal setup
    Set up your integration
    Connect to a reader
    Accepting a payment
    Collect card payments
    Additional payment methods
    Accept offline payments
    Mail order and telephone order payments
    Regional considerations
    During checkout
    Collect tips
    Collect and save payment details for future use
    Flexible authorisations
    After checkout
    Refund transactions
    Provide receipts
    Customize checkout
    Cart display
    Collect on-screen inputs
    Collect swiped data
    Collect tapped data for NFC instruments
    Apps on devices
    Manage readers
    Order, return, replace readers
    Register readers
    Manage locations and zones
    Configure readers
    Monitor Readers
    Encryption
    References
    API references
    Mobile readers
    Smart readers
    SDK migration guide
    Deployment checklist
    Stripe Terminal reader product sheets
Beyond payments
Incorporate your company
Crypto
Financial Connections
Climate
HomePaymentsTerminal

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

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.

Country

Availability

Refer to the following table to understand which readers and SDK platforms you can use in each country.

CountryAndroid**iOS**JavaScriptServer-Driven
Netherlands
BBPOS WisePad 3
Bluetooth or USB
Stripe Reader S700
Smart
BBPOS WisePOS E
Smart
Tap to Pay*
Embedded
BBPOS WisePad 3
Bluetooth
Stripe Reader S700
Smart
BBPOS WisePOS E
Smart
Tap to Pay
Embedded
Stripe Reader S700
Smart
BBPOS WisePOS E
Smart
BBPOS WisePOS E
Smart
*This Terminal integration shape is currently in beta.
**Compatibility for this mobile SDK also applies when used with React Native.

Integrate Terminal in the Netherlands

Stripe supports Visa, Mastercard, American Express, and Discover payments in the Netherlands. All transactions must be made in euros (EUR). To accept Terminal charges in the Netherlands, either your platform account or connected account must be in the Netherlands.

Use locations

Create Locations for your business with addresses in the Netherlands and associate your readers to them. This will ensure that they automatically download the configuration needed to properly process charges in the Netherlands. A valid address for a Location in the Netherlands must contain the line1, city, postal_code, and country properties.

Command Line
curl
curl https://api.stripe.com/v1/terminal/locations \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "display_name"="HQ" \ -d "address[line1]"="Frederik Roeskestraat 96" \ -d "address[city]"="Amsterdam" \ -d "address[country]"="NL" \ -d "address[postal_code]"="1076 ED" \

Reader software version

BBPOS WisePad 3 readers operating in the Netherlands must use the reader software version 4.01.00.52_Prod_EU_W1_on_v24_510001 or later. Read about BBPOS WisePad 3 software updates for details.

Translation

Default reader language

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 the Netherlands, 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.

Other translations

If you would like to translate text into Dutch in addition to English, ensure that your custom reader screens and receipts display the appropriate translations.

Strong Customer Authentication

Strong Customer Authentication (SCA) is a European regulatory requirement to reduce fraud and make payments more secure. SCA is or will be required for customer-initiated electronic payments within the European Economic Area (EEA). For more information about this European regulation, you can read Stripe’s PSD2: SCA guide.

Transactions below 50 euros (or the local currency equivalent) are considered low value and may be exempted from SCA. However, banks need to request authentication if the low value exemption has been used five times since the cardholder’s last successful authentication or if the sum of previously exempted payments exceeds 150 euros (or the local currency equivalent).

In the Netherlands, all transactions authenticated with a PIN satisfy the SCA requirements. The card represents the first authentication element of the transaction (possession) and the PIN represents the second (knowledge). Some contactless cards may support PIN validation with a single tap; however, others may require initiating an authenticated Chip and PIN contact transaction to comply with the SCA requirements.

If a contactless transaction isn’t eligible for an SCA exemption, the reader prompts the customer to enter their PIN or insert their card for a chip-and-PIN transaction.

You will see two charges associated with SCA-authenticated transactions. The first will be a soft-declined charge with an error message online_or_offline_pin_required or offline_pin_required, depending on the card’s capabilities. The second will be the authorized or hard-declined charge.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access programme.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc