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.

December 18th, 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.

November 20th, 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 authorization, extended authorizations, 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 authorizations, and specify custom amounts and currencies while testing authorizations.

October 28th, 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 PAYCO) 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.

September 30th, 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 S700 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, checking, 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.