Clover

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.

October 29, 2025

The October release of Clover introduces new features for GA:

• Payment Records: We’ve added new APIs for Payment Records and Payment Attempt Records, which let you report payments processed outside of Stripe to maintain a unified ledger within Stripe.
• New payment methods and payment method support: MB Way, a Portugese local payment method, is now supported in the Payment Method Configurations API, Payment Links, and the Checkout Sessions API. You can also now include references for line items and subscriptions for Klarna payments.
• New stablecoin support: You can manage stablecoin payments in the Payment Method Configurations API. And stablecoin Refunds now include a reference to the blockchain transaction that sent funds back to your customers.
• Visa compliance disputes: We’ve added Visa compliance disputes to the Stripe API. You can now use the payment_method_details.card.case_type parameter to determine whether it’s a compliance dispute.

The public preview channel also includes some new updates:

• Improved handling for accounts with Connect: We’ve added a new error code to indicate when we were unable to look up some data based on the information entered about a connected account. The Accounts API now also includes account representative details. And the Accounts v2 API now lets you retrieve and list closed accounts.
• Additional support for US and GB bank accounts: Microdeposits are now supported for US Bank Accounts. You can also now list US and GB bank accounts.

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.