Skip to content

or

Platforms and marketplaces

Money management

Developer resources

Versioning

Previous versions

Upgrade your API version

Upgrade your SDK version

Essentials

Sample projects

Tools

Stripe Dashboard

Developers Dashboard

Stripe for Visual Studio Code

Features

Event destinations

Stripe health alerts File uploads

AI solutions

Model Context Protocol Build agentic AI SaaS Billing workflows

Security and privacy

Stripebot web crawler

Extend Stripe

Build Stripe apps

Use apps from Stripe

Partners

Partner ecosystem

Partner certification

HomeDeveloper resourcesChangelog

Clover

What is clover?

Clover is a small, hardy plant found in temperate regions around the world, often dotting pastures, meadows, and farmland. They enhance soil fertility by fixing nitrogen in their roots, nourish grazing animals, and attract pollinating bumblebees and honeybees with their nectar-rich flowers. Also known as trefoils (from the Latin tres and folium, meaning “three-leaf”), clover is seen as a sign of good luck and prosperity in many cultures.

Clover is the third release in our new API versioning model. As the first version in the Clover release, 2025-09-30.clover introduces both breaking changes and new features—subsequent Clover versions will include only additive changes. Our prior releases were Acacia and Basil: every time we introduce a breaking change version, we move to the next release.

September 30, 2025

The September release of Clover includes new features in our GA channel:

New descriptions for risk verification requirements: The new descriptions provide more specific information about the status of accounts that undergo sanctions, PEP, and legal reviews.
Updated behavior for Elements with Checkout Sessions: Elements now prevents you from reusing client secrets in cases that could lead to broken payment forms. And you no longer have to enable saved payment methods both on the Checkout Session and explicitly in your initialization call.
Updated behavior for Checkout: Postal codes are no longer automatically collected in Canada, United Kingdom, and Puerto Rico. Details about Adaptive pricing are now found in presentment_details rather than the currency_conversion field, which has been removed as of this release. Checkout’s initialization call, initCheckout, is now synchronous, which lets you mount Elements earlier, reducing latency.
Flexible billing mode is the new default: When you create Subscriptions with this GA version, the subscriptions default to flexible billing mode, which changes how those Subscriptions behave at different points in their lifecycle.

Our public preview channel also includes several updates:

v2 Accounts no longer have platform-specific fields: Platform-specific properties have been removed from the the Accounts v2 object because they’re platform specific and not shareable across operational contexts.
Smart Disputes recommended evidence fields restructured: We’ve changed the structure of the recommended_evidence field to group relevant evidence fields together, making it easier to identify which evidence fields you have to provide together to use Smart Disputes.

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

Clover releases

ProductBreaking changes

Category: All

2025-09-30.clover

Breaking changes

Connect enhancements

Adds specific descriptions for risk requirements during legal, PEP, and sanctions review

Adds a new error code for business type validations

Elements enhancements

Updates default behavior for saved payment methods in Elements with Checkout Sessions

Prevents reusing client secrets for Intents in certain states when initializing Elements

Removes deprecated messaging and bank elements that were replaced

Checkout enhancements

Removes postal code for card payments in certain regions on Checkout and Payment Element

Checkout+ 1 more

Removes currency conversion field from Checkout Session object

Removes support for the redirectToCheckout method

Updates initCheckout to be synchronous

Checkout+ 1 more

Adds support for collecting business and individual names in Checkout Sessions

Adds the ability to exclude payment methods from Checkout Sessions and Payment Intents

Checkout+ 1 more

Adds support for setting the capture method for specific payment methods with the Checkout Sessions API

Adds support for configuring branding settings for Checkout Sessions

Enables specifying units of measurement for Products

Billing enhancements

Removes iterations parameter for subscription schedules

Promotion Codes now reference Coupons using a polymorphic field for promotions

Adds the Discount source property and removes the Discount coupon property

Makes flexible billing mode the default for new subscriptions

Billing+ 1 more

Updates computation of subscription schedule phase end date to consider billing cycle anchor changes

Adds customer portal configuration trial behavior

Adds the ability to itemize proration discount amounts

Billing+ 2 more

Enhancements to payments and payment methods

Changes the set of decline codes used for Alma, Amazon Pay, Billie, Satispay, and South Korean payment methods

Adds a processing status to submitted stablecoin payments

Adds a documented reason for Klarna chargeback losses to Disputes API

Adds support for the MB WAY payment method

Checkout+ 3 more

Terminal enhancements

Adds Japan-specific fields to the Terminal Locations API

Adds support for custom BBPOS WisePad 3 splash screens

Additional updates

Adds additional enum values for Radar manual reviews

Updates risk levels for Issuing Authorizations to use standard values

Adds new error codes for failures when creating Payment Methods from Financial Connections Accounts

Financial Connections+ 2 more

Adds support for business and individual names on Customers

Affects all products

Adds support for printing a second line on Issuing physical cards

Adds cash as a value for the crypto token currency enum

Adds a test-mode developer assistant in Elements with Intents

Adds tax calculation provider to Tax settings

Adds account balance and payout settings with the Balance Settings API

Connect+ 1 more

Was this page helpful?

Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc