# Dahlia The dahlia is a flowering plant native to Mexico and Central America, prized for its bold, intricate blooms and remarkable variety. A member of the daisy family, it comes in thousands of cultivars ranging from petite pompon flowers to dramatic dinner-plate-sized blossoms, in colors spanning nearly every shade except true blue. Dahlias reward careful tending and bloom from midsummer through fall, making them a favorite in gardens and floral arrangements alike. **Dahlia** is the fourth release in our [flora-named API versioning model](http://stripe.com/blog/introducing-stripes-new-api-release-process). As the first version in the Dahlia release, `2026-03-25.dahlia` introduces both breaking changes and new features—subsequent Dahlia versions will include only additive changes. (Our prior releases were [Acacia](https://docs.stripe.com/changelog/acacia.md), [Basil](https://docs.stripe.com/changelog/basil.md), and [Clover](https://docs.stripe.com/changelog/clover.md): 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](https://docs.stripe.com/changelog/dahlia/2026-03-25/remove-legacy-stripejs-methods.md) from Stripe.js in favor of equivalent methods with clearer naming and improved functionality, as well as the [renaming of the Checkout initialization method](https://docs.stripe.com/changelog/dahlia/2026-03-25/rename-init-checkout-to-init-checkout-elements.md). - **New payment method support**: We added [support for UPI](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-support-for-the-upi-payment-method.md), 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](https://docs.stripe.com/changelog/dahlia/2026-03-25/issuing-card-lifecycle-controls.md) to automatically be cancelled after making a specified number of payments. We also [renamed risk level properties](https://docs.stripe.com/changelog/dahlia/2026-03-25/issuing-authorization-risk-assessments-risk-level.md) in Issuing Authorization risk assessments. - **New risk evaluation information for payments**: You can now access [more detailed risk evaluation information](https://docs.stripe.com/changelog/dahlia/2026-03-25/payment-evaluation-signals-recommended-action.md) when using Payment Evaluations. - **Checkout Sessions enhancements and changes**: You can now [group and track your Checkout Sessions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-integration-identifier-parameter-to-checkout-sessions.md) using integration identifiers. We also updated the Checkout Session [UI mode enum values](https://docs.stripe.com/changelog/dahlia/2026-03-25/updates-available-checkout-session-ui-modes.md). Further, you can now [configure the billing interval](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions.md) for pending invoice items when creating subscription-based payments in Checkout Sessions. - **Decimal quantity support for invoices**: We added [support for decimal quantities](https://docs.stripe.com/changelog/dahlia/2026-03-25/invoice-items-decimal-quantity.md) with up to 12 decimal places of precision when creating or updating Invoice Items and Invoice Line Items. Our [public preview](https://docs.stripe.com/changelog.md?channel=preview) channel also includes several updates: - **Multicurrency support for payouts**: v2 Payout Methods now [support foreign currencies](https://docs.stripe.com/changelog/dahlia/2026-03-25/multicurrency-v2-payout-methods.md) for payouts. - **Batch API operations**: You can now [run API operations in batches](https://docs.stripe.com/changelog/dahlia/2026-03-25/batch-jobs-v2-api.md), 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](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-support-for-azure-event-grid-as-an-event-destination.md) using Azure Event Grid as a new type of destination. - **Ticket sales support in Stripe Tax**: You can now [calculate tax](https://docs.stripe.com/changelog/dahlia/2026-03-25/stripe-tax-ticket-sales-event-location.md) 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](https://docs.stripe.com/changelog/dahlia/2026-03-25/trial-offers-on-subscription-items.md) for subscription items. To get started with these updates, review the changelog and [upgrade your API version](https://docs.stripe.com/upgrades.md). # Dahlia [Learn what's changing in Dahlia](https://docs.stripe.com/changelog/dahlia.md) ## 2026-03-25.dahlia ### Checkout enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ---------------- | -------- | | [Updates Checkout Session UI mode enum values](https://docs.stripe.com/changelog/dahlia/2026-03-25/updates-available-checkout-session-ui-modes.md) | Checkout, Paymentlinks | Breaking | api | | [Adds pending invoice item interval parameter to create Checkout Sessions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions.md) | Checkout | Non-breaking | api | | [Adds integration identifier parameter to Checkout Sessions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-integration-identifier-parameter-to-checkout-sessions.md) | Checkout | Non-breaking | api | ### Connect enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds risk requirements to the Capabilities API](https://docs.stripe.com/changelog/dahlia/2026-03-25/capabilities-api-risk-requirements.md) | Connect | Breaking | api | | [Removes the requirement for certain connected accounts to collect external account information in the Account Sessions API](https://docs.stripe.com/changelog/dahlia/2026-03-25/relaxed_external_account_collection_account_session.md) | Connect | Non-breaking | api | ### Elements and Stripe.js enhancements | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Changes the Address Element state field to default to Latin-formatted characters](https://docs.stripe.com/changelog/dahlia/2026-03-25/address-element-getvalue-and-change-event-formatting.md) | Elements | Breaking | stripejs | | [Updates the process for configuring future usage in the Payment Element](https://docs.stripe.com/changelog/dahlia/2026-03-25/elements-pmo-sfu-customer-session-conflict.md) | Elements | Breaking | stripejs | | [Updates the elements.update() method to return a Promise](https://docs.stripe.com/changelog/dahlia/2026-03-25/elements-update-returns-promise.md) | Elements | Breaking | stripejs | | [Removes support for boolean values in options.layout.radios](https://docs.stripe.com/changelog/dahlia/2026-03-25/disallow-booleans-for-radios.md) | Elements | Breaking | stripejs | | [Removes deprecated Payment Intents, Setup Intents, and Sources methods from Stripe.js](https://docs.stripe.com/changelog/dahlia/2026-03-25/remove-legacy-stripejs-methods.md) | Payments | Breaking | stripejs | | [Renames Checkout initialization method](https://docs.stripe.com/changelog/dahlia/2026-03-25/rename-init-checkout-to-init-checkout-elements.md) | Checkout, Elements | Breaking | stripejs | | [Renames Embedded Checkout initialization method](https://docs.stripe.com/changelog/dahlia/2026-03-25/rename-init-embedded-checkout-to-create-embedded-checkout-page.md) | Checkout | Breaking | stripejs | ### Issuing enhancements | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Updates the Issuing Token card reference ID for Visa to be optional](https://docs.stripe.com/changelog/dahlia/2026-03-25/visa-card-reference-id-optional.md) | Issuing | Breaking | api | | [Renames risk level properties in Issuing Authorization risk assessments](https://docs.stripe.com/changelog/dahlia/2026-03-25/issuing-authorization-risk-assessments-risk-level.md) | Issuing | Breaking | api | | [Adds support for limiting the number of allowed payments for Issuing cards](https://docs.stripe.com/changelog/dahlia/2026-03-25/issuing-card-lifecycle-controls.md) | Issuing | Non-breaking | api | ### Payments enhancements | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Updates card property requirements and adds 3D Secure authentication properties to PaymentRecord](https://docs.stripe.com/changelog/dahlia/2026-03-25/add-3d-secure-properties-to-paymentrecords.md) | Payments | Non-breaking | api | | [Adds support for the UPI payment method](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-support-for-the-upi-payment-method.md) | Payments | Non-breaking | api | | [Adds payment method-level support for configuring future usage of crypto payment methods in Checkout Sessions](https://docs.stripe.com/changelog/dahlia/2026-03-25/expands-crypto-payment-method-options-for-checkout-sessions.md) | Payments, Crypto | Non-breaking | api | ### Radar enhancements | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds more detailed information to the Payment Evaluation object and changes its structure](https://docs.stripe.com/changelog/dahlia/2026-03-25/payment-evaluation-signals-recommended-action.md) | Radar | Breaking | api | | [Adds crypto fingerprint support to Radar value list items](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-crypto-fingerprint-support-to-radar-value-list-items.md) | Radar, Crypto | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds retention policy cancellation reason to Subscriptions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-new-cancellation-reason-subscription-test-retention-policy.md) | Billing | Breaking | api | | [Updates the events_from parameter on event destinations to accept string values](https://docs.stripe.com/changelog/dahlia/2026-03-25/updates-eventsfrom-parameter-on-event-destinations.md) | All products | Breaking | api | | [Adds decimal quantity support for Invoice Items and Invoice Line Items](https://docs.stripe.com/changelog/dahlia/2026-03-25/invoice-items-decimal-quantity.md) | Invoicing | Non-breaking | api | | [Adds marine carbon removal as a new Climate Orders pathway](https://docs.stripe.com/changelog/dahlia/2026-03-25/marine-carbon-removal-pathway.md) | Climate | Non-breaking | api | | [Adds metadata property to credit note line items](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-metadata-field-to-credit-note-line-items.md) | Invoicing | Non-breaking | api | | [Adds Tempo network support for crypto payments](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-tempo-network-enum-for-crypto-payments.md) | Payments, Crypto | Non-breaking | api | ## 2026-03-25.preview ### Payments enhancements | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Removes the source type property from Stripe balance payment methods](https://docs.stripe.com/changelog/dahlia/2026-03-25/stripe-balance-payment-method-source-type.md) | Payments, Connect | Breaking | api | | [Adds surcharge configuration options for card-not-present payments](https://docs.stripe.com/changelog/dahlia/2026-03-25/card-not-present-payments-surcharge-configuration-options.md) | Payments | Non-breaking | api | | [Adds Risk Reserved Balance to the Balances API](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-risk-reserved-balance-to-the-balances-api.md) | Payments, Payouts | Non-breaking | api | ### Payouts enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds multicurrency support for v2 payout methods](https://docs.stripe.com/changelog/dahlia/2026-03-25/multicurrency-v2-payout-methods.md) | Payouts | Breaking | api | | [Restricts Accounts v2 identity properties for some Global Payouts use cases](https://docs.stripe.com/changelog/dahlia/2026-03-25/accounts-identity-fields-global-payouts.md) | Payouts | Breaking | api | | [Adds the restricted property to the Payout Method object](https://docs.stripe.com/changelog/dahlia/2026-03-25/payout-method-restricted-property.md) | Payouts | Non-breaking | api | | [Expands Global Payouts cross-border payout destinations to three additional countries](https://docs.stripe.com/changelog/dahlia/2026-03-25/cross-border-payouts-new-countries.md) | Payouts | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ---------------- | -------- | | [Adds hosted relink flow for Financial Connections](https://docs.stripe.com/changelog/dahlia/2026-03-25/financial-connections-hosted-relink-api.md) | Financialconnections | Non-breaking | api | | [Adds support for running API operations in batches](https://docs.stripe.com/changelog/dahlia/2026-03-25/batch-jobs-v2-api.md) | All products | Non-breaking | api | | [Adds pending invoice item interval parameter to update Checkout Sessions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-pending-invoice-item-interval-parameter-to-checkout-sessions-update.md) | Checkout | Non-breaking | api | | [Adds support for Azure Event Grid as an event destination](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-support-for-azure-event-grid-as-an-event-destination.md) | All products | Non-breaking | api | | [Adds time zone support to the Accounts v2 API](https://docs.stripe.com/changelog/dahlia/2026-03-25/accounts-v2-time-zone-support.md) | Connect | Non-breaking | api | | [Adds Stripe Tax support for ticket sales](https://docs.stripe.com/changelog/dahlia/2026-03-25/stripe-tax-ticket-sales-event-location.md) | Tax | Non-breaking | api | | [Adds a description and counterparty to transactions](https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-description-and-counterparty-to-transactions.md) | Treasury | Non-breaking | api | | [Adds configurable trial offers for subscription items](https://docs.stripe.com/changelog/dahlia/2026-03-25/trial-offers-on-subscription-items.md) | Billing | Non-breaking | api |