Dahlia
Dahlia is the fourth release in our flora-named API versioning model. As the first version in the Dahlia release, 2026-03-25. introduces both breaking changes and new features—subsequent Dahlia versions will include only additive changes. (Our prior releases were Acacia, Basil, and Clover: every time we introduce a breaking change version, we move to the next release.)
March 25, 2026
The March release of Dahlia includes new features in our GA channel, along with several breaking changes:
- Elements and Stripe.js changes: We made several updates to Stripe Elements and Stripe.js, including the removal of deprecated methods from Stripe.js in favor of equivalent methods with clearer naming and improved functionality, as well as the renaming of the Checkout initialization method.
- New payment method support: We added support for UPI, a real-time payment method in India for accepting one-time and recurring payments.
- Issuing improvements and changes: You can now configure a virtual Issuing card to automatically be cancelled after making a specified number of payments.
- Checkout Sessions enhancements and changes: You can now group and track your Checkout Sessions using integration identifiers. We also updated the Checkout Session UI mode enum values. Further, you can now configure the billing interval for pending invoice items when creating subscription-based payments in Checkout Sessions.
- Decimal quantity support for invoices: We added support for decimal quantities with up to 12 decimal places of precision when creating or updating Invoice Items and Invoice Line Items.
Our public preview channel also includes several updates:
- Multicurrency support for payouts: v2 Payout Methods now support foreign currencies for payouts.
- Batch API operations: You can now run API operations in batches, making it easier to process bulk operations like creating multiple customers, migrating subscriptions, or updating large datasets.
- Azure Event Grid support: You can now send Stripe events directly to Azure using Azure Event Grid as a new type of destination.
- Ticket sales support in Stripe Tax: You can now calculate tax based on the event’s location instead of the customer’s location. Also, you can now support event-related US tax registration types and access event-related tax breakdown values.
- Trial offers for subscription items: We introduced the new Trial Offers API, which allows you to create and manage trial offers for subscription items.
To get started with these updates, review the changelog and upgrade your API version.
2026-03-25.dahlia
Breaking changes
Payments enhancements
Elements and Stripe.js enhancements
Changes the Address Element state field to default to Latin-formatted characters
Elements
Updates the process for configuring future usage in the Payment Element
Elements
Updates the elements.update() method to return a Promise
Elements
Removes support for boolean values in options.layout.radios
Elements
Removes deprecated Payment Intents, Setup Intents, and Sources methods from Stripe.js
Payments
Renames Checkout initialization method
Checkout+ 1 more
Renames Embedded Checkout initialization method
Checkout
Connect enhancements
Checkout enhancements
Issuing enhancements
Radar enhancements
Additional updates
Adds retention policy cancellation reason to Subscriptions
Billing
Updates the events_from parameter on event destinations to accept string values
Affects all products
Adds decimal quantity support for Invoice Items and Invoice Line Items
Invoicing
Adds marine carbon removal as a new Climate Orders pathway
Climate
Adds metadata property to credit note line items
Invoicing
Adds Tempo network support for crypto payments
Payments+ 1 more
Adds presentment details for Adaptive Pricing Subscriptions
Billing