@stripe/stripe-react-native 0.65.0 → 0.65.1

package/lib/typescript/src/types/EmbeddedPaymentElement.d.ts

@@ -1,4 +1,5 @@
 import type { BillingDetails, AddressDetails, UserInterfaceStyle, CardBrand } from './Common';
+import type { Checkout } from './Checkout';
 import * as PaymentSheetTypes from './PaymentSheet';
 import { ReactElement } from 'react';
 /**
@@ -201,7 +202,16 @@ export interface UseEmbeddedPaymentElementResult {
      * @note Upon completion, `paymentOption` may become null if it's no longer available.
      * @note If you call `update` while a previous call to `update` is still in progress, the previous call is canceled.
      */
-    update: (intentConfig: PaymentSheetTypes.IntentConfiguration) => void;
+    update: {
+        (intentConfig: PaymentSheetTypes.IntentConfiguration): void;
+        /**
+         * Call this method when the Checkout Session values you used to initialize
+         * `EmbeddedPaymentElement` change.
+         * @checkoutSessionsPreview
+         * @internal
+         */
+        (checkout: Checkout): void;
+    };
     clearPaymentOption: () => void;
     loadingError: Error | null;
     isLoaded: boolean;
@@ -215,4 +225,29 @@ export interface UseEmbeddedPaymentElementResult {
  * @description If loading fails, this function sets the loadingError state variable instead of throwing an error.
  */
 export declare function useEmbeddedPaymentElement(intentConfig: PaymentSheetTypes.IntentConfiguration, configuration: EmbeddedPaymentElementConfiguration): UseEmbeddedPaymentElementResult;
+/**
+ * Initializes an `EmbeddedPaymentElement` from a Stripe Checkout Session.
+ *
+ * Pass a loaded handle from `useCheckout`. Render the consumer in a child
+ * component so the hook only runs once `state.status === 'loaded'`.
+ *
+ * @example
+ * function Cart() {
+ *   const { checkout, state } = useCheckout(clientSecret);
+ *   if (state?.status !== 'loaded') return null;
+ *   return <EmbeddedCheckout checkout={checkout} />;
+ * }
+ *
+ * function EmbeddedCheckout({ checkout }: { checkout: Checkout }) {
+ *   const { embeddedPaymentElementView } =
+ *     useEmbeddedPaymentElement(checkout, configuration);
+ *   return embeddedPaymentElementView;
+ * }
+ *
+ * @param checkout - A loaded `Checkout` handle from `useCheckout`.
+ * @param configuration - Configuration for the embedded element.
+ * @checkoutSessionsPreview
+ * @internal
+ */
+export declare function useEmbeddedPaymentElement(checkout: Checkout, configuration: EmbeddedPaymentElementConfiguration): UseEmbeddedPaymentElementResult;
 //# sourceMappingURL=EmbeddedPaymentElement.d.ts.map

package/lib/typescript/src/types/EmbeddedPaymentElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmbeddedPaymentElement.d.ts","sourceRoot":"","sources":["../../../../src/types/EmbeddedPaymentElement.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"EmbeddedPaymentElement.d.ts","sourceRoot":"","sources":["../../../../src/types/EmbeddedPaymentElement.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-react-native",
-  "version": "0.65.0",
+  "version": "0.65.1",
   "author": "Stripe",
   "description": "Stripe SDK for React Native",
   "main": "lib/commonjs/index",
@@ -19,7 +19,7 @@
     "update-pods": "cd example/ios && pod update Stripe StripeApplePay StripeFinancialConnections StripePayments StripePaymentSheet StripePaymentsUI StripeCore StripeUICore StripeCryptoOnramp",
     "bootstrap": "yarn example && yarn && yarn pods",
     "bootstrap-no-pods": "yarn example && yarn",
-    "docs": "yarn typedoc ./src/index.tsx --out ./docs/api-reference --tsconfig ./tsconfig.json --readme none --sort source-order",
+    "docs": "yarn typedoc ./src/index.tsx --out ./docs/api-reference --tsconfig ./tsconfig.json --readme none --sort source-order --excludeInternal",
     "run-example-ios": "cd example && yarn ios --simulator \"iPhone 16 Pro Max\"",
     "run-example-ios:release": "cd example && yarn build:ios && yarn ios --mode Release --simulator \"iPhone 16 Pro Max\" --no-packager",
     "run-example-android": "cd example && yarn android",
@@ -35,6 +35,8 @@
     "lint:android": "cd android && ./gradlew detekt",
     "format:ios:check": "swiftlint ios --config .swiftlint.yml --strict",
     "format:ios:write": "./scripts/format-changed-ios",
+    "test:package-types": "attw --pack .",
+    "prepublishOnly": "echo \"\\nPlease use ./scripts/publish instead\\n\" && exit 1",
     "api-extractor:update": "bob build && api-extractor run --local --verbose",
     "api-extractor:check": "bob build && api-extractor run --verbose"
   },
@@ -70,6 +72,7 @@
   },
   "homepage": "https://github.com/stripe/stripe-react-native/#readme",
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.0",
     "@expo/config-plugins": "^9.0.16",
     "@microsoft/api-extractor": "^7.58.7",
     "@react-native/babel-preset": "^0.81.0",
