API Changelog

Major breaking changes across multiple product areas:

Payments enhancements: Updates card property requirements and adds 3D Secure authentication properties to Payment Records. Adds support for UPI payment method. Adds payment method-level support for configuring future usage of crypto payment methods in Checkout Sessions.

Elements and Stripe.js enhancements: Changes Address Element state field to default to Latin-formatted characters. Updates process for configuring future usage in Payment Element. Updates elements.update() method to return a Promise. Removes support for boolean values in options.layout.radios. Removes deprecated Payment Intents, Setup Intents, and Sources methods from Stripe.js. Renames Checkout initialization method. Renames Embedded Checkout initialization method.

Connect enhancements: Adds risk requirements to the Capabilities API. Removes requirement for certain connected accounts to collect external account information in Account Sessions API.

Checkout enhancements: Updates Checkout Session UI mode enum values. Adds pending invoice item interval parameter. Adds integration identifier parameter.

Issuing enhancements: Updates Issuing Token card reference ID for Visa to be optional. Adds support for limiting allowed payments for Issuing cards.

Radar enhancements: Adds crypto fingerprint support to Radar value list items.

Additional updates: Adds retention policy cancellation reason to Subscriptions. Updates events_from parameter on event destinations. Adds decimal quantity support for Invoice Items and Line Items. Adds marine carbon removal as new Climate Orders pathway. Adds metadata property to credit note line items. Adds Tempo network support for crypto payments. Adds presentment details for Adaptive Pricing Subscriptions.

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 payment method details for Payment Records.

Billing enhancements: Adds Pay by Bank to the Billing API. Adds payment behavior control for subscription item deletion.

Terminal enhancements: Adds Terminal reader and location to payment method details. Adds ability to manage cellular connectivity settings for Terminal readers. Adds support for uploading Terminal Wi-Fi certificates and private keys. Adds support for Stripe Reader S710.

Tax enhancements: Adds support for tax collection in Sri Lanka for digital services. Adds support for Sri Lanka VAT numbers.

Additional updates: Adds settlement type to Application Fee objects.

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 Line Items. Adds Adyen as issuer for iDEAL payments. Adds adjustable quantity to line items response.

Additional updates: Adds OpenAPI artifacts containing v2 API endpoints. Reintroduces ability to set amount-off coupon duration to forever. Adds support for Polish NIP tax ID type. Adds top-up field to Treasury ReceivedDebit linked flows. Changes currency mapping for Bulgaria from BGN to EUR. Adds contact phone parameter to Accounts API. Adds ability to specify company registration date on Accounts v2 objects.

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.

Payment methods enhancements: Adds Mollie as supported iDEAL issuer. Adds additional card payment method details to Payment Records. Adds expected debit date for bank debit payments. Adds support for PayTo payment method.

Accounts v2 and Connect enhancements: Connect platforms can now use Accounts v2 to manage connected accounts and customers. Adds customer account property to v1 APIs for Accounts v2 interoperability. Accounts now support digital attestation for proof of registration and beneficial ownership verification.

Additional updates: Adds ability to update line items on existing Checkout Sessions with custom UI.

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

Enhancements to payments and payment methods

• Adds the ability to specify the capture method for card present payments with Payment Intents
• Adds the transaction ID to iDEAL payment method details
• Adds MB WAY and TWINT to destination details for refunds
• Adds Finom as a supported iDEAL issuer

Enhancements to Issuing and fraud protection

• Adds a fraud warning for potentially compromised Issuing Cards
• Adds fraud risk assessments to Issuing Authorizations

Additional updates

• Adds support for using a web browser to accept Apple's terms and conditions for Tap to Pay on iPhone
• Adds support for automatic tax transactions to Payment Intents
• Makes client secret optional for Financial Connections Sessions
• Adds support for handling tokenized bank account numbers

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

Billing enhancements

• Adds support for using Payment Records with Invoices and Credit Notes
• Updates the category field of Credit Grants to be optional
• Adds a webhook event type for Invoices that require a non-Stripe payment

Payment methods enhancements

