Adds Japan-specific fields to the Terminal Locations API
What’s new
Adds new fields to the Terminal Location resource to support creating locations for addresses in Japan that you can associate with your readers.
Impact
You can now create locations for addresses in Japan and associate them with your readers. 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
The Terminal Location can optionally contain the phone field.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| address_kana address_kanji display_name_kana display_name_kanji phone | Added | Terminal. Location Terminal. Location#create Terminal. Location#update |
| Fields | Change | From → to |
| Terminal. Location#create. address | Changed | required → optional |
| Terminal. Location#create. display_name | Changed | required → optional |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-09-30. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.