Basil

Basil is the second release in our new API versioning model. As the first version in the Basil release, 2025-03-31.basil introduces both breaking changes and new features—subsequent Basil versions will include only additive changes. (Our last release was Acacia: every time we introduce a breaking change version, we move to the next release.)

August 27, 2025

The August release of Basil introduces these features to our GA channel:

• New Connect embedded components: The Payout Details embedded component shows details for individual payouts to connected accounts. The Balance Report and Payout Reconciliation Report components let connected accounts view and export those reports.
• Payouts to Financial Accounts v2: You can now create a payout to any v2 Financial Account by specifying its ID.
• Third-party tax apps: When using subscriptions in flexible billing mode, you can now use any third-party tax app.

Our public preview channel also includes several updates:

• Flexible billing mode is now the default: When you create Subscriptions with this public preview version, the subscriptions default to flexible billing mode. Flexible billing mode changes how those Subscriptions behave at different points in their lifecycle, such as calculating prorations, handling trials, and managing usage-based billing.
• Accounts v2 improvements: You can now deactivate configurations for v2 Accounts, changing how your user is represented in Stripe. You can apply and remove configurations as you go.
• Overcapture with payment line items: You can now include payment line items, which help facilitate reconciliation and improve authorization rates for payment methods such as Klarna and PayPal, if your integration uses overcapture.

July 30, 2025

The July release of Basil introduces these features to our GA channel:

• Personalized invoices: You can now personalize the appearance of your post-payment invoices with Invoice Rendering Templates, for different customers, a useful feature for Checkout and Payment Links.
• Ad hoc pricing for Payment Links: You can now specify a Price while creating a Payment Link in just one API request.
• Billing improvements: Subscription schedules can now have phases with mixed durations. Subscriptions that use the flexible billing mode now support thresholds for usage-based billing and mixed intervals with different recurring prices.

Our public preview channel also includes several updates:

• Faster onboarding for Accounts v2: When using Accounts v2, you can now onboard users with the new Account Links v2 API, which forwards the user to a Stripe-hosted onboarding experience.
• New Connect embedded component: The Instant Payouts promotion shows your connected accounts the available funds to pay out and a call-to-action to initiate a payout.
• Smart Disputes: The Disputes API now shows when Smart Disputes can automatically manage disputes for you.
• Payment line items support: You can now add payment line items for any payment for multicapture and incremental authorization.

June 30, 2025

This month’s release brings these new additions to our GA channel:

• Support for crypto payments: You can now use crypto with the Payment Methods API, and customers who pay with crypto can settle as fiat in your Stripe balance.
• New billing mode for subscriptions: Opt into a broad set of more flexible subscription behaviors, such as better proration calculation, metered pricing improvements, and improved trial support.
• Flexible payout schedules: You can now customize payout schedules for Accounts to select multiple days in a week or month.

Our public preview channel also includes these new additions:

• Saving Klarna payment methods: By saving these payment methods, you can charge your customer at a later date (either off-session or on-session).
• Accounts v2 proof-of-address and capabilities: You can now provide proof-of-address documents and better responses for unsupported capabilities.

May 28, 2025

New features in our GA channel include:

• Expanded payment method support: We’ve added new capabilities for Pix, Satispay, Naver Pay, WeChat Pay, and PayPal, and South Korean payment methods across several APIs.
• Simulated S700 reader support: You can now use the Reader API with a simulated S700 terminal.
• New balance types: Balance Transactions now specify a balance type and provide balances for refund and dispute prefunding.
• Partial payments on invoices: You can now attach multiple Payment Intents to one Invoice, allowing for partial and multiple payments.

Our public preview channel includes several updates:

• Flexible billing mode for Subscriptions: You can migrate individual subscriptions to a flexible mode, which provides fine-tuned calculation and orchestration

April 30, 2025

We’ve introduced a number of new features in this latest version, as well as a new public preview channel with early access to new capabilities and upcoming features.

Key updates from our GA channel include:

• Broader tax registration support: Twelve new countries are now supported by the Tax Registration API, enabling businesses to automatically collect tax in those regions.
• Expanded payment method support: We’ve added new capabilities for Affirm, Pix, and Billie across several APIs.
• Test your event destinations: We’ve introduced a new event type so you can ping a webhook endpoint (or other destination type) to test whether it’s ready to receive events from Stripe.

We also have some exciting developments in our public preview channel:

• Global Payouts is now available: Users in the US and UK can send money directly to third parties with a new set of money management APIs.
• Third-party tax provider support: We now support automatic tax calculation with several providers after you install a third-party tax app.
• Retrieve and manage FX rates: The new FX Quote API retrieves our current FX rate and lets you extend that rate for up to a day.
• Scripts support custom business logic: You can now provide scripts to define your own logic for specific API objects and extend Stripe’s behavior.

March 31, 2025

This version introduces a significant number of breaking changes. Make sure to review the complete changelog below. Most notably:

• Billing changes: We removed or reorganized a number of capabilities, including legacy usage-based billing and a migration from the Upcoming Invoice API to the Create Preview API. Many of these breaking changes are preparing our APIs for future updates later this year in the Basil release.
• Total counts no longer supported on lists: You can no longer expand the total_count property on lists, because this is no longer a recommended integration pattern.
• Checkout Session changes: Checkout Sessions for subscriptions now postpone creation of subscriptions until after the user completes payment—this both improves latency on all Checkout Session API calls and fixes a common bug where customers couldn’t modify billing details after the first payment attempt.

We’ve also included some new features:

• Payment method improvements: Klarna can now be used on Hosted Invoice Pages, and we’ve introduced support for Naver Pay, Billie, Satispay, and New Zealand’s BECS Direct Debit.
• Build custom UIs for Checkout Sessions: You can now specify a ui_mode of custom to use Elements and Checkout Sessions to design your own checkout page.
• Billing meter improvements: We’ve introduced new webhook events for billing meters and credits, and new aggregation formula (last) to use the final meter event in a time range as the total value for a bill.

To get started with these updates, review the changelog and upgrade your API version.