Acacia

Acacia is the first release in our new API versioning model – you can read more about the model in our announcement post. As the first version in the Acacia release, 2024-09-30.acacia introduces both breaking changes and new features – the next Acacia versions include only additive changes.

24 February 2025

More granular control of credit grants: You can now configure which prices a credit grant covers and assign a custom priority when using multiple grants.
Scheduled debit payments: You can now specify a future date when Stripe will debit funds when using any bank debit payment method (for example, ACH , the related setting , the related setting , AU the related setting and the related setting ).
Restrict card brands for a Checkout Session: You can now specify which card brands you don’t want to display in your checkout flow.

27 January 2025

Specify management details for business accounts: To support Know Your Customer (KYC) requirements, you can now define directors and beneficial owners for accounts.
New embedded components for Issuing and Treasury: You can now deploy embedded finance components for connected accounts with minimal coding and configuration (for example, Issuing cards , Financial Accounts and their transactions).
New payment method support: You can now use Pay by Bank so customers in the UK and Europe can pay directly from their bank account.

18 December 2024

Tax features available in more countries: Tax IDs are now supported for 19 more countries and Tax Registrations are now supported in 21 more countries.
Billing enhancements: Billing credits are now reinstated when an invoice is voided and you can now adjust the number of free trial days on a subscription at any point.
Better support for card networks: Charges now include a specific transaction identifier provided by card networks and declines now provide any advice or error codes from a card network. We’ve also introduced API support for responding to a Visa compliance dispute .

20 November 2024

More flexible payments: Checkout Sessions now support Adaptive Pricing , card-only integrations can now use Link to accept payment methods beyond just cards and IC+ users now have support for advanced card features ( incremental authorisation , extended authorisations , multicapture and overcapture ).
Trace payouts with banks: We now provide a unique identifier that you can use to track missing or delayed payouts when contacting your bank.
Issuing improvements: You can now see fraud challenges sent for individual authorisations and specify custom amounts and currencies while testing authorisations.

28 October 2024

Billing now supports Credit Grants: You can now create credits for customers that you can then apply to invoices as discounts and credit notes.
Expanded payment method support: You can now accept a number of South Korean payment methods ( cards , Naver Pay , Kakao Pay , Samsung Pay and the related setting ) in many Stripe products and use Alma , a buy now, pay later payment method in France.
Event Destinations API: We now provide an API for managing event destinations , which allow you to receive events at both webhook endpoints and cloud services, like Amazon EventBridge .
Tax improvements: We now support tax registrations and tax IDs for more countries. You can also automatically validate a customer’s tax location when updating them.

30 September 2024

Improved usage-based billing capabilities: The Meter Events v2 API supports high-throughput usage reporting (up to 10,000 events per stream), including alerting and monitoring. Learn more about APIs in the v2 namespace .
Terminal updates: The the related setting reader is generally available. You can now track offline card present transactions collected through Terminal’s mobile SDKs.
Expanded payment method support: You can offer Multibanco, Twint and Zip as payment options on Payment Links and Invoices.
Billing and invoicing improvements: We support tax IDs for Switzerland and Croatia. You can perform bulk operations for invoices in a single API call and define alerts based on billing thresholds.
Improved customer-facing flows: We improved validations for shipping addresses and the Issuing card creation flow. You can now integrate Payment Elements within Customer Sessions.
More filtering options for Financial Connections: You can filter accounts by subcategories (for example, current, savings and mortgages).
New thin event payload type: You can more easily maintain future webhook integrations with thin events, which are unversioned and only contain the IDs of the objects related to the event. Learn more about thin events .

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

Acacia releases

Breaking changes Product Category All

Relevant changes only

2025-02-24.acacia

Improved workflows for Checkout Sessions

Adds support for blocking specific card brands in Checkout Sessions Checkout Checkout Sessions now group customer information in one field Checkout

More granular control of credit grants

Credit grants can now be applied to specific prices Billing Credit grants can now be prioritised Billing

More flexibility for buy now, pay later methods

Makes shipping information an optional parameter for Afterpay payments Payments Makes billing country and email fields optional for Klarna payments Payments

Additional updates

Adds metadata field to the Products API for creating an inline default price Billing Adds ability to schedule debit payments for a specific date Payments Versioning in Stripe JS Checkout + 1 more

2025-01-27.acacia

Company details for Accounts

Adds support for ownership exemption reason to the Accounts API Connect Adds directorship declaration to the Accounts API Connect Adds proof of ultimate beneficial ownership as a document type Connect

Payment method enhancements

Adds support for the Pay by Bank local payment method Checkout + 1 more Adds PayPal country property to the PaymentMethods and Charge objects Payments

Checkout enhancements

Adds discounts field to Checkout Sessions Checkout Adds Sudan to allowed shipping countries for Checkout Checkout

Additional updates

Adds advice code to Charges Payments Modify phone number collection on Payment Links Payment Links Makes Issuing and Treasury embedded components generally available Issuing + 1 more Adds support for multiple financial accounts per business Treasury Adds support for collecting tips in JPY currency to Terminal Terminal

2024-12-18.acacia

Payout enhancements

Adds SDK support for trace IDs Payments Adds new balance transaction types to support minimum balance Payouts

Issuing enhancements

Issuing authorisations now include merchant tax ID number Issuing Creates Issuing authorisations when Stripe is unavailable Issuing

Payment method enhancements

Adds additional beneficiary information for bank transfer payments Payments Adds funding details to Amazon Pay and Revolut Pay charges Payments Adds support for the related setting Direct Debit and Bacs Direct Debit mandate reference prefix Checkout + 1 more

Tax enhancements

Adds disabled reason to invoices, subscriptions, and schedules Tax + 2 more Adds support for tax ID types in 19 new countries Tax Adds support for 21 new countries to the Tax Registration API Tax

Billing enhancements

Adds support for reinstating Billing Credits on Invoice voiding Billing + 1 more Modify trial subscriptions created by Payment Links Payment Links Billing Portal Configuration always returns period end date in responses Billing

Additional updates

Adds signature request as a replacement option for the Vault and Forward API Affects all products Adds support for responding to Visa compliance disputes Payments Adds network advice and decline codes Payments Supports redisplaying payment methods for Cards and Sources Payments Adds field-level permissions for revenue and worker count in an Account’s business profile Connect Adds network transaction ID to charges Payments Adds regulated status field to card objects in several APIs Payments

2024-11-20.acacia

Support for new tax types

Adds support for Service Tax type Tax Adds tax ID support for Liechtenstein VAT Tax

Issuing enhancements

Adds support for merchant amount and currency for test mode authorisations Issuing Adds support for issuing fraud challenges Issuing

Additional payment flexibility

Adds support for enabling Adaptive Pricing per Checkout Session Checkout Customise the submit button recurring Payment Links and Checkout Sessions Checkout + 1 more Adds support for advanced card features on Checkout Sessions Checkout Allows Link card-only integrations to accept non-card payments under Link card brand Payments Adds additional beneficiary information for bank transfer payments Payments

Payment method enhancements

Adds network decline code field for Swish and the related setting refunds Payments Adds support for the related setting Direct Debit and Bacs Direct Debit mandate reference prefixes in Checkout Sessions Checkout Specifying an originating payment method for Inbound Transfers is now optional Treasury Use configurable capture methods and set up future usage for South Korean payment methods Checkout

Additional updates

Trace payouts with a unique identifier Payouts Converts properties on the Account object from a String to an enum Connect Adds indicator for connected accounts that must log in before using embedded components Connect Adds support for authorisers to Person API Connect

2024-10-28.acacia

Billing credit grants

Adds Credit Grant APIs and resources Billing + 1 more Adds support for pre-tax credit amount information to invoices Billing + 1 more Adds support for pre-tax credit amount information to credit notes Billing + 1 more

New payment methods

Adds support for new South Korean payment methods Billing + 5 more Adds support for Alma in France Checkout + 3 more

Event destinations and event types

Adds Event Destinations v2 API endpoint Affects all products Adds event type for updated receipt data in Issuing transactions Issuing

Payment method enhancements

Adds a metadata field to the Vault and Forward API Payments Adds Polish PLN currency support to Terminal tipping configuration Terminal Supports domain registration for Amazon Pay Elements

Additional tax registration options

Adds support for new countries to the Tax Registration API Tax Adds support for tax ID types in several new countries Tax Adds support for collecting retail delivery fees Tax Adds option to automatically validate customer tax location during an update Tax

Additional updates