@@ -83,6 +86,7 @@
     "eslint-plugin-prettier": "^5.1.3",
     "husky": "^9.1.7",
     "jest": "^29.2.1",
+    "lint-staged": "^16.4.0",
     "prettier": "^3.5.2",
     "react": "19.1.0",
     "react-native": "^0.81.0",
@@ -175,6 +179,12 @@
       "typescript"
     ]
   },
+  "lint-staged": {
+    "*.{js,ts,tsx}": "eslint --ignore-path .gitignore",
+    "*.{ts,tsx}": "bash -c 'yarn typescript'",
+    "*.kt": "bash -c 'yarn format:android:write'",
+    "*.swift": "bash -c 'yarn format:ios:write'"
+  },
   "resolutions": {
     "simple-plist": "1.3.1"
   },
@@ -192,7 +202,8 @@
         "CardForm": "CardFormComponentView",
         "EmbeddedPaymentElementView": "EmbeddedPaymentElementViewComponentView",
         "NavigationBar": "NavigationBarComponentView",
-        "StripeContainer": "StripeContainerComponentView"
+        "StripeContainer": "StripeContainerComponentView",
+        "StripeCurrencySelectorElement": "StripeCurrencySelectorElementComponentView"
       }
     },
     "name": "rnstripe",

package/src/components/CurrencySelectorElement.tsx

