@moonpay/platform-sdk-react-native 1.16.0 → 1.18.0

package/dist/index.d.cts

@@ -28,15 +28,15 @@ import * as GooglePaySdk from '@moonpay/platform-protocol/sdks/google-pay';
 export { Event as GooglePayEvent, SetupError as SetupGooglePayError } from '@moonpay/platform-protocol/sdks/google-pay';
 import * as WidgetSdk from '@moonpay/platform-protocol/sdks/widget';
 export { SetupError as SetupWidgetError, Event as WidgetEvent } from '@moonpay/platform-protocol/sdks/widget';
-import { FrameTransport, FrameOptions, PresentationMode, ThemeOptions, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
-export { ListAssetsParams, ThemeOptions } from '@moonpay/platform-sdk-core';
+import { FrameTransport, FrameOptions, PresentationMode, ThemeOptions, Credentials, GetCredentialsError, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
+export { Credentials, GetCredentialsError, ListAssetsParams, ThemeOptions } from '@moonpay/platform-sdk-core';
 import { GetPaymentMethodsError, GetQuoteError, GetAssetsError, GetTransactionsError, SimulateBankTransferError, DevPlatformApiError, GetCustomerError, SubmitCustomerKycError, GetCustomerUploadUrlError, SubmitCustomerFilesError, CreateIdentityError, GetIdentityError, UpdateIdentityError, VerifyIdentityError, GetIdentityUploadUrlError, SubmitIdentityFilesError } from '@moonpay/platform-protocol/api/errors';
 import { UpdateIdentityRequestBody, IdentityFileUploadUrlRequestBody, IdentityFileUploadUrl, SubmitIdentityFilesRequestBody, CreateIdentityRequestBody, Identity, IdentityVerificationResponse } from '@moonpay/platform-protocol/api/identity';
 import { ResetConnectionError } from '@moonpay/platform-protocol/sdks/reset';
 import { ViewStyle } from 'react-native';
+import WebView, { WebViewProps } from 'react-native-webview';
 import { ProtocolMessage } from '@moonpay/platform-protocol/protocol';
 import { RefObject, ReactNode } from 'react';
-import WebView from 'react-native-webview';
 
 /**
  * Transport surface the RN SDK passes around internally. `WebViewTransport`
@@ -234,6 +234,18 @@ interface RNClient {
      * call `setupAuth()` to drive the customer through email/OTP.
      */
     setupAuth(options: SetupAuthOptions): Promise<Result<AuthFrame, AuthSdk.SetupError>>;
+    /**
+     * Returns the connected customer's `{ accessToken, clientToken }` so you can
+     * forward the `accessToken` to your own backend for customer-scoped Platform
+     * API calls (e.g. server-side quote fetching).
+     *
+     * Advanced escape hatch — the SDK otherwise keeps these credentials internal.
+     * The `accessToken` is short-lived and scoped to the connected customer. Errs
+     * with `noActiveSession` until a customer session exists — call
+     * `getConnection()` (and `connect()` / `setupAuth()` where needed) first.
+     * Synchronous — returns a `Result`, not a Promise.
+     */
+    getCredentials(): Result<Credentials, GetCredentialsError>;
     getPaymentMethods(): Promise<Result<{
         data: ListPaymentMethodsResponse;
     }, GetPaymentMethodsError>>;
@@ -318,9 +330,11 @@ interface MoonPayAddCardProps {
     onEvent?: (event: AddCardSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline add-card frame — embed card entry in your own layout/animation. */
-declare function MoonPayAddCard({ onEvent, style }: MoonPayAddCardProps): JSX.Element;
+declare function MoonPayAddCard({ onEvent, style, webViewProps }: MoonPayAddCardProps): JSX.Element;
 
 interface MoonPayApplePayButtonProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -331,22 +345,26 @@ interface MoonPayApplePayButtonProps {
     onEvent?: (event: ApplePaySdk.Event) => void;
     /** Container style. Defaults to height 48. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline Apple Pay button. Render it wherever it should appear in your layout. */
-declare function MoonPayApplePayButton({ quote, externalTransactionId, onEvent, style, }: MoonPayApplePayButtonProps): JSX.Element;
+declare function MoonPayApplePayButton({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayApplePayButtonProps): JSX.Element;
 
 interface MoonPayAuthProps {
     /** Callback for auth lifecycle events. */
     onEvent?: (event: AuthSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /**
  * Inline auth frame for headless / Identity-API integrations. Requires a clientToken in context —
  * call getConnection() (or render <MoonPayConnectionCheck>) first; if it resolves with
  * `connectionRequired`, mount this component. Emits an error event otherwise.
  */
-declare function MoonPayAuth({ onEvent, style }: MoonPayAuthProps): JSX.Element;
+declare function MoonPayAuth({ onEvent, style, webViewProps }: MoonPayAuthProps): JSX.Element;
 
 interface MoonPayBuyButtonProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -357,9 +375,11 @@ interface MoonPayBuyButtonProps {
     onEvent?: (event: BuyButtonSdk.Event) => void;
     /** Container style. Defaults to height 48. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline card/buy button. Render it wherever it should appear in your layout. */
-declare function MoonPayBuyButton({ quote, externalTransactionId, onEvent, style, }: MoonPayBuyButtonProps): JSX.Element;
+declare function MoonPayBuyButton({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayBuyButtonProps): JSX.Element;
 
 interface MoonPayBuyFrameProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -368,9 +388,11 @@ interface MoonPayBuyFrameProps {
     externalTransactionId?: string;
     /** Callback for buy frame lifecycle events. */
     onEvent?: (event: BuySdk.Event) => void;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Headless buy frame (renders nothing visible). The declarative alternative to client.setupBuy(). */
-declare function MoonPayBuyFrame({ quote, externalTransactionId, onEvent, }: MoonPayBuyFrameProps): JSX.Element;
+declare function MoonPayBuyFrame({ quote, externalTransactionId, onEvent, webViewProps, }: MoonPayBuyFrameProps): JSX.Element;
 
 interface MoonPayChallengeProps {
     /** Full challenge URL received from a frame's `challenge` event. Mount-time only. */
@@ -379,9 +401,11 @@ interface MoonPayChallengeProps {
     onEvent?: (event: ChallengeSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline 3DS/challenge frame. Mount it when a payment frame emits a `challenge` event. */
-declare function MoonPayChallenge({ url, onEvent, style }: MoonPayChallengeProps): JSX.Element;
+declare function MoonPayChallenge({ url, onEvent, style, webViewProps, }: MoonPayChallengeProps): JSX.Element;
 
 interface MoonPayConnectProps {
     /** Theme for this connect frame. Overrides the provider-level `theme`. Mount-time only. */
@@ -390,9 +414,11 @@ interface MoonPayConnectProps {
     onEvent?: (event: ConnectSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline connect frame. On an active completion, credentials are applied to the shared client automatically. */
-declare function MoonPayConnect({ theme, onEvent, style }: MoonPayConnectProps): JSX.Element;
+declare function MoonPayConnect({ theme, onEvent, style, webViewProps, }: MoonPayConnectProps): JSX.Element;
 
 type ConnectionCheckEvent = {
     kind: 'complete';
@@ -417,29 +443,35 @@ interface MoonPayConnectionCheckProps {
     skipKyc?: boolean;
     /** Emits `complete` with the Connection, or `error`. */
     onEvent?: (event: ConnectionCheckEvent) => void;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /**
  * Headless connection check (renders nothing visible). The declarative
  * alternative to client.getConnection() — on an active connection,
  * credentials are applied to the shared client automatically.
  */
-declare function MoonPayConnectionCheck({ skipKyc, onEvent, }: MoonPayConnectionCheckProps): JSX.Element;
+declare function MoonPayConnectionCheck({ skipKyc, onEvent, webViewProps, }: MoonPayConnectionCheckProps): JSX.Element;
 
 interface MoonPayConnectionResetProps {
     /** Callback for connection reset lifecycle events. */
     onEvent?: (event: ConnectionResetEvent) => void;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Headless reset frame (renders nothing visible). The declarative alternative to client.resetConnection(). */
-declare function MoonPayConnectionReset({ onEvent }: MoonPayConnectionResetProps): JSX.Element;
+declare function MoonPayConnectionReset({ onEvent, webViewProps, }: MoonPayConnectionResetProps): JSX.Element;
 
 interface MoonPayCustomerExportProps {
     /** Callback for customer-export lifecycle events. */
     onEvent?: (event: CustomerExportSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline customer-export consent frame — embed export consent capture in your own layout. */
-declare function MoonPayCustomerExport({ onEvent, style }: MoonPayCustomerExportProps): JSX.Element;
+declare function MoonPayCustomerExport({ onEvent, style, webViewProps, }: MoonPayCustomerExportProps): JSX.Element;
 
 interface MoonPayGooglePayButtonProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -450,9 +482,11 @@ interface MoonPayGooglePayButtonProps {
     onEvent?: (event: GooglePaySdk.Event) => void;
     /** Container style. Defaults to height 48. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline Google Pay button. Render it wherever it should appear in your layout. */
-declare function MoonPayGooglePayButton({ quote, externalTransactionId, onEvent, style, }: MoonPayGooglePayButtonProps): JSX.Element;
+declare function MoonPayGooglePayButton({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayGooglePayButtonProps): JSX.Element;
 
 interface MoonPayWidgetProps {
     /** Quote signature from getQuote(). Mount-time only — changing it reloads the widget. */
@@ -463,9 +497,11 @@ interface MoonPayWidgetProps {
     onEvent?: (event: WidgetSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline widget frame. Render it wherever it should appear in your layout. */
-declare function MoonPayWidget({ quote, externalTransactionId, onEvent, style, }: MoonPayWidgetProps): JSX.Element;
+declare function MoonPayWidget({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayWidgetProps): JSX.Element;
 
 interface MoonPayFrameProps {
     /** The transport instance managing this frame's communication. */
@@ -474,12 +510,18 @@ interface MoonPayFrameProps {
     hidden?: boolean;
     /** Optional style overrides for the container view. */
     style?: ViewStyle;
+    /**
+     * Advanced: extra props forwarded to the underlying react-native-webview.
+     * `ref`, `source`, and `onMessage` are managed by the SDK and cannot be
+     * overridden; all other props (including `originWhitelist`) may be set here.
+     */
+    webViewProps?: Partial<WebViewProps>;
 }
 /**
  * Reusable React Native component that renders a MoonPay frame as a WebView.
  * Bridges the WebViewTransport to the actual WebView instance.
  */
-declare function MoonPayFrame({ transport, hidden, style }: MoonPayFrameProps): JSX.Element | null;
+declare function MoonPayFrame({ transport, hidden, style, webViewProps, }: MoonPayFrameProps): JSX.Element | null;
 
 interface MoonPayProviderProps {
     /**

package/dist/index.d.ts

@@ -28,15 +28,15 @@ import * as GooglePaySdk from '@moonpay/platform-protocol/sdks/google-pay';
 export { Event as GooglePayEvent, SetupError as SetupGooglePayError } from '@moonpay/platform-protocol/sdks/google-pay';
 import * as WidgetSdk from '@moonpay/platform-protocol/sdks/widget';
 export { SetupError as SetupWidgetError, Event as WidgetEvent } from '@moonpay/platform-protocol/sdks/widget';
-import { FrameTransport, FrameOptions, PresentationMode, ThemeOptions, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
-export { ListAssetsParams, ThemeOptions } from '@moonpay/platform-sdk-core';
+import { FrameTransport, FrameOptions, PresentationMode, ThemeOptions, Credentials, GetCredentialsError, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
+export { Credentials, GetCredentialsError, ListAssetsParams, ThemeOptions } from '@moonpay/platform-sdk-core';
 import { GetPaymentMethodsError, GetQuoteError, GetAssetsError, GetTransactionsError, SimulateBankTransferError, DevPlatformApiError, GetCustomerError, SubmitCustomerKycError, GetCustomerUploadUrlError, SubmitCustomerFilesError, CreateIdentityError, GetIdentityError, UpdateIdentityError, VerifyIdentityError, GetIdentityUploadUrlError, SubmitIdentityFilesError } from '@moonpay/platform-protocol/api/errors';
 import { UpdateIdentityRequestBody, IdentityFileUploadUrlRequestBody, IdentityFileUploadUrl, SubmitIdentityFilesRequestBody, CreateIdentityRequestBody, Identity, IdentityVerificationResponse } from '@moonpay/platform-protocol/api/identity';
 import { ResetConnectionError } from '@moonpay/platform-protocol/sdks/reset';
 import { ViewStyle } from 'react-native';
+import WebView, { WebViewProps } from 'react-native-webview';
 import { ProtocolMessage } from '@moonpay/platform-protocol/protocol';
 import { RefObject, ReactNode } from 'react';
-import WebView from 'react-native-webview';
 
 /**
  * Transport surface the RN SDK passes around internally. `WebViewTransport`
@@ -234,6 +234,18 @@ interface RNClient {
      * call `setupAuth()` to drive the customer through email/OTP.
      */
     setupAuth(options: SetupAuthOptions): Promise<Result<AuthFrame, AuthSdk.SetupError>>;
+    /**
+     * Returns the connected customer's `{ accessToken, clientToken }` so you can
+     * forward the `accessToken` to your own backend for customer-scoped Platform
+     * API calls (e.g. server-side quote fetching).
+     *
+     * Advanced escape hatch — the SDK otherwise keeps these credentials internal.
+     * The `accessToken` is short-lived and scoped to the connected customer. Errs
+     * with `noActiveSession` until a customer session exists — call
+     * `getConnection()` (and `connect()` / `setupAuth()` where needed) first.
+     * Synchronous — returns a `Result`, not a Promise.
+     */
+    getCredentials(): Result<Credentials, GetCredentialsError>;
     getPaymentMethods(): Promise<Result<{
         data: ListPaymentMethodsResponse;
     }, GetPaymentMethodsError>>;
@@ -318,9 +330,11 @@ interface MoonPayAddCardProps {
     onEvent?: (event: AddCardSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline add-card frame — embed card entry in your own layout/animation. */
-declare function MoonPayAddCard({ onEvent, style }: MoonPayAddCardProps): JSX.Element;
+declare function MoonPayAddCard({ onEvent, style, webViewProps }: MoonPayAddCardProps): JSX.Element;
 
 interface MoonPayApplePayButtonProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -331,22 +345,26 @@ interface MoonPayApplePayButtonProps {
     onEvent?: (event: ApplePaySdk.Event) => void;
     /** Container style. Defaults to height 48. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline Apple Pay button. Render it wherever it should appear in your layout. */
-declare function MoonPayApplePayButton({ quote, externalTransactionId, onEvent, style, }: MoonPayApplePayButtonProps): JSX.Element;
+declare function MoonPayApplePayButton({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayApplePayButtonProps): JSX.Element;
 
 interface MoonPayAuthProps {
     /** Callback for auth lifecycle events. */
     onEvent?: (event: AuthSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /**
  * Inline auth frame for headless / Identity-API integrations. Requires a clientToken in context —
  * call getConnection() (or render <MoonPayConnectionCheck>) first; if it resolves with
  * `connectionRequired`, mount this component. Emits an error event otherwise.
  */
-declare function MoonPayAuth({ onEvent, style }: MoonPayAuthProps): JSX.Element;
+declare function MoonPayAuth({ onEvent, style, webViewProps }: MoonPayAuthProps): JSX.Element;
 
 interface MoonPayBuyButtonProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -357,9 +375,11 @@ interface MoonPayBuyButtonProps {
     onEvent?: (event: BuyButtonSdk.Event) => void;
     /** Container style. Defaults to height 48. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline card/buy button. Render it wherever it should appear in your layout. */
-declare function MoonPayBuyButton({ quote, externalTransactionId, onEvent, style, }: MoonPayBuyButtonProps): JSX.Element;
+declare function MoonPayBuyButton({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayBuyButtonProps): JSX.Element;
 
 interface MoonPayBuyFrameProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -368,9 +388,11 @@ interface MoonPayBuyFrameProps {
     externalTransactionId?: string;
     /** Callback for buy frame lifecycle events. */
     onEvent?: (event: BuySdk.Event) => void;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Headless buy frame (renders nothing visible). The declarative alternative to client.setupBuy(). */
-declare function MoonPayBuyFrame({ quote, externalTransactionId, onEvent, }: MoonPayBuyFrameProps): JSX.Element;
+declare function MoonPayBuyFrame({ quote, externalTransactionId, onEvent, webViewProps, }: MoonPayBuyFrameProps): JSX.Element;
 
 interface MoonPayChallengeProps {
     /** Full challenge URL received from a frame's `challenge` event. Mount-time only. */
@@ -379,9 +401,11 @@ interface MoonPayChallengeProps {
     onEvent?: (event: ChallengeSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline 3DS/challenge frame. Mount it when a payment frame emits a `challenge` event. */
-declare function MoonPayChallenge({ url, onEvent, style }: MoonPayChallengeProps): JSX.Element;
+declare function MoonPayChallenge({ url, onEvent, style, webViewProps, }: MoonPayChallengeProps): JSX.Element;
 
 interface MoonPayConnectProps {
     /** Theme for this connect frame. Overrides the provider-level `theme`. Mount-time only. */
@@ -390,9 +414,11 @@ interface MoonPayConnectProps {
     onEvent?: (event: ConnectSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline connect frame. On an active completion, credentials are applied to the shared client automatically. */
-declare function MoonPayConnect({ theme, onEvent, style }: MoonPayConnectProps): JSX.Element;
+declare function MoonPayConnect({ theme, onEvent, style, webViewProps, }: MoonPayConnectProps): JSX.Element;
 
 type ConnectionCheckEvent = {
     kind: 'complete';
@@ -417,29 +443,35 @@ interface MoonPayConnectionCheckProps {
     skipKyc?: boolean;
     /** Emits `complete` with the Connection, or `error`. */
     onEvent?: (event: ConnectionCheckEvent) => void;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /**
  * Headless connection check (renders nothing visible). The declarative
  * alternative to client.getConnection() — on an active connection,
  * credentials are applied to the shared client automatically.
  */
-declare function MoonPayConnectionCheck({ skipKyc, onEvent, }: MoonPayConnectionCheckProps): JSX.Element;
+declare function MoonPayConnectionCheck({ skipKyc, onEvent, webViewProps, }: MoonPayConnectionCheckProps): JSX.Element;
 
 interface MoonPayConnectionResetProps {
     /** Callback for connection reset lifecycle events. */
     onEvent?: (event: ConnectionResetEvent) => void;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Headless reset frame (renders nothing visible). The declarative alternative to client.resetConnection(). */
-declare function MoonPayConnectionReset({ onEvent }: MoonPayConnectionResetProps): JSX.Element;
+declare function MoonPayConnectionReset({ onEvent, webViewProps, }: MoonPayConnectionResetProps): JSX.Element;
 
 interface MoonPayCustomerExportProps {
     /** Callback for customer-export lifecycle events. */
     onEvent?: (event: CustomerExportSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline customer-export consent frame — embed export consent capture in your own layout. */
-declare function MoonPayCustomerExport({ onEvent, style }: MoonPayCustomerExportProps): JSX.Element;
+declare function MoonPayCustomerExport({ onEvent, style, webViewProps, }: MoonPayCustomerExportProps): JSX.Element;
 
 interface MoonPayGooglePayButtonProps {
     /** Quote signature from getQuote(). Reactive — updates are pushed via setQuote without remounting. */
@@ -450,9 +482,11 @@ interface MoonPayGooglePayButtonProps {
     onEvent?: (event: GooglePaySdk.Event) => void;
     /** Container style. Defaults to height 48. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline Google Pay button. Render it wherever it should appear in your layout. */
-declare function MoonPayGooglePayButton({ quote, externalTransactionId, onEvent, style, }: MoonPayGooglePayButtonProps): JSX.Element;
+declare function MoonPayGooglePayButton({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayGooglePayButtonProps): JSX.Element;
 
 interface MoonPayWidgetProps {
     /** Quote signature from getQuote(). Mount-time only — changing it reloads the widget. */
@@ -463,9 +497,11 @@ interface MoonPayWidgetProps {
     onEvent?: (event: WidgetSdk.Event) => void;
     /** Container style. Defaults to flex: 1. */
     style?: ViewStyle;
+    /** Advanced props forwarded to the underlying react-native-webview. `ref`, `source`, and `onMessage` are SDK-managed. */
+    webViewProps?: Partial<WebViewProps>;
 }
 /** Inline widget frame. Render it wherever it should appear in your layout. */
-declare function MoonPayWidget({ quote, externalTransactionId, onEvent, style, }: MoonPayWidgetProps): JSX.Element;
+declare function MoonPayWidget({ quote, externalTransactionId, onEvent, style, webViewProps, }: MoonPayWidgetProps): JSX.Element;
 
 interface MoonPayFrameProps {
     /** The transport instance managing this frame's communication. */
@@ -474,12 +510,18 @@ interface MoonPayFrameProps {
     hidden?: boolean;
     /** Optional style overrides for the container view. */
     style?: ViewStyle;
+    /**
+     * Advanced: extra props forwarded to the underlying react-native-webview.
+     * `ref`, `source`, and `onMessage` are managed by the SDK and cannot be
+     * overridden; all other props (including `originWhitelist`) may be set here.
+     */
+    webViewProps?: Partial<WebViewProps>;
 }
 /**
  * Reusable React Native component that renders a MoonPay frame as a WebView.
  * Bridges the WebViewTransport to the actual WebView instance.
  */
-declare function MoonPayFrame({ transport, hidden, style }: MoonPayFrameProps): JSX.Element | null;
+declare function MoonPayFrame({ transport, hidden, style, webViewProps, }: MoonPayFrameProps): JSX.Element | null;
 
 interface MoonPayProviderProps {
     /**