Regional considerations

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.

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.

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 France must use the reader software version 4.01.00.54_JP_v4_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.