Add EmbeddedPaymentElement support for Flutter #2239

programmeraditya · 2025-10-13T21:16:43Z

What This Adds

Implements the new Embedded Payment Element from Stripe's mobile SDKs. Lets you embed the payment UI inline instead of using modal sheets.

Changes

New EmbeddedPaymentElement widget with iOS/Android platform views
EmbeddedPaymentElementController to call confirm() and clearPaymentOption()
Callbacks for payment selection, height changes, loading failures, form sheet completion, and immediate actions
Works with both payment and setup intents

Status

iOS ✅

Works. Platform view renders properly, confirm() returns the result, all callbacks fire. Tested with cards, Apple Pay, Link, PayPal, Revolut Pay.

Android ✅

Works. Platform view renders properly, confirm() returns the result, all callbacks fire. Tested with cards, Google Pay, Link, PayPal, Revolut Pay.

Quick Example

EmbeddedPaymentElement(
  intentConfiguration: IntentConfiguration(
    mode: IntentMode.paymentMode(amount: 5000, currencyCode: 'USD'),
    confirmHandler: (paymentMethod, shouldSave, callback) async {
      // Get client secret from your backend
      callback(IntentCreationCallbackParams(clientSecret: secret));
    },
  ),
  configuration: SetupPaymentSheetParameters(
    merchantDisplayName: 'My Store',
    customerId: customerId,
    customerEphemeralKeySecret: ephemeralKey,
  ),
  controller: controller,
  onPaymentOptionChanged: (option) => print('Payment method selected'),
)

React Native docs: https://docs.stripe.com/payments/mobile/accept-payment-embedded?platform=react-native

…irm() Changes confirm() method to return payment result instead of void, allowing Flutter apps to detect payment failures without relying solely on callbacks. - Modified EmbeddedPaymentElementController.confirm() return type - Updated embedded_payment_element.dart to capture method channel result - iOS implementation complete with result dictionary - Android implementation incomplete (help wanted) Fixes detection of payment failures (insufficient funds, card declined, etc.) Follows React Native SDK pattern where confirm() returns result status.

- Added onConfirmResult callback property to EmbeddedPaymentElementView - Modified resultCallback to invoke Flutter method channel callback - Updated platform view to set callback before calling confirm() - Callback returns Map with status and optional error message - Matches iOS implementation for consistent cross-platform behavior

…errors - Removed updateConfiguration and updateIntentConfiguration from method channel handler - These methods were unused and causing Dynamic type mismatch compile errors - Configuration is set once during initialization and doesn't need updates

- Added Jetpack Compose BOM and core dependencies (ui, foundation, runtime) - Updated Kotlin from 1.8.0 to 1.9.0 for Compose compatibility - Added Compose build features and compiler extension version - Fixes 'Unresolved reference' errors for Box, requiredHeight, foundation - Required for EmbeddedPaymentElement which uses Compose UI

- Read kotlinVersion from rootProject.ext with fallback - Check kotlinMajor version to conditionally load compose plugin - Fixes Kotlin 2.0 compose compiler requirement

- Cast entry.value to Dynamic for ViewManager methods - Change array.size() to array.size (property not function) - Fixes Kotlin 2.0 compilation errors

Android would crash when intentConfiguration was provided. Fixed by updating how payment data is passed to native code.

Fixed compilation errors in Bundle handling and upgraded Gradle to 8.11.1 to match React Native SDK.

Bundle.getBundle() throws ClassCastException when value is a string. Wrapped in try-catch to mirror React Native's ReadableMap behavior.

Changed from try-catch to type check with Bundle.get() to avoid Android logging warnings when color values are strings.

Height changes were sent to wrong channel. Widget now receives events directly from platform view instead of global emitter. Added callbacks for all events: - onHeightChanged - onPaymentOptionChanged - onLoadingFailed - onRowSelectionImmediateAction - onFormSheetConfirmComplete Matches iOS behavior.

jonasbark · 2025-10-17T08:58:50Z

It looks really good upon first inspection, thanks for all the effort!

I was hesitant to add it due to the Compose requirement, but I think it's a transitive dependency of stripe-android anyway.

Will have a closer look soon

remonh87

Checked it from the dart side and looks good to me only I think dart format did create a bigger change than needed

thank you for this great contribution. I will wait for @jonasbark feedback before integrating it

remonh87 · 2025-10-19T15:47:35Z

packages/stripe/lib/src/model/apple_pay_button.dart

-  black,
-  automatic,
-}
+enum ApplePayButtonStyle { white, whiteOutline, black, automatic }


What command did you run for dart format?

Looks like quite some changes were made due formatter

