Breaking Changes

• collectBankAccountForPayment and verifyPaymentIntentWithMicrodeposits now return CollectBankAccountResult (a sealed class) instead of PaymentIntent. Update any code that assigns or pattern-matches the return value. (#2395)

Features

• EmbeddedPaymentElement — Full Flutter widget support for the embedded payment element on iOS and Android. The new EmbeddedPaymentElement widget renders inline in your layout (no bottom sheet). Use EmbeddedPaymentElementController to call confirm(), which now returns a payment result so failures (declined card, insufficient funds, etc.) can be detected directly without relying solely on callbacks. Available callbacks: onHeightChanged, onPaymentOptionChanged, onLoadingFailed, onRowSelectionImmediateAction, onFormSheetConfirmComplete. (#2239)
• Multibanco — Added Multibanco as a supported payment method following the sync with Stripe React Native v0.66.0. (#2421)
• Sync with Stripe React Native v0.66.0 — Aligned iOS and Android native bridges with the upstream React Native SDK v0.66.0. (#2421)

Fixes

• Fixed collectBankAccountForPayment and verifyPaymentIntentWithMicrodeposits crashing when the native SDK returns a setup intent instead of a payment intent. (#2395)
• Fixed crash in _handleCardChanged when the native layer sends a wrapped {card: {...}} payload instead of flat card fields. Both shapes are now handled. (#2265)
• Fixed confirmPaymentSheetPayment not triggering the token creation handler registered via onCreatePaymentMethod. (#2400)
• Fixed LinkDisplayParams serialization — Dart field names were not matching the link / display keys expected by native iOS and Android, causing Link display configuration to be silently ignored. (#2407)
• iOS: Added FlutterFramework as an explicit SPM dependency in stripe_ios to fix Swift Package Manager resolution. (#2420)

Removed

• UPI payment method has been removed following its removal from the Stripe React Native SDK.

Features:

• added createRadarSession to support stripe radar sessions

Fixes:

• Bumped compile SDK android to sdk 36
• iOS card details not complete issue on cardfield
• #2385: correct termsDisplay type to Map<String, TermsDisplay>

12.5.0

Features:

• Sync with Stripe React Native 0.61.0

12.3.0

Features

• Sync with Stripe React Native 0.58.0

Fixes

• #2332 Android: Google Pay not appear on the PaymentSheet
• #2321 Android: Wrap context with AppCompat theme for Google Pay button.
• #2320 Android: add ProGuard rules to prevent 3D Secure crash.
• #2314 Android: Card details not complete error when using dangerouslyUpdateCardDetails
• #2307 Android: Paymentsheet card not focusable when tapping middle or bottom of the field.

12.2.0

Features

• Sync with Stripe React Native 0.57.1
• Added support for Alma payments
• Added token creation callback methods
• ioS: Support for liquid glass
• Implemented new constructors for customer sheet and deprecated the old ones
• Remove Giropay as Stripe no longer supports it
• Improved stability of customer sheet screen

Fixes

• #2064 crash collect bankaccounttoken
• android: keyboard not appearing on first tap for CardField @meylis1998
• #2137 improve URL callback handling for Link payment method @meylis1998
• #2283 fix: change initCustomerSheet return type to Future @meylis1998

12.1.1

Fixes

• 2064 crash collect bankaccounttoken

12.1.0

Features

• Sync with Stripe React Native 0.53.1
• Add support for billie payment
• Add config params paymentsheet

12.0.0

Breaking changes

• This package now supports and requires Freezed v3
• Breaking change due to sync with Stripe React Native's (v0.50.1) new architecture.
• Remove Sofort payment method as Stripe does not support it anymore

Features

• Paymentsheet now supports link display parameters
• Paymentsheet can now be configured with a map of paymentmethods for future usage

Fixes

• #2173 add billing address config to google pay
• #2185 blank screen paypal payment on iOS
• #2176 support Klarna on the web
• #2005 card details not supported on android
• #2180 collect bank account token failing due to missing parameter

11.5.0

Align with Stripe React Native 0.43.0:

Breaking changes

• Removed support for FPX payments via the bank picker UI. If you'd like to accept FPX payments, we recommend using Mobile Payment Element. Also see the FPX Payment guide for more info on how to integrate FPX specifically.

Features

• Financial Connections now supports dark mode, and will automatically adapt to the device's theme. Learn more about configuring appearance settings.

• Added card brand filtering to PaymentSheet and CustomerSheet to specify allowed or blocked card brands. 1857

• Added ability to pass an onEvent listener to Financial Connections methods via a params argument:

  • collectBankAccountForPayment
  • collectBankAccountForSetup
  • collectBankAccountToken
  • collectFinancialConnectionsAccounts

• Added ability to pass metadata to PaymentMethod.ConfirmParams and PaymentMethod.CreateParams

• CustomerSheet is now generally available!

  • If you were using CustomerSheetBeta, change that to CustomerSheet.
  • If you were using CustomerSheetBeta.CustomerSheet, change that to CustomerSheet.Component

• Enabled vertical mode

Fixes

• Updated stripe-ios to 24.7.*
• Updated stripe-android to 21.6.*

Align with Stripe React Native 0.39.0: Features

• Adds support for CustomerSession in private beta 1744
• Added onBehalfOf prop to CardField

Fixes

• Updated stripe-ios to 23.30.*
• Updated stripe-android to 20.52.*