Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
OverviewUpgrade your integration
Online payments
OverviewFind your use caseUse Managed Payments
Payment methods
Payment interfaces
Payment scenarios
In-person payments
Terminal
Beyond payments

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**JavaScript
Japan+
WisePad 3
Bluetooth or USB
Stripe Reader S700
Smart
WisePad 3
Bluetooth
Stripe Reader S700
Smart
Tap to Pay*
Embedded
Stripe Reader S700
Smart
+Terminal is currently in beta in this country.
*This Terminal integration shape is currently in beta.
**Compatibility for this mobile SDK also applies when used with React Native.

Integrate Terminal in Japan Private preview

Stripe supports Visa, Mastercard, American Express, JCB, and Discover payments in Japan. All transactions must be made in Japanese yen (JPY). To accept Terminal charges in Japan, either your platform account or connected account must be in Japan.

Note

Saving payment details is only supported after collecting a payment.

Contactless payment support

Contactless cards and wallets in Japan use different payment networks that affect compatibility with Stripe Terminal:

  • International contactless: Standard contactless technology supported globally. See our list of supported networks, which includes Visa, Mastercard and JCB.
  • Local contactless: Japan-specific networks, such as iD and QUICPay.

Stripe Terminal only supports international contactless networks. Some cards in Japan, including physical cards and cards added to wallets like Apple Pay or Google Pay might only support local networks (iD or QUICPay) and won’t work with Terminal readers, even if the underlying card displays a supported card brand logo.

Cards that display the contactless “wave” symbol work with Terminal because they support the international contactless standard.

Use locations

Create Locations for your business with addresses in Japan and associate your readers to them. This ensures that they automatically download the configuration needed to properly process charges in Japan. The Terminal Location object for Japan requires different fields than other countries. You can’t set the address field for locations in Japan.

The new address_kana and address_kanji fields contain the same fields as the existing address field, with the addition of an optional town field. A valid Terminal Location in Japan must contain:

One or both of:

  • address_kana
  • address_kanji

At least one of:

  • display_name
  • display_name_kana
  • display_name_kanji

and can optionally contain the phone field.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/terminal/locations \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "display_name"="My Shop" \
  -d "display_name_kana"="わたしの　みせ" \
  -d "display_name_kanji"="私の店" \
  -d "address_kana[line1]"="6-36-401" \
  -d "address_kana[line2]"="ニシコウエンハイツ" \
  -d "address_kana[town]"="ｱﾗﾄ 3-" \
  -d "address_kana[city]"="ﾌｸｵｶｼ ﾁﾕｳｵｳｸ" \
  -d "address_kana[state]"="ﾌｸｵｶｹﾝ" \
  -d "address_kana[country]"="JP" \
  -d "address_kana[postal_code]"="810-0062" \
  -d "address_kanji[line1]"="6-36-401" \
  -d "address_kanji[line2]"="西公園ハイツ" \
  -d "address_kanji[town]"="荒戸　３丁目" \
  -d "address_kanji[city]"="福岡市　中央区" \
  -d "address_kanji[state]"="福岡県" \
  -d "address_kanji[country]"="JP" \
  -d "address_kanji[postal_code]"="８１０００６２" \
  --data-urlencode "phone"="+819012345678"

Reader software version

Stripe S700 readers operating in Japan must use the reader software version 2.34.3.0 or later. For details, see the Stripe Reader S700 software update. Similarly, BBPOS WisePad 3 readers operating in Japan must use the reader software version 4.01.00.57_JP_v11_491001 or later. Read about BBPOS WisePad 3 software updates for details.

Translation

Default reader language

The Stripe Reader S700 supports 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 Japan, 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 Japanese in addition to English, ensure that your custom reader screens and receipts display the appropriate translations.

Was this page helpful?
YesNo