Adds support for disabling Stripe user authentication for certain embedded components Connect Adds a test helper that updates the shipping status for physical cards Issuing Adds created, updated, and failed events for all refund types Payments Adds pricing groups to the Accounts API Connect + 1 more Adds scheduled subscription downgrades in the customer portal Billing Makes business profile optional for customer portal configuration Billing Uses Visa’s Compelling Evidence 3.0 to respond to qualifying disputes Affects all products Adds support for scheduling invoice finalisation Invoicing

2024-09-30.acacia

Breaking changes

Add alerts, monitoring and reporting to usage-based billing

Adds contextual filters to billing alerts Billing Adds an Alerts API for usage-based billing Billing Adds an event for triggered billing alerts Billing Adds support for listening to triggered billing alerts Billing Adds billing alert resources and endpoints Billing Adds support for subscriptions and subscription items to billing alerts Billing + 1 more Adds Meter Event v2 API endpoints Billing

Enhancements for Terminal readers and integrations

Updates consent modelling for saving cards with Terminal Terminal Adds support for configuring the reboot time setting Terminal Adds the Stripe the related setting reader as a valid device type Terminal Adds details about offline collection on card_present PaymentMethod objects Terminal

Payment method enhancements

Adds option to retrieve CVC tokens on Confirmation Tokens Elements Adds customer ID to payment method preview on a confirmation token Elements Adds support for identifying the unique payer for the the related setting payment method Payments Adds support for Affirm transaction IDs Payments Adds support for in-person payment methods, including Interac cards Terminal Displays authorization_code for Charges Payments Adds wallet details for card_present Charges and Payment Methods Terminal Adds country field for Charges that use Klarna Payments Displays Amazon Pay dispute type on Disputes Payments

Add support for new payment methods

Adds support for three new payment methods: Multibanco, Twint, and Zip Payment Links Adds support for using the Multibanco payment method with billing Billing Adds Twint to the PaymentMethodConfiguration API Payments Adds Girocard as a PaymentMethod brand and network Payments

Add tax IDs for Switzerland and Croatia, and optional tax ID requirement

Adds Switzerland UID as a supported customer tax ID Invoicing + 1 more Adds Croatian Personal Identification Number to supported Tax IDs Billing + 2 more Adds support for requiring a customer tax ID on Checkout and Payment Links Checkout + 1 more

Add filtering support for Financial Connections

Adds support for filtering by account subcategories on Financial Connections Financial Connections Expands filtering support for Financial Connections Sessions Financial Connections

New error codes for more robust testing

Adds error code for exceeded transaction limits Invoicing + 1 more Adds new error code for invalid mandate prefixes to Bacs Direct Debit and the related setting Direct Debit payments Payments

Add new Invoice Rendering Template resource

Adds Invoice Rendering Templates for Invoices Invoicing Adds retrieve and archive methods for Invoice Rendering Templates Invoicing Adds support for templates to Invoices and Customers Invoicing Adds version support for Invoice Rendering Templates Invoicing

Improve address validation and dispute and regulatory management for Issuing

Updates the default value for shipping address validation Issuing Adds address validation for physical cards Issuing Adds a new webhook event for when funds are deducted as part of a dispute Issuing

Streamline invoice processing

Adds support for bulk invoice line item operations Invoicing Adds webhook events for when an invoice is due or overdue Billing Adds option to automatically finalise invoices Invoicing

Tax enhancements

Adds support for posting time on tax transaction creation Tax Adds support for tax settings and registrations for Embedded Components Connect + 1 more Adds new method to retrieve a Tax Calculation Tax Adds support for specifying US state sales tax elections while creating tax registrations Tax

Additional updates

Adds risk verification details for connected accounts Connect Adds support for email types to Credit Notes Invoicing Adds support for the Payment Element on a Customer Session Elements Adds support for identifying the case type for card disputes Payments Adds a method to update the metadata for Checkout Sessions Checkout Adds parameter to link Verification Sessions to Customers Identity Displays the related setting tracking details for outbound wire payments and transfers Treasury Adds additional reasonable defaulting to the Account Link API v1 Connect Makes LineItem.description optional Checkout Adds target_frozen_time for advancing test_helpers.test_clock objects Billing Makes status details for Test Clock test helpers required Billing Adds a new enum value representing a ReceivedDebit failure due to an international transaction Treasury Makes it optional to update the products and prices of a subscription Billing Add support for custom_unit_amount during product creation Checkout + 1 more Adds support for retrieving thin events Billing