Stripe API Updates & Release Notes

Breaking changes

Payments enhancements

Updates card property requirements and adds 3D Secure authentication properties to Payment Records

Payments

Adds support for the UPI payment method

Payments

Adds payment method-level support for configuring future usage of crypto payment methods in Checkout Sessions

Payments + 1 more

Elements and Stripe.js enhancements

Changes the Address Element state field to default to Latin-formatted characters

Elements

Updates the elements.update() method to return a Promise

Elements

Removes support for boolean values in options.layout.radios

Elements

Removes deprecated Payment Intents, Setup Intents, and Sources methods from Stripe.js

Payments

Renames Checkout initialization method

Checkout + 1 more

Renames Embedded Checkout initialization method

Checkout

Connect enhancements

Adds risk requirements to the Capabilities API

Connect

Removes the requirement for certain connected accounts to collect external account information in the Account Sessions API

Connect

Checkout enhancements

Updates Checkout Session UI mode enum values

Checkout + 1 more

Adds pending invoice item interval parameter to create Checkout Sessions

Checkout

Adds integration identifier parameter to Checkout Sessions

Checkout

Issuing enhancements

Updates the Issuing Token card reference ID for Visa to be optional

Issuing

Adds support for limiting the number of allowed payments for Issuing cards

Issuing

Radar enhancements

Adds crypto fingerprint support to Radar value list items

Radar + 1 more

Additional updates

Adds retention policy cancellation reason to Subscriptions

Billing

Updates the events_from parameter on event destinations to accept string values

Affects all products

Adds decimal quantity support for Invoice Items and Invoice Line Items

Invoicing

Adds marine carbon removal as a new Climate Orders pathway

Climate

Adds metadata property to credit note line items

Invoicing

Adds Tempo network support for crypto payments

Payments + 1 more

Adds presentment details for Adaptive Pricing Subscriptions

Billing

Original source

Payments and payment method enhancements

• Adds display name and service user number to Bacs Direct Debit mandates

Payments

• Adds events for reserve holds, releases, and plans

Payments

• Adds transaction purpose to PaymentIntents for US bank account payments

Payments

• Makes Boleto tax ID nullable in payment method details for Payment Records

Affects all products

Billing enhancements

• Adds Pay by Bank to the Billing API

Billing + 1 more

• Adds payment behavior control for subscription item deletion

Billing

Terminal enhancements

• Adds Terminal reader and location to payment method details

Payments + 1 more

• Adds the ability to manage cellular connectivity settings for Terminal readers

Terminal

• Adds support for uploading Terminal Wi-Fi certificates and private keys

Terminal

• Adds support for the Stripe Reader S710

Terminal

Tax enhancements

• Adds support for tax collection in Sri Lanka for digital services

Tax

• Adds support for Sri Lanka VAT numbers

Additional updates

• Adds settlement type to Application Fee objects

Affects all products

Original source

Payments and payment method enhancements

Adds support for 3D Secure versions 2.3.0 and 2.3.1

Payments

Adds the ability to monitor reserve activity on Balance Transactions and reconcile Risk Reserved balance changes

Payments + 1 more

Adds the ability to opt out of strict arithmetic validation for Payment Line Items

Payments

Adds Adyen as an issuer for iDEAL payments

Payments

Adds adjustable quantity to the line items response

Checkout + 1 more

Additional updates

Adds OpenAPI artifacts containing v2 API endpoints

Affects all products

Reintroduces the ability to set an amount-off coupon’s duration to forever

Billing

Adds support for Polish NIP tax ID type

Tax + 2 more

Adds the top-up field to Treasury ReceivedDebit linked flows

Treasury

Changes currency mapping for Bulgaria from BGN to EUR

Terminal

Adds the contact phone parameter to the Accounts API

Affects all products

Adds the ability to specify a company’s registration date on Accounts v2 objects

Connect

Original source

Billing enhancements

• Subscriptions updated from the Customer Portal can now also modify their billing cycle anchor
• Billing
• Adds the ability to filter customer balance transactions by invoice
• Billing
• Enables expansion for invoice pricing details
• Invoicing
• Adds subtotal property to Invoice Line Items
• Billing + 1 more

Payment methods enhancements

• Adds Mollie as a supported iDEAL issuer
• Payments
• Adds additional card payment method details to Payment Records
• Payments
• Adds expected debit date for bank debit payments
• Payments
• Adds support for the PayTo payment method
• Payments

Accounts v2 and Connect enhancements

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

Additional updates

• Adds the ability to update line items on existing Checkout Sessions with a custom UI
• Checkout

Original source

Billing enhancements

• Adds filtering by creation date to Customer Balance Transactions lists

Billing

• Adds filtering by creation date to Invoice Payment lists

Billing

• 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
• Terminal + 1 more
• Adds the transaction ID to iDEAL payment method details
• Payments
• Adds MB WAY and TWINT to destination details for refunds
• Payments
• Adds Finom as a supported iDEAL issuer
• Payments

Enhancements to Issuing and fraud protection

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

Additional updates

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

Original source

Global API enhancements