@@ -0,0 +1,95 @@
+import React, { useCallback, useState } from 'react';
+import {
+  AccessibilityProps,
+  LayoutAnimation,
+  NativeSyntheticEvent,
+} from 'react-native';
+import type { Checkout } from '../types/Checkout';
+import NativeCurrencySelectorElement, {
+  type HeightChangeEvent,
+} from '../specs/NativeCurrencySelectorElement';
+
+/**
+ * Props for {@link CurrencySelectorElement}.
+ * @internal
+ */
+export interface CurrencySelectorElementProps extends AccessibilityProps {
+  /**
+   * The `Checkout` handle returned by `useCheckout`.
+   *
+   * The element reads currency options from this session and calls
+   * `selectCurrency` internally — you never call it yourself.
+   */
+  checkout: Checkout;
+
+  /**
+   * When `true`, the toggle is visible but does not respond to taps.
+   *
+   * Tip: pass `disabled={state?.status === 'loading'}` to freeze the
+   * selector while an unrelated mutation (e.g. applying a promo code)
+   * is in flight. The element also disables itself automatically
+   * during its own currency-selection network call.
+   *
+   * @default false
+   */
+  disabled?: boolean;
+}
+
+/**
+ * A self-contained currency selector for Adaptive Pricing.
+ *
+ * Place this element on your cart or checkout page **near the total price**,
+ * above the Payment Element. It automatically:
+ *
+ * - Reads currency options from the `Checkout` session
+ * - Renders a two-option toggle with exchange rate disclosure
+ * - Calls `selectCurrency` when the customer taps an option
+ * - Collapses to zero height when Adaptive Pricing is unavailable
+ * - Displays inline errors on failed selections
+ *
+ * Session state updates automatically through `useCheckout` — no extra
+ * wiring needed to keep your cart totals in sync.
+ *
+ * @example
+ * ```tsx
+ * const { state, checkout } = useCheckout(clientSecret, {
+ *   adaptivePricing: { allowed: true },
+ * });
+ *
+ * return (
+ *   <ScrollView>
+ *     <CurrencySelectorElement checkout={checkout} />
+ *     <Text>{formatTotal(state?.session.totals?.total, state?.session.currency)}</Text>
+ *   </ScrollView>
+ * );
+ * ```
+ *
+ * @param props {@link CurrencySelectorElementProps}
+ * @category ReactComponents
+ * @internal
+ */
+export function CurrencySelectorElement({
+  checkout,
+  disabled = false,
+  ...a11yProps
+}: CurrencySelectorElementProps) {
+  const [height, setHeight] = useState<number>(0);
+
+  const handleHeightChange = useCallback(
+    (e: NativeSyntheticEvent<HeightChangeEvent>) => {
+      LayoutAnimation.configureNext(LayoutAnimation.Presets.easeInEaseOut);
+      setHeight(e.nativeEvent.height);
+    },
+    []
+  );
+
+  return (
+    <NativeCurrencySelectorElement
+      sessionKey={checkout.sessionKey}
+      disabled={disabled}
+      style={{ width: '100%', height }}
+      onHeightChange={handleHeightChange}
+      {...a11yProps}
+    />
+  );
+}

package/src/events.ts