• Adds MB WAY to payment method configurations
• Adds TWINT payment method options to Checkout Sessions
• Adds support for specifying payment method configurations to the customer portal
• Adds MB WAY payment method to Payment Links and Checkout Sessions
• Adds the ability to exclude payment methods when using Setup Intents
• Adds Klarna reference parameters for line items in Payment Intents
• Adds a subscription reference to Klarna line items in Payment Intents
• Adds support for custom payment methods

Crypto enhancements

• Adds support for managing stablecoin payments with Payment Method Configurations
• Adds crypto network support for Solana
• Adds blockchain transaction hash to stablecoin refunds

Tax enhancements

• Adds support for remote sellers in Taiwan to Stripe Tax
• Adds third-party tax providers for automatic tax calculation

Terminal enhancements

• Adds a field for a Terminal reader's last connection timestamp
• Adds support for tipping in Gibraltar pounds on Terminal readers

Additional updates

• Adds support for filtering by event type to Events v2
• Adds Payment Records and Payment Attempt Records
• Adds support for payment line items
• Adds support for collecting business and individual names on Payment Links
• Adds support for Customer Sessions for Mobile Payment Element and Customer Sheet

Connect enhancements

• Adds specific descriptions for risk requirements during legal, PEP, and sanctions review
• Adds a new error code for business type validations
• Adds account balance and payout settings with the Balance Settings API

Elements enhancements

• Updates default behavior for saved payment methods in Elements with Checkout Sessions
• Prevents reusing client secrets for Intents in certain states when initializing Elements
• Removes deprecated messaging and bank elements that were replaced

Checkout enhancements

• Removes postal code for card payments in certain regions on Checkout and Payment Element
• Removes currency conversion field from Checkout Sessions
• Removes support for the redirectToCheckout method
• Updates initCheckout to be synchronous
• Adds support for collecting business and individual names in Checkout Sessions
• Adds the ability to exclude payment methods from Checkout Sessions and Payment Intents
• Adds support for setting the capture method for specific payment methods with the Checkout Sessions API
• Adds support for configuring branding settings for Checkout Sessions
• Enables specifying units of measurement for Products

Billing enhancements

• Removes iterations parameter for subscription schedules
• Promotion Codes now reference Coupons using a polymorphic field for promotions
• Adds the Discount source property and removes the Discount coupon property
• Makes flexible billing mode the default for new subscriptions
• Updates computation of subscription schedule phase end date to consider billing cycle anchor changes
• Adds customer portal configuration trial behavior
• Adds the ability to itemize proration discount amounts

Enhancements to payments and payment methods

• Changes the set of decline codes used for Alma, Amazon Pay, Billie, Satispay, and South Korean payment methods
• Adds a processing status to submitted stablecoin payments
• Adds a documented reason for Klarna chargeback losses to Disputes API
• Adds support for the MB WAY payment method

Terminal enhancements

• Adds Japan-specific fields to the Terminal Locations API
• Adds support for custom BBPOS WisePad 3 splash screens

Additional updates

• Adds additional enum values for Radar manual reviews
• Updates risk levels for Issuing Authorizations to use standard values
• Adds new error codes for failures when creating Payment Methods from Financial Connections Accounts
• Adds support for business and individual names on Customers
• Adds support for printing a second line on Issuing physical cards
• Adds cash as a value for the crypto token currency enum
• Adds a testing developer assistant in Elements with Intents
• Adds tax calculation provider to Tax settings

Connect and payout enhancements

• Adds Payout Details embedded component to the Account Session API
• Public preview for Payout Details embedded component
• Adds support for paying out to Financial Accounts v2

Billing enhancements

• Adds a name field to the customer portal configuration object
• Adds support for invoice items metadata and period in subscriptions and schedules
• Adds support for third-party tax on flexible billing mode subscriptions

Payment method enhancements

• Adds PayPay settings to the Account object
• Adds a Charge transaction ID for several payment methods
• Adds the number of installments for Alma payments to Charge objects
• Adds support to include the IOF tax in the amount for Pix payments
• Adds excluded payment method types to the Payment Intents API

Terminal enhancements

• Adds support for simulating card payments on Terminal readers
• Adds support for PayNow on Terminal
• Adds support for MXN currency in Terminal tipping configuration
• Makes CVC optional when presenting a payment method on a simulated reader

Additional updates