• Adds support for filtering by event type to Events v2
• Affects all products
• Adds the ability to upload your platform’s terms of service agreement
• Affects all products

Connect enhancements

• Adds the ability to attest to an Account’s authorized company representative
• Connect
• Adds a webhook event type for updates to the balance settings for connected accounts
• Connect + 1 more

Billing enhancements

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

Payment methods enhancements

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

Crypto enhancements

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

Tax enhancements

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

Terminal enhancements

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

Additional updates

• Adds Payment Records and Payment Attempt Records
• Payments
• Adds support for payment line items
• Payments
• Adds support for collecting business and individual names on Payment Links
• Payment Links
• Adds support for Customer Sessions for Mobile Payment Element and Customer Sheet
• Elements + 1 more

Original source

Breaking changes

Connect enhancements

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

Elements enhancements

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

Checkout enhancements

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

Billing enhancements

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

Enhancements to payments and payment methods

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

Terminal enhancements

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

Additional updates

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

Original source

Connect and payout enhancements

Connect

• Adds Payout Details embedded component to the Account Session API
• Public placeholder for Payout Details embedded component
• Connect + 1 more
• Adds a Charge transaction ID for several payment methods

Payouts

• Adds support for paying out to Financial Accounts v2

Billing enhancements

Billing

• 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

Connect

• Adds PayPay settings to the Account object
• Connect + 1 more
• Adds a Charge transaction ID for several payment methods

Payments

• Adds the number of installments for Alma payments to Charge objects
• Adds support to include the IOF tax in the amount for Pix payments

Checkout

• Adds excluded payment method types to the Payment Intents API
• Checkout + 1 more

Terminal enhancements

Terminal

• 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

Affects all products

• Adds Android APK for Terminal to purpose of file uploads

Payments

• Adds support for Dispute Preventions

Issuing

• Adds support for custom expiration dates to Issuing virtual cards

Original source

Checkout enhancements

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

Billing enhancements

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

Additional updates

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

Original source

Connect enhancements

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

Payment method enhancements

• Adds new plan types for Japan installments
• Payments
• Adds support for saving Klarna payment methods
• Billing + 1 more
• Adds BUUT as a supported bank when using iDEAL
• Payments
• Adds support for crypto payment method
• Crypto

Additional updates

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

Original source

Enhancements for Balances and Balance Transactions

• Adds balance types to the Balance Transactions API
• Issuing + 3 more
• Adds refund and dispute prefunding balances to the Balance API

Payments

• Payment method enhancements
• Adds South Korean payment methods to the Payment Method Configurations API

Connect

• Adds account capability for the Pix payment method for US-based sellers

Checkout

• 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

Terminal

• Adds simulated S700 device type to Reader API
• Reintroduces billing thresholds
• Adds forms to Terminal readers to collect user information
• Adds support for partial payments on invoices

Identity

• Extracts sex and place of birth from government-issued ID documents
• Adds metadata field on Tax Calculation line items

Tax

• Adds two new Connect embedded components for Disputes

Connect

• Adds forms to Terminal readers to collect user information

Billing

• Billing + 1 more

Original source

New country support for Tax Registration

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

Regulatory enhancements

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

Payment method enhancements

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

Events enhancements

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

Additional updates

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

Original source

Breaking changes

Coupons enhancements

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

Increase Invoice flexibility

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

Billing enhancements

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

Elements with Checkout Session

Adds custom UI mode to Checkout Sessions
Checkout
Adds the initCheckout method
Checkout + 1 more

Deprecations to billing features

Replaces Upcoming Invoice API methods with the Create Preview Invoice API
Billing + 1 more
Removes legacy usage-based billing
Billing + 1 more

Issuing enhancements

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

Payment enhancements

Updates the Vault and Forward API to return a 402 status code for upstream request timeouts
Payments
Removes manual capture method for Interac cards
Payments + 1 more
Payment Methods won’t allow modifying fields for Naver Pay after the object is first created
Payments
Partially capturing or canceling payments no longer creates a Refund
Payments
Adds support for Klarna in the Hosted Invoice Page
Billing
Adds ability to configure saved payment methods for one-time payments on the Hosted Invoice Page
Connect + 1 more
Adds support for saving and reusing Naver Pay payment methods
Billing + 4 more
Adds support for the Billie local payment method
Checkout + 5 more
Adds support for the Satispay local payment method
Checkout + 5 more
Makes the client parameter optional for WeChat Pay until confirmation
Invoicing
Adds support for the New Zealand BECS Direct Debit local payment method
Billing + 6 more

Checkout enhancements

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

Additional updates

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

Original source

Improved workflows for Checkout Sessions

• Adds support for blocking specific card brands in Checkout Sessions

Checkout

• Checkout Sessions now group customer information in one field

More granular control of credit grants

• Credit grants can now be applied to specific prices

Billing

• Credit grants can now be prioritized

More flexibility for buy now, pay later methods

• Makes shipping information an optional parameter for Afterpay payments

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

Billing

• Adds ability to schedule debit payments for a specific date

Payments

• Versioning in Stripe JS

Checkout + 1 more

Original source