Stripe API Updates & Release Notes

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

Payments

Adds support for Mastercard compliance disputes

Payments

Adds support for recurring payments with Satispay

Billing + 1 more

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

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

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

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