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.
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.
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_ 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_ for Charges | Payments | |
Adds wallet details for card_ 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. optional | Checkout | |
Adds target_ for advancing test_ 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_ during product creation | Checkout+ 1 more |