@stripe/stripe-react-native 0.47.1 → 0.49.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # CHANGELOG
-## 0.47.1 - 2025-29-2025
+
+## 0.49.0 - 2025-07-02
+
+**Features**
+- Added rowSelectionBehavior to `EmbeddedPaymentElementConfiguration` with `immediateAction` option
+- Added `flatWithChevron` to `AppearanceParams.embeddedPaymentElement.rowConfig.style`
+- Added `PaymentMethodOptions` to `PaymentMode` to enable setting payment method level setup future usage value
+- Added `None` to `FutureUsage`
+
+## 0.48.0 - 2025-06-11
+
+**Feature**
+- Added `height` to `PrimaryButtonConfig.shapes`.
+- Added `formInsetValues` to `AppearanceParams`.
+
+## 0.47.1 - 2025-05-29
 
 **Fixes**
 - Fixed EmbeddedPaymentElement unable to present view controllers after navigating back and forth between screens.

package/android/gradle.properties

@@ -3,4 +3,4 @@ StripeSdk_compileSdkVersion=30
 StripeSdk_targetSdkVersion=28
 StripeSdk_minSdkVersion=21
 # Keep StripeSdk_stripeVersion in sync with https://github.com/stripe/stripe-identity-react-native/blob/main/android/gradle.properties
-StripeSdk_stripeVersion=21.15.+
+StripeSdk_stripeVersion=21.19.+

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

@@ -7,6 +7,7 @@ import androidx.compose.runtime.Composable
 import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableIntStateOf
+import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
 import androidx.compose.ui.Modifier
@@ -20,7 +21,6 @@ import com.facebook.react.uimanager.ThemedReactContext
 import com.reactnativestripesdk.utils.KeepJsAwakeTask
 import com.reactnativestripesdk.utils.mapFromPaymentMethod
 import com.stripe.android.paymentelement.EmbeddedPaymentElement
-import com.stripe.android.paymentelement.ExperimentalEmbeddedPaymentElementApi
 import com.stripe.android.paymentelement.rememberEmbeddedPaymentElement
 import com.stripe.android.paymentsheet.CreateIntentResult
 import com.stripe.android.paymentsheet.PaymentSheet
@@ -29,7 +29,11 @@ import kotlinx.coroutines.channels.Channel
 import kotlinx.coroutines.flow.consumeAsFlow
 import toWritableMap
 
