25.0.0 2025-11-03

This major version introduces many small breaking changes. Please see MIGRATING.md to help you migrate.

All

• [Added] You can now access the HTTP status code of failed API requests by inspecting userInfo[STPError.httpStatusCodeKey] on the error.
• [Added] You can now access the Stripe request ID of failed API requests by inspecting userInfo[STPError.stripeRequestIDKey] on the error.
• [Changed] Most delegate protocols are now marked as @MainActor @preconcurrency to improve support for Swift strict concurrency. This includes: STPApplePayContextDelegate, STPAuthenticationContext, STPPaymentCardTextFieldDelegate, STPCardFormViewDelegate, AddressViewControllerDelegate, and STPAUBECSDebitFormViewDelegate.

PaymentSheet

• [Fixed] PaymentSheet, PaymentSheet.FlowController, and EmbeddedPaymentElement return errors when loading with invalid configuration instead of loading in a degraded state.
• [Added] Added async versions of all completion-block-based PaymentSheet and PaymentSheet.FlowController methods.
• [Added] CustomerSessions is now generally available.
• [Added] ConfirmationTokens is now generally available.
• [Changed] Replaced ExternalPaymentMethodConfirmHandler with an async equivalent.
• [Changed] Replaced IntentConfiguration.ConfirmHandler with an async equivalent.
• [Changed] Replaced PaymentSheet.ApplePayConfiguration.Handlers completion-block based authorizationResultHandler with an async equivalent.
• [Removed] Removed PaymentSheet.reset() in favor of PaymentSheet.resetCustomer().
• [Removed] Removed PaymentSheet.CustomerConfiguration.ephemeralKeySecret.

Financial Connections

• [Added] Added async versions of present(from:) and presentForToken(from:).

CustomerSheet

• [Added] Added an async version of present(from:).
• [Added] CustomerSessions is now generally available.

STPApplePayContext

• [Added] Added async delegate methods.
• [Changed] Replaces the ApplePayContextDelegate.didCreatePaymentMethod method with an async version.

Payments

• [Added] STPPaymentHandler and STPAPIClient methods with completion blocks now have async equivalents.
• [Changed] STPPaymentIntent.paymentMethodTypes and STPSetupIntent.paymentMethodTypes now return [STPPaymentMethodType] instead of [NSNumber] in Swift for better ergonomics.
• [Changed] STPSetupIntentConfirmParams.useStripeSDK, STPPaymentIntentConfirmParams.useStripeSDK, STPConnectAccountCompanyParams.directorsProvided, STPConnectAccountCompanyParams.ownersProvided, and STPConnectAccountParams.tosShownAndAccepted now uses Bool? instead of NSNumber? in Swift for better ergonomics.
• [Changed] Renamed STPPaymentHandler's confirm and handleNextAction methods and added async versions.
• [Changed] Renamed STPPaymentIntentParams to STPPaymentIntentConfirmParams
• [Changed] linkedAccount on STPPaymentMethodUSBankAccount has been renamed to financialConnectionsAccount.
• [Changed] Changed STPPaymentMethodType.description to be more consistent.
• [Removed] Removed requiresSource and requiresSourceAction statuses from STPPaymentIntentStatus. Also removed STPPaymentIntentSourceActionType.
• [Removed] Removed deprecated STPPaymentIntentParams.saveSourceToCustomer property. Use savePaymentMethod instead.
• [Removed] Removed singleUsePaymentMethod STPPaymentMethodParams initializer.
• [Removed] Removed STPPaymentMethod metadata.
• [Removed] Sources are no longer supported for non-card payment methods or cards that require 3DS authentication. Please migrate to the Payment Methods API.
• [Removed] Removed Sofort. Migrate to SEPA Debit or other EU payment methods. See this page for more information.
• [Removed] Removed Giropay. Use alternative payment methods instead. See this page for more information.

24.25.0 2025-10-27

PaymentSheet

• [Fixed] Blocked emoji input in text fields.

CustomerSheet

• [Added] Added support for onBehalfOf to CustomerSheet.IntentConfiguration. This parameter makes CustomerSheet use a connected account to determine the payment method that users see and whether CardBrandChoice is enabled. For more information, see the SetupIntent docs.

24.24.4 2025-10-20

PaymentSheet

• [Fixed] Fixed a bug with FlowController and EmbeddedPaymentElement in dark mode where paymentOption.image could be a blank icon for Alma, Billie, Multibanco, Paynow, Promptpay, Satispay, and Sunbit

24.24.3 2025-10-13

PaymentSheet

• [Fixed] Fixed a bug where theDoneButtonToolbar was not tappable on devices < iOS 26 when compiled with Xcode26.
• [Fixed] Fixed minor styling issues with Link UI on < iOS 26 when compiled with Xcode26.

24.24.2 2025-10-06

PaymentSheet

• [Improved] Improved CVC recollection UI in Link

General

• [Improved] Added automatic retry on network errors when fetching payment intents for improved resilience

24.24.1 2025-09-29

Connect

• [Fixed] Renamed PrivateBetaConnect to PreviewConnect.

PaymentSheet

• [Fixed] Fixed a navigation bar shadow bug when appearance.navigationBarStyle is glass (iOS 26.1 fixed the underlying API).

24.24.0 2025-09-22

Connect

• [Added] Payments and Payouts embedded components are available to use in public preview.

PaymentSheet

• [Added] Added Appearance.applyLiquidGlass(), a convenience method that changes the values of various properties on the Appearance object used by PaymentSheet, PaymentSheet.FlowController, EmbeddedPaymentElement, CustomerSheet, and AddressViewController to match Liquid Glass when building with Xcode 26 or later and running on iOS 26. This includes appearance.cornerRadius, appearance.borderWidth, appearance.navigationBarStyle, colors.background, navigationBarStyle, and others. This feature is in public preview while we gather feedback and is subject to change. Please use https://github.com/stripe/stripe-ios/issues to file feedback!

• [Added] Appearance.navigationBarStyle. Setting to .glass will change the sheet navigation bar to a glassy appearance when building with Xcode 26 or later and running on iOS 26. Calling Appearance.applyLiquidGlass() will set this value to .glass.
• [Changed] appearance.cornerRadius is now nullable. Below iOS 26, When nil, the corner radius is 6.0 (ie unchanged from the current default). On iOS 26+, multiple rounder corner configurations are used to match Liquid Glass design.
• [Fixed] Improved the cancellation UX when paying with Amazon Pay, Revolut Pay, P24, Twint, Swish, and 3DS2 card.

24.23.3 2025-09-17

StripeCryptoOnramp

• [Added] Additional APIs and improvements to support the development of the React Native StripeCryptoOnramp SDK.

24.23.2 2025-09-16

PaymentSheet

• [Fixed] Fixed an issue with the Liquid Glass keyboard toolbar where tapping on the sheet immediately above the keyboard didn't have an effect.

24.23.1 2025-09-08

StripeCryptoOnramp

• [Added] Additional APIs and improvements to support the development of the React Native StripeCryptoOnramp SDK.