@@ -66,6 +66,17 @@ type Events = {
   onCustomPaymentMethodConfirmHandlerCallback: EventEmitter<UnsafeObject<any>>;
   paymentMethodMessagingElementDidUpdateHeight: EventEmitter<UnsafeObject<any>>;
   paymentMethodMessagingElementConfigureResult: EventEmitter<UnsafeObject<any>>;
+  /**
+   * Fired by native every time a `Checkout` instance's state transitions —
+   * regardless of whether the mutation was JS-driven (e.g. `applyPromotionCode`
+   * via `useCheckout`) or native-driven (e.g. `CurrencySelectorElement`).
+   * `useCheckout` mirrors this into its `state` so the entire React tree
+   * stays in sync with the underlying native session.
+   */
+  checkoutSessionDidChangeState: EventEmitter<{
+    sessionKey: string;
+    state: UnsafeObject<any>;
+  }>;
 };
 
 export function addListener<EventT extends keyof Events>(

package/src/functions.ts

@@ -350,6 +350,33 @@ let financialConnectionsEventListener: EventSubscription | null = null;
 let paymentSheetCustomPaymentMethodConfirmCallback: EventSubscription | null =
   null;
 
+type NativeCheckoutSetupParams = Omit<
+  PaymentSheet.CheckoutSetupParams,
+  'checkout'
+> & {
+  checkout: {
+    sessionKey: string;
+  };
+};
+
+const toNativePaymentSheetSetupParams = (
+  params: PaymentSheet.SetupParams
+): PaymentSheet.SetupParams => {
+  if (!('checkout' in params)) {
+    return params;
+  }
+
+  const nativeCheckoutParams: NativeCheckoutSetupParams = {
+    ...params,
+    // The native side already owns the Checkout instance, so only pass its opaque session key.
+    checkout: {
+      sessionKey: params.checkout.sessionKey,
+    },
+  };
+
+  return nativeCheckoutParams as PaymentSheet.SetupParams;
+};
+
 export const initPaymentSheet = async (
   params: PaymentSheet.SetupParams
 ): Promise<InitPaymentSheetResult> => {
@@ -431,7 +458,9 @@ export const initPaymentSheet = async (
         `[@stripe/stripe-react-native] You have not provided the 'returnURL' field to 'initPaymentSheet', so payment methods that require redirects will not be shown in your iOS Payment Sheet. Visit https://stripe.com/docs/payments/accept-a-payment?platform=react-native&ui=payment-sheet#react-native-set-up-return-url to learn more.`
       );
     }
-    result = await NativeStripeSdk.initPaymentSheet(params);
+    result = await NativeStripeSdk.initPaymentSheet(
+      toNativePaymentSheetSetupParams(params)
+    );
 
     if (result.error) {
       return {

package/src/hooks/useCheckout.tsx

@@ -1,6 +1,7 @@
-import { useState, useEffect, useCallback, useRef } from 'react';
+import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
 import NativeStripeSdk from '../specs/NativeStripeSdkModule';
 import type { Checkout } from '../types/Checkout';
+import { addListener } from '../events';
 
 /**
  * Initializes a Stripe Checkout Session and returns a reactive handle.
@@ -55,9 +56,20 @@ export function useCheckout(
       }
     })();
 
+    // Listen for state changes from native (e.g. currency selector taps)
+    // so we stay in sync even when mutations don't originate from JS.
+    const sub = addListener(
+      'checkoutSessionDidChangeState',
+      ({ sessionKey, state: nextState }) => {
+        if (sessionKey !== sessionKeyRef.current) return;
+        setState(nextState as Checkout.State);
+      }
+    );
+
     // Ignore in-flight init if unmounted or clientSecret changed.
     return () => {
       cancelled = true;
+      sub.remove();
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [clientSecret]);
@@ -89,80 +101,107 @@ export function useCheckout(
     []
   );
 
-  // Mutation methods — each delegates to withLoading.
-  const checkout: Checkout = {
-    get sessionKey(): string {
-      if (!sessionKeyRef.current) {
-        throw new Error('Checkout session not initialized.');
-      }
-      return sessionKeyRef.current;
-    },
-    updateShippingAddress: useCallback(
-      (address, name, phone) =>
-        withLoading((key) =>
-          NativeStripeSdk.checkoutUpdateShippingAddress(
-            key,
-            address,
-            name ?? null,
-            phone ?? null
-          )
-        ),
-      [withLoading]
-    ),
-    updateBillingAddress: useCallback(
-      (address, name, phone) =>
-        withLoading((key) =>
-          NativeStripeSdk.checkoutUpdateBillingAddress(
-            key,
-            address,
-            name ?? null,
-            phone ?? null
-          )
-        ),
-      [withLoading]
-    ),
-    applyPromotionCode: useCallback(
-      (code) =>
-        withLoading((key) =>
-          NativeStripeSdk.checkoutApplyPromotionCode(key, code)
-        ),
-      [withLoading]
-    ),
-    removePromotionCode: useCallback(
-      () =>
-        withLoading((key) => NativeStripeSdk.checkoutRemovePromotionCode(key)),
-      [withLoading]
-    ),
-    updateLineItemQuantity: useCallback(
-      (lineItemId, quantity) =>
-        withLoading((key) =>
-          NativeStripeSdk.checkoutUpdateLineItemQuantity(
-            key,
-            lineItemId,
-            quantity
-          )
-        ),
-      [withLoading]
-    ),
-    selectShippingOption: useCallback(
-      (id) =>
-        withLoading((key) =>
-          NativeStripeSdk.checkoutSelectShippingOption(key, id)
-        ),
-      [withLoading]
-    ),
-    updateTaxId: useCallback(
-      (type, value) =>
-        withLoading((key) =>
-          NativeStripeSdk.checkoutUpdateTaxId(key, type, value)
-        ),
-      [withLoading]
-    ),
-    refresh: useCallback(
-      () => withLoading((key) => NativeStripeSdk.checkoutRefresh(key)),
-      [withLoading]
-    ),
-  };
+  // Mutation methods. Each is memoized so `checkout` has a stable identity.
+  const updateShippingAddress = useCallback<Checkout['updateShippingAddress']>(
+    (address, name, phone) =>
+      withLoading((key) =>
+        NativeStripeSdk.checkoutUpdateShippingAddress(
+          key,
+          address,
+          name ?? null,
+          phone ?? null
+        )
+      ),
+    [withLoading]
+  );
+  const updateBillingAddress = useCallback<Checkout['updateBillingAddress']>(
+    (address, name, phone) =>
+      withLoading((key) =>
+        NativeStripeSdk.checkoutUpdateBillingAddress(
+          key,
+          address,
+          name ?? null,
+          phone ?? null
+        )
+      ),
+    [withLoading]
+  );
+  const applyPromotionCode = useCallback<Checkout['applyPromotionCode']>(
+    (code) =>
+      withLoading((key) =>
+        NativeStripeSdk.checkoutApplyPromotionCode(key, code)
+      ),
+    [withLoading]
+  );
+  const removePromotionCode = useCallback<Checkout['removePromotionCode']>(
+    () =>
+      withLoading((key) => NativeStripeSdk.checkoutRemovePromotionCode(key)),
+    [withLoading]
+  );
+  const updateLineItemQuantity = useCallback<
+    Checkout['updateLineItemQuantity']
+  >(
+    (lineItemId, quantity) =>
+      withLoading((key) =>
+        NativeStripeSdk.checkoutUpdateLineItemQuantity(
+          key,
+          lineItemId,
+          quantity
+        )
+      ),
+    [withLoading]
+  );
+  const selectShippingOption = useCallback<Checkout['selectShippingOption']>(
+    (id) =>
+      withLoading((key) =>
+        NativeStripeSdk.checkoutSelectShippingOption(key, id)
+      ),
+    [withLoading]
+  );
+  const updateTaxId = useCallback<Checkout['updateTaxId']>(
+    (type, value) =>
+      withLoading((key) =>
+        NativeStripeSdk.checkoutUpdateTaxId(key, type, value)
+      ),
+    [withLoading]
+  );
+  const refresh = useCallback<Checkout['refresh']>(
+    () => withLoading((key) => NativeStripeSdk.checkoutRefresh(key)),
+    [withLoading]
+  );
+
+  const checkout = useMemo<Checkout>(
+    () => ({
+      get sessionKey(): string {
+        if (!sessionKeyRef.current) {
+          throw new Error(
+            'Checkout session not initialized. Wait for `state.status === "loaded"` ' +
+              'before passing `checkout` to `useEmbeddedPaymentElement` or calling a ' +
+              'mutation method (e.g. `applyPromotionCode`).'
+          );
+        }
+        return sessionKeyRef.current;
+      },
+      updateShippingAddress,
+      updateBillingAddress,
+      applyPromotionCode,
+      removePromotionCode,
+      updateLineItemQuantity,
+      selectShippingOption,
+      updateTaxId,
+      refresh,
+    }),
+    [
+      updateShippingAddress,
+      updateBillingAddress,
+      applyPromotionCode,
+      removePromotionCode,
+      updateLineItemQuantity,
+      selectShippingOption,
+      updateTaxId,
+      refresh,
+    ]
+  );
 
   return { state, checkout, error };
 }

package/src/specs/NativeCurrencySelectorElement.ts

@@ -0,0 +1,35 @@
+import type { HostComponent, ViewProps } from 'react-native';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import type {
+  DirectEventHandler,
+  Double,
+  WithDefault,
+} from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface HeightChangeEvent {
+  height: Double;
+}
+
+export interface NativeProps extends ViewProps {
+  /**
+   * Opaque key returned by `useCheckout`. The native side uses this to look
+   * up the matching `Checkout` instance and observe its state — there's no
+   * separate session-update event from this view, since `useCheckout`
+   * already subscribes to a single `checkoutSessionDidChangeState` channel
+   * that mirrors every native-driven mutation back into JS.
+   */
+  sessionKey: string;
+
+  /** When true, the toggle is visible but ignores user interaction. */
+  disabled?: WithDefault<boolean, false>;
+
+  /**
+   * Fired whenever the element's intrinsic height changes so the RN
+   * layout system can update the containing view.
+   */
+  onHeightChange?: DirectEventHandler<HeightChangeEvent>;
+}
+
+export default codegenNativeComponent<NativeProps>(
+  'StripeCurrencySelectorElement'
+) as HostComponent<NativeProps>;

package/src/specs/NativeEmbeddedPaymentElement.ts

@@ -7,7 +7,8 @@ import type { UnsafeMixed } from './utils';
 
 export interface NativeProps extends ViewProps {
   configuration: UnsafeMixed<EmbeddedPaymentElementConfiguration>;
-  intentConfiguration: UnsafeMixed<IntentConfiguration>;
+  intentConfiguration?: UnsafeMixed<IntentConfiguration>;
+  checkout?: UnsafeMixed<{ sessionKey: string }>;
 }
 
 export interface NativeCommands {
@@ -19,10 +20,19 @@ export interface NativeCommands {
     viewRef: React.ElementRef<HostComponent<NativeProps>>,
     intentConfigurationJson: string
   ) => void;
+  updateWithCheckout: (
+    viewRef: React.ElementRef<HostComponent<NativeProps>>,
+    sessionKey: string
+  ) => void;
 }
 
 export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
-  supportedCommands: ['confirm', 'clearPaymentOption', 'update'],
+  supportedCommands: [
+    'confirm',
+    'clearPaymentOption',
+    'update',
+    'updateWithCheckout',
+  ],
 });
 
 type ComponentType = HostComponent<NativeProps>;

