@unifold/connect-react-native 0.1.50 → 0.1.52

package/README.md

@@ -36,7 +36,7 @@ Link Pay uses `@stripe/stripe-react-native`, which includes **native** code (App
 
 Importing `@unifold/connect-react-native` loads the Stripe UI registration in the same JS bundle as the provider. Ensure the peer dependencies in **Installation** above are installed so Metro does not duplicate native modules.
 
-**`expo-constants`** is a **dependency** of `@unifold/connect-react-native`. The prebuilt bundle uses a **static** `import` from `expo-constants` (in the Stripe helper that reads the Expo plugin) so Metro always links the module. (A runtime `require("expo-constants")` in that path was still emitted inside the bundle and could trigger “unknown module” in Metro.) You can still set **`config.stripeMerchantIdentifier`** on `UnifoldProvider` to override or skip reading the plugin from constants.
+The Apple Pay **`merchantIdentifier`** in `app.json` is still required for the **native entitlement** at build time. The value used at runtime for `initStripe`, however, comes **only** from the Unifold dashboard (via the Stripe config endpoint) — the SDK no longer reads it from a prop or `app.json`, so make sure the dashboard value matches the id compiled into your build.
 
 #### Expo Go vs development build vs prebuild
 
@@ -50,7 +50,7 @@ Importing `@unifold/connect-react-native` loads the Stripe UI registration in th
 1. **Peer dependencies** — Install everything in **Installation** (or `expo install …`). Missing peers often show up as duplicate native modules or Metro resolution errors.
 2. **`react-native-gesture-handler`** — In bare React Native, import it at the **entry file** first (see [React Navigation](https://reactnavigation.org/docs/getting-started/#installing-dependencies-into-a-bare-react-native-project)); Expo Router projects usually already satisfy this.
 3. **`UnifoldProvider` placement** — Wrap near the root so `beginDeposit` and theme context are available app-wide. Call `setDevApiUrl` **before** the provider if you use staging in development (see example app).
-4. **Stripe Link Pay** — Requires a **development / EAS build** on Expo (not Expo Go), the Stripe **config plugin** in `app.json`, and `config.enableStripeLinkPay: true`. Apple Pay needs a matching `merchantIdentifier` (plugin and/or `config.stripeMerchantIdentifier`; Expo apps can rely on plugin + `expo-constants` auto-read in `StripeOnramp`).
+4. **Stripe Link Pay** — Requires a **development / EAS build** on Expo (not Expo Go), the Stripe **config plugin** in `app.json`, and `config.enableStripeLink: true`. Apple Pay's `merchantIdentifier` must be set in the `app.json` plugin (native entitlement); the runtime value is sourced from the Unifold dashboard (Stripe config endpoint), so keep the two in sync.
 5. **Theme** — `UnifoldProvider` applies `ThemeProvider` to **all** children. If you use another theme system, nest it inside or outside deliberately so `useTheme` resolves as you expect.
 
 ## Quick Start
@@ -192,8 +192,9 @@ await beginDeposit({
 | `config.fonts` | `FontConfig` | No | Granular font weight configuration |
 | `config.components` | `ComponentConfig` | No | Component-specific token overrides |
 | `config.sheetBorderRadius` | `SheetBorderRadius` | No | Border radius configuration for all bottom sheets (see below) |
-| `config.enableStripeLinkPay` | `boolean` | No | Show Pay with Link (Stripe) in the deposit menu (default: omit / falsy hides it). Stripe is bundled with Connect. |
-| `config.stripeMerchantIdentifier` | `string` | No | Apple Pay merchant id for Link Pay. Must match the Stripe Expo plugin in app.json. On Expo, omit if the id is only in the plugin (read from `expo-constants`). |
+| `config.enableStripeLink` | `boolean` | No | Show Pay with Link (Stripe) in the deposit menu (default: omit / falsy hides it). Stripe is bundled with Connect. |
+
+> **Apple Pay merchant id:** there is no longer an SDK config for this. The runtime value comes solely from the Unifold dashboard (Stripe config endpoint). Keep it in sync with the `merchantIdentifier` in your `app.json` Stripe plugin, which is still required for the native entitlement.
 
 ### SheetBorderRadius
 
@@ -251,8 +252,7 @@ const { beginDeposit, closeDeposit, publishableKey } = useUnifold();
 | `destinationTokenAddress` | `string` | No | Target token contract address |
 | `destinationTokenSymbol` | `string` | No | Target token symbol (e.g., `'USDC'`) |
 | `recipientAddress` | `string` | No | Wallet address to receive funds |
-| `stripeOnrampEmail` | `string` | No | Pre-fills Stripe Link Pay email when user opens Pay with Stripe Link from the deposit menu |
-| `stripeOnrampPhone` | `string` | No | Pre-fills Stripe Link Pay phone (use with `stripeOnrampEmail` per Stripe’s flow) |
+| `user` | `{ email?: string; phone?: string }` | No | Host-app-supplied user identity. Pre-fills supported flows — currently Stripe Link Pay uses `user.email` / `user.phone` (with both set, Stripe may skip verify steps). |
 | `defaultChainType` | `'ethereum' \| 'solana' \| 'bitcoin'` | No | Pre-select source network type |
 | `defaultChainId` | `string` | No | Pre-select source chain ID |
 | `defaultTokenAddress` | `string` | No | Pre-select source token address |
@@ -308,7 +308,6 @@ import type {
 | react-native-gesture-handler | >= 2.14.0 |
 | react-native-svg | >= 13.0.0 |
 | react-native-webview | >= 13.0.0 |
-| expo-constants | Installed with Connect (>= 14) — mirrors `merchantIdentifier` from the Stripe Expo plugin into JS; optional override via `config.stripeMerchantIdentifier` |
 
 ## Support
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import React$1, { ReactNode } from 'react';
-export { AmountScreen, CreateSessionParams, CustomerVerification, KYCData, KYCWizardScreen, OnrampConfig, OnrampCustomer, OnrampError, OnrampErrorCode, OnrampScreen, OnrampSession, OnrampSessionTransactionDetails, OnrampStep, OnrampTransaction, StripeOnramp, StripeOnrampHook, StripeOnrampPreconfigure, StripeOnrampProps, getStripePublishableKey, setStripeOnrampApiUrl, setStripeOnrampPublishableKey, useStripeOnramp } from '@unifold/ui-react-native/stripe';
+export { AmountScreen, CreateSessionParams, CustomerVerification, KYCData, KYCWizardScreen, OnrampConfig, OnrampCustomer, OnrampError, OnrampErrorCode, OnrampScreen, OnrampSession, OnrampSessionTransactionDetails, OnrampStep, OnrampTransaction, StripeOnramp, StripeOnrampConfig, StripeOnrampHook, StripeOnrampPreconfigure, StripeOnrampProps, getStripeConfig, getStripePublishableKey, setStripeOnrampApiUrl, setStripeOnrampPublishableKey, useStripeOnramp } from '@unifold/ui-react-native/stripe';
 
 /**
  * Unifold color palette for React Native
@@ -371,6 +371,11 @@ interface BottomSheetProps {
     onClose: () => void;
     children: React$1.ReactNode;
     closeOnBackdropPress?: boolean;
+    /** Handler invoked when the backdrop is tapped (and `closeOnBackdropPress`
+     *  is true). Defaults to `onClose`. Provide this when a backdrop tap should
+     *  behave differently from pan-down/hardware-back (e.g. fully dismiss a
+     *  multi-screen modal instead of navigating back one step). */
+    onBackdropPress?: () => void;
     enablePanDownToClose?: boolean;
     showHandle?: boolean;
     heightPercent?: number;
@@ -389,7 +394,7 @@ interface BottomSheetProps {
      *  Use this for sheets that must appear on top of an already-open Modal (iOS limitation). */
     useModal?: boolean;
 }
-declare function BottomSheet({ visible, onClose, children, closeOnBackdropPress, enablePanDownToClose, showHandle, heightPercent, maxHeightPercent, startExpanded, noPadding, borderTopLeftRadius, borderTopRightRadius, marginHorizontal: marginH, marginBottom: marginBottomProp, overlay, useModal: useModalProp, }: BottomSheetProps): React$1.JSX.Element | null;
+declare function BottomSheet({ visible, onClose, children, closeOnBackdropPress, onBackdropPress, enablePanDownToClose, showHandle, heightPercent, maxHeightPercent, startExpanded, noPadding, borderTopLeftRadius, borderTopRightRadius, marginHorizontal: marginH, marginBottom: marginBottomProp, overlay, useModal: useModalProp, }: BottomSheetProps): React$1.JSX.Element | null;
 
 /** Controls which transfer crypto input variant is rendered */
 type TransferInputVariant = "single_input" | "double_input" | "compact";
@@ -401,11 +406,26 @@ type TransferInputVariant = "single_input" | "double_input" | "compact";
 type DepositMenuDisplay = "stacked" | "tabs";
 /** Controls which screen opens first when the deposit modal is shown */
 type DepositInitialScreen = "main" | "transfer" | "card" | "tracker" | "cashapp" | "wallet";
+/**
+ * Host-app-supplied user identity used to pre-fill supported flows.
+ * Currently consumed by Stripe Link Pay (email/phone pre-fill). Kept as an
+ * extensible object so more fields can be added later without new top-level
+ * props.
+ */
+interface UnifoldUser {
+    /** Pre-fills the user's email (e.g. Stripe Link Pay). */
+    email?: string;
+    /** Pre-fills the user's phone; with `email`, Stripe may skip verify steps. */
+    phone?: string;
+}
 interface DepositModalProps {
     /** Whether the modal is visible */
     visible: boolean;
     /** Callback when the modal should close */
     onClose: () => void;
+    /** When true, tapping the backdrop (outside the sheet) dismisses the deposit
+     *  modal. Defaults to false so an outside tap does not dismiss. */
+    closeOnBackdropPress?: boolean;
     /** User ID for the deposit */
     externalUserId: string;
     /** Publishable API key */
@@ -441,19 +461,14 @@ interface DepositModalProps {
     /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
     enableFiatOnramp?: boolean;
     /** Show "Pay with Link" (Stripe) option in the deposit menu */
-    enableStripeLinkPay?: boolean;
-    /** Registered Stripe onramp component (Connect sets this from `enableStripeLinkPay`) */
+    enableStripeLink?: boolean;
+    /** Registered Stripe onramp component (Connect sets this from `enableStripeLink`) */
     StripeOnrampComponent?: React$1.ComponentType<any>;
-    /** Pre-fills Stripe Link Pay email — set via `beginDeposit({ stripeOnrampEmail })` (forwarded as `email` on `StripeOnramp`) */
-    stripeOnrampEmail?: string;
-    /** Pre-fills Stripe Link Pay phone — set via `beginDeposit({ stripeOnrampPhone })` (forwarded as `phone` on `StripeOnramp`) */
-    stripeOnrampPhone?: string;
     /**
-     * Apple Pay merchant id for Stripe Link Pay. Forwarded to `StripeOnramp` as `merchantIdentifier`.
-     * On Expo, you can omit this if the same value is set on the `@stripe/stripe-react-native` plugin
-     * in app.json (the UI reads it via `expo-constants`).
+     * Host-app-supplied user identity. Pre-fills supported flows (currently Stripe
+     * Link Pay email/phone). Set via `beginDeposit({ user })`.
      */
-    stripeMerchantIdentifier?: string;
+    user?: UnifoldUser;
     /** Where to render the Stripe payment method selector: "header" or "inline". Default: "header" */
     stripePaymentSelectorPosition?: "header" | "inline";
     /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
@@ -521,7 +536,7 @@ interface DepositModalProps {
         /** Price impact & slippage info sheet */
         infoSheet?: BorderRadiusConfig;
         /** Stripe Link Pay sheet */
-        stripeLinkPay?: BorderRadiusConfig;
+        stripeLink?: BorderRadiusConfig;
         /** Cash App sheet */
         cashApp?: BorderRadiusConfig;
         /** Connect Wallet sheet */
@@ -628,7 +643,7 @@ interface UnifoldConnectProviderConfig {
          * Show "Pay with Link" (Stripe) option in the deposit menu.
          * Stripe onramp is bundled with Connect; set to false to hide the option.
          */
-        enableStripeLinkPay?: boolean;
+        enableStripeLink?: boolean;
         /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableTransferCrypto?: boolean;
         /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
@@ -637,17 +652,13 @@ interface UnifoldConnectProviderConfig {
         enableConnectWallet?: boolean;
         /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableFiatOnramp?: boolean;
-        /**
-         * Apple Pay merchant id (`merchant.com...`) for Stripe Link Pay. Must match the
-         * `merchantIdentifier` in the `@stripe/stripe-react-native` Expo plugin (app.json).
-         * On Expo you can omit this if it is only set in the plugin — `StripeOnramp` reads it from
-         * `expo-constants`. Use this for bare React Native or to override.
-         */
-        stripeMerchantIdentifier?: string;
-        /** Where to render the Stripe payment method selector: "header" (above amount) or "inline" (below). Default: "header" */
-        stripePaymentSelectorPosition?: "header" | "inline";
-        /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
-        stripeSkipSuccessConfirmation?: boolean;
+        /** Stripe Link Pay tuning options (only applies when `enableStripeLink` is true). */
+        stripeLink?: {
+            /** Where to render the Stripe payment method selector: "header" (above amount) or "inline" (below). Default: "header" */
+            paymentSelectorPosition?: "header" | "inline";
+            /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
+            skipSuccessConfirmation?: boolean;
+        };
     };
 }
 interface DepositResult {
@@ -671,10 +682,13 @@ interface DepositConfig {
     defaultChainId?: string;
     defaultTokenAddress?: string;
     showBalance?: boolean;
-    /** Pre-fills Stripe Link Pay email (`beginDeposit` only — not provider config) */
-    stripeOnrampEmail?: string;
-    /** Pre-fills Stripe Link Pay phone; with `stripeOnrampEmail`, Stripe may skip verify steps */
-    stripeOnrampPhone?: string;
+    /**
+     * Host-app-supplied user identity (`beginDeposit` only — not provider config).
+     * Pre-fills supported flows; currently Stripe Link Pay uses `user.email` /
+     * `user.phone` (with both set, Stripe may skip verify steps). Kept as an
+     * object so more fields can be added later without new `stripeXxx` params.
+     */
+    user?: UnifoldUser;
     /**
      * How deposit confirmation and waiting behavior is handled.
      * - auto_ui (default): Automatically show "Processing deposit" UI and start polling after 10s. No "I've deposited" button.
@@ -692,6 +706,11 @@ interface DepositConfig {
     initialScreen?: DepositInitialScreen;
     onSuccess?: (data: DepositResult) => void;
     onError?: (error: DepositError) => void;
+    /** Called when the user dismisses the deposit modal */
+    onDismiss?: () => void;
+    /** When true, tapping outside the deposit modal (backdrop) dismisses it and
+     *  triggers `onDismiss`. Defaults to false. */
+    closeOnBackdropPress?: boolean;
 }
 interface WithdrawResult {
     message: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import React$1, { ReactNode } from 'react';
-export { AmountScreen, CreateSessionParams, CustomerVerification, KYCData, KYCWizardScreen, OnrampConfig, OnrampCustomer, OnrampError, OnrampErrorCode, OnrampScreen, OnrampSession, OnrampSessionTransactionDetails, OnrampStep, OnrampTransaction, StripeOnramp, StripeOnrampHook, StripeOnrampPreconfigure, StripeOnrampProps, getStripePublishableKey, setStripeOnrampApiUrl, setStripeOnrampPublishableKey, useStripeOnramp } from '@unifold/ui-react-native/stripe';
+export { AmountScreen, CreateSessionParams, CustomerVerification, KYCData, KYCWizardScreen, OnrampConfig, OnrampCustomer, OnrampError, OnrampErrorCode, OnrampScreen, OnrampSession, OnrampSessionTransactionDetails, OnrampStep, OnrampTransaction, StripeOnramp, StripeOnrampConfig, StripeOnrampHook, StripeOnrampPreconfigure, StripeOnrampProps, getStripeConfig, getStripePublishableKey, setStripeOnrampApiUrl, setStripeOnrampPublishableKey, useStripeOnramp } from '@unifold/ui-react-native/stripe';
 
 /**
  * Unifold color palette for React Native
@@ -371,6 +371,11 @@ interface BottomSheetProps {
     onClose: () => void;
     children: React$1.ReactNode;
     closeOnBackdropPress?: boolean;
+    /** Handler invoked when the backdrop is tapped (and `closeOnBackdropPress`
+     *  is true). Defaults to `onClose`. Provide this when a backdrop tap should
+     *  behave differently from pan-down/hardware-back (e.g. fully dismiss a
+     *  multi-screen modal instead of navigating back one step). */
+    onBackdropPress?: () => void;
     enablePanDownToClose?: boolean;
     showHandle?: boolean;
     heightPercent?: number;
@@ -389,7 +394,7 @@ interface BottomSheetProps {
      *  Use this for sheets that must appear on top of an already-open Modal (iOS limitation). */
     useModal?: boolean;
 }
-declare function BottomSheet({ visible, onClose, children, closeOnBackdropPress, enablePanDownToClose, showHandle, heightPercent, maxHeightPercent, startExpanded, noPadding, borderTopLeftRadius, borderTopRightRadius, marginHorizontal: marginH, marginBottom: marginBottomProp, overlay, useModal: useModalProp, }: BottomSheetProps): React$1.JSX.Element | null;
+declare function BottomSheet({ visible, onClose, children, closeOnBackdropPress, onBackdropPress, enablePanDownToClose, showHandle, heightPercent, maxHeightPercent, startExpanded, noPadding, borderTopLeftRadius, borderTopRightRadius, marginHorizontal: marginH, marginBottom: marginBottomProp, overlay, useModal: useModalProp, }: BottomSheetProps): React$1.JSX.Element | null;
 
 /** Controls which transfer crypto input variant is rendered */
 type TransferInputVariant = "single_input" | "double_input" | "compact";
@@ -401,11 +406,26 @@ type TransferInputVariant = "single_input" | "double_input" | "compact";
 type DepositMenuDisplay = "stacked" | "tabs";
 /** Controls which screen opens first when the deposit modal is shown */
 type DepositInitialScreen = "main" | "transfer" | "card" | "tracker" | "cashapp" | "wallet";
+/**
+ * Host-app-supplied user identity used to pre-fill supported flows.
+ * Currently consumed by Stripe Link Pay (email/phone pre-fill). Kept as an
+ * extensible object so more fields can be added later without new top-level
+ * props.
+ */
+interface UnifoldUser {
+    /** Pre-fills the user's email (e.g. Stripe Link Pay). */
+    email?: string;
+    /** Pre-fills the user's phone; with `email`, Stripe may skip verify steps. */
+    phone?: string;
+}
 interface DepositModalProps {
     /** Whether the modal is visible */
     visible: boolean;
     /** Callback when the modal should close */
     onClose: () => void;
+    /** When true, tapping the backdrop (outside the sheet) dismisses the deposit
+     *  modal. Defaults to false so an outside tap does not dismiss. */
+    closeOnBackdropPress?: boolean;
     /** User ID for the deposit */
     externalUserId: string;
     /** Publishable API key */
@@ -441,19 +461,14 @@ interface DepositModalProps {
     /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
     enableFiatOnramp?: boolean;
     /** Show "Pay with Link" (Stripe) option in the deposit menu */
-    enableStripeLinkPay?: boolean;
-    /** Registered Stripe onramp component (Connect sets this from `enableStripeLinkPay`) */
+    enableStripeLink?: boolean;
+    /** Registered Stripe onramp component (Connect sets this from `enableStripeLink`) */
     StripeOnrampComponent?: React$1.ComponentType<any>;
-    /** Pre-fills Stripe Link Pay email — set via `beginDeposit({ stripeOnrampEmail })` (forwarded as `email` on `StripeOnramp`) */
-    stripeOnrampEmail?: string;
-    /** Pre-fills Stripe Link Pay phone — set via `beginDeposit({ stripeOnrampPhone })` (forwarded as `phone` on `StripeOnramp`) */
-    stripeOnrampPhone?: string;
     /**
-     * Apple Pay merchant id for Stripe Link Pay. Forwarded to `StripeOnramp` as `merchantIdentifier`.
-     * On Expo, you can omit this if the same value is set on the `@stripe/stripe-react-native` plugin
-     * in app.json (the UI reads it via `expo-constants`).
+     * Host-app-supplied user identity. Pre-fills supported flows (currently Stripe
+     * Link Pay email/phone). Set via `beginDeposit({ user })`.
      */
-    stripeMerchantIdentifier?: string;
+    user?: UnifoldUser;
     /** Where to render the Stripe payment method selector: "header" or "inline". Default: "header" */
     stripePaymentSelectorPosition?: "header" | "inline";
     /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
@@ -521,7 +536,7 @@ interface DepositModalProps {
         /** Price impact & slippage info sheet */
         infoSheet?: BorderRadiusConfig;
         /** Stripe Link Pay sheet */
-        stripeLinkPay?: BorderRadiusConfig;
+        stripeLink?: BorderRadiusConfig;
         /** Cash App sheet */
         cashApp?: BorderRadiusConfig;
         /** Connect Wallet sheet */
@@ -628,7 +643,7 @@ interface UnifoldConnectProviderConfig {
          * Show "Pay with Link" (Stripe) option in the deposit menu.
          * Stripe onramp is bundled with Connect; set to false to hide the option.
          */
-        enableStripeLinkPay?: boolean;
+        enableStripeLink?: boolean;
         /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableTransferCrypto?: boolean;
         /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
@@ -637,17 +652,13 @@ interface UnifoldConnectProviderConfig {
         enableConnectWallet?: boolean;
         /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableFiatOnramp?: boolean;
-        /**
-         * Apple Pay merchant id (`merchant.com...`) for Stripe Link Pay. Must match the
-         * `merchantIdentifier` in the `@stripe/stripe-react-native` Expo plugin (app.json).
-         * On Expo you can omit this if it is only set in the plugin — `StripeOnramp` reads it from
-         * `expo-constants`. Use this for bare React Native or to override.
-         */
-        stripeMerchantIdentifier?: string;
-        /** Where to render the Stripe payment method selector: "header" (above amount) or "inline" (below). Default: "header" */
-        stripePaymentSelectorPosition?: "header" | "inline";
-        /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
-        stripeSkipSuccessConfirmation?: boolean;
+        /** Stripe Link Pay tuning options (only applies when `enableStripeLink` is true). */
+        stripeLink?: {
+            /** Where to render the Stripe payment method selector: "header" (above amount) or "inline" (below). Default: "header" */
+            paymentSelectorPosition?: "header" | "inline";
+            /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
+            skipSuccessConfirmation?: boolean;
+        };
     };
 }
 interface DepositResult {
@@ -671,10 +682,13 @@ interface DepositConfig {
     defaultChainId?: string;
     defaultTokenAddress?: string;
     showBalance?: boolean;
-    /** Pre-fills Stripe Link Pay email (`beginDeposit` only — not provider config) */
-    stripeOnrampEmail?: string;
-    /** Pre-fills Stripe Link Pay phone; with `stripeOnrampEmail`, Stripe may skip verify steps */
-    stripeOnrampPhone?: string;
+    /**
+     * Host-app-supplied user identity (`beginDeposit` only — not provider config).
+     * Pre-fills supported flows; currently Stripe Link Pay uses `user.email` /
+     * `user.phone` (with both set, Stripe may skip verify steps). Kept as an
+     * object so more fields can be added later without new `stripeXxx` params.
+     */
+    user?: UnifoldUser;
     /**
      * How deposit confirmation and waiting behavior is handled.
      * - auto_ui (default): Automatically show "Processing deposit" UI and start polling after 10s. No "I've deposited" button.
@@ -692,6 +706,11 @@ interface DepositConfig {
     initialScreen?: DepositInitialScreen;
     onSuccess?: (data: DepositResult) => void;
     onError?: (error: DepositError) => void;
+    /** Called when the user dismisses the deposit modal */
+    onDismiss?: () => void;
+    /** When true, tapping outside the deposit modal (backdrop) dismisses it and
+     *  triggers `onDismiss`. Defaults to false. */
+    closeOnBackdropPress?: boolean;
 }
 interface WithdrawResult {
     message: string;