Stripe API

Checkout Session's "tax IDs" property becomes "tax ID" and the "taxes" parameter becomes "tax items" in industry metadata payment details, both breaking changes. Received Debits now support bank transfer types beyond US banks, error visibility added for eventually due requirements, and Shared Payment Tokens gain extra next-action support. Also: live mode indicator on Tax Location, Issuing Cardholder name updates, trial offer list/retrieve, legacy payout type deprecation, and SCIM/SSO role change activity logging.

Adds invoice description, footer, and custom parameters to Subscription Schedules and Quotes, item-level discounts for pending updates, and payment method support for Top-ups. Also brings smarter Connect account rejection controls, new Payment Links shipping/consent options, and a broad set of new banks, networks, and payment methods across Payments.

Payments

This preview adds Express connected accounts with Stripe-owned pricing, Sunbit payments for Accounts v2, and redaction details on Customer and related resources. Breaking changes replace SWIFT with BIC in Financial Addresses, add under review status events for outbound payments and transfers, require a failure reason for received debits when the debit capability is inactive, rename the List Financial Accounts status filter to statuses, and remove the rate limit parameter from Batch Job v2 objects.

Payments

• Adds support for Twint as a payment method for recurring payments
• Adds destination payment description and metadata support to transfer data
• Adds active status filtering to payment method configurations
• Adds card brand restrictions to Payment Links
• Adds…

The billed-until property on subscription items is no longer returned unless explicitly requested, and Mastercard is now supported in the Issuing Settlement API. Also adds a subscription pause endpoint, trial offer price expansion, individual activity log retrieval, 20 new bank account types for cross-border payouts, and CHAPS support in Financial Addresses and Received Credits.

Adds Shared Payment Granted Token, SharedPaymentIssuedToken, and Orchestrated Commerce Agreements API for agentic commerce. Introduces Breaking validation for billing meter event values over 15 digits, new Global Payouts destinations (Japan, China), and breaks on transaction categories and the radar session property in the Payment Evaluations API.

Payments

• Adds support for Sunbit, a buy now, pay later payment method
• Adds support for Pix recurring payments
• Adds the moto property to Setup Attempt payment method details for cards
• Adds QR code support for Klarna payments with Terminal readers
• Adds an amount…

Major breaking changes across multiple product areas:

This preview removes the source type property from Stripe balance payment methods and adds multicurrency support for v2 payouts, both breaking changes. Accounts v2 identity properties are also restricted for some Global Payouts use cases, alongside new surcharge configuration for card-not-present payments and a Risk Reserved Balance on the Balances API.

Payments and payment method enhancements: Adds display name and service user number to Bacs Direct Debit mandates. Adds events for reserve holds, releases, and plans. Adds transaction purpose to PaymentIntents for US bank account payments. Makes Boleto tax ID nullable in…

Preview 2026-02-25 makes the flow property nullable on Transactions, a breaking change, and introduces Managed Payments, Stripe's merchant of record solution. Also expands cross-border payout destinations to 12 additional countries, adds Smart Disputes settings to v2 Accounts, and expands bank account identification details in payout method responses.

Adds account holder information to Financial Address credentials, the ability to relink deactivated Financial Connections Accounts, and a fingerprint property for card payout methods. Also adds alternative reference fields, expands Global Payouts to 15 new countries, and updates Outbound Setup Intents API error codes (breaking).

Payments and payment method enhancements: Adds support for 3D Secure versions 2.3.0 and 2.3.1. Adds ability to monitor reserve activity on Balance Transactions and reconcile Risk Reserved balance changes. Adds ability to opt out of strict arithmetic validation for Payment…

Accounts v2 now always returns the responsibilities field when defaults is included, and removes the requested field from capabilities hashes. Payout Methods adds generic error types and fires an event on creation; Global Payouts supports 13 new countries, and reserves info is now retrievable.

Billing enhancements: Subscriptions updated from Customer Portal can now modify billing cycle anchor. Adds ability to filter customer balance transactions by invoice. Enables expansion for invoice pricing details. Adds subtotal property to Invoice Line Items.

Billing enhancements

• Adds filtering by creation date to Customer Balance Transactions lists
• Adds filtering by creation date to Invoice Payment lists
• Adds the ability to specify a payment method configuration in the customer portal

Preview 2025-11-17 breaks Accounts v2's requirements collection parameters and adds a future requirements field, plus health alerts for event-generation failures and meter usage analytics filtering by multi-tenant/dimension values. Also adds PayPay, Konbini payments, EUR fund holding, account/person tokens, and Argentine ID support to Accounts v2, and thin events now surface field changes on related objects.

Connect enhancements

• Adds the ability to upload your platform's terms of service agreement
• Adds the ability to attest to an Account's authorized company representative
• Adds a webhook event type for updates to the balance settings for connected accounts

Preview 2025-10-29 introduces a breaking change: Stripe Tax can now use Accounts v2 payment method billing details for location, and a new error code fires when verification data is missing from connected accounts. Also adds closed v2 Account retrieval, microdeposit support for US bank accounts, and Tax ID Element in Customer Sessions.