Acacia

What's new in 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 Acacia release, 2024-09-30.acacia introduces both breaking changes and new features—the next Acacia releases include only additive changes. This release includes several enhancements and new features, such as:

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

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

Acacia releases

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 modeling for saving cards with Terminal	Terminal
Adds support for configuring the reboot time setting	Terminal
Adds the Stripe S700 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 BLIK 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 SEPA 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 finalize 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 CHIPS 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