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.

November 17, 2025

The November release of Clover introduces these features to our GA channel:

• Fraud protection improvements for Issuing: Issuing Card objects now indicate if they have been reported as compromised, and Issuing Authorizations include fraud risk assessments.
• Enhancements to payments and payment methods: We’ve added Finom as a supported iDEAL issuer, refunds for MB WAY and TWINT payments, and the ability to specify a card present-specific capture method for Payment Intents.
• Invoice Payments and Customer Balance Transactions filtering: You can now filter both Invoice Payments and Customer Balance Transactions by their creation date using the new created parameter.
• Support for handling tokenized bank account numbers: You can now identify and understand the status of tokenized bank account numbers connected through Financial Connections.
• Automatic tax transactions with Payment Intents: Stripe Tax can now automatically commit tax transactions when using Payment Intents, eliminating the need to manually commit them through multiple webhooks.

Our public preview channel also includes several updates:

• Accounts v2 and Connect improvements: We’ve made several updates to the Accounts v2 API, including support for listing payment methods, the addition of PayPay onboarding properties for Connect platforms, support for Konbini payments for connected accounts in Japan, and a EUR storer capability.
• Supplementary purchase data and industry metadata for cards and Klarna: We’ve added the ability to provide industry-specific transaction details to help you comply with card network requirements and improve how Klarna payments are assessed through Klarna’s risk assessment systems.
• Support for Argentine ID types: If you work with users or businesses in Argentina, you can now collect and store DNI or CUIT numbers to improve identity verification and compliance.

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.

Our 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 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.