@stripe/stripe-react-native 0.65.0 → 0.65.1

package/README.md

@@ -75,8 +75,8 @@ to your `app.json` file, where `merchantIdentifier` is the Apple merchant ID obt
 
 #### Android
 
-- Android 5.0 (API level 21) and above
-  - Your `compileSdkVersion` must be `34`. See [this issue](https://github.com/stripe/stripe-react-native/issues/812) for potential workarounds.
+- Android 6.0 (API level 23) and above
+  - Your `compileSdkVersion` must be `36` or higher.
 - Android gradle plugin 4.x and above
 - Kotlin 2.x and above. See [this issue](https://github.com/stripe/stripe-react-native/issues/1924#issuecomment-2867227374) for how to update the Kotlin version when using react-native 0.77 and below or Expo SDK 52.
 

package/android/detekt/detekt-baseline.xml

@@ -46,71 +46,6 @@
     <ID>LongMethod:PaymentSheetAppearanceTest.kt:PaymentSheetAppearanceTest$@Test fun testPartialAppearanceConfiguration</ID>
     <ID>LongMethod:PaymentSheetManager.kt:PaymentSheetManager$fun configure</ID>
     <ID>LongMethod:StripeSdkModule.kt:StripeSdkModule$@ReactMethod override fun confirmPlatformPay</ID>
-    <ID>MagicNumber:CardFieldView.kt:CardFieldView$20</ID>
-    <ID>MagicNumber:EmbeddedPaymentElementView.kt:EmbeddedPaymentElementView$100</ID>
-    <ID>MagicNumber:FinancialConnectionsSheetManager.kt:FinancialConnectionsSheetManager.Companion$1000.0</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$1000</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$1001</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$11</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$4</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$5</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$6</ID>
-    <ID>MagicNumber:GooglePayButtonView.kt:GooglePayButtonView$7</ID>
-    <ID>MagicNumber:Mappers.kt:1000</ID>
-    <ID>MagicNumber:Mappers.kt:3</ID>
-    <ID>MagicNumber:Mappers.kt:4</ID>
-    <ID>MagicNumber:Mappers.kt:5</ID>
-    <ID>MagicNumber:Mappers.kt:6</ID>
-    <ID>MagicNumber:Mappers.kt:7</ID>
-    <ID>MagicNumber:Mappers.kt:8</ID>
-    <ID>MagicNumber:NavigationBarView.kt:NavigationBarView$16</ID>
-    <ID>MagicNumber:NavigationBarView.kt:NavigationBarView$17f</ID>
-    <ID>MagicNumber:NavigationBarView.kt:NavigationBarView$4f</ID>
-    <ID>MagicNumber:NavigationBarView.kt:NavigationBarView$56</ID>
-    <ID>MagicNumber:PaymentMethodMessagingElementConfig.kt:16.0</ID>
-    <ID>MagicNumber:PaymentMethodMessagingElementConfig.kt:6</ID>
-    <ID>MagicNumber:PaymentMethodMessagingElementConfig.kt:8</ID>
-    <ID>MagicNumber:PaymentOptionDisplayDataMapper.kt:0xFFFFFF</ID>
-    <ID>MagicNumber:PaymentOptionDisplayDataMapper.kt:16f</ID>
-    <ID>MagicNumber:PaymentOptionDisplayDataMapper.kt:5_000L</ID>
-    <ID>MagicNumber:PaymentSheetAppearance.kt:6</ID>
-    <ID>MagicNumber:PaymentSheetAppearance.kt:8</ID>
-    <ID>MagicNumber:PaymentSheetManager.kt:100</ID>
-    <ID>MagicNumber:PaymentSheetManager.kt:PaymentSheetManager$100</ID>
-    <ID>MagicNumber:StripeSdkModule.kt:StripeSdkModule$3000</ID>
-    <ID>MaxLineLength:AddToWalletButtonManager.kt:AddToWalletButtonManager$override fun createViewInstance: AddToWalletButtonView</ID>
-    <ID>MaxLineLength:AddressLauncherManager.kt:AddressLauncherManager$"No publishable key set. Stripe has not been initialized. Initialize Stripe in your app with the StripeProvider component or the initStripe method."</ID>
-    <ID>MaxLineLength:AddressSheetView.kt:AddressSheetView.Companion$internal</ID>
-    <ID>MaxLineLength:AuBECSDebitFormView.kt:AuBECSDebitFormView$UIManagerHelper.getEventDispatcherForReactTag(context, id)?.dispatchEvent(FormCompleteEvent(context.surfaceId, id, formDetails))</ID>
-    <ID>MaxLineLength:AuBECSDebitFormViewManager.kt:AuBECSDebitFormViewManager$override fun createViewInstance: AuBECSDebitFormView</ID>
-    <ID>MaxLineLength:CustomerSheetManager.kt:CustomerSheetManager.Companion$internal</ID>
-    <ID>MaxLineLength:EmbeddedPaymentElementView.kt:EmbeddedPaymentElementView$"Tried to call confirmHandler, but no callback was found. Please file an issue: https://github.com/stripe/stripe-react-native/issues"</ID>
-    <ID>MaxLineLength:EmbeddedPaymentElementView.kt:EmbeddedPaymentElementView$"Tried to call confirmationTokenConfirmHandler, but no callback was found. Please file an issue: https://github.com/stripe/stripe-react-native/issues"</ID>
-    <ID>MaxLineLength:Errors.kt:"Stripe has not been initialized. Initialize Stripe in your app with the StripeProvider component or the initStripe method."</ID>
-    <ID>MaxLineLength:Errors.kt:internal fun createCanceledError: WritableMap</ID>
-    <ID>MaxLineLength:Extensions.kt:)</ID>
-    <ID>MaxLineLength:FinancialConnectionsSheetManager.kt:FinancialConnectionsSheetManager.Companion$private</ID>
-    <ID>MaxLineLength:GooglePayButtonManager.kt:GooglePayButtonManager$override fun createViewInstance: GooglePayButtonView</ID>
-    <ID>MaxLineLength:GooglePayLauncherManager.kt:GooglePayLauncherManager$"Google Pay is not available on this device. You can use isPlatformPaySupported to preemptively check for Google Pay support."</ID>
-    <ID>MaxLineLength:Mappers.kt:internal</ID>
-    <ID>MaxLineLength:Mappers.kt:val disableBillingDetailCollection = customPaymentMethodMap.getBooleanOr("disableBillingDetailCollection", false)</ID>
-    <ID>MaxLineLength:NavigationBarView.kt:NavigationBarView$drawable?.setColorFilter(android.graphics.BlendModeColorFilter(Color.BLACK, android.graphics.BlendMode.SRC_IN))</ID>
-    <ID>MaxLineLength:PaymentElementConfig.kt:internal</ID>
-    <ID>MaxLineLength:PaymentLauncherManager.kt:PaymentLauncherManager$"Invalid parameters provided to PaymentLauncher. Ensure that you are providing the correct client secret and setup params (if necessary)."</ID>
-    <ID>MaxLineLength:PaymentMethodCreateParamsFactory.kt:PaymentMethodCreateParamsFactory$private</ID>
-    <ID>MaxLineLength:PaymentMethodMessagingElementViewManager.kt:PaymentMethodMessagingElementViewManager$override fun createViewInstance: PaymentMethodMessagingElementView</ID>
-    <ID>MaxLineLength:PaymentOptionDisplayDataMapperTest.kt:PaymentOptionDisplayDataMapperTest$"By continuing, you agree to &lt;b>&lt;font color=\"#0000FF\">&lt;u>&lt;a href=\"https://stripe.com/terms\">Terms&lt;/a>&lt;/u>&lt;/font>&lt;/b> and &lt;i>&lt;font color=\"#FF0000\">&lt;a href=\"https://stripe.com/privacy\">Privacy&lt;/a>&lt;/font>&lt;/i>. Important details are &lt;span style=\"background-color: #FFFF00;\">highlighted&lt;/span>."</ID>
-    <ID>MaxLineLength:PaymentOptionDisplayDataMapperTest.kt:PaymentOptionDisplayDataMapperTest$"By continuing, you agree to our &lt;a href=\"https://stripe.com/privacy\">Privacy Policy&lt;/a> and &lt;a href=\"https://stripe.com/terms\">Terms of Service&lt;/a>."</ID>
-    <ID>MaxLineLength:PaymentOptionDisplayDataMapperTest.kt:PaymentOptionDisplayDataMapperTest$"Check &lt;b>&lt;a href=\"https://stripe.com\">Stripe&lt;/a>&lt;/b> and &lt;i>&lt;font color=\"#00FF00\">&lt;a href=\"https://github.com\">GitHub&lt;/a>&lt;/font>&lt;/i>"</ID>
-    <ID>MaxLineLength:PaymentOptionDisplayDataMapperTest.kt:PaymentOptionDisplayDataMapperTest$"Visit our &lt;b>&lt;font color=\"#0000FF\">&lt;a href=\"https://stripe.com/privacy\">Privacy Policy&lt;/a>&lt;/font>&lt;/b> for details"</ID>
-    <ID>MaxLineLength:PaymentSheetAppearance.kt:"$fontErrorPrefix appearance.font.$key should only contain lowercase alphanumeric characters on Android, but received '$fontFileName'. This value must match the filename in android/app/src/main/res/font"</ID>
-    <ID>MaxLineLength:PaymentSheetAppearance.kt:System.err.println("WARN: Unsupported embedded payment element row style received: $styleString. Falling back to default.")</ID>
-    <ID>MaxLineLength:PaymentSheetManager.kt:internal</ID>
-    <ID>MaxLineLength:PostalCodeUtilities.kt:PostalCodeUtilities.Companion$internal fun isValidGlobalPostalCodeCharacter: Boolean</ID>
-    <ID>MaxLineLength:ReactNativeCustomerAdapter.kt:ReactNativeCustomerAdapter$override suspend</ID>
-    <ID>MaxLineLength:ReactNativeCustomerSessionProvider.kt:ReactNativeCustomerSessionProvider$override suspend fun intentConfiguration: Result&lt;CustomerSheet.IntentConfiguration></ID>
-    <ID>MaxLineLength:StripeSdkModule.kt:StripeSdkModule$composeCompatView</ID>
-    <ID>MaxLineLength:StripeSdkModule.kt:StripeSdkModule$reactApplicationContext.currentActivity?.application?.unregisterActivityLifecycleCallbacks(activityLifecycleCallbacks)</ID>
     <ID>RethrowCaughtException:PaymentMethodCreateParamsFactory.kt:PaymentMethodCreateParamsFactory$throw error</ID>
     <ID>SwallowedException:StripeSdkModule.kt:StripeSdkModule$e: Exception</ID>
     <ID>ThrowsCount:PaymentSheetAppearance.kt:@Throws(PaymentSheetAppearanceException::class) internal fun getFontResId: Int?</ID>
@@ -125,7 +60,7 @@
     <ID>TooGenericExceptionCaught:StripeSdkModule.kt:StripeSdkModule$e: Exception</ID>
     <ID>TooGenericExceptionCaught:TapAndPayProxy.kt:TapAndPayProxy$e: Exception</ID>
     <ID>TooGenericExceptionThrown:EmbeddedPaymentElementViewManager.kt:EmbeddedPaymentElementViewManager$throw Error()</ID>
-    <ID>TooGenericExceptionThrown:PaymentLauncherManager.kt:PaymentLauncherManager$throw Exception( "Invalid parameters provided to PaymentLauncher. Ensure that you are providing the correct client secret and setup params (if necessary).", )</ID>
+    <ID>TooGenericExceptionThrown:PaymentLauncherManager.kt:PaymentLauncherManager$throw Exception( "Invalid parameters provided to PaymentLauncher. Ensure that you are providing the correct client " + "secret and setup params (if necessary).", )</ID>
     <ID>TooGenericExceptionThrown:PaymentLauncherManager.kt:PaymentLauncherManager$throw Exception("Failed to create Payment Launcher. No client secret provided.")</ID>
     <ID>TooGenericExceptionThrown:PaymentMethodCreateParamsFactory.kt:PaymentMethodCreateParamsFactory$throw Exception("This paymentMethodType is not supported yet")</ID>
     <ID>TooManyFunctions:AddToWalletButtonManager.kt:AddToWalletButtonManager : SimpleViewManagerAddToWalletButtonManagerInterface</ID>

package/android/gradle.properties

@@ -1,6 +1,6 @@
 StripeSdk_kotlinVersion=2.2.21
-StripeSdk_compileSdkVersion=30
-StripeSdk_targetSdkVersion=28
-StripeSdk_minSdkVersion=21
+StripeSdk_compileSdkVersion=36
+StripeSdk_targetSdkVersion=36
+StripeSdk_minSdkVersion=23
 # Keep StripeSdk_stripeVersion in sync with https://github.com/stripe/stripe-identity-react-native/blob/main/android/gradle.properties
 StripeSdk_stripeVersion=23.6.+

package/android/src/main/java/com/reactnativestripesdk/AuBECSDebitFormView.kt

@@ -109,7 +109,9 @@ class AuBECSDebitFormView(
         "email" to billingDetails["email"] as String,
       )
 
-    UIManagerHelper.getEventDispatcherForReactTag(context, id)?.dispatchEvent(FormCompleteEvent(context.surfaceId, id, formDetails))
+    UIManagerHelper.getEventDispatcherForReactTag(context, id)?.dispatchEvent(
+      FormCompleteEvent(context.surfaceId, id, formDetails)
+    )
   }
 
   private fun setListeners() {

package/android/src/main/java/com/reactnativestripesdk/AuBECSDebitFormViewManager.kt

@@ -41,7 +41,8 @@ class AuBECSDebitFormViewManager :
     view.setFormStyle(style.asMapOrNull())
   }
 