• Adds Android APK for Terminal to purpose of file uploads
• Adds support for Dispute Preventions
• Adds support for custom expiration dates to Issuing virtual cards

Checkout enhancements

• Enhances Checkout for app-to-web purchases
• Adds support for disabling future usage of Pix in Checkout Sessions
• Adds support for Invoice Rendering Templates on Checkout and Payment Links
• Adds support for the NZ BECS Direct Debit local payment method in Checkout and Payment Links

Billing enhancements

• Adds a duration parameter for schedule phases
• Adds support for quantity adjustment to the Customer Portal Configuration API
• Adds helpers to cancel subscriptions for billing periods with mixed intervals
• Adds support for billing thresholds on flexible billing mode Subscriptions
• Adds support for mixed intervals on the same subscription

Additional updates

• Adds transaction ID to Charges for Cash App
• Adds support for the America/Coyhaique time zone
• Adds a new value to payment review closed reasons
• Adds support for ad-hoc products and prices when creating Payment Links
• Adds support for new tipping currencies to the Terminal Configuration object
• Adds Connect embedded component for Instant Payouts promotion

Connect enhancements

• Verification Sessions can now collect verification information for a related Person
• Adds the ability to provide proof-of-address documents for connected accounts
• Adds more flexible schedules for monthly and weekly payouts

Payment method enhancements

• Adds new plan types for Japan installments
• Adds support for saving Klarna payment methods
• Adds BUUT as a supported bank when using iDEAL
• Adds support for crypto payment method

Additional updates

• Adds optional filter by status when listing Financial Accounts
• Adds support for collecting card details and confirming Payment Intents to server-driven Terminal integrations
• Adds Visa compliance disputes
• Adds billing mode for more flexible subscriptions behavior

Enhancements for Balances and Balance Transactions

• Adds balance types to the Balance Transactions API
• Adds refund and dispute prefunding balances to the Balance API

Payment method enhancements

• Adds South Korean payment methods to the Payment Method Configurations API
• Adds account capability for the Pix payment method for US-based sellers
• Adds option to Checkout Sessions to let customers remove saved payment methods
• Adds capture method option to Satispay payments
• Adds support for setting up future usage of Naver Pay in Checkout Sessions
• Adds support for WeChat Pay for Setup Intents
• Adds network decline codes for PayPal refunds

Additional updates

• Adds simulated S700 device type to Reader API
• Reintroduces billing thresholds
• Extracts sex and place of birth from government-issued ID documents
• Adds metadata field on Tax Calculation line items
• Adds two new Connect embedded components for Disputes
• Adds forms to Terminal readers to collect user information
• Adds support for partial payments on invoices

New country support for Tax Registration

• Adds support for tax ID types in ten new countries
• Tax Registration API now supports twelve new countries

Regulatory enhancements

• Adds a demographic information hash to the Persons API
• Adds a minority-owned business designation field to the business profile hash

Payment method enhancements

• Adds Affirm as a supported payment method for one-time invoices and subscriptions
• Adds tax ID to Payment Method billing details
• Adds Pix to payment method configurations
• Adds capture method option to Billie payments

Events enhancements

• Adds context field to event payload
• Adds a new ping event type for testing an event destination

Additional updates

• Adds a field explaining why refunds are pending
• Adds registration date to the Accounts API
• Adds wallet options to Checkout Sessions
• Adds support for card installments on Confirmation Token

Breaking Changes:

Coupons enhancements:

• Removes support for discount coupons that don't have a specified end time
• Removes coupon and promotion code parameters with stackable discounts

Increase Invoice flexibility:

• Replaces top-level price fields with improved price modeling on Invoice Items and Invoice Line Items
• Replaces top-level tax-related properties with improved tax modeling on Invoices, Invoice Line Items, and Credit Note Line Items
• Adds support for multiple (partial) payments on invoices
• Adds jurisdiction level and taxability reason to manual tax amounts on invoices

Billing enhancements:

• Adds subscription item-level billing periods and removes subscription-level periods
• Invoicing resources now specify how they were generated
• Adds support for last aggregation formula on meters
• Adds new webhook event types for Billing Meters and billing credits

Elements with Checkout Session:

• Adds custom UI mode to Checkout Sessions
• Adds the initCheckout method

