25.2.0

25.2.0 2025-12-01

Payment Method Messaging Element

• [Added] PaymentMethodMessagingElement is now in public preview

25.1.1

25.1.1 2025-11-24

Financial Connections

• [Fixed] Fixes Instant Bank Payments when used in a webview flow.

25.1.0

25.1.0 2025-11-18

PaymentSheet

• [Added] Added card property to STPPaymentMethodPreview to expose card details (brand, country, exp_month, exp_year, funding, last4, display_brand) from ConfirmationTokens.

Financial Connections

• [Added] StripeFinancialConnections SDK is now localized!

25.0.1

25.0.1 2025-11-10

PaymentSheet

• [Fixed] Fixed an issue where async APIs did not run on the main thread.

25.0.0

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

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

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

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

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

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).