-  override fun createViewInstance(reactContext: ThemedReactContext): AuBECSDebitFormView = AuBECSDebitFormView(reactContext)
+  override fun createViewInstance(reactContext: ThemedReactContext): AuBECSDebitFormView =
+    AuBECSDebitFormView(reactContext)
 
   companion object {
     const val REACT_CLASS = "AuBECSDebitForm"

package/android/src/main/java/com/reactnativestripesdk/CardFieldView.kt

@@ -169,7 +169,7 @@ class CardFieldView(
       }
     }
 
-    mCardWidget.setPadding(20, 0, 20, 0)
+    mCardWidget.setPadding(CARD_WIDGET_HORIZONTAL_PADDING, 0, CARD_WIDGET_HORIZONTAL_PADDING, 0)
     mCardWidget.background =
       MaterialShapeDrawable(
         ShapeAppearanceModel()
@@ -530,4 +530,8 @@ class CardFieldView(
       )
       layout(left, top, right, bottom)
     }
+
+  private companion object {
+    const val CARD_WIDGET_HORIZONTAL_PADDING = 20
+  }
 }

package/android/src/main/java/com/reactnativestripesdk/CurrencySelectorElementView.kt

@@ -0,0 +1,26 @@
+package com.reactnativestripesdk
+
+import android.annotation.SuppressLint
+import android.widget.FrameLayout
+import com.facebook.react.uimanager.ThemedReactContext
+
+/**
+ * Minimal stub so the JS-side `CurrencySelectorElement` codegen mapping
+ * resolves at app launch. The full Compose-based implementation that hosts
+ * `Checkout.CurrencySelectorContent()` lives on the feature branch and will
+ * replace this once that lands.
+ */
+@SuppressLint("ViewConstructor")
+class CurrencySelectorElementView(
+  context: ThemedReactContext,
+) : FrameLayout(context) {
+  @Suppress("UnusedParameter")
+  fun setSessionKey(value: String?) {
+    // no-op stub
+  }
+
+  @Suppress("UnusedParameter")
+  fun setDisabled(value: Boolean) {
+    // no-op stub
+  }
+}