package/src/specs/NativeStripeSdkModule.ts

@@ -199,12 +199,19 @@ export interface Spec extends TurboModule {
     intentConfig: UnsafeObject<IntentConfiguration>,
     configuration: UnsafeObject<EmbeddedPaymentElementConfiguration>
   ): Promise<void>;
+  createEmbeddedPaymentElementWithCheckout(
+    sessionKey: string,
+    configuration: UnsafeObject<EmbeddedPaymentElementConfiguration>
+  ): Promise<void>;
   confirmEmbeddedPaymentElement(
     viewTag: Int32
   ): Promise<EmbeddedPaymentElementResult>;
   updateEmbeddedPaymentElement(
     intentConfig: UnsafeObject<IntentConfiguration>
-  ): Promise<void>;
+  ): Promise<UnsafeObject<any> | null>;
+  updateEmbeddedPaymentElementWithCheckout(
+    sessionKey: string
+  ): Promise<UnsafeObject<any> | null>;
   clearEmbeddedPaymentOption(viewTag: Int32): Promise<void>;
   createRadarSession(): Promise<CreateRadarSessionResult>;
 

package/src/types/Checkout.ts

@@ -14,7 +14,7 @@ export namespace Checkout {
      * When allowed, Stripe may present prices in the customer's local
      * currency alongside the merchant's settlement currency.
      *
-     * Default: `{ allowed: true }`.
+     * Default: `{ allowed: false }`.
      */
     adaptivePricing?: AdaptivePricing;
   }
@@ -30,7 +30,7 @@ export namespace Checkout {
      * Set to `false` to prevent Stripe from activating adaptive pricing even
      * if the Checkout Session is configured for it on the server.
      *
-     * Default: `true`.
+     * Default: `false`.
      */
     allowed: boolean;
   }