Stripe API Release Notes

Breaking changes

Payments enhancements

• Updates card property requirements and adds 3D Secure authentication properties to Payment Records
• Adds support for the 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 the Address Element state field to default to Latin-formatted characters
• Updates the process for configuring future usage in the Payment Element
• Updates the 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 the requirement for certain connected accounts to collect external account information in the Account Sessions API

Checkout enhancements

• Updates Checkout Session UI mode enum values
• Adds pending invoice item interval parameter to create Checkout Sessions
• Adds integration identifier parameter to Checkout Sessions

Issuing enhancements

• Updates the Issuing Token card reference ID for Visa to be optional
• Adds support for limiting the number of 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 the events_from parameter on event destinations to accept string values
• Adds decimal quantity support for Invoice Items and Invoice Line Items
• Adds marine carbon removal as a 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

Original source Report a problem

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
• 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

• Adds the top-up field to Treasury ReceivedDebit linked flows

Financial Accounts for platforms

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 Report a problem

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 Report a problem

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 Report a problem

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 Report a problem

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 Report a problem

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 Report a problem

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 Report a problem

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 Report a problem