package/android/src/main/java/com/reactnativestripesdk/CurrencySelectorElementViewManager.kt

@@ -0,0 +1,42 @@
+package com.reactnativestripesdk
+
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewGroupManager
+import com.facebook.react.uimanager.annotations.ReactProp
+import com.facebook.react.viewmanagers.StripeCurrencySelectorElementManagerDelegate
+import com.facebook.react.viewmanagers.StripeCurrencySelectorElementManagerInterface
+
+@ReactModule(name = CurrencySelectorElementViewManager.NAME)
+class CurrencySelectorElementViewManager :
+  ViewGroupManager<CurrencySelectorElementView>(),
+  StripeCurrencySelectorElementManagerInterface<CurrencySelectorElementView> {
+  companion object {
+    const val NAME = "StripeCurrencySelectorElement"
+  }
+
+  private val delegate = StripeCurrencySelectorElementManagerDelegate(this)
+
+  override fun getName() = NAME
+
+  override fun getDelegate() = delegate
+
+  override fun createViewInstance(ctx: ThemedReactContext): CurrencySelectorElementView =
+    CurrencySelectorElementView(ctx)
+
+  @ReactProp(name = "sessionKey")
+  override fun setSessionKey(
+    view: CurrencySelectorElementView,
+    value: String?,
+  ) {
+    view.setSessionKey(value)
+  }
+
+  @ReactProp(name = "disabled")
+  override fun setDisabled(
+    view: CurrencySelectorElementView,
+    value: Boolean,
+  ) {
+    view.setDisabled(value)
+  }
+}