Deprecations to billing features:

• Replaces Upcoming Invoice API methods with the Create Preview Invoice API
• Removes legacy usage-based billing

Issuing enhancements:

• Adds reason code for Issuing authorizations created while Stripe is unavailable
• HTTP Accept headers for webhooks now specify JSON during Issuing authorizations
• Adds expired status for Issuing Authorizations

Payment enhancements:

• Updates the Vault and Forward API to return a 402 status code for upstream request timeouts
• Removes manual capture method for Interac cards
• Payment Methods won't allow modifying fields for Naver Pay after the object is first created
• Partially capturing or canceling payments no longer creates a Refund
• Adds support for Klarna, Naver Pay, Billie, Satispay, New Zealand BECS Direct Debit in various payment flows
• Makes the client parameter optional for WeChat Pay until confirmation

Checkout enhancements:

• Checkout Session removes shipping details
• Checkout Sessions have lower latency and new update semantics
• Checkout Session allows shipping option updates
• Adds permissions parameter to Checkout Sessions
• Adds optional items to Checkout Sessions and Payment Links

Additional updates:

• Removes total count expansion for list API methods
• Adds new error codes for required verifications
• Updates the default layout for Payment Element
• Changes the political exposure property of the Person object from a string to an enum
• Adds default value to custom fields on Payment Links
• Expanded availability of Account KYC data
• Adds new error code for failures with the Setup Intents API using mobile wallets
• Adds presentment details for Adaptive Pricing
• Adds BalanceTransaction types related to pay with Stripe balance
• Introduces new customer balance transaction types
• Removes support for the page parameter
• Adds ability to configure WiFi for Terminal readers

Improved workflows for Checkout Sessions:

• Adds support for blocking specific card brands in Checkout Sessions
• Checkout Sessions now group customer information in one field

More granular control of credit grants:

• Credit grants can now be applied to specific prices
• Credit grants can now be prioritized

More flexibility for buy now, pay later methods:

• Makes shipping information an optional parameter for Afterpay payments
• Makes billing country and email fields optional for Klarna payments

Additional updates:

• Adds metadata field to the Products API for creating an inline default price
• Adds ability to schedule debit payments for a specific date
• Versioning in Stripe JS

Company details for Accounts:

• Adds support for ownership exemption reason to the Accounts API
• Adds directorship declaration to the Accounts API
• Adds proof of ultimate beneficial ownership as a document type

Payment method enhancements:

• Adds support for the Pay by Bank local payment method
• Adds PayPal country property to the PaymentMethods and Charge objects

Checkout enhancements:

• Adds discounts field to Checkout Sessions
• Adds Sudan to allowed shipping countries for Checkout

Additional updates:

• Adds advice code to Charges
• Modify phone number collection on Payment Links
• Makes Issuing and Treasury embedded components generally available
• Adds support for multiple financial accounts per business
• Adds support for collecting tips in JPY currency to Terminal

Payout enhancements

• SDK support for trace IDs in Payments
• New balance transaction types to support minimum balance Payouts

Issuing enhancements

• Issuing authorizations now include merchant tax ID number
• Creates Issuing authorizations when Stripe is unavailable

Payment method enhancements

• Additional beneficiary information for bank transfer payments
• Funding details added to Amazon Pay and Revolut Pay charges
• Support for SEPA Direct Debit and Bacs Direct Debit mandate reference prefix

Tax enhancements

• Disabled reason added to invoices, subscriptions, and schedules
• Support for tax ID types in 19 new countries
• Support for 21 new countries in Tax Registration API

Billing enhancements

• Support for reinstating Billing Credits on Invoice voiding
• Modify trial subscriptions created by Payment Links
• Billing Portal Configuration always returns period end date in responses

Additional updates

• Signature request as replacement option for Vault and Forward API
• Support for responding to Visa compliance disputes
• Network advice and decline codes
• Redisplaying payment methods for Cards and Sources
• Field-level permissions for revenue and worker count in Account business profile
• Network transaction ID added to charges
• Regulated status field added to card objects in several APIs

Support for new tax types

• Service Tax type support
• Tax ID support for Liechtenstein VAT

Issuing enhancements

