Adds new plan types for Japan instalments
What’s new
Adds bonus and revolving enum values to the type parameter for card instalment plans.
Impact
This change coincides with the release of instalment payments for Stripe Japan accounts, which support other plan types than fixed_count to also choose from:
- With a bonus instalment plan, the customer defers payment to a later date that aligns with their salary bonus.
- With a revolving instalment plan, the customer pays a certain amount each month, and the remaining balance rolls over to the next month.
Changes
| Fields | Change | From → to |
|---|---|---|
| Charge. payment_method_details. card. installments. plan. type ConfirmationToken. payment_method_options. card. installments. plan. type ConfirmationToken. testHelpers#create. payment_method_options. card. installments. plan. type Invoice#create. payment_settings. payment_method_options. card. installments. plan. type Invoice#update. payment_settings. payment_method_options. card. installments. plan. type PaymentIntent#confirm. payment_method_options. card. installments. plan. type PaymentIntent#create. payment_method_options. card. installments. plan. type PaymentIntent#update. payment_method_options. card. installments. plan. type PaymentIntent. payment_method_options. card. installments. available_plans[]. type PaymentIntent. payment_method_options. card. installments. plan. type | Changed | literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') + 7 more literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') literal('fixed_count') → enum('bonus'|'fixed_count'|'revolving') |
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-06-30. basil
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.