stripe_platform_interface

14.0.0

Breaking Changes

• Breaking: add support for AGP 9

Features:

• Sync with Stripe React Native 0.71.0
• Add support for Flutter 3.47.0
• Add support for scene delegates

Bugs

• Fixed scrolling issue for the cardfield in web (#2045)
• Fixed serialisation issue in EmbeddedPAymentElement RadioConfig (2431)

• FIX(ios): stop the unhandled-URL log mis-attributing deep-link breakage + add scene-delegate support (#2422) (#2429).

2026-08-14

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v8.2.0

Breaking Changes

• Breaking: add support for AGP 9

Features:

• Sync with Stripe React Native 0.71.0
• Add support for Flutter 3.47.0
• Add support for scene delegates

** Bugs

• Fixed scrolling issue for the cardfield in web (#2045)
• Fixed serialisation issue in EmbeddedPAymentElement RadioConfig (2431)

Features:

• Embedded Payment Element: Added official support for updating the EmbeddedPaymentElement. (#2427)

Fixes:

• Fixed Build Failures: Resolved an issue where iOS builds would fail on Flutter versions earlier than 3.41.0 due to a missing FlutterFramework dependency. (#2425)
• Embedded Payment Element Fix: Fixed an issue where the EmbeddedPaymentElement failed to load on iOS because the merchantIdentifier could not be found. (#2426)
• Element Remounting Fix: Resolved an issue causing an infinite spinner when an ExpressCheckoutElement instance remounted by ensuring a unique view type per instance. (#2405, #2439)
• Google Pay Fix: Fixed an issue where isPlatformPaySupported would not work properly when used with existingPaymentMethodRequired. (#2245)

• FIX: return sealed CollectBankAccountResult for bank account collection (#2395).

2026-07-10

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v8.1.0

Features:

• Embedded Payment Element: Added official support for updating the EmbeddedPaymentElement. (#2427)

Fixes:

• Fixed Build Failures: Resolved an issue where iOS builds would fail on Flutter versions earlier than 3.41.0 due to a missing FlutterFramework dependency. (#2425)
• Embedded Payment Element Fix: Fixed an issue where the EmbeddedPaymentElement failed to load on iOS because the merchantIdentifier could not be found. (#2426)
• Element Remounting Fix: Resolved an issue causing an infinite spinner when an ExpressCheckoutElement instance remounted by ensuring a unique view type per instance. (#2405, #2439)
• Google Pay Fix: Fixed an issue where isPlatformPaySupported would not work properly when used with existingPaymentMethodRequired. (#2245)

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.

• FIX: return sealed CollectBankAccountResult for bank account collection (#2395).
• FIX: 2306 remove descendantsAreFocusable are focusable as it dismisses the keyboard when we do not want it (#2316).
• FIX: change initCustomerSheet return type to Future<void> (#2292).
• FIX(ios): improve URL callback handling for Link payment method (#2290).
• FIX(android): keyboard not appearing on first tap for CardField (#2291).
• FIX: add meta import for @internal annotation (#2269).
• FIX: add new proguard rules to prevent release build from building (#2213).
• FIX: add missing param to method channel (#2181).
• FEAT: expose Stripe Connect deep link infrastructure to Dart (#2388).
• FEAT: add createRadarSession to Dart API (#2386).
• FEAT(android): add hint text parameters to CardFormField (#2296).
• FEAT: web language (#2267).

2026-06-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v8.0.0

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>

• FEAT: expose Stripe Connect deep link infrastructure to Dart (#2388).
• FEAT: add createRadarSession to Dart API (#2386).

2026-04-10

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v7.6.0

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

Features:

• Sync with Stripe React Native 0.61.0

2026-03-09

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v12.4.0
• flutter_stripe - v12.3.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v12.3.1

Fixes

• #2347: Fix card details not complete for dangerously update card details
• #2350: Fix invalid methodcall on Android for cardfield

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.

• FIX: 2306 remove descendantsAreFocusable are focusable as it dismisses the keyboard when we do not want it (#2316).
• FEAT(android): add hint text parameters to CardFormField (#2296).
• FEAT: web language (#2267)".

2026-02-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v7.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

• FIX: change initCustomerSheet return type to Future<void> (#2292).
• FIX(ios): improve URL callback handling for Link payment method (#2290).
• FIX(android): keyboard not appearing on first tap for CardField (#2291).
• FIX: add meta import for @internal annotation (#2269).
• FEAT: web language (#2267)".
• FEAT: web language (#2267).

2026-01-22

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v7.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

2025-11-15

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v7.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

• FIX: add new proguard rules to prevent release build from building (#2213).

2025-10-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v7.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

• FIX: add missing param to method channel (#2181).

2025-08-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v7.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

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

2025-01-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v6.4.0

Features

• Swift package manager support
• Implemented Address sheet widget
• Add P24 support on Stripe web

Fixes

• Compliance with latest Dart analyzer
• Prevent focus loop in Payment element for the web

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

2024-10-08

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v11.2.0
• flutter_stripe - v11.1.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v11.1.1

Features

• Add basic support for Expresscheckout on the web

Fixes

• Export elementappearance and element theme

• FIX: #1912 wallet parsing.

2024-09-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v6.1.0

• :wq

2024-09-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_ios - v11.1.0
• flutter_stripe - v11.0.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v11.0.1

• Sync with Stripe 0.38.6.
• Minor fixes and improvements.

• aaa

2024-07-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v6.0.0

Breaking changes

• Add support for intentmode setupMode. If you used IntentMode before change it to IntentMode.paymentMode instead.
• This library now only supports Dart sdk 3.0.0 for mobile and Dart sdk 3.3.0 for web and higher.

Features

• Sync with Stripe 0.38.3.

Fixes

• #1729 parse unknown error.
• #1837 fix for deferred payment methods.
• #1630 handle next action setup for ios.

Features

• Sync with Stripe 0.38.0:
  • Adds support for paymentMethodOrder in PaymentSheet, which provides client side sorting of payment methods. Fixes
• Fix: Apply dynamic Stripe account ID to confirmPayment method in WebStripe (#1798)
• Update models and bugfixes for flutter_stripe_web

• Fix #1639 cashapp payments

2024-03-07

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v10.1.1
• flutter_stripe - v10.1.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v10.1.1

Fixes

• #1670 Fix issue when not providing preferredNetworks on CardField or CardForm

• aa

• BREAKING BREAKING: rename ApplePayShippingContact to Platformpayshipping contact.

2024-03-02

Changes

Packages with breaking changes:

• flutter_stripe_web - v5.1.0

Packages with other changes:

• There are no other changes in this release.

Features

• #1122 Add google pay and apple pay for web
• Sync with Stripe 0.37.0
• #1606 Enable tap to pay

Fixes

• #1637 Cash app pay causes crash on web.
• #1608 prevent paymentintent crash.
• #1465 unknow result.
• #1512 add latest charge field to payment intent (Web only).

• BREAKING BREAKING: rename ApplePayShippingContact to Platformpayshipping contact.

2023-12-19

Changes

Packages with breaking changes:

• flutter_stripe_web - v5.0.0

Packages with other changes:

• There are no other changes in this release.

Breaking changes Rename ApplePayShippingContact to PlatformpayshippingContact.

Fixes

• #1465 Handle nullable result coming from Stripe sdk.
• #1512 add latest charge field to payment intent (Web only).
• #1522 add bankidentifiercode to ideal paymentdata.
• #1560 fix payment sheet crash when pressing back button.

• aaa

• FIX: #1409 send usesDeprecatedTokenFlow to stripe platform (#1410).

2023-11-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v4.6.0

Sync with Stripe React Native v0.34 and v0.35:

Features

• Added new presentationStyle options for CustomerSheet and AddressSheet.
• Support PlatformPayButton's appearance and borderRadius props on Android.
• PaymentSheet now supports Swish for PaymentIntents in private beta.
• PaymentSheet now supports saved payment method support for SEPA family payment methods.
• Added support for Flutter 3.16 and AGP 8

Fixes #1459 allow image to be null (#1466). #1409 send usesDeprecatedTokenFlow to stripe platform (#1410).

• aa

2023-09-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v9.4.0
• flutter_stripe - v9.3.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v9.3.1

Breaking changes

• Removed deprecated methods isApplePaySupported, checkApplePaySupport, presentApplePay, confirmApplePayPayment.

Features

• Added support for deffered payments in the payment sheet for more info see docs.
• Sync with Stripe 0.29.0 and 0.30.0.

Fixes

• Fixed #1376 focus issue on iOS.

• a

• FIX: #1233 increase android cardform height to display image (#1254).

• FEAT: add retrieveSetupIntent (#1302).

• FEAT: release versions (#1283).

• FEAT: release 9.2.1 (#1262).

2023-07-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_stripe_web - v4.3.0

Features

• Add method for retrieve setupintent.

Fixes

• Calling confirm payment without params won't crash #1246
• Fix inproper calling of cashapp payment method. #1313
• Sync with Stripe 0.28.0.

Fixes

• Updates json_annotation version requirement

Fixes

• Move amount value to GooglePayPaymentMethodParams #1255
• iOS: Apple Pay updatePlatformSheet now pass the errors #1230
• iOS: Fixes styling parameter for ApplePayButton #1231
• Android: Fixes bug that to display image in card form #1254
• Sync with Stripe 0.27.1.

Features

• Add BillingDetailsCollectionConfiguration to payment sheet for collecting addresses.
• Sync with Stripe 0.27.

Fixes

• Make project compatible with Android gradle plugin 8.0.
• New google pay button assets in order to comply with Google's new branding guidelines.
• #1219 use correct value for enum PaymentConfirmationRedirect.ifRequired.
• Add setting to render the cardfield using the standard AndroidView instead as alternative to the default ExpensiveAndroid view.

This release is based on version 0.25.0 of Stripe React Native:

Breaking Changes

• Renamed the paymentSummaryItems field in initPaymentSheet()'s applePay params to cartItems.

Features

• Added the supportsTapToPay option to canAddCardToWallet. reference
• Added the setOrderTracking property to the PlatformPayButton component and the initPaymentSheet method. Use this callback for setting the order details to give users the ability to track and manage their purchases in Wallet. To learn more about order tracking, see Apple’s Wallet Orders documentation. reference
• Added the buttonType field to initPaymentSheet()'s applePay params. Use this to set the text displayed by the call to action button in the Apple Pay sheet.reference
• Added the request field to initPaymentSheet()'s, confirmPlatformPayPayment()'s, and confirmPlatformPaySetupIntent's applePay params. Use this to support different types of payment requests, like RecurringPaymentRequest, AutomaticReloadPaymentRequest, and MultiMerchantRequest.reference
• Added an options argument to presentPaymentSheet which includes a timeout property. reference
• Added the hasPairedAppleWatch option to canAddCardToWallet. reference
• Added new functions and a new component to streamline integrating with Apple and Google Pay and add more feature support. See the Migrating to Platform Pay guide for more details. The old Apple and Google Pay APIs are marked as deprecated and will be removed in a future release, but are still supported in this version.

Fixes

• Fixed an issue on iOS where canAddCardToWallet would always return a details.status of UNSUPPORTED_DEVICE on iPads. reference
• Fixed an issue on iOS where canAddCardToWallet would always return a {canAddCard: false} if the card in question had been provsioned on the current device, but had not yet been provisioned on a paired Watch. ref
• Fixed an issue on iOS where the deprecated onDidSetShippingMethod & onDidSetShippingContact events wouldn't be triggered if you were using the useApplePay hook without using the ApplePayButton component. ref
• Fixed an issue on Android where canAddCardToWallet could result in a null pointer exception on devices without NFC compatibility. ref
• Fixes a build failure on Android when using stripe-android v20.19.2. ref
• Fixed a bug on Android where canAddCardToWallet wouldn't correctly return the details.token object. ref
• Fixed an issue with confirmPlatformPaySetupIntent on iOS. ref
• Fixed types so that Klarna accepts the shippingDetails property. ref
• Both PaymentIntent.Result and SetupIntent.Result types now include a paymentMethod field. This replaces the paymentMethodId field, which will be removed in a later release. ref
• Fixed an issue with createPlatformPayPaymentMethod on iOS where a "Canceled" error could be returned in production. ref
• Fixed an issue where the PlatformPayButton with type={PlatformPay.ButtonType.GooglePayMark} would be unclickable. ref
• Fixed an issue on Android where CardField would render without the necessary padding. 48debb2
• Fixed an issue on iOS where providing a null value to certain method parameters would result in a crash. ref
• Fixed the ShippingMethod type to contain the isPending field instead of a type field (which previously was never correct). This reflects the inputs accepted. ref
• Fixed the ShippingMethod type to contain the startDate and endDate keys, if applicable. ref
• Fixed instances of the "duplicate registered views" error. ref
• Fixed extra margin that was being added to <CardForm /> on Android. ref
• Fixed an issue where builds would error with the message 'const' enums are not supported. see commit
• Fixed an issue where the canAddCardToWallet method would sometimes wrongly return false with a details.status of MISSING_CONFIGURATION in production builds. ref
• Fixed an issue on Android where, for certain countries, the postal code would not be enabled but would still be required. ref
• Fixed an issue on iOS where canAddCardToWallet would return false if the card had already been provisioned on a paired device like an Apple Watch, but had not yet been provisioned on the current device, and would also return false if the card had been provisioned on the current device, but not on a paired Apple Watch. ref

Note This version pulls in a new version of stripe-android that now requires v1.8.0 of the Kotlin Gradle plugin. Refer to this issue for a limited workaround.

• FIX: return sealed CollectBankAccountResult for bank account collection (#2395).
• FIX(web): unique view type per PaymentElement instance to fix infinite spinner on remount (#2368) (#2372).
• FIX: correct CardField web color rendering and apply all style colors (#2365).
• FIX: remove giropay payment method references from codebase (#2309).
• FIX: change initCustomerSheet return type to Future<void> (#2292).
• FIX: Remove empty bank parameter from iDEAL payments to comply with Stripe API changes (#2186).
• FEAT: expose Stripe Connect deep link infrastructure to Dart (#2388).
• FEAT: add createRadarSession to Dart API (#2386).
• FEAT: web language (#2267).

2026-06-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v13.0.0
• flutter_stripe - v12.6.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v12.6.1

• FIX: Remove empty bank parameter from iDEAL payments to comply with Stripe API changes (#2186).

2025-08-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_js - v7.0.0
• flutter_stripe_web - v6.5.2

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe_web - v6.5.2

Breaking Changes

• This library now supports iOS 13 and up, due to stripe-ios increasing the deployment target

Features

• Added Link support in Payment Sheet.

• Added the resetPaymentSheetCustomer method to clear persisted authentication state in the PaymentSheet.

• Added preferredNetwork and availableNetworks fields to the CardResult payment method.

• Added support for custom fonts to CardForm and CardView on Android.

• Added support for customizing the call to action button label in Payment Sheet by providing the primaryButtonLabel property to initPaymentSheet().

• Fixes

• Several fixes by the Stripe sdk v.0.20.0.

• aa

• FIX: Apply dynamic Stripe account ID to confirmPayment method in WebStripe (#1798).

• FIX: wait html element load (#1730).

• FIX: [WEB]Issue of saving/not saving payment information for future. #1673 (#1674).

• FIX: Respect the font color for CardField on web platforms (#1658).

• FIX: invalid argument requires_capture on web (#1431).

• FIX: confirmation redirect and stripeAccountId (#1201).

• FIX: apple pay (#1202).

• FIX: timeout payment sheet (#1161).

• FIX: payment intent error in web (#1010).

• FIX: web_checkout (#973).

• FIX: implemented handleURLCallback method for iOS iDeal payment. (#939).

• FEAT: add retrieveSetupIntent (#1302).

• FEAT: release versions (#1283).

• FEAT: web fixes and features (#1270).

• FEAT: release 9.2.1 (#1262).

• FEAT: tokens for web (#1079).

• FEAT: stripe js (#1052).

• FEAT: update checkout (#582).

2024-07-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_js - v6.0.0
• flutter_stripe_web - v6.0.0-dev.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe_web - v6.0.0-dev.1

Breaking Changes

• Move PaymentMethodOptions out of PaymentMethodparams so interface is similar with Stripe sdk.

Before

await Stripe.instance.confirmPayment(
	paymentIntentClientSecret: clientSecret,
		data: PaymentMethodParams.card(
		  paymentMethodData: PaymentMethodData(
		    billingDetails: billingDetails,
		  ),
		  options: PaymentMethodOptions(
		  	setupFutureUsage: PaymentIntentsFutureUsage.OffSession : null,
		),
	),	
);

Now

await Stripe.instance.confirmPayment(
	paymentIntentClientSecret: clientSecret,
		data: PaymentMethodParams.card(
		  paymentMethodData: PaymentMethodData(
		    billingDetails: billingDetails,
		  ),
		),
		options: PaymentMethodOptions(
		  setupFutureUsage: PaymentIntentsFutureUsage.OffSession : null,
		),
);

• Deprecate support for Flutter 2 in order to use the new expensive Androidviews. This improves the overall experience on Android.

• aaa

• FIX: Respect the font color for CardField on web platforms (#1658).

• FIX: #1512 add latest charge field to payment intent (Web only).

• BREAKING BREAKING: rename ApplePayShippingContact to Platformpayshipping contact.

2024-03-02

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_js - v3.4.0
• flutter_stripe_web - v5.0.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe_web - v5.0.1

• Several fixes by the Stripe sdk v.0.19.0.
• Fix for #462, added handleURLCallback method for iOS to handle returnUrl when iDeal payment is successful. This will close the in-app webview of Safari.

• FIX: #1512 add latest charge field to payment intent (Web only).
• BREAKING BREAKING: rename ApplePayShippingContact to Platformpayshipping contact.

2023-12-19

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_ios - v10.0.0
• flutter_stripe - v9.6.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v9.6.1

Breaking changes

• Your compileSdkVersion (in android/build.gradle) now must be at least 32. Changing your compileSdkVersion does not change runtime behavior.

Features

• Added support for pay_dark and standard_dark to the GooglePayButton component. This allows you to display the dark Google Pay button.
• Added support for borderColor, borderRadius, and cursorColor to CardForm's cardStyle prop on iOS (already exists on Android).
• Added the collectBankAccountToken & collectFinancialConnectionsAccounts functions.
• confirmPayment can now be called with just a client secret (e.g. await confirmPayment("payment-intent-id")), in other words the payment method can be excluded. If the payment method is excluded, it is assumed by the SDK that you have attached the payment method on the server-side during payment intent creation.
• Payment Sheet now supports Link on iOS. #1086.

Other changes

• Several fixes by the Stripe sdk v.0.16.0.
• Several fixes by the Stripe sdk v.0.17.0.
• Several fixes by the Stripe sdk v.0.18.0.

** Breaking changes **

• Added support for iOS 15 paymentSummaryItems: PKDeferredPaymentSummaryItem and PKRecurringPaymentSummaryItem. Adding a summary item before was:

 ApplePayCartSummaryItem(
    label: 'Product Test',
    amount: '0.01',
);

Becomes

ApplePayCartSummaryItem.immediate(
  label: 'Product Test',
  amount: '0.01',
);

• Changed paymentsheet parameters to make it more clear which settings are used for Google Pay and Apple Pay. Changes: merchantCountryCode is now moved into both PaymentSheetApplePayand PaymentSheetGooglePay, currencyCode and testEnv is now part of the PaymentSheetGooglePay object.

• Added possibility to add ApplePayCartSummaryItem to the paymensheet.

Other changes

• Support for affirm payment method.
• Several fixes by the Stripe sdk v.0.15.0.

• aaa

• FIX: invalid argument requires_capture on web (#1431).

2023-11-29

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v9.6.0+1
• flutter_stripe - v9.6.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v9.6.1

• Added the canAddCardToWallet method.
• Several fixes by the Stripe sdk v.0.14.0.

• a

• FIX: PaymentConfirmationRedirect enum value (#1221).

• FIX: confirmation redirect and stripeAccountId (#1201).

• FEAT: release versions (#1283).

• FEAT: web fixes and features (#1270).

• FEAT: release 9.2.1 (#1262).

• FEAT: tokens for web (#1079).

• FEAT: stripe js (#1052).

2023-07-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_android - v9.3.0
• flutter_stripe - v9.2.3

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v9.2.3

• Added possibility to create a PII token.
• Support country code in Cardfield.
• Added default values to CardformField.
• Several fixes by the Stripe sdk v.0.13.0.

• Added styling parameters for the payment sheet.
• Better error logging for Google Pay.
• Fix #462 Not returning back when using in app browser.
• Fix bug that threw not implemented exception in the nextCardAction method when using 3d Secure.
• Make Flutter Stripe backwards compatible with Flutter v2.
• Fix #731 Styling for the Cardform field.
• Several fixes by the Stripe sdk v.0.10.0, v.0.11.0 and v.0.12.0 .

** Breaking change **

• handleCardAction is now called handleNextAction

** Breaking changes **

• Support for Flutter 3 and support Dart sdk 2.16 and higher.
• Only supports application running on Freezed v2.0.0 and higher
• Changed parameter structure for createPaymentMethod, confirmPayment, confirmSetupIntent in line with latest changes of the Stripe SDK. For example

 Stripe.instance.confirmPayment(
        clientSecret,
        PaymentMethodParams.ideal(
        	bankName:   'revolut',
        ),
      );

Becomes

 Stripe.instance.confirmPayment(
        clientSecret,
        PaymentMethodParams.ideal(
          paymentMethodData:
              PaymentMethodDataIdeal( 'revolut'),
        ),
      );

• Change styling parameter structure for Cardformfield in order to support more styling options.

Other changes

• Support for paypal (accessible in private beta on Stripe)
• Several fixes by the Stripe sdk v.0.8.0 and v.0.9.0

• BREAKING CHANGE: Mostly fixes and changes to types, but some method's now accept slightly different parameters:
  • Removed setUrlSchemeOnAndroid in favor of setReturnUrlSchemeOnAndroid. setReturnUrlSchemeOnAndroid functions exactly the same, this is just a rename.
  • Removed handleCardAction in favor of handleNextAction. handleNextAction functions exactly the same, this is just a rename.
• BREAKING: This library now supports iOS 12 and up, due to stripe-ios increasing the deployment target.
  • To upgrade your iOS deployment target to 12.0, you can either do so in Xcode under your Build Settings, or by modifying IPHONEOS_DEPLOYMENT_TARGET in your project.pbxproj directly. You will also need to update your Podfile to target :ios, '12.0'.
• Feat: add card ID and bankAccount ID to token response
• Feat: Add support for ACHv2
• Feat: Add support for setting a card's currency when creating a Token
• Feat: Added support for placeholderColor, textErrorColor , borderColor, borderRadius, and borderWidth for AuBECSDebitForm on iOS
• Several fixes by the Stripe sdk v0.7.0
• Updated freezed dependency to allow 2.x

• Add support for paying with Klarna.
• Several fixes by the Stripe sdk v0.4.0
• Fix #632 added return_url to payment sheet. Needed for Ideal payments
• Fix #185 make sure that address will be added to the payment intent.

• add isGooglePaySupported method
• reenable support for legacy bank account token creation
• Several fixes by the Stripe sdk v0.3.0

• Add currency code to the Paymentsheet
• Add validation state to cardfield
• Deprecated CreatetokenParams use CreateTokenParams.card instead
• Several fixes by the Stripe sdk v0.2.4
• Fix #416 ocassional crash on Android on the Paymentsheetfragment

• Improved logging for Android initialization
• Fix #494 Make ShippingDetails parameters nullable
• Fix #499 Update cardnumber when using dangerouslyGetFullCardDetails

** Enabled web support (Beta) **

Other changes

• Integrated native form to collect Aubecs payment data
• Add Button Border-Radius for Apple Pay Button #448
• Update dependencies to comply to new Flutter and dart release
• Add billing name for future payments #441

• New params primaryButtonColor, billingDetails and allowsDelayedPaymentMethods for initPaymentSheet
• Fixed iOS focus issues #408

• Add support for Flutter 3.16

• FIX: upgrade to android agp 8 (#1479).

• FIX: web_checkout (#973).

• FEAT: release 9.2.1 (#1262).

• FEAT: tokens for web (#1079).

• DOCS: fix typo "succesfullly" in checkout.dart (#1013).

• DOCS: update checkout readme.

2023-11-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• stripe_ios - v9.6.0
• flutter_stripe - v9.5.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_stripe - v9.5.1

** First stable release **

** Breaking changes **

• Temporarily disable Wechat

Other changes

• add openApplePaySetup method
• several fixes by Stripe SDK (v0.2.1, v0.2.2)
• Focus issues on Android #14 are fixed

** BREAKING CHANGES **

• Deprecate redundant parameters for payment sheet.

Other changes

• Add new multiline card form.
• Add Stripe Google pay integration.
• Add WeChat payment method.
• Improved example app.

** Breaking changes **

• Rename confirmPaymentMethod to confirmPayment accordingly with the change in the native SDK

Other changes

• Sync with latest Stripe sdk.
• Add StripeException that encapsulates finer grained and localized error messaging coming from the Stripe SDK.
• Add CardEditController to handle the clear, focus, blur methods from the cardfield.
• Implement FontFamily on iOS.
• Add dangerouslyUpdateCardDetails to allow custom UIs. (Please be sure to understand the severe implications of this approach here).

** Breaking changes **

• Make paymentIntentClientSecret nullable for SetupPaymentSheetParameters and add setupIntentClientSecret.
• Rename ThreeDSecureSubmitButtonThemeData to ThreeDSecureButtonThemeData in order to facilitate for a generic class to customise 3D secure buttons.

Other changes

• Sync with latest Stripe sdk.
• Fix #147 add urlscheme to initialise method. Thanks to @dariuspo.
• Improved focus behavior on Cardfield.
• Add dangerouslyGetFullCardDetails and FontFamily to cardfield.
• Better debug logging in case something goes wrong.

• Fix #68 Android leaks and activity for result propagation
• Add FPX payment method
• Fix #87 can't create payment method iOS
• Expose apple pay styling options to API

• Fix Colors in CardField #64

• Fix: CardField textColor and enablePostalCode params