package/android/src/main/java/com/reactnativestripesdk/EmbeddedPaymentElementView.kt

@@ -25,7 +25,9 @@ import com.reactnativestripesdk.utils.KeepJsAwakeTask
 import com.reactnativestripesdk.utils.mapFromConfirmationToken
 import com.reactnativestripesdk.utils.mapFromCustomPaymentMethod
 import com.reactnativestripesdk.utils.mapFromPaymentMethod
+import com.stripe.android.checkout.Checkout
 import com.stripe.android.model.PaymentMethod
+import com.stripe.android.paymentelement.CheckoutSessionPreview
 import com.stripe.android.paymentelement.CustomPaymentMethodResult
 import com.stripe.android.paymentelement.CustomPaymentMethodResultHandler
 import com.stripe.android.paymentelement.EmbeddedPaymentElement
@@ -43,6 +45,7 @@ enum class RowSelectionBehaviorType {
   ImmediateAction,
 }
 
+@OptIn(CheckoutSessionPreview::class)
 class EmbeddedPaymentElementView(
   context: Context,
 ) : StripeAbstractComposeView(context) {
@@ -52,10 +55,19 @@ class EmbeddedPaymentElementView(
       val intentConfiguration: PaymentSheet.IntentConfiguration,
     ) : Event
 
+    data class ConfigureWithCheckout(
+      val configuration: EmbeddedPaymentElement.Configuration,
+      val checkout: Checkout,
+    ) : Event
+
     data class Update(
       val intentConfiguration: PaymentSheet.IntentConfiguration,
     ) : Event
 
+    data class UpdateWithCheckout(
+      val checkout: Checkout,
+    ) : Event
+
     data object Confirm : Event
 
     data object ClearPaymentOption : Event
@@ -63,6 +75,7 @@ class EmbeddedPaymentElementView(
 
   var latestIntentConfig: PaymentSheet.IntentConfiguration? = null
   var latestElementConfig: EmbeddedPaymentElement.Configuration? = null
+  var latestCheckout: Checkout? = null
 
   val rowSelectionBehaviorType = mutableStateOf<RowSelectionBehaviorType?>(null)
   val useConfirmationTokenCallback = mutableStateOf(false)
@@ -115,7 +128,7 @@ class EmbeddedPaymentElementView(
           coroutineScope.launch {
             try {
               // Give the CustomPaymentMethodActivity a moment to fully initialize
-              delay(100)
+              delay(CUSTOM_PAYMENT_METHOD_INIT_DELAY_MS)
 
               // Emit event so JS can show the Alert and eventually respond via `customPaymentMethodResultCallback`.
               stripeSdkModule.eventEmitter.emitOnCustomPaymentMethodConfirmHandlerCallback(
@@ -199,7 +212,9 @@ class EmbeddedPaymentElementView(
                     return@Builder CreateIntentResult.Failure(
                       cause =
                         Exception(
-                          "Tried to call confirmationTokenConfirmHandler, but no callback was found. Please file an issue: https://github.com/stripe/stripe-react-native/issues",
+                          "Tried to call confirmationTokenConfirmHandler, but no callback was " +
+                            "found. Please file an issue: " +
+                            "https://github.com/stripe/stripe-react-native/issues",
                         ),
                       displayMessage = "An unexpected error occurred",
                     )
@@ -245,7 +260,8 @@ class EmbeddedPaymentElementView(
                     return@Builder CreateIntentResult.Failure(
                       cause =
                         Exception(
-                          "Tried to call confirmHandler, but no callback was found. Please file an issue: https://github.com/stripe/stripe-react-native/issues",
+                          "Tried to call confirmHandler, but no callback was found. Please " +
+                            "file an issue: https://github.com/stripe/stripe-react-native/issues",
                         ),
                       displayMessage = "An unexpected error occurred",
                     )
@@ -300,40 +316,25 @@ class EmbeddedPaymentElementView(
       events.consumeAsFlow().collect { ev ->
         when (ev) {
           is Event.Configure -> {
-            // call configure and grab the result
-            val result =
+            handleConfigureResult(
               embedded.configure(
                 intentConfiguration = ev.intentConfiguration,
                 configuration = ev.configuration,
-              )
+              ),
+            )
+          }
 
-            when (result) {
-              is EmbeddedPaymentElement.ConfigureResult.Succeeded -> reportHeightChange(1f)
-              is EmbeddedPaymentElement.ConfigureResult.Failed -> {
-                // send the error back to JS
-                val err = result.error
-                val msg = err.localizedMessage ?: err.toString()
-                // build a RN map
-                val payload =
-                  Arguments.createMap().apply {
-                    putString("message", msg)
-                  }
-                requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementLoadingFailed(payload)
-              }
-            }
+          is Event.ConfigureWithCheckout -> {
+            handleConfigureResult(
+              embedded.configure(
+                checkout = ev.checkout,
+                configuration = ev.configuration,
+              ),
+            )
           }
 
           is Event.Update -> {
-            val elemConfig = latestElementConfig
-            if (elemConfig == null) {
-              val payload =
-                Arguments.createMap().apply {
-                  putString("message", "Cannot update: no element configuration exists")
-                }
-              requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementLoadingFailed(payload)
-              requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementUpdateComplete(null)
-              return@collect
-            }
+            val elemConfig = latestElementConfig ?: return@collect emitUpdateMissingConfiguration()
 
             val result =
               embedded.configure(
@@ -341,29 +342,25 @@ class EmbeddedPaymentElementView(
                 configuration = elemConfig,
               )
 
-            when (result) {
-              is EmbeddedPaymentElement.ConfigureResult.Succeeded -> {
-                val payload =
-                  Arguments.createMap().apply {
-                    putString("status", "succeeded")
-                  }
-                requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementUpdateComplete(payload)
-              }
-              is EmbeddedPaymentElement.ConfigureResult.Failed -> {
-                val err = result.error
-                val msg = err.localizedMessage ?: err.toString()
-                val failPayload =
-                  Arguments.createMap().apply {
-                    putString("message", msg)
-                  }
-                requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementLoadingFailed(failPayload)
-                requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementUpdateComplete(null)
-              }
-            }
+            handleUpdateResult(result)
 
             latestIntentConfig = ev.intentConfiguration
           }
 
+          is Event.UpdateWithCheckout -> {
+            val elemConfig = latestElementConfig ?: return@collect emitUpdateMissingConfiguration()
+
+            val result =
+              embedded.configure(
+                checkout = ev.checkout,
+                configuration = elemConfig,
+              )
+
+            handleUpdateResult(result)
+
+            latestCheckout = ev.checkout
+          }
+
           is Event.Confirm -> {
             embedded.confirm()
           }
@@ -446,6 +443,50 @@ class EmbeddedPaymentElementView(
     requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementDidUpdateHeight(params)
   }
 
+  private fun handleConfigureResult(result: EmbeddedPaymentElement.ConfigureResult) {
+    when (result) {
+      is EmbeddedPaymentElement.ConfigureResult.Succeeded -> reportHeightChange(1f)
+      is EmbeddedPaymentElement.ConfigureResult.Failed -> {
+        val err = result.error
+        val msg = err.localizedMessage ?: err.toString()
+        val payload =
+          Arguments.createMap().apply {
+            putString("message", msg)
+          }
+        requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementLoadingFailed(payload)
+      }
+    }
+  }
+
+  private fun handleUpdateResult(result: EmbeddedPaymentElement.ConfigureResult) {
+    when (result) {
+      is EmbeddedPaymentElement.ConfigureResult.Succeeded -> {
+        val payload =
+          Arguments.createMap().apply {
+            putString("status", "succeeded")
+          }
+        requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementUpdateComplete(payload)
+      }
+      is EmbeddedPaymentElement.ConfigureResult.Failed -> {
+        emitUpdateFailed(result.error)
+      }
+    }
+  }
+
+  private fun emitUpdateMissingConfiguration() {
+    emitUpdateFailed(IllegalStateException("Cannot update: no element configuration exists"))
+  }
+
+  private fun emitUpdateFailed(error: Throwable) {
+    val msg = error.localizedMessage ?: error.toString()
+    val payload =
+      Arguments.createMap().apply {
+        putString("message", msg)
+      }
+    requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementLoadingFailed(payload)
+    requireStripeSdkModule().eventEmitter.emitEmbeddedPaymentElementUpdateComplete(null)
+  }
+
   // APIs
   fun configure(
     config: EmbeddedPaymentElement.Configuration,
@@ -454,10 +495,21 @@ class EmbeddedPaymentElementView(
     events.trySend(Event.Configure(config, intentConfig))
   }
 
+  fun configureWithCheckout(
+    config: EmbeddedPaymentElement.Configuration,
+    checkout: Checkout,
+  ) {
+    events.trySend(Event.ConfigureWithCheckout(config, checkout))
+  }
+
   fun update(intentConfig: PaymentSheet.IntentConfiguration) {
     events.trySend(Event.Update(intentConfig))
   }
 
+  fun updateWithCheckout(checkout: Checkout) {
+    events.trySend(Event.UpdateWithCheckout(checkout))
+  }
+
   fun confirm() {
     events.trySend(Event.Confirm)
   }
@@ -467,4 +519,8 @@ class EmbeddedPaymentElementView(
   }
 
   private fun requireStripeSdkModule() = requireNotNull(reactContext.getNativeModule(StripeSdkModule::class.java))
+
+  private companion object {
+    const val CUSTOM_PAYMENT_METHOD_INIT_DELAY_MS = 100L
+  }
 }

package/android/src/main/java/com/reactnativestripesdk/EmbeddedPaymentElementViewManager.kt

@@ -23,6 +23,7 @@ import com.reactnativestripesdk.utils.getStringList
 import com.reactnativestripesdk.utils.mapToPreferredNetworks
 import com.reactnativestripesdk.utils.parseCustomPaymentMethods
 import com.stripe.android.ExperimentalAllowsRemovalOfLastSavedPaymentMethodApi
+import com.stripe.android.paymentelement.CheckoutSessionPreview
 import com.stripe.android.paymentelement.EmbeddedPaymentElement
 import com.stripe.android.paymentsheet.CardFundingFilteringPrivatePreview
 import com.stripe.android.paymentsheet.PaymentSheet
@@ -30,6 +31,8 @@ import org.json.JSONArray
 import org.json.JSONObject
 
 @ReactModule(name = EmbeddedPaymentElementViewManager.NAME)
+@OptIn(CheckoutSessionPreview::class)
+@Suppress("TooManyFunctions")
 class EmbeddedPaymentElementViewManager :
   ViewGroupManager<EmbeddedPaymentElementView>(),
   EmbeddedPaymentElementViewManagerInterface<EmbeddedPaymentElementView> {
@@ -66,9 +69,7 @@ class EmbeddedPaymentElementViewManager :
 
     val elementConfig = parseElementConfiguration(readableMap, view.context)
     view.latestElementConfig = elementConfig
-    // if intentConfig is already set, configure immediately:
-    view.latestIntentConfig?.let { intentCfg ->
-      view.configure(elementConfig, intentCfg)
+    if (configureIfReady(view, elementConfig)) {
       view.post {
         view.requestLayout()
         view.invalidate()
@@ -81,18 +82,55 @@ class EmbeddedPaymentElementViewManager :
     view: EmbeddedPaymentElementView,
     cfg: Dynamic,
   ) {
-    val readableMap = cfg.asMapOrNull()
-    if (readableMap == null) return
+    val readableMap = cfg.asMapOrNull() ?: return
+
+    view.setUseConfirmationTokenCallback(readableMap.hasKey("confirmationTokenConfirmHandler"))
+
+    view.latestIntentConfig = parseIntentConfiguration(readableMap)
+    view.latestElementConfig?.let { configureIfReady(view, it) }
+  }
 
-    // Detect which callback type to use based on the presence of the confirmation token handler
-    val useConfirmationTokenCallback = readableMap.hasKey("confirmationTokenConfirmHandler")
-    view.setUseConfirmationTokenCallback(useConfirmationTokenCallback)
+  @ReactProp(name = "checkout")
+  override fun setCheckout(
+    view: EmbeddedPaymentElementView,
+    cfg: Dynamic,
+  ) {
+    val sessionKey = cfg.asMapOrNull()?.getString("sessionKey") ?: return
 
-    val intentConfig = parseIntentConfiguration(readableMap)
-    view.latestIntentConfig = intentConfig
-    view.latestElementConfig?.let { elemCfg ->
-      view.configure(elemCfg, intentConfig)
+    val stripeSdkModule =
+      (view.context as ThemedReactContext).getNativeModule(StripeSdkModule::class.java)
+    val checkout = stripeSdkModule?.checkoutInstances?.get(sessionKey)
+    if (checkout == null) {
+      val payload =
+        Arguments.createMap().apply {
+          putString("message", "Checkout session not found.")
+        }
+      stripeSdkModule?.eventEmitter?.emitEmbeddedPaymentElementLoadingFailed(payload)
+      return
     }
+
+    view.latestCheckout = checkout
+    view.latestElementConfig?.let { configureIfReady(view, it) }
+  }
+
+  /**
+   * Configures the embedded element once both the element config and an
+   * intent source (intent configuration or checkout) have arrived. Returns
+   * `true` when a configure was dispatched.
+   */
+  private fun configureIfReady(
+    view: EmbeddedPaymentElementView,
+    elementConfig: EmbeddedPaymentElement.Configuration,
+  ): Boolean {
+    view.latestCheckout?.let { checkout ->
+      view.configureWithCheckout(elementConfig, checkout)
+      return true
+    }
+    view.latestIntentConfig?.let { intentCfg ->
+      view.configure(elementConfig, intentCfg)
+      return true
+    }
+    return false
   }
 
   @SuppressLint("RestrictedApi")
@@ -206,6 +244,28 @@ class EmbeddedPaymentElementViewManager :
     }
   }
 
+  override fun updateWithCheckout(
+    view: EmbeddedPaymentElementView,
+    sessionKey: String?,
+  ) {
+    if (sessionKey == null) return
+
+    val stripeSdkModule =
+      (view.context as ThemedReactContext).getNativeModule(StripeSdkModule::class.java)
+    val checkout = stripeSdkModule?.checkoutInstances?.get(sessionKey)
+    if (checkout == null) {
+      val payload =
+        Arguments.createMap().apply {
+          putString("message", "Checkout session not found.")
+        }
+      stripeSdkModule?.eventEmitter?.emitEmbeddedPaymentElementLoadingFailed(payload)
+      stripeSdkModule?.eventEmitter?.emitEmbeddedPaymentElementUpdateComplete(null)
+      return
+    }
+
+    view.updateWithCheckout(checkout)
+  }
+
   private fun jsonToWritableMap(json: JSONObject): WritableMap {
     val map = Arguments.createMap()
     val keys = json.keys()

package/android/src/main/java/com/reactnativestripesdk/FinancialConnectionsSheetManager.kt

@@ -138,7 +138,7 @@ class FinancialConnectionsSheetManager(
         map.putString("status", mapFromStatus(account.status))
         map.putString("institutionName", account.institutionName)
         map.putString("last4", account.last4)
-        map.putDouble("created", account.created * 1000.0)
+        map.putDouble("created", account.created * SECONDS_TO_MILLIS)
         map.putMap("balance", mapFromAccountBalance(account.balance))
         map.putMap("balanceRefresh", mapFromAccountBalanceRefresh(account.balanceRefresh))
         map.putString("category", mapFromCategory(account.category))
@@ -166,7 +166,7 @@ class FinancialConnectionsSheetManager(
         return null
       }
       val map = Arguments.createMap()
-      map.putDouble("asOf", balance.asOf * 1000.0)
+      map.putDouble("asOf", balance.asOf * SECONDS_TO_MILLIS)
       map.putString("type", mapFromBalanceType(balance.type))
       Arguments.createMap().also {
         for (entry in balance.current.entries) {
@@ -210,7 +210,7 @@ class FinancialConnectionsSheetManager(
       }
       val map = Arguments.createMap()
       map.putString("status", mapFromBalanceRefreshStatus(balanceRefresh.status))
-      map.putDouble("lastAttemptedAt", balanceRefresh.lastAttemptedAt * 1000.0)
+      map.putDouble("lastAttemptedAt", balanceRefresh.lastAttemptedAt * SECONDS_TO_MILLIS)
       return map
     }
 
@@ -252,7 +252,9 @@ class FinancialConnectionsSheetManager(
         FinancialConnectionsAccount.Permissions.UNKNOWN -> "unparsable"
       }
 
-    private fun mapFromSupportedPaymentMethodTypes(type: FinancialConnectionsAccount.SupportedPaymentMethodTypes): String =
+    private fun mapFromSupportedPaymentMethodTypes(
+      type: FinancialConnectionsAccount.SupportedPaymentMethodTypes
+    ): String =
       when (type) {
         FinancialConnectionsAccount.SupportedPaymentMethodTypes.US_BANK_ACCOUNT -> "usBankAccount"
         FinancialConnectionsAccount.SupportedPaymentMethodTypes.LINK -> "link"
@@ -274,6 +276,8 @@ class FinancialConnectionsSheetManager(
         BalanceRefresh.BalanceRefreshStatus.UNKNOWN -> "unparsable"
         null -> "null"
       }
+
+    private const val SECONDS_TO_MILLIS = 1000.0
   }
 }
 

package/android/src/main/java/com/reactnativestripesdk/GooglePayButtonManager.kt

@@ -17,7 +17,8 @@ class GooglePayButtonManager :
 
   override fun getDelegate() = delegate
 
-  override fun createViewInstance(reactContext: ThemedReactContext): GooglePayButtonView = GooglePayButtonView(reactContext)
+  override fun createViewInstance(reactContext: ThemedReactContext): GooglePayButtonView =
+    GooglePayButtonView(reactContext)
 
   override fun onAfterUpdateTransaction(view: GooglePayButtonView) {
     super.onAfterUpdateTransaction(view)