25.5.0

25.5.0 2026-01-15

StripeIssuing

• [Added] StripeIssuing is now available as a separate module, enabling support for Apple Pay Wallet Extensions. If you use the legacy Stripe framework with Carthage or by manually embedding the .xcframeworks, you must also embed StripeIssuing.xcframework in your app. No action is required for Cocoapods and Swift Package Manager users, or users of the individual StripePayments, StripePaymentsUI, and StripePaymentSheet modules.

PaymentSheet

• [Fixed] Fixed an issue where confirming fails when setting setupFutureUsageValues on the IntentConfiguration.paymentMethodOptions parameter for Cash App Pay, Satispay, PayPal, Amazon Pay, Revolut Pay, or Klarna due to missing mandate_data.

25.4.0

25.4.0 2026-01-12

All

• [Fixed] Improved telemetry used for advanced fraud signals.

PaymentSheet

• [Fixed] Fixed an issue where confirming Cash App Pay, Satispay, or PayPal could fail when setup_future_usage = on_session.
• [Changed] Custom Payment Methods is now generally available, learn more by visiting the docs.

25.3.1

25.3.1 2025-12-19

Financial Connections

• [Fixed] The native Instant Bank Payments flow is now available to more merchants.

25.3.0

25.3.0 2025-12-15

PaymentSheet

• [Added] Support for PayPay with PaymentIntents.

Payments

• [Added] Support for PayPay bindings.

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.