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.
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.
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
Displays merchant tax ID number on Issuing authorizations | Issuing | |
Creates Issuing authorizations 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 SEPA 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 | ||
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 authorizations | Issuing | |
Adds support for issuing fraud challenges | Issuing |
Additional payment flexibility
Adds support for enabling Adaptive Pricing per Checkout Session | Checkout | |
Customize 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 BLIK refunds | Payments | |
Adds support for SEPA 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 authorizers 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 | ||
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 | ||
Adds support for scheduling invoice finalization | 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 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 | |
Adds support for retrieving thin events | Billing |