• Support for merchant amount and currency for test mode authorizations
• Support for issuing fraud challenges

Additional payment flexibility

• Support for enabling Adaptive Pricing per Checkout Session
• Customize the submit button for recurring Payment Links and Checkout Sessions
• Support for advanced card features on Checkout Sessions
• Link card-only integrations can now accept non-card payments under Link card brand
• Additional beneficiary information for bank transfer payments

Payment method enhancements

• Network decline code field for Swish and BLIK refunds
• Support for SEPA Direct Debit and Bacs Direct Debit mandate reference prefixes in Checkout Sessions
• Originating payment method for Inbound Transfers is now optional
• Configurable capture methods and future usage setup for South Korean payment methods

Additional updates

• Trace payouts with unique identifier
• Account object properties converted from String to enum
• Indicator for connected accounts requiring login before using embedded components
• Support for authorizers to Person API

Billing credit grants

• Credit Grant APIs and resources
• Support for pre-tax credit amount information to invoices
• Support for pre-tax credit amount information to credit notes

New payment methods

• Support for new South Korean payment methods
• Support for Alma in France

Event destinations and event types

• Event Destinations v2 API endpoint
• Event type for updated receipt data in Issuing transactions

Payment method enhancements

• Metadata field added to Vault and Forward API
• Polish PLN currency support added to Terminal tipping configuration
• Domain registration support for Amazon Pay

Additional tax registration options

• Support for new countries in Tax Registration API
• Support for tax ID types in several new countries
• Support for collecting retail delivery fees
• Option to automatically validate customer tax location during update

Additional updates

• Support for disabling Stripe user authentication for certain embedded components
• Test helper for updating shipping status for physical cards
• Created, updated, and failed events for all refund types
• Pricing groups added to Accounts API
• Scheduled subscription downgrades in customer portal
• Business profile made optional for customer portal configuration
• Visa Compelling Evidence 3.0 for responding to qualifying disputes
• Support for scheduling invoice finalization

Major release with multiple enhancements across billing, payments, and financial services:

Billing & Alerts: Adds alerts, monitoring, and reporting to usage-based billing with contextual filters, Alerts API, triggered billing alert events and webhooks, and Meter Event v2 API endpoints.

Terminal Readers: Updates consent modeling for card saving, adds reboot time configuration, introduces Stripe S700 reader support, and adds offline collection details to card_present PaymentMethods.

Payment Methods: Adds CVC token retrieval on Confirmation Tokens, customer ID to payment method preview, BLIK payer identification, Affirm transaction IDs, Interac card support, authorization codes for charges, wallet details, Klarna country field, and Amazon Pay dispute type.

New Payment Methods: Adds support for Multibanco, Twint, Zip payment methods, and Girocard as PaymentMethod brand and network.

Tax IDs: Adds Switzerland UID and Croatian Personal Identification Number as supported tax IDs, with optional tax ID requirement on Checkout and Payment Links.

Financial Connections: Adds filtering by account subcategories and expands filtering support for sessions.

Invoicing: Introduces Invoice Rendering Templates resource with retrieve, archive, and version support; adds bulk line item operations and webhook events for due/overdue invoices; adds automatic finalization option.

Tax: Adds posting time support on tax transaction creation, tax settings and registrations for Embedded Components, retrieves tax calculation API, and US state sales tax elections.

Issuing: Updates shipping address validation default, adds address validation for physical cards, and new webhook events for dispute fund deductions.

Additional Updates: Risk verification details for connected accounts, email types for credit notes, Payment Element on Customer Session, card dispute case type identification, Checkout Session metadata update method, Verification Session customer linking, CHIPS tracking details for wire transfers, Account Link API improvements, optional LineItem description, Test Clock enhancements, ReceivedDebit failure enum, and custom_unit_amount during product creation.

Breaking changes to Issuing and Connect APIs:

Issuing: Renames fuel attribute in Authorization object and purchase_details attribute in Transaction object. Removes undocumented fuel and fleet fields. Adds enum values for fuel units and disabled reasons. Deprecates alphanumeric_id for Issuing Authorization. Adds new enum values for request history reasons.

Connect: Adds enum values for disabled reasons in capabilities. Deprecates bank_transfer_payments capability type in favor of newer capability types.