-@OptIn(ExperimentalEmbeddedPaymentElementApi::class)
+enum class RowSelectionBehaviorType {
+  Default,
+  ImmediateAction,
+}
+
 class EmbeddedPaymentElementView(
   context: Context,
 ) : StripeAbstractComposeView(context) {
@@ -47,75 +51,91 @@ class EmbeddedPaymentElementView(
   var latestIntentConfig: PaymentSheet.IntentConfiguration? = null
   var latestElementConfig: EmbeddedPaymentElement.Configuration? = null
 
+  val rowSelectionBehaviorType = mutableStateOf<RowSelectionBehaviorType?>(null)
+
   private val reactContext get() = context as ThemedReactContext
   private val events = Channel<Event>(Channel.UNLIMITED)
 
-  private val builder by lazy {
-    EmbeddedPaymentElement.Builder(
-      createIntentCallback = { paymentMethod, shouldSavePaymentMethod ->
-        val stripeSdkModule =
-          try {
-            requireStripeSdkModule()
-          } catch (ex: IllegalArgumentException) {
-            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",
-                ),
-              displayMessage = "An unexpected error occurred",
-            )
-          }
-
-        // Make sure that JS is active since the activity will be paused when stripe ui is presented.
-        val keepJsAwakeTask = KeepJsAwakeTask(reactContext.reactApplicationContext).apply { start() }
-
-        val params =
-          Arguments.createMap().apply {
-            putMap("paymentMethod", mapFromPaymentMethod(paymentMethod))
-            putBoolean("shouldSavePaymentMethod", shouldSavePaymentMethod)
-          }
-
-        stripeSdkModule.emitOnConfirmHandlerCallback(params)
-
-        val resultFromJavascript = stripeSdkModule.embeddedIntentCreationCallback.await()
-        // reset the completable
-        stripeSdkModule.embeddedIntentCreationCallback = CompletableDeferred()
-
-        keepJsAwakeTask.stop()
-
-        resultFromJavascript.getString("clientSecret")?.let {
-          CreateIntentResult.Success(clientSecret = it)
-        } ?: run {
-          val errorMap = resultFromJavascript.getMap("error")
-          CreateIntentResult.Failure(
-            cause = Exception(errorMap?.getString("message")),
-            displayMessage = errorMap?.getString("localizedMessage"),
-          )
-        }
-      },
-      resultCallback = { result ->
-        val map =
-          Arguments.createMap().apply {
-            when (result) {
-              is EmbeddedPaymentElement.Result.Completed -> {
-                putString("status", "completed")
-              }
-              is EmbeddedPaymentElement.Result.Canceled -> {
-                putString("status", "canceled")
+  @Composable
+  override fun Content() {
+    val type by remember { rowSelectionBehaviorType }
+    val builder =
+      remember(type) {
+        EmbeddedPaymentElement
+          .Builder(
+            createIntentCallback = { paymentMethod, shouldSavePaymentMethod ->
+              val stripeSdkModule =
+                try {
+                  requireStripeSdkModule()
+                } catch (ex: IllegalArgumentException) {
+                  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",
+                      ),
+                    displayMessage = "An unexpected error occurred",
+                  )
+                }
+
+              // Make sure that JS is active since the activity will be paused when stripe ui is presented.
+              val keepJsAwakeTask =
+                KeepJsAwakeTask(reactContext.reactApplicationContext).apply { start() }
+
+              val params =
+                Arguments.createMap().apply {
+                  putMap("paymentMethod", mapFromPaymentMethod(paymentMethod))
+                  putBoolean("shouldSavePaymentMethod", shouldSavePaymentMethod)
+                }
+
+              stripeSdkModule.emitOnConfirmHandlerCallback(params)
+
+              val resultFromJavascript = stripeSdkModule.embeddedIntentCreationCallback.await()
+              // reset the completable
+              stripeSdkModule.embeddedIntentCreationCallback = CompletableDeferred()
+
+              keepJsAwakeTask.stop()
+
+              resultFromJavascript.getString("clientSecret")?.let {
+                CreateIntentResult.Success(clientSecret = it)
+              } ?: run {
+                val errorMap = resultFromJavascript.getMap("error")
+                CreateIntentResult.Failure(
+                  cause = Exception(errorMap?.getString("message")),
+                  displayMessage = errorMap?.getString("localizedMessage"),
+                )
               }
-              is EmbeddedPaymentElement.Result.Failed -> {
-                putString("status", "failed")
-                putString("error", result.error.message ?: "Unknown error")
+            },
+            resultCallback = { result ->
+              val map =
+                Arguments.createMap().apply {
+                  when (result) {
+                    is EmbeddedPaymentElement.Result.Completed -> {
+                      putString("status", "completed")
+                    }
+
+                    is EmbeddedPaymentElement.Result.Canceled -> {
+                      putString("status", "canceled")
+                    }
+
+                    is EmbeddedPaymentElement.Result.Failed -> {
+                      putString("status", "failed")
+                      putString("error", result.error.message ?: "Unknown error")
+                    }
+                  }
+                }
+              requireStripeSdkModule().emitEmbeddedPaymentElementFormSheetConfirmComplete(map)
+            },
+          ).rowSelectionBehavior(
+            if (type == RowSelectionBehaviorType.Default) {
+              EmbeddedPaymentElement.RowSelectionBehavior.default()
+            } else {
+              EmbeddedPaymentElement.RowSelectionBehavior.immediateAction {
+                requireStripeSdkModule().emitEmbeddedPaymentElementRowSelectionImmediateAction()
               }
-            }
-          }
-        requireStripeSdkModule().emitEmbeddedPaymentElementFormSheetConfirmComplete(map)
-      },
-    )
-  }
+            },
+          )
+      }
 
-  @Composable
-  override fun Content() {
     val embedded = rememberEmbeddedPaymentElement(builder)
     var height by remember {
       mutableIntStateOf(0)

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

@@ -21,10 +21,8 @@ import com.reactnativestripesdk.utils.mapToPreferredNetworks
 import com.reactnativestripesdk.utils.toBundleObject
 import com.stripe.android.ExperimentalAllowsRemovalOfLastSavedPaymentMethodApi
 import com.stripe.android.paymentelement.EmbeddedPaymentElement
-import com.stripe.android.paymentelement.ExperimentalEmbeddedPaymentElementApi
 import com.stripe.android.paymentsheet.PaymentSheet
 
-@OptIn(ExperimentalEmbeddedPaymentElementApi::class)
 @ReactModule(name = EmbeddedPaymentElementViewManager.NAME)
 class EmbeddedPaymentElementViewManager :
   ViewGroupManager<EmbeddedPaymentElementView>(),
@@ -54,6 +52,9 @@ class EmbeddedPaymentElementViewManager :
     view: EmbeddedPaymentElementView,
     cfg: Dynamic,
   ) {
+    val rowSelectionBehaviorType = parseRowSelectionBehavior(cfg.asMap())
+    view.rowSelectionBehaviorType.value = rowSelectionBehaviorType
+
     val elementConfig = parseElementConfiguration(cfg.asMap(), view.context)
     view.latestElementConfig = elementConfig
     // if intentConfig is already set, configure immediately:
@@ -190,6 +191,21 @@ class EmbeddedPaymentElementViewManager :
     return configurationBuilder.build()
   }
 
+  private fun parseRowSelectionBehavior(map: ReadableMap): RowSelectionBehaviorType {
+    val rowSelectionBehavior =
+      map
+        .getMap("rowSelectionBehavior")
+        ?.getString("type")
+        ?.let { type ->
+          when (type) {
+            "immediateAction" -> RowSelectionBehaviorType.ImmediateAction
+            else -> RowSelectionBehaviorType.Default
+          }
+        }
+        ?: RowSelectionBehaviorType.Default
+    return rowSelectionBehavior
+  }
+
   private fun parseIntentConfiguration(map: ReadableMap): PaymentSheet.IntentConfiguration {
     val intentConfig = PaymentSheetFragment.buildIntentConfiguration(toBundleObject(map))
     return intentConfig ?: throw IllegalArgumentException("IntentConfiguration is null")

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

@@ -2,13 +2,11 @@ import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
 import com.reactnativestripesdk.utils.mapFromPaymentSheetBillingDetails
 import com.stripe.android.paymentelement.EmbeddedPaymentElement
-import com.stripe.android.paymentelement.ExperimentalEmbeddedPaymentElementApi
 
 /**
  * Serialize Stripe's PaymentOptionDisplayData into a WritableMap
  * that can be sent over the RN bridge.
  */
-@OptIn(ExperimentalEmbeddedPaymentElementApi::class)
 fun EmbeddedPaymentElement.PaymentOptionDisplayData.toWritableMap(): WritableMap =
   Arguments.createMap().apply {
     putString("label", label)

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

@@ -6,8 +6,9 @@ import android.content.res.Configuration
 import android.graphics.Color
 import android.os.Bundle
 import com.reactnativestripesdk.utils.PaymentSheetAppearanceException
-import com.stripe.android.paymentelement.ExperimentalEmbeddedPaymentElementApi
+import com.stripe.android.paymentelement.AppearanceAPIAdditionsPreview
 import com.stripe.android.paymentsheet.PaymentSheet
+import com.stripe.android.uicore.StripeThemeDefaults
 
 @SuppressLint("RestrictedApi")
 fun buildPaymentSheetAppearance(
@@ -17,6 +18,7 @@ fun buildPaymentSheetAppearance(
   val colorParams = userParams?.getBundle(PaymentSheetAppearanceKeys.COLORS)
   val lightColorParams = colorParams?.getBundle(PaymentSheetAppearanceKeys.LIGHT) ?: colorParams
   val darkColorParams = colorParams?.getBundle(PaymentSheetAppearanceKeys.DARK) ?: colorParams
+  val insetParams = userParams?.getBundle(PaymentSheetAppearanceKeys.FORM_INSETS)
 
   val embeddedAppearance =
     buildEmbeddedAppearance(
@@ -37,6 +39,7 @@ fun buildPaymentSheetAppearance(
           context,
         ),
       embeddedAppearance = embeddedAppearance,
+      formInsetValues = buildFormInsets(insetParams),
     )
   }
 
@@ -50,9 +53,11 @@ fun buildPaymentSheetAppearance(
         userParams?.getBundle(PaymentSheetAppearanceKeys.PRIMARY_BUTTON),
         context,
       ),
+    formInsetValues = buildFormInsets(insetParams),
   )
 }
 
+@OptIn(AppearanceAPIAdditionsPreview::class)
 private fun buildTypography(
   fontParams: Bundle?,
   context: Context,
@@ -198,6 +203,7 @@ private fun buildPrimaryButton(
           getFloatOrNull(shapeParams, PaymentSheetAppearanceKeys.BORDER_RADIUS),
         borderStrokeWidthDp =
           getFloatOrNull(shapeParams, PaymentSheetAppearanceKeys.BORDER_WIDTH),
+        heightDp = getFloatOrNull(shapeParams, PaymentSheetAppearanceKeys.HEIGHT),
       ),
     typography =
       PaymentSheet.PrimaryButtonTypography(
@@ -239,7 +245,6 @@ private fun buildPrimaryButtonColors(
       ),
   )
 
-@OptIn(ExperimentalEmbeddedPaymentElementApi::class)
 @SuppressLint("RestrictedApi")
 @Throws(PaymentSheetAppearanceException::class)
 private fun buildEmbeddedAppearance(
@@ -336,7 +341,7 @@ private fun buildEmbeddedAppearance(
         val checkmarkParams = getBundleOrNull(flatParams, PaymentSheetAppearanceKeys.CHECKMARK)
         val separatorInsetsParams = getBundleOrNull(flatParams, PaymentSheetAppearanceKeys.SEPARATOR_INSETS)
 
-        // Default separator insets specific to FlatWithCheckmark
+        // Default separator insets specific to FlatWithCheckmark and FlatWithChevron
         val defaultSeparatorStartInsetDp = 0.0f
         val defaultSeparatorEndInsetDp = 0.0f
 
@@ -387,6 +392,59 @@ private fun buildEmbeddedAppearance(
           colorsDark = flatCheckmarkColors,
         )
       }
+      "flatWithChevron" -> {
+        val flatParams = getBundleOrNull(rowParams, PaymentSheetAppearanceKeys.FLAT)
+        val chevronParams = getBundleOrNull(flatParams, PaymentSheetAppearanceKeys.CHEVRON)
+        val separatorInsetsParams = getBundleOrNull(flatParams, PaymentSheetAppearanceKeys.SEPARATOR_INSETS)
+
+        // Default separator insets specific to FlatWithCheckmark and FlatWithChevron
+        val defaultSeparatorStartInsetDp = 0.0f
+        val defaultSeparatorEndInsetDp = 0.0f
+
+        // Parse dimensions as Floats
+        val separatorThickness = getFloatOr(flatParams, PaymentSheetAppearanceKeys.SEPARATOR_THICKNESS, defaultSeparatorThicknessDp)
+        val startSeparatorInset = getFloatOr(separatorInsetsParams, PaymentSheetAppearanceKeys.LEFT, defaultSeparatorStartInsetDp)
+        val endSeparatorInset = getFloatOr(separatorInsetsParams, PaymentSheetAppearanceKeys.RIGHT, defaultSeparatorEndInsetDp)
+
+        // Parse booleans
+        val topEnabled = getBooleanOr(flatParams, PaymentSheetAppearanceKeys.TOP_SEPARATOR_ENABLED, true)
+        val bottomEnabled = getBooleanOr(flatParams, PaymentSheetAppearanceKeys.BOTTOM_SEPARATOR_ENABLED, true)
+
+        val parsedSeparatorColor =
+          dynamicColorFromParams(
+            context,
+            flatParams,
+            PaymentSheetAppearanceKeys.SEPARATOR_COLOR,
+            Color.GRAY,
+          )
+
+        val parsedChevronColor =
+          dynamicColorFromParams(
+            context,
+            chevronParams,
+            PaymentSheetAppearanceKeys.COLOR,
+            defaultColors.componentBorder, // Default to component border color like other elements
+          )
+
+        // Create the required Colors object
+        val flatChevronColors =
+          PaymentSheet.Appearance.Embedded.RowStyle.FlatWithChevron.Colors(
+            separatorColor = parsedSeparatorColor,
+            chevronColor = parsedChevronColor,
+          )
+
+        PaymentSheet.Appearance.Embedded.RowStyle.FlatWithChevron(
+          separatorThicknessDp = separatorThickness,
+          startSeparatorInsetDp = startSeparatorInset,
+          endSeparatorInsetDp = endSeparatorInset,
+          topSeparatorEnabled = topEnabled,
+          bottomSeparatorEnabled = bottomEnabled,
+          additionalVerticalInsetsDp = additionalInsets,
+          horizontalInsetsDp = 0.0F, // We do not have an iOS equal for this API so it's not configurable in React Native
+          colorsLight = flatChevronColors,
+          colorsDark = flatChevronColors,
+        )
+      }
       "floatingButton" -> {
         val floatingParams = getBundleOrNull(rowParams, PaymentSheetAppearanceKeys.FLOATING)
         PaymentSheet.Appearance.Embedded.RowStyle.FloatingButton(
@@ -403,6 +461,22 @@ private fun buildEmbeddedAppearance(
   return PaymentSheet.Appearance.Embedded(style = rowStyle)
 }
 
+@SuppressLint("RestrictedApi")
+private fun buildFormInsets(insetParams: Bundle?): PaymentSheet.Insets {
+  val defaults = StripeThemeDefaults.formInsets
+  val left = getFloatOr(insetParams, PaymentSheetAppearanceKeys.LEFT, defaults.start)
+  val top = getFloatOr(insetParams, PaymentSheetAppearanceKeys.TOP, defaults.top)
+  val right = getFloatOr(insetParams, PaymentSheetAppearanceKeys.RIGHT, defaults.end)
+  val bottom = getFloatOr(insetParams, PaymentSheetAppearanceKeys.BOTTOM, defaults.bottom)
+
+  return PaymentSheet.Insets(
+    startDp = left,
+    topDp = top,
+    endDp = right,
+    bottomDp = bottom,
+  )
+}
+
 /**
  * Pulls a light/dark hex‑string map out of [params],
  * chooses the right one based on the current UI mode,
@@ -564,6 +638,7 @@ private class PaymentSheetAppearanceKeys {
     const val SHAPES = "shapes"
     const val BORDER_RADIUS = "borderRadius"
     const val BORDER_WIDTH = "borderWidth"
+    const val HEIGHT = "height"
 
     const val PRIMARY_BUTTON = "primaryButton"
     const val TEXT = "text"
@@ -584,6 +659,7 @@ private class PaymentSheetAppearanceKeys {
     const val SELECTED_COLOR = "selectedColor"
     const val UNSELECTED_COLOR = "unselectedColor"
     const val CHECKMARK = "checkmark"
+    const val CHEVRON = "chevron"
     const val COLOR = "color"
     const val CHECKMARK_INSET = "inset"
 
@@ -593,5 +669,9 @@ private class PaymentSheetAppearanceKeys {
     // Keys for EdgeInsetsConfig
     const val LEFT = "left"
     const val RIGHT = "right"
+    const val TOP = "top"
+    const val BOTTOM = "bottom"
+
+    const val FORM_INSETS = "formInsetValues"
   }
 }

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

@@ -32,6 +32,8 @@ import com.reactnativestripesdk.utils.mapFromPaymentMethod
 import com.reactnativestripesdk.utils.mapToPreferredNetworks
 import com.reactnativestripesdk.utils.removeFragment
 import com.stripe.android.ExperimentalAllowsRemovalOfLastSavedPaymentMethodApi
+import com.stripe.android.model.PaymentMethod
+import com.stripe.android.paymentelement.PaymentMethodOptionsSetupFutureUsagePreview
 import com.stripe.android.paymentsheet.CreateIntentCallback
 import com.stripe.android.paymentsheet.CreateIntentResult
 import com.stripe.android.paymentsheet.ExperimentalCustomerSessionApi
@@ -518,6 +520,7 @@ class PaymentSheetFragment : StripeFragment() {
       )
     }
 
+    @OptIn(PaymentMethodOptionsSetupFutureUsagePreview::class)
     private fun buildIntentConfigurationMode(modeParams: Bundle): PaymentSheet.IntentConfiguration.Mode {
       val currencyCode =
         modeParams.getString("currencyCode")
@@ -531,6 +534,7 @@ class PaymentSheetFragment : StripeFragment() {
           currency = currencyCode,
           setupFutureUse = mapToSetupFutureUse(modeParams.getString("setupFutureUsage")),
           captureMethod = mapToCaptureMethod(modeParams.getString("captureMethod")),
+          paymentMethodOptions = mapToPaymentMethodOptions(modeParams.getBundle("paymentMethodOptions")),
         )
       } else {
         val setupFutureUsage =
@@ -639,6 +643,7 @@ fun mapToSetupFutureUse(type: String?): PaymentSheet.IntentConfiguration.SetupFu
   when (type) {
     "OffSession" -> PaymentSheet.IntentConfiguration.SetupFutureUse.OffSession
     "OnSession" -> PaymentSheet.IntentConfiguration.SetupFutureUse.OnSession
+    "None" -> PaymentSheet.IntentConfiguration.SetupFutureUse.None
     else -> null
   }
 
@@ -650,6 +655,26 @@ fun mapToCaptureMethod(type: String?): PaymentSheet.IntentConfiguration.CaptureM
     else -> PaymentSheet.IntentConfiguration.CaptureMethod.Automatic
   }
 
+@OptIn(PaymentMethodOptionsSetupFutureUsagePreview::class)
+fun mapToPaymentMethodOptions(options: Bundle?): PaymentSheet.IntentConfiguration.Mode.Payment.PaymentMethodOptions? {
+  val sfuBundle = options?.getBundle("setupFutureUsageValues")
+  val paymentMethodToSfuMap = mutableMapOf<PaymentMethod.Type, PaymentSheet.IntentConfiguration.SetupFutureUse>()
+  sfuBundle?.keySet()?.forEach { code ->
+    val sfuValue = mapToSetupFutureUse(sfuBundle?.getString(code))
+    val paymentMethodType = PaymentMethod.Type.fromCode(code)
+    if (paymentMethodType != null && sfuValue != null) {
+      paymentMethodToSfuMap[paymentMethodType] = sfuValue
+    }
+  }
+  return if (paymentMethodToSfuMap.isNotEmpty()) {
+    PaymentSheet.IntentConfiguration.Mode.Payment.PaymentMethodOptions(
+      setupFutureUsageValues = paymentMethodToSfuMap,
+    )
+  } else {
+    null
+  }
+}
+
 fun mapToCardBrandAcceptance(params: Bundle?): PaymentSheet.CardBrandAcceptance {
   val cardBrandAcceptanceParams = params?.getBundle("cardBrandAcceptance") ?: return PaymentSheet.CardBrandAcceptance.all()
   val filter = cardBrandAcceptanceParams.getString("filter") ?: return PaymentSheet.CardBrandAcceptance.all()

package/ios/PaymentSheetAppearance.swift

@@ -33,6 +33,10 @@ internal class PaymentSheetAppearance {
           appearance.embeddedPaymentElement = try buildEmbeddedPaymentElementAppearance(params: embeddedPaymentElementParams)
         }
         
+        if let formInsetParams = userParams[PaymentSheetAppearanceKeys.FORM_INSETS] as? NSDictionary {
+            appearance.formInsets = try buildFormInsets(params: formInsetParams)
+        }
+        
         return appearance
     }
     
@@ -114,6 +118,9 @@ internal class PaymentSheetAppearance {
             if let shadowParams = shapeParams[PaymentSheetAppearanceKeys.SHADOW] as? NSDictionary {
                 primaryButton.shadow = try buildShadow(params: shadowParams)
             }
+            if let height = shapeParams[PaymentSheetAppearanceKeys.HEIGHT] as? CGFloat {
+                primaryButton.height = height
+            }
         }
         if let colorParams = params[PaymentSheetAppearanceKeys.COLORS] as? NSDictionary {
             if (colorParams.object(forKey: PaymentSheetAppearanceKeys.LIGHT) != nil && colorParams.object(forKey: PaymentSheetAppearanceKeys.DARK) == nil ||
@@ -178,6 +185,8 @@ internal class PaymentSheetAppearance {
                   row.style = .floatingButton
               case PaymentSheetAppearanceKeys.ROW_STYLE_FLAT_WITH_CHECKMARK:
                   row.style = .flatWithCheckmark
+              case PaymentSheetAppearanceKeys.ROW_STYLE_FLAT_WITH_CHEVRON:
+                  row.style = .flatWithChevron
               default:
                   throw PaymentSheetAppearanceError.invalidRowStyle(styleString)
               }
@@ -232,6 +241,10 @@ internal class PaymentSheetAppearance {
               flat.checkmark = try buildEmbeddedCheckmark(params: checkmarkParams)
           }
 
+          if let chevronParams = params[PaymentSheetAppearanceKeys.CHEVRON] as? NSDictionary {
+              flat.chevron = try buildEmbeddedChevron(params: chevronParams)
+          }
+
           return flat
       }
 
@@ -270,6 +283,19 @@ internal class PaymentSheetAppearance {
           return checkmark
       }
 
+      private class func buildEmbeddedChevron(params: NSDictionary) throws -> PaymentSheet.Appearance.EmbeddedPaymentElement.Row.Flat.Chevron {
+        var chevron = PaymentSheet.Appearance.default.embeddedPaymentElement.row.flat.chevron
+
+        if let colorHexes = params[PaymentSheetAppearanceKeys.COLOR] as? [String: String] {
+          chevron.color = dynamicColor(
+            from: colorHexes,
+            default: UIColor.systemGray // Default iOS system gray color
+          )
+        }
+
+          return chevron
+      }
+
       private class func buildEmbeddedFloating(params: NSDictionary) throws -> PaymentSheet.Appearance.EmbeddedPaymentElement.Row.Floating {
           var floating = PaymentSheet.Appearance.default.embeddedPaymentElement.row.floating
 
@@ -314,6 +340,20 @@ internal class PaymentSheetAppearance {
             return defaultColor
           })
       }
+    
+    private class func buildFormInsets(params: NSDictionary) throws -> NSDirectionalEdgeInsets {
+        let top = params[PaymentSheetAppearanceKeys.TOP] as? CGFloat ?? PaymentSheet.Appearance.default.formInsets.top
+        let leading = params[PaymentSheetAppearanceKeys.LEFT] as? CGFloat ?? PaymentSheet.Appearance.default.formInsets.leading
+        let bottom = params[PaymentSheetAppearanceKeys.BOTTOM] as? CGFloat ?? PaymentSheet.Appearance.default.formInsets.bottom
+        let trailing = params[PaymentSheetAppearanceKeys.RIGHT] as? CGFloat ?? PaymentSheet.Appearance.default.formInsets.trailing
+        
+        return NSDirectionalEdgeInsets(
+          top: top,
+          leading: leading,
+          bottom: bottom,
+          trailing: trailing
+        )
+    }
 }
 
 enum PaymentSheetAppearanceError : Error {
@@ -333,7 +373,7 @@ extension PaymentSheetAppearanceError: LocalizedError {
         case .unexpectedHexStringLength(let hexString):
             return NSLocalizedString("Failed to set Payment Sheet appearance. Expected hex string of length 6 or 8, but received: \(hexString)", comment: "Failed to set color")
         case .invalidRowStyle(let styleString):
-            return NSLocalizedString("Failed to set Embedded Payment Element appearance. Invalid row style '\(styleString)'. Expected one of: 'flatWithRadio', 'floatingButton', 'flatWithCheckmark'.", comment: "Invalid row style string")
+            return NSLocalizedString("Failed to set Embedded Payment Element appearance. Invalid row style '\(styleString)'. Expected one of: 'flatWithRadio', 'floatingButton', 'flatWithCheckmark', 'flatWithChevron'.", comment: "Invalid row style string")
         }
     }
 }
@@ -361,6 +401,7 @@ private struct PaymentSheetAppearanceKeys {
     static let SHAPES = "shapes"
     static let BORDER_RADIUS = "borderRadius"
     static let BORDER_WIDTH = "borderWidth"
+    static let HEIGHT = "height"
 
     static let SHADOW = "shadow"
     static let SHADOW_COLOR = "color"
@@ -389,6 +430,7 @@ private struct PaymentSheetAppearanceKeys {
     static let SELECTED_COLOR = "selectedColor"
     static let UNSELECTED_COLOR = "unselectedColor"
     static let CHECKMARK = "checkmark"
+    static let CHEVRON = "chevron"
     static let SPACING = "spacing"
     static let TOP = "top"
     static let LEFT = "left"
@@ -400,4 +442,7 @@ private struct PaymentSheetAppearanceKeys {
     static let ROW_STYLE_FLAT_WITH_RADIO = "flatWithRadio"
     static let ROW_STYLE_FLOATING_BUTTON = "floatingButton"
     static let ROW_STYLE_FLAT_WITH_CHECKMARK = "flatWithCheckmark"
+    static let ROW_STYLE_FLAT_WITH_CHEVRON = "flatWithChevron"
+    
+    static let FORM_INSETS = "formInsetValues"
 }