Stripe API Updates & Release Notes

Payments

Adds support for updating Connect parameters of an existing Payment Link

Adds a funding source identifier to Link payments

Adds new error codes for payment method failures

Adds the ability to restrict card funding types in Checkout Sessions

Adds support for metadata in confirmation tokens

Adds a funding source identifier to Link wallet card payments

Billing and invoicing

Adds a customer update deep link for billing portal sessions

Adds the ability to query entitlements and launch the customer portal in Customer Sessions

Adds frozen fields property to Invoice Items

Adds support for the Billie payment method for invoices and subscriptions

Increases the subscription item limit

Additional updates

Adds support for specifying place of supply scheme on IGIC tax in the EU

Payments

Adds the ability to update shipping options, consent collection, and future usage support on Payment Links

Adds the ability to indicate that you don’t intend to reuse Samsung Pay and PAYCO payment method types

Adds customer and payment method details to the Refunds API

Adds support for new banks to FPX payments

Adds CHAPS as a supported network for funding instructions

Adds the allowed payment method types parameter to Payment Intents and Setup Intents

Adds MB WAY support to the hosted invoice page

Adds card network details to the Dispute object

Adds the ability to list Payment Records

Connect

Adds the ability to show who initiated a top-up

Adds Payment Method support to Top-ups

Adds new address fields to Accounts v1 for Singapore compliance

Adds a new Smart Disputes management feature to Account Session embedded components

Adds new address fields to Accounts v2 for Singapore compliance

Enables rejecting connected accounts with non-zero balances and controlling whether to pause payouts

Adds the ability to reverse platform rejections on connected accounts

Billing and invoicing

Adds invoice description, footer, and custom parameters to the Subscription Schedules and Quotes APIs

Adds subscription metadata support to invoice previews

Adds the trial property to subscription schedule phases

Adds item-level discount support for pending updates

Tax

Adds support for parking tax registration types in the US

Adds support for Canary Islands tax ID type

Financial Connections

Adds explicit session configuration options for Financial Connections

Adds deactivation event notifications for Financial Connections accounts and authorizations

Issuing

Adds Correos as an Issuing card shipping carrier in the EU

Adds the business name field to the shipping address for Issuing cards

Additional updates

Adds Alipay support for invoices and subscriptions that send invoices for collection

Adds a referrer parameter to Radar options on Payment Intents

Payments

Adds buyer ID support for Bizum payments

Payments

Enables manual capture for Sunbit payments

Payments

Adds buyer ID support for BLIK payments

Payments

Adds a fingerprint to Pix payment method details

Payments

Adds transaction link ID to card payment method details for Mastercard and Maestro transactions

Payments

Adds payment method options for Sunbit in Checkout Sessions

Payments

Adds support for the Sui network and USDsui token for crypto payments

Crypto + 1 more

Adds support for Mastercard compliance disputes

Payments

Adds support for recurring payments with Satispay

Billing + 1 more

Checkout

Makes billing cycle anchor configuration available for Checkout Sessions in subscription mode

Checkout

Adds WeChat Pay payment method options to the Checkout Session response

Checkout

Additional updates

Adds validated status to the redaction status enum

Identity

Adds payment method and payment method options to the Top-ups API (US bank accounts only)

Connect

Adds reserve release details to the Reserve Hold object

Payments + 2 more

Adds information about upcoming deactivations to the Financial Connections Account object

Financial Connections

Adds invoice description, footer, and custom fields to the Subscriptions API

Billing

Adds mode property and promotion feed type support to the Product Catalog Import API v2

Payments

Payments

Adds support for Twint as a payment method for recurring payments

Payments

Adds destination payment description and metadata support to transfer data

Payments

Adds active status filtering to payment method configurations

Payments

Adds card brand restrictions to Payment Links

Payment Links

Adds support for Scalapay payments

Payments

Billing

Adds discount eligibility options for add-on invoice items on Subscriptions and Preview Invoice APIs

Billing

Adds amount paid off Stripe property to Invoice object

Invoicing

Adds billing schedules to enable prebilling on subscriptions

Billing

Adds discount and discounts properties to pending subscription updates

Sigma + 1 more

Adds metadata support to pending subscription updates

Billing

Adds credited items information to invoice item proration details

Billing

Adds customer parameter to test clock creation

Billing

Terminal

Adds support for printing images on Terminal readers with embedded printers

Terminal

Adds support for Verifone third-party device types to Terminal APIs

Terminal

Adds API error details to Terminal reader action failures

Terminal

Elements

Renames Link Authentication Element to Contact Details Element

Elements

Adds the ability to collect email in Checkout Sessions with Contact Details Element

Checkout + 1 more

Connect

Adds digital attestation support to Accounts v2 for proof of registration and beneficial ownership verification

Connect

Adds automatic transfer rules to balance settings

Payouts

Adds the ability to configure custom start of day per connected account

Payments + 1 more

Additional updates

Adds support for Bizum payments

Payments

Payments

Adds support for Sunbit, a buy now, pay later payment method

Payments

Adds support for Pix recurring payments

Payments

Adds the moto property to Setup Attempt payment method details for cards

Payments

Adds QR code support for Klarna payments with Terminal readers

Affects all products

Adds support for Managed Payments, Stripe’s merchant of record solution

Checkout + 2 more

Tax

Adds the ability to collect and store tax identification information for customers in the Faroe Islands, Gibraltar, Italy, and Paraguay

Tax + 1 more

Adds expandable tax rate property to tax rate details

Invoicing

Additional updates

Adds account as a new item type to Radar value lists

Radar

Removes mandatory payments KYC onboarding for app distribution for Stripe Apps

Affects all products

Adds fulfillment error to issuing card cancellation and replacement reasons

Issuing

Adds balance report and payout reconciliation report embedded components to the Account Session API

Connect

Adds support for Azure Event Grid as an event destination

Affects all products

Adds new balance transaction types for inbound transfers and reversals

Treasury

Adds support for Phantom Cash and USDT to stablecoin payments

Crypto

Adds the Product Catalog Import API v2

Affects all products

Adds a card-presence spending control for Issuing

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

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

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

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

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

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

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

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

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