…to IntentConfiguration

tara-pogancev · 2025-10-22T10:12:57Z

packages/stripe_platform_interface/lib/src/method_channel_stripe.dart

+  @override
+  void setConfirmHandler(ConfirmHandler? handler) {
+    _confirmHandler = handler;
+  }
+


When opening the code locally, I get an error for WebStripe class:
"Missing concrete implementation of 'abstract class StripePlatform extends PlatformInterface. setConfirmHandler'."

I fixed it via quick fix, but should this change for web package be in the PR as well?

programmeraditya · 2025-11-24T21:50:22Z

Hello @remonh87
Is there any update on when this PR can be merged?

remonh87 · 2025-11-25T11:42:56Z

@jonasbark can you take a look at it as well?

programmeraditya mentioned this pull request Oct 13, 2025

Add support for Embedded Payment Element #2236

Open

programmeraditya added 3 commits October 14, 2025 03:22

programmeraditya force-pushed the sync branch from 194f414 to b161474 Compare October 14, 2025 06:09

feat(android): mirror React Native SDK Kotlin 2.0 detection

f9d132c

- Read kotlinVersion from rootProject.ext with fallback - Check kotlinMajor version to conditionally load compose plugin - Fixes Kotlin 2.0 compose compiler requirement

programmeraditya force-pushed the sync branch from b161474 to f9d132c Compare October 14, 2025 06:14

programmeraditya added 6 commits October 14, 2025 12:06

fix(android): fix Kotlin type mismatches and array size calls

496ce52

- Cast entry.value to Dynamic for ViewManager methods - Change array.size() to array.size (property not function) - Fixes Kotlin 2.0 compilation errors

Fix Android crash when using embedded payment element

76b86e4

Android would crash when intentConfiguration was provided. Fixed by updating how payment data is passed to native code.

Fix Android compilation errors and upgrade Gradle

2213418

Fixed compilation errors in Bundle handling and upgraded Gradle to 8.11.1 to match React Native SDK.

Fix Android color parsing when values are strings

f8f2bf2

Bundle.getBundle() throws ClassCastException when value is a string. Wrapped in try-catch to mirror React Native's ReadableMap behavior.

Fix Bundle type check to avoid ClassCastException warnings

8784de2

Changed from try-catch to type check with Bundle.get() to avoid Android logging warnings when color values are strings.

programmeraditya force-pushed the sync branch from 06e9f2f to 145e5d4 Compare October 14, 2025 08:19

fix: fix height, component overflow

f32ddb1

remonh87 approved these changes Oct 19, 2025

View reviewed changes

programmeraditya added 3 commits October 20, 2025 15:53

chore: add paymentMethodConfigurationId Payment Method Configuration …

9ef8006

…to IntentConfiguration

fix: avoid embedded element height reentry on iOS simulator

2b2bca7

fix: avoid embedded element height reentry on iOS simulator

1d52b72

tara-pogancev reviewed Oct 22, 2025

View reviewed changes

programmeraditya added 2 commits November 15, 2025 02:38

chore: improve error handling and return data

28d16d8

fix: nonobjc error

6fea095

jonasbark approved these changes Nov 25, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Add EmbeddedPaymentElement support for Flutter #2239

Add EmbeddedPaymentElement support for Flutter #2239

Uh oh!

programmeraditya commented Oct 13, 2025 •

edited

Loading

Uh oh!

jonasbark commented Oct 17, 2025 •

edited

Loading

Uh oh!

remonh87 left a comment •

edited

Loading

Uh oh!

remonh87 Oct 19, 2025

Uh oh!

tara-pogancev Oct 22, 2025 •

edited

Loading

Uh oh!

programmeraditya commented Nov 24, 2025 •

edited

Loading

Uh oh!

remonh87 commented Nov 25, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Add EmbeddedPaymentElement support for Flutter #2239

Are you sure you want to change the base?

Add EmbeddedPaymentElement support for Flutter #2239

Uh oh!

Conversation

programmeraditya commented Oct 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What This Adds

Changes

Status

iOS ✅

Android ✅

Quick Example

Uh oh!

jonasbark commented Oct 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

remonh87 left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

remonh87 Oct 19, 2025

Choose a reason for hiding this comment

Uh oh!

tara-pogancev Oct 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

programmeraditya commented Nov 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

remonh87 commented Nov 25, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

programmeraditya commented Oct 13, 2025 •

edited

Loading

jonasbark commented Oct 17, 2025 •

edited

Loading

remonh87 left a comment •

edited

Loading

tara-pogancev Oct 22, 2025 •

edited

Loading

programmeraditya commented Nov 24, 2025 •

edited

Loading