# Acacia **Acacia** is the first release in our new API versioning model—you can read more about the model in our [announcement post](http://stripe.com/blog/introducing-stripes-new-api-release-process). 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. #### February 24, 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](https://docs.stripe.com/payments/bank-debits.md) (for example, [ACH](https://docs.stripe.com/payments/ach-direct-debit.md), [SEPA](https://docs.stripe.com/payments/sepa-debit.md), [BACS](https://docs.stripe.com/payments/payment-methods/bacs-debit.md), [AU BECS](https://docs.stripe.com/payments/au-becs-debit.md), and [PADS](https://docs.stripe.com/payments/acss-debit.md)). - **Restrict card brands for a Checkout Session:** You can now [specify which card brands](https://docs.stripe.com/payments/checkout/customization/card-brands.md) you don’t want to display in your checkout flow. #### January 27, 2025 - **Specify management details for business accounts:** To support [Know Your Customer](https://support.stripe.com/questions/know-your-customer-obligations) (KYC) requirements, you can now define [directors](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) and [beneficial owners](https://support.stripe.com/questions/beneficial-owner-and-director-definitions) for accounts. - **New embedded components for Issuing and Treasury:** You can now deploy [embedded finance](https://docs.stripe.com/baas/start-integration/integration-guides/embedded-finance.md) components for connected accounts with minimal coding and configuration (for example, [Issuing cards](https://docs.stripe.com/connect/supported-embedded-components/issuing-card.md), [Financial Accounts](https://docs.stripe.com/connect/supported-embedded-components/financial-account.md), and their transactions). - **New payment method support:** You can now use [Pay by Bank](https://docs.stripe.com/payments/pay-by-bank.md) so customers in the UK and Europe can pay directly from their bank account. #### December 18, 2024 - **Tax features available in more countries:** [Tax IDs](https://docs.stripe.com/billing/customer/tax-ids.md) are now supported for 19 more countries, and [Tax Registrations](https://docs.stripe.com/api/tax/registrations.md) 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](https://docs.stripe.com/disputes/api/visa-compliance.md). #### November 20, 2024 - **More flexible payments:** Checkout Sessions now support [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md), card-only integrations can now use Link to accept payment methods beyond just cards, and [IC+](https://support.stripe.com/questions/understanding-blended-interchange-pricing) users now have support for advanced card features ([incremental authorization](https://docs.stripe.com/payments/incremental-authorization.md), [extended authorizations](https://docs.stripe.com/payments/extended-authorization.md), [multicapture](https://docs.stripe.com/payments/multicapture.md), and [overcapture](https://docs.stripe.com/payments/overcapture.md)). - **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](https://docs.stripe.com/issuing/controls/fraud-challenges.md) sent for individual authorizations, and specify custom amounts and currencies while testing authorizations. #### October 28, 2024 - **Billing now supports Credit Grants:** You can now [create credits](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits.md) 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](https://docs.stripe.com/payments/kr-card/accept-a-payment.md), [Naver Pay](https://docs.stripe.com/payments/naver-pay/accept-a-payment.md), [Kakao Pay](https://docs.stripe.com/payments/kakao-pay/accept-a-payment.md), [Samsung Pay](https://docs.stripe.com/payments/samsung-pay/accept-a-payment.md), and [PAYCO](https://docs.stripe.com/payments/payco/accept-a-payment.md)) in many Stripe products and use [Alma](https://docs.stripe.com/payments/alma.md), a buy now, pay later payment method in France. - **Event Destinations API:** We now provide an API for managing [event destinations](https://docs.stripe.com/event-destinations.md), which allow you to receive events at both webhook endpoints and cloud services, like [Amazon EventBridge](https://docs.stripe.com/event-destinations/eventbridge.md). - **Tax improvements:** We now support [tax registrations](https://docs.stripe.com/tax/registering.md) and [tax IDs](https://docs.stripe.com/billing/customer/tax-ids.md) 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](https://docs.stripe.com/api-v2-overview.md). - **Terminal updates:** The [S700 reader](https://stripe.com/terminal/s700) 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](https://docs.stripe.com/event-destinations.md#events-overview). To get started with these updates, review the changelog and [upgrade your API version](https://docs.stripe.com/upgrades.md). # Acacia [Learn what's changing in Acacia](https://docs.stripe.com/changelog/acacia.md) ## 2025-02-24.acacia ### Improved workflows for Checkout Sessions | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for blocking specific card brands in Checkout Sessions](https://docs.stripe.com/changelog/acacia/2025-02-24/checkout_add_brands_blocked.md) | Checkout | Non-breaking | api | | [Checkout Sessions now group customer information in one field](https://docs.stripe.com/changelog/acacia/2025-02-24/checkout-sessions-collected-info.md) | Checkout | Non-breaking | api | ### More flexibility for buy now, pay later methods | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Makes shipping information an optional parameter for Afterpay payments](https://docs.stripe.com/changelog/acacia/2025-02-24/afterpay-shipping-details-optional.md) | Payments | Non-breaking | api | | [Makes billing country and email fields optional for Klarna payments](https://docs.stripe.com/changelog/acacia/2025-02-24/cs_make_billing_country_and_email_field_optional_for_klarna_payments.md) | Payments | Non-breaking | api | ### More granular control of credit grants | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Credit grants can now be applied to specific prices](https://docs.stripe.com/changelog/acacia/2025-02-24/billing-credits-price-level-applicability.md) | Billing | Non-breaking | api | | [Credit grants can now be prioritized](https://docs.stripe.com/changelog/acacia/2025-02-24/billing-credits-priority.md) | Billing | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Adds metadata field to the Products API for creating an inline default price](https://docs.stripe.com/changelog/acacia/2025-02-24/products-default-price-data-metadata-field.md) | Billing | Non-breaking | api | | [Adds ability to schedule debit payments for a specific date](https://docs.stripe.com/changelog/acacia/2025-02-24/target-date.md) | Payments | Non-breaking | api | | [Versioning in Stripe JS](https://docs.stripe.com/changelog/acacia/2025-02-24/stripe-js-versioning.md) | Checkout, Elements | Non-breaking | stripejs | ## 2025-01-27.acacia ### Checkout enhancements | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds discounts field to Checkout Sessions](https://docs.stripe.com/changelog/acacia/2025-01-27/checkout-sessions-discounts-field.md) | Checkout | Non-breaking | api | | [Adds Sudan to allowed shipping countries for Checkout](https://docs.stripe.com/changelog/acacia/2025-01-27/checkout-sudan-shipping-support.md) | Checkout | Non-breaking | api | ### Company details for Accounts | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for ownership exemption reason to the Accounts API](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api.md) | Connect | Non-breaking | api | | [Adds directorship declaration to the Accounts API](https://docs.stripe.com/changelog/acacia/2025-01-27/directorship-declaration.md) | Connect | Non-breaking | api | | [Adds proof of ultimate beneficial ownership as a document type](https://docs.stripe.com/changelog/acacia/2025-01-27/proof-of-ultimate-beneficial-ownership-document-support.md) | Connect | Non-breaking | api | ### Payment method enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Adds support for the Pay by Bank local payment method](https://docs.stripe.com/changelog/acacia/2025-01-27/pay-by-bank-lpm.md) | Checkout, Payments | Non-breaking | api | | [Adds PayPal country property to the PaymentMethods and Charge objects](https://docs.stripe.com/changelog/acacia/2025-01-27/paypal-country.md) | Payments | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds advice code to Charges](https://docs.stripe.com/changelog/acacia/2025-01-27/charge-outcome-advice-code.md) | Payments | Non-breaking | api | | [Modify phone number collection on Payment Links](https://docs.stripe.com/changelog/acacia/2025-01-27/add-phone-number-collection-update-payment-links-api.md) | Paymentlinks | Non-breaking | api | | [Makes Issuing and Treasury embedded components generally available](https://docs.stripe.com/changelog/acacia/2025-01-27/issuing-treasury-embedded-components.md) | Issuing, Treasury | Non-breaking | api | | [Adds support for multiple financial accounts per business](https://docs.stripe.com/changelog/acacia/2025-01-27/multi-fa.md) | Treasury | Non-breaking | api | | [Adds support for collecting tips in JPY currency to Terminal](https://docs.stripe.com/changelog/acacia/2025-01-27/terminal-jp-supported-country.md) | Terminal | Non-breaking | api | ## 2024-12-18.acacia ### Billing enhancements | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Adds support for reinstating Billing Credits on Invoice voiding](https://docs.stripe.com/changelog/acacia/2024-12-18/billing-credits-invoice-voiding.md) | Billing, Invoicing | Non-breaking | api | | [Modify trial subscriptions created by Payment Links](https://docs.stripe.com/changelog/acacia/2024-12-18/add-trial-days-update-payment-links-api.md) | Paymentlinks | Non-breaking | api | | [Billing Portal Configuration always returns period end date in responses](https://docs.stripe.com/changelog/acacia/2024-12-18/portal-config-schedule-at-period-end-required.md) | Billing | Non-breaking | api | ### Issuing enhancements | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Issuing authorizations now include merchant tax ID number](https://docs.stripe.com/changelog/acacia/2024-12-18/issuing-merchant-tax-id.md) | Issuing | Non-breaking | api | | [Creates Issuing authorizations when Stripe is unavailable](https://docs.stripe.com/changelog/acacia/2024-12-18/issuing-auths-when-stripe-unavailable.md) | Issuing | Non-breaking | api | ### Payment method enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Adds additional beneficiary information for bank transfer payments](https://docs.stripe.com/changelog/acacia/2024-12-18/new-bank-transfer-beneficiary-information.md) | Payments | Non-breaking | api | | [Adds funding details to Amazon Pay and Revolut Pay charges](https://docs.stripe.com/changelog/acacia/2024-12-18/charge-pm-details.md) | Payments | Non-breaking | api | | [Adds support for SEPA Direct Debit and Bacs Direct Debit mandate reference prefix](https://docs.stripe.com/changelog/acacia/2024-12-18/mandate-reference-prefix.md) | Checkout, Payments | Non-breaking | api | ### Payout enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds SDK support for trace IDs](https://docs.stripe.com/changelog/acacia/2024-12-18/trace-id-sdk.md) | Payments | Non-breaking | api | | [Adds new balance transaction types to support minimum balance](https://docs.stripe.com/changelog/acacia/2024-12-18/payout-minimum-balance.md) | Payouts | Non-breaking | api | ### Tax enhancements | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------- | -------- | | [Adds disabled reason to invoices, subscriptions, and schedules](https://docs.stripe.com/changelog/acacia/2024-12-18/add-disabled-reason.md) | Tax, Billing, Invoicing | Non-breaking | api | | [Adds support for tax ID types in 19 new countries](https://docs.stripe.com/changelog/acacia/2024-12-18/tax-ids-19-new-countries.md) | Tax | Non-breaking | api | | [Adds support for 21 new countries to the Tax Registration API](https://docs.stripe.com/changelog/acacia/2024-12-18/tax-registration-21-new-countries.md) | Tax | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- | ---------------- | -------- | | [Adds signature request as a replacement option for the Vault and Forward API](https://docs.stripe.com/changelog/acacia/2024-12-18/vault-and-forward-request-signature-replacement.md) | All products | Non-breaking | api | | [Adds support for responding to Visa compliance disputes](https://docs.stripe.com/changelog/acacia/2024-12-18/visa-compliance.md) | Payments | Non-breaking | api | | [Adds network advice and decline codes](https://docs.stripe.com/changelog/acacia/2024-12-18/network-advice-code-network-decline-code.md) | Payments | Non-breaking | api | | [Supports redisplaying payment methods for Cards and Sources](https://docs.stripe.com/changelog/acacia/2024-12-18/cards-sources-allow-redisplay.md) | Payments | Non-breaking | api | | [Adds field-level permissions for revenue and worker count in an Account’s business profile](https://docs.stripe.com/changelog/acacia/2024-12-18/business-profile-revenue-worker-count.md) | Connect | Non-breaking | api | | [Adds network transaction ID to charges](https://docs.stripe.com/changelog/acacia/2024-12-18/charge-display-network-transaction-id.md) | Payments | Non-breaking | api | | [Adds regulated status field to card objects in several APIs](https://docs.stripe.com/changelog/acacia/2024-12-18/regulated-status.md) | Payments | Non-breaking | api | ## 2024-11-20.acacia ### Additional payment flexibility | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ---------------- | -------- | | [Adds support for enabling Adaptive Pricing per Checkout Session](https://docs.stripe.com/changelog/acacia/2024-11-20/adaptive-pricing-param.md) | Checkout | Non-breaking | api | | [Customize the submit button recurring Payment Links and Checkout Sessions](https://docs.stripe.com/changelog/acacia/2024-11-20/submit-type-recurring-cpl.md) | Checkout, Paymentlinks | Non-breaking | api | | [Adds support for advanced card features on Checkout Sessions](https://docs.stripe.com/changelog/acacia/2024-11-20/advanced-card-features.md) | Checkout | Non-breaking | api | | [Allows Link card-only integrations to accept non-card payments under Link card brand](https://docs.stripe.com/changelog/acacia/2024-11-20/link-card-brand.md) | Payments | Non-breaking | api | | [Adds additional beneficiary information for bank transfer payments](https://docs.stripe.com/changelog/acacia/2024-11-20/new-bank-transfer-beneficiary-information.md) | Payments | Non-breaking | api | ### Issuing enhancements | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for merchant amount and currency for test mode authorizations](https://docs.stripe.com/changelog/acacia/2024-11-20/add-merchant-currency-and-merchant-amount-on-create-testmode-authorization-method.md) | Issuing | Non-breaking | api | | [Adds support for issuing fraud challenges](https://docs.stripe.com/changelog/acacia/2024-11-20/issuing-fraud-challenges.md) | Issuing | Non-breaking | api | ### Payment method enhancements | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds network decline code field for Swish and BLIK refunds](https://docs.stripe.com/changelog/acacia/2024-11-20/refunds-network-decline-code.md) | Payments | Non-breaking | api | | [Adds support for SEPA Direct Debit and Bacs Direct Debit mandate reference prefixes in Checkout Sessions](https://docs.stripe.com/changelog/acacia/2024-11-20/checkout-sessions-sepa-debit-bacs-debit-mandate-options.md) | Checkout | Non-breaking | api | | [Specifying an originating payment method for Inbound Transfers is now optional](https://docs.stripe.com/changelog/acacia/2024-11-20/inbound-transfers-optional-pm.md) | Treasury | Non-breaking | api | | [Use configurable capture methods and set up future usage for South Korean payment methods](https://docs.stripe.com/changelog/acacia/2024-11-20/south-korea-payment-methods.md) | Checkout | Non-breaking | api | ### Support for new tax types | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for Service Tax type](https://docs.stripe.com/changelog/acacia/2024-11-20/service_tax.md) | Tax | Non-breaking | api | | [Adds tax ID support for Liechtenstein VAT](https://docs.stripe.com/changelog/acacia/2024-11-20/li_vat.md) | Tax | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Trace payouts with a unique identifier](https://docs.stripe.com/changelog/acacia/2024-11-20/payout-trace-id-api.md) | Payouts | Non-breaking | api | | [Converts properties on the Account object from a String to an enum](https://docs.stripe.com/changelog/acacia/2024-11-20/account-disabled-reason.md) | Connect | Non-breaking | api | | [Adds indicator for connected accounts that must log in before using embedded components](https://docs.stripe.com/changelog/acacia/2024-11-20/account-sessions-stripe-authentication-response.md) | Connect | Non-breaking | api | | [Adds support for authorizers to Person API](https://docs.stripe.com/changelog/acacia/2024-11-20/authorizer-person-api.md) | Connect | Non-breaking | api | ## 2024-10-28.acacia ### Additional tax registration options | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for new countries to the Tax Registration API](https://docs.stripe.com/changelog/acacia/2024-10-28/tax-registration-new-countries.md) | Tax | Non-breaking | api | | [Adds support for tax ID types in several new countries](https://docs.stripe.com/changelog/acacia/2024-10-28/tax-ids.md) | Tax | Non-breaking | api | | [Adds support for collecting retail delivery fees](https://docs.stripe.com/changelog/acacia/2024-10-28/tax-retail-delivery-fee.md) | Tax | Non-breaking | api | | [Adds option to automatically validate customer tax location during an update](https://docs.stripe.com/changelog/acacia/2024-10-28/tax-validate-location-auto.md) | Tax | Non-breaking | api | ### Billing credit grants | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Adds Credit Grant APIs and resources](https://docs.stripe.com/changelog/acacia/2024-10-28/billing-credits-apis.md) | Billing, Invoicing | Non-breaking | api | | [Adds support for pre-tax credit amount information to invoices](https://docs.stripe.com/changelog/acacia/2024-10-28/billing-credits-invoice.md) | Billing, Invoicing | Non-breaking | api | | [Adds support for pre-tax credit amount information to credit notes](https://docs.stripe.com/changelog/acacia/2024-10-28/billing-credits-credit-note.md) | Billing, Invoicing | Non-breaking | api | ### Event destinations and event types | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds Event Destinations v2 API endpoint](https://docs.stripe.com/changelog/acacia/2024-10-28/event-destinations-api.md) | All products | Non-breaking | api | | [Adds event type for updated receipt data in Issuing transactions](https://docs.stripe.com/changelog/acacia/2024-10-28/issuing-transactions-updated-receipt-event.md) | Issuing | Non-breaking | api | ### New payment methods | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------- | -------- | | [Adds support for new South Korean payment methods](https://docs.stripe.com/changelog/acacia/2024-10-28/south-korean-payment-methods.md) | Billing, Checkout, Elements, Invoicing, Paymentlinks, Payments | Non-breaking | api | | [Adds support for Alma in France](https://docs.stripe.com/changelog/acacia/2024-10-28/alma.md) | Checkout, Elements, Paymentlinks, Payments | Non-breaking | api | ### Payment method enhancements | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds a metadata field to the Vault and Forward API](https://docs.stripe.com/changelog/acacia/2024-10-28/forwarding-api-metadata-field.md) | Payments | Non-breaking | api | | [Adds Polish PLN currency support to Terminal tipping configuration](https://docs.stripe.com/changelog/acacia/2024-10-28/terminal-tipping-pln.md) | Terminal | Non-breaking | api | | [Supports domain registration for Amazon Pay](https://docs.stripe.com/changelog/acacia/2024-10-28/amazon-pay-domain-registration.md) | Elements | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for disabling Stripe user authentication for certain embedded components](https://docs.stripe.com/changelog/acacia/2024-10-28/disable-stripe-user-authentication-account-sessions.md) | Connect | Non-breaking | api | | [Adds a test helper that updates the shipping status for physical cards](https://docs.stripe.com/changelog/acacia/2024-10-28/testmode-helper-shipping-status.md) | Issuing | Non-breaking | api | | [Adds created, updated, and failed events for all refund types](https://docs.stripe.com/changelog/acacia/2024-10-28/refund-webhook-update.md) | Payments | Non-breaking | api | | [Adds pricing groups to the Accounts API](https://docs.stripe.com/changelog/acacia/2024-10-28/pricing-groups-account-objects.md) | Connect, Payments | Non-breaking | api | | [Adds scheduled subscription downgrades in the customer portal](https://docs.stripe.com/changelog/acacia/2024-10-28/customer-portal-schedule-downgrades.md) | Billing | Non-breaking | api | | [Makes business profile optional for customer portal configuration](https://docs.stripe.com/changelog/acacia/2024-10-28/customer-portal-config-business-profile.md) | Billing | Non-breaking | api | | [Uses Visa’s Compelling Evidence 3.0 to respond to qualifying disputes](https://docs.stripe.com/changelog/acacia/2024-10-28/visa-compelling-evidence-3-0.md) | All products | Non-breaking | api | | [Adds support for scheduling invoice finalization](https://docs.stripe.com/changelog/acacia/2024-10-28/schedule-invoice-finalization.md) | Invoicing | Non-breaking | api | ## 2024-09-30.acacia ### Add alerts, monitoring, and reporting to usage-based billing | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ---------------- | -------- | | [Adds contextual filters to billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-contextualizing-filters.md) | Billing | Breaking | api | | [Adds an Alerts API for usage-based billing](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-api.md) | Billing | Non-breaking | api | | [Adds an event for triggered billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alert-trigger-event.md) | Billing | Non-breaking | api | | [Adds support for listening to triggered billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alert-webhook-listener.md) | Billing | Non-breaking | api | | [Adds billing alert resources and endpoints](https://docs.stripe.com/changelog/acacia/2024-09-30/adds-billing-alert-resources-endpoints.md) | Billing | Non-breaking | api | | [Adds support for subscriptions and subscription items to billing alerts](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-alerts-subscription-items-subscriptions.md) | Billing, Invoicing | Non-breaking | api | | [Adds Meter Event v2 API endpoints](https://docs.stripe.com/changelog/acacia/2024-09-30/usage-based-billing-v2-meter-events-api.md) | Billing | Non-breaking | api | ### Add filtering support for Financial Connections | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ---------------- | -------- | | [Adds support for filtering by account subcategories on Financial Connections](https://docs.stripe.com/changelog/acacia/2024-09-30/financial-connections-filters.md) | Financialconnections | Non-breaking | api | | [Expands filtering support for Financial Connections Sessions](https://docs.stripe.com/changelog/acacia/2024-09-30/financial-connections-additional-filters.md) | Financialconnections | Non-breaking | api | ### Add new Invoice Rendering Template resource | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds Invoice Rendering Templates for Invoices](https://docs.stripe.com/changelog/acacia/2024-09-30/invoice-rendering-template-resource.md) | Invoicing | Non-breaking | api | | [Adds retrieve and archive methods for Invoice Rendering Templates](https://docs.stripe.com/changelog/acacia/2024-09-30/invoice-rendering-template-methods.md) | Invoicing | Non-breaking | api | | [Adds support for templates to Invoices and Customers](https://docs.stripe.com/changelog/acacia/2024-09-30/invoice-rendering-template-parameter.md) | Invoicing | Non-breaking | api | | [Adds version support for Invoice Rendering Templates](https://docs.stripe.com/changelog/acacia/2024-09-30/invoice-rendering-template-version.md) | Invoicing | Non-breaking | api | ### Add support for new payment methods | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- | ---------------- | -------- | | [Adds support for three new payment methods: Multibanco, Twint, and Zip](https://docs.stripe.com/changelog/acacia/2024-09-30/payment-links-new-payment-methods.md) | Paymentlinks | Non-breaking | api | | [Adds support for using the Multibanco payment method with billing](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-mutlibanco-support.md) | Billing | Non-breaking | api | | [Adds Twint to the PaymentMethodConfiguration API](https://docs.stripe.com/changelog/acacia/2024-09-30/twint-support-payment-method-configuration.md) | Payments | Non-breaking | api | | [Adds Girocard as a PaymentMethod brand and network](https://docs.stripe.com/changelog/acacia/2024-09-30/adds-girocard-paymentmethod-brand-network.md) | Payments | Non-breaking | api | ### Add tax IDs for Switzerland and Croatia, and optional tax ID requirement | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ---------------- | -------- | | [Adds Switzerland UID as a supported customer tax ID](https://docs.stripe.com/changelog/acacia/2024-09-30/switzerland-tax-uid.md) | Invoicing, Tax | Non-breaking | api | | [Adds Croatian Personal Identification Number to supported Tax IDs](https://docs.stripe.com/changelog/acacia/2024-09-30/adds-tax-id-type-hr_oib-croatian-personal-id-number.md) | Billing, Checkout, Tax | Non-breaking | api | | [Adds support for requiring a customer tax ID on Checkout and Payment Links](https://docs.stripe.com/changelog/acacia/2024-09-30/requiring-customer-tax-id-checkout-session-paymentlink.md) | Checkout, Paymentlinks | Non-breaking | api | ### Enhancements for Terminal readers and integrations | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Updates consent modeling for saving cards with Terminal](https://docs.stripe.com/changelog/acacia/2024-09-30/terminal-remove-customer-consent-require-allow-redisplay.md) | Terminal | Breaking | api | | [Adds support for configuring the reboot time setting](https://docs.stripe.com/changelog/acacia/2024-09-30/terminal-reboot-window.md) | Terminal | Non-breaking | api | | [Adds the Stripe S700 reader as a valid device type](https://docs.stripe.com/changelog/acacia/2024-09-30/terminal-reader-s700.md) | Terminal | Non-breaking | api | | [Adds details about offline collection on `card_present` PaymentMethod objects](https://docs.stripe.com/changelog/acacia/2024-09-30/terminal-offline-details-card-present-paymentmethods.md) | Terminal | Non-breaking | api | ### Improve address validation and dispute and regulatory management for Issuing | Title | Affected Products | Breaking change? | Category | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Updates the default value for shipping address validation](https://docs.stripe.com/changelog/acacia/2024-09-30/card-shipping-status-submitted-address-validation.md) | Issuing | Breaking | api | | [Adds address validation for physical cards](https://docs.stripe.com/changelog/acacia/2024-09-30/issuing-address-validation.md) | Issuing | Non-breaking | api | | [Adds a new webhook event for when funds are deducted as part of a dispute](https://docs.stripe.com/changelog/acacia/2024-09-30/issuing-webhook-fund-deduction.md) | Issuing | Non-breaking | api | ### New error codes for more robust testing | Title | Affected Products | Breaking change? | Category | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------- | -------- | | [Adds error code for exceeded transaction limits](https://docs.stripe.com/changelog/acacia/2024-09-30/error-code-transaction-limit.md) | Invoicing, Payments | Non-breaking | api | | [Adds new error code for invalid mandate prefixes to Bacs Direct Debit and SEPA Direct Debit payments](https://docs.stripe.com/changelog/acacia/2024-09-30/error-code-invalid-mandate-reference-prefix.md) | Payments | Non-breaking | api | ### Payment method enhancements | Title | Affected Products | Breaking change? | Category | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds option to retrieve CVC tokens on Confirmation Tokens](https://docs.stripe.com/changelog/acacia/2024-09-30/support-payment-method-options-confirmation.md) | Elements | Non-breaking | api | | [Adds customer ID to payment method preview on a confirmation token](https://docs.stripe.com/changelog/acacia/2024-09-30/support-customer-payment-method-preview.md) | Elements | Non-breaking | api | | [Adds support for identifying the unique payer for the BLIK payment method](https://docs.stripe.com/changelog/acacia/2024-09-30/buyer-id-blik.md) | Payments | Non-breaking | api | | [Adds support for Affirm transaction IDs](https://docs.stripe.com/changelog/acacia/2024-09-30/affirm-transaction-id-dashboard.md) | Payments | Non-breaking | api | | [Adds support for in-person payment methods, including Interac cards](https://docs.stripe.com/changelog/acacia/2024-09-30/card-interac-present-support.md) | Terminal | Non-breaking | api | | [Displays `authorization_code` for Charges](https://docs.stripe.com/changelog/acacia/2024-09-30/displays-authorization-code-for-charges.md) | Payments | Non-breaking | api | | [Adds wallet details for `card_present` Charges and Payment Methods](https://docs.stripe.com/changelog/acacia/2024-09-30/adds-offline-details-card-present-paymentmethods.md) | Terminal | Non-breaking | api | | [Adds country field for Charges that use Klarna](https://docs.stripe.com/changelog/acacia/2024-09-30/charges-klarna-payer-details-country.md) | Payments | Non-breaking | api | | [Displays Amazon Pay dispute type on Disputes](https://docs.stripe.com/changelog/acacia/2024-09-30/display-amazonpay-dispute-type.md) | Payments | Non-breaking | api | ### Streamline invoice processing | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- | ---------------- | -------- | | [Adds support for bulk invoice line item operations](https://docs.stripe.com/changelog/acacia/2024-09-30/invoicing-bulk-line-item-operations.md) | Invoicing | Non-breaking | api | | [Adds webhook events for when an invoice is due or overdue](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-due-date-webhooks.md) | Billing | Non-breaking | api | | [Adds option to automatically finalize invoices](https://docs.stripe.com/changelog/acacia/2024-09-30/automatically-finalizes-at-invoice.md) | Invoicing | Non-breaking | api | ### Tax enhancements | Title | Affected Products | Breaking change? | Category | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------- | -------- | | [Adds support for posting time on tax transaction creation](https://docs.stripe.com/changelog/acacia/2024-09-30/tax-posting-time-on-creation.md) | Tax | Non-breaking | api | | [Adds support for tax settings and registrations for Embedded Components](https://docs.stripe.com/changelog/acacia/2024-09-30/tax-registrations-settings-embedded-components.md) | Connect, Tax | Non-breaking | api | | [Adds new method to retrieve a Tax Calculation](https://docs.stripe.com/changelog/acacia/2024-09-30/retrieves-tax-calculation-api.md) | Tax | Non-breaking | api | | [Adds support for specifying US state sales tax elections while creating tax registrations](https://docs.stripe.com/changelog/acacia/2024-09-30/support-us-state-sales-tax-elections-api.md) | Tax | Non-breaking | api | ### Additional updates | Title | Affected Products | Breaking change? | Category | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------- | -------- | | [Adds risk verification details for connected accounts](https://docs.stripe.com/changelog/acacia/2024-09-30/additional-risk-verification-details-connected-accounts.md) | Connect | Breaking | api | | [Adds support for email types to Credit Notes](https://docs.stripe.com/changelog/acacia/2024-09-30/credit-note-email-type.md) | Invoicing | Non-breaking | api | | [Adds support for the Payment Element on a Customer Session](https://docs.stripe.com/changelog/acacia/2024-09-30/support-payment-element-customer-session.md) | Elements | Non-breaking | api | | [Adds support for identifying the case type for card disputes](https://docs.stripe.com/changelog/acacia/2024-09-30/disputes-case-type-card.md) | Payments | Non-breaking | api | | [Adds a method to update the metadata for Checkout Sessions](https://docs.stripe.com/changelog/acacia/2024-09-30/checkout-update-method.md) | Checkout | Non-breaking | api | | [Adds parameter to link Verification Sessions to Customers](https://docs.stripe.com/changelog/acacia/2024-09-30/identity-verification-session-related-customer.md) | Identity | Non-breaking | api | | [Displays CHIPS tracking details for outbound wire payments and transfers](https://docs.stripe.com/changelog/acacia/2024-09-30/displays-chips-tracking-details-treasury-outbound-wires.md) | Treasury | Non-breaking | api | | [Adds additional reasonable defaulting to the Account Link API v1](https://docs.stripe.com/changelog/acacia/2024-09-30/account-link-api-default-fields-v1.md) | Connect | Non-breaking | api | | [Makes `LineItem.description` optional](https://docs.stripe.com/changelog/acacia/2024-09-30/description-optional-checkout-session-line-item.md) | Checkout | Non-breaking | api | | [Adds `target_frozen_time` for advancing `test_helpers.test_clock` objects](https://docs.stripe.com/changelog/acacia/2024-09-30/support-status-details-test-clock.md) | Billing | Non-breaking | api | | [Makes status details for Test Clock test helpers required](https://docs.stripe.com/changelog/acacia/2024-09-30/make-testclock-status-details-required.md) | Billing | Non-breaking | api | | [Adds a new enum value representing a ReceivedDebit failure due to an international transaction](https://docs.stripe.com/changelog/acacia/2024-09-30/ef-features.md) | Treasury | Non-breaking | api | | [Makes it optional to update the products and prices of a subscription](https://docs.stripe.com/changelog/acacia/2024-09-30/billing-portal-updates-optional.md) | Billing | Non-breaking | api | | [Add support for `custom_unit_amount` during product creation](https://docs.stripe.com/changelog/acacia/2024-09-30/products-custom-unit-amount.md) | Checkout, Paymentlinks | Non-breaking | api | | [Adds support for retrieving thin events](https://docs.stripe.com/changelog/acacia/2024-09-30/api-v2-thin-events.md) | Billing | Non-breaking | api |