@stripe/stripe-react-native 0.67.0 → 0.69.0

package/src/hooks/useLinkController.tsx

@@ -0,0 +1,54 @@
+import { useState, useCallback } from 'react';
+import { initLinkController, presentLinkController } from '../functions';
+import type { LinkController } from '../types';
+
+/**
+ * `useLinkController` hook.
+ *
+ * Provides `initLinkController` and `presentLinkController` methods with a shared
+ * `loading` state. Call `initLinkController` once when your checkout screen loads,
+ * then `presentLinkController` when the customer taps your Link button.
+ *
+ * @PrivatePreview This API is in private preview and may change without notice.
+ */
+export function useLinkController() {
+  const [loading, setLoading] = useState(false);
+
+  const init = useCallback(
+    async (
+      params: LinkController.Configuration
+    ): Promise<LinkController.InitResult> => {
+      setLoading(true);
+      const result = await initLinkController(params);
+      setLoading(false);
+      return result;
+    },
+    []
+  );
+
+  const present =
+    useCallback(async (): Promise<LinkController.PresentResult> => {
+      setLoading(true);
+      const result = await presentLinkController();
+      setLoading(false);
+      return result;
+    }, []);
+
+  return {
+    /** Whether an operation is currently in progress. */
+    loading,
+    /**
+     * Initializes the LinkController with the provided configuration.
+     * Must be called before `presentLinkController`.
+     *
+     * @PrivatePreview
+     */
+    initLinkController: init,
+    /**
+     * Presents the Link flow. Must be called after `initLinkController`.
+     *
+     * @PrivatePreview
+     */
+    presentLinkController: present,
+  };
+}

package/src/index.tsx

@@ -6,6 +6,7 @@ export { usePlatformPay } from './hooks/usePlatformPay';
 export { usePaymentSheet } from './hooks/usePaymentSheet';
 export { useFinancialConnectionsSheet } from './hooks/useFinancialConnectionsSheet';
 export { useOnramp } from './hooks/useOnramp';
+export { useLinkController } from './hooks/useLinkController';
 
 //components
 export { initStripe, StripeProvider } from './components/StripeProvider';

package/src/specs/NativeAddToWalletButton.ts

@@ -29,6 +29,7 @@ export interface NativeProps extends ViewProps {
   testEnv?: boolean;
   cardDetails: UnsafeMixed<CardDetails>;
   token?: UnsafeMixed<GooglePayCardToken> | null;
+  isBounceProvisioned?: boolean;
   ephemeralKey: UnsafeMixed<object>;
   onCompleteAction?: DirectEventHandler<AddToWalletButtonCompleteEvent>;
 }

package/src/specs/NativeCurrencySelectorElement.ts

@@ -5,6 +5,8 @@ import type {
   Double,
   WithDefault,
 } from 'react-native/Libraries/Types/CodegenTypes';
+import type { CurrencySelectorAppearance } from '../components/CurrencySelectorElement';
+import type { UnsafeMixed } from './utils';
 
 export interface HeightChangeEvent {
   height: Double;
@@ -23,6 +25,9 @@ export interface NativeProps extends ViewProps {
   /** When true, the toggle is visible but ignores user interaction. */
   disabled?: WithDefault<boolean, false>;
 
+  /** Appearance overrides for the selector. */
+  appearance?: UnsafeMixed<CurrencySelectorAppearance>;
+
   /**
    * Fired whenever the element's intrinsic height changes so the RN
    * layout system can update the containing view.

package/src/specs/NativeEmbeddedPaymentElement.ts

@@ -20,19 +20,10 @@ 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',
-    'updateWithCheckout',
-  ],
+  supportedCommands: ['confirm', 'clearPaymentOption', 'update'],
 });
 
 type ComponentType = HostComponent<NativeProps>;

package/src/specs/NativeStripeSdkModule.ts

@@ -22,6 +22,7 @@ import type {
   InitialiseParams,
   InitPaymentSheetResult,
   IsCardInWalletResult,
+  LinkController,
   OpenApplePaySetupResult,
   PaymentIntent,
   PaymentMethod,
@@ -209,9 +210,6 @@ export interface Spec extends TurboModule {
   updateEmbeddedPaymentElement(
     intentConfig: UnsafeObject<IntentConfiguration>
   ): Promise<UnsafeObject<any> | null>;
-  updateEmbeddedPaymentElementWithCheckout(
-    sessionKey: string
-  ): Promise<UnsafeObject<any> | null>;
   clearEmbeddedPaymentOption(viewTag: Int32): Promise<void>;
   createRadarSession(): Promise<CreateRadarSessionResult>;
 
@@ -229,13 +227,6 @@ export interface Spec extends TurboModule {
     phone: string | null
   ): Promise<UnsafeObject<Checkout.State>>;
 
-  checkoutUpdateBillingAddress(
-    sessionKey: string,
-    address: UnsafeObject<Checkout.Address>,
-    name: string | null,
-    phone: string | null
-  ): Promise<UnsafeObject<Checkout.State>>;
-
   checkoutApplyPromotionCode(
     sessionKey: string,
     code: string
@@ -281,6 +272,16 @@ export interface Spec extends TurboModule {
   storeStripeConnectDeepLink(url: string): Promise<void>;
   pollAndClearPendingStripeConnectUrls(): Promise<string[]>;
 
+  // LinkController - Private Preview
+
+  /** @PrivatePreview */
+  initLinkController(
+    params: UnsafeObject<LinkController.Configuration>
+  ): Promise<UnsafeObject<LinkController.InitResult>>;
+
+  /** @PrivatePreview */
+  presentLinkController(): Promise<UnsafeObject<LinkController.PresentResult>>;
+
   // Events
   addListener: (eventType: string) => void;
   removeListeners: (count: number) => void;

package/src/types/Checkout.ts

@@ -103,7 +103,7 @@ export namespace Checkout {
     tax: Tax;
     /** Tax and discount details for the computed total amount. */
     total?: Total;
-    /** The billing address set via `updateBillingAddress`, if any. */
+    /** The billing address for this session, if any. */
     billingAddress?: ContactAddress;
   }
 
@@ -507,24 +507,6 @@ export interface Checkout {
     phone?: string
   ): Promise<void>;
 
-  /**
-   * Sets the billing address for this checkout.
-   *
-   * The address is stored locally and merged into PaymentSheet configuration
-   * when presenting payment UI. If automatic tax is enabled and the tax
-   * address source is "billing", the address is also sent to the server to
-   * compute updated tax amounts.
-   *
-   * @param address - The billing address to set.
-   * @param name - The customer's name.
-   * @param phone - The customer's phone number.
-   */
-  updateBillingAddress(
-    address: Checkout.Address,
-    name?: string,
-    phone?: string
-  ): Promise<void>;
-
   /**
    * Applies a promotion code to the session.
    * - Parameter code: The promotion code to apply (e.g. `"SUMMER2026"`).

package/src/types/EmbeddedPaymentElement.tsx

@@ -251,12 +251,6 @@ class EmbeddedPaymentElement {
     );
   }
 
-  async updateCheckout(checkout: Checkout): Promise<unknown> {
-    return await NativeStripeSdkModule.updateEmbeddedPaymentElementWithCheckout(
-      checkout.sessionKey
-    );
-  }
-
   /**
    * Confirm the payment or setup intent.
    * Waits for any in-progress `update()` call to finish before proceeding.
@@ -438,16 +432,7 @@ 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;
-    /**
-     * Call this method when the Checkout Session values you used to initialize
-     * `EmbeddedPaymentElement` change.
-     * @checkoutSessionsPreview
-     * @internal
-     */
-    (checkout: Checkout): void;
-  };
+  update: (intentConfig: PaymentSheetTypes.IntentConfiguration) => void;
   // Sets the currently selected payment option to null
   clearPaymentOption: () => void;
   // Any error encountered during creation/update, or null
@@ -642,9 +627,7 @@ export function useEmbeddedPaymentElement(
     return getElementOrThrow(elementRef).confirm();
   }, [isAndroid]);
   const update = useCallback(
-    (
-      updateSource: PaymentSheetTypes.IntentConfiguration | Checkout
-    ): Promise<unknown> => {
+    (updateSource: PaymentSheetTypes.IntentConfiguration): Promise<unknown> => {
       if (isAndroid) {
         const currentRef = viewRef.current;
         if (currentRef) {
@@ -656,11 +639,7 @@ export function useEmbeddedPaymentElement(
                 resolve(result);
               }
             );
-            if (isCheckoutSession(updateSource)) {
-              Commands.updateWithCheckout(currentRef, updateSource.sessionKey);
-            } else {
-              Commands.update(currentRef, JSON.stringify(updateSource));
-            }
+            Commands.update(currentRef, JSON.stringify(updateSource));
           });
         }
         return Promise.reject(
@@ -670,9 +649,7 @@ export function useEmbeddedPaymentElement(
 
       // iOS: use native module directly
       const embeddedElement = getElementOrThrow(elementRef);
-      return isCheckoutSession(updateSource)
-        ? embeddedElement.updateCheckout(updateSource)
-        : embeddedElement.updateIntent(updateSource);
+      return embeddedElement.updateIntent(updateSource);
     },
     [isAndroid]
   );

package/src/types/Errors.ts

@@ -106,3 +106,12 @@ export enum RadarError {
   Failed = 'Failed',
   Unknown = 'Unknown',
 }
+
+/**
+ * @PrivatePreview
+ */
+export enum LinkControllerError {
+  Failed = 'Failed',
+  Canceled = 'Canceled',
+  Unknown = 'Unknown',
+}

package/src/types/LinkController.ts

@@ -0,0 +1,75 @@
+import type { Result as PaymentMethodResult } from './PaymentMethod';
+import type { LinkControllerError, StripeError } from './Errors';
+
+/**
+ * @PrivatePreview Payment method types supported by the Link flow.
+ */
+export enum LinkPaymentMethodType {
+  Card = 'card',
+  BankAccount = 'bankAccount',
+}
+
+/**
+ * @PrivatePreview Configuration for initializing the Link controller.
+ */
+export type Configuration = {
+  /** The customer's email address used for Link consumer lookup. */
+  email?: string;
+  /** Your customer-facing business name, displayed in Link UI. */
+  merchantDisplayName: string;
+  /** Payment method types to support in the Link sheet. If omitted, all available types are shown. */
+  supportedPaymentMethodTypes?: LinkPaymentMethodType[];
+  /** Customer phone number in E.164 format to prefill during signup. */
+  phoneNumber?: string;
+  /** Whether to allow the user to log out. Defaults to true. */
+  allowLogout?: boolean;
+  /**
+   * Optional SetupIntent client secret. When provided, the SDK confirms the SetupIntent
+   * with the selected payment method automatically before returning.
+   */
+  setupIntentClientSecret?: string;
+};
+
+/**
+ * @PrivatePreview A preview of the payment method the user selected in Link.
+ * Intended for display in the host app's checkout UI after the flow completes.
+ */
+export type PaymentMethodPreview = {
+  /**
+   * Payment method icon as a data URI PNG string (e.g., "data:image/png;base64,...").
+   * Suitable for rendering directly in a React Native `<Image source={{ uri: icon }}>` component.
+   */
+  icon: string;
+  /** The Link label to render in your screen. */
+  label: string;
+  /** Details about the selected Link payment method. This will typically render the display name of the payment method followed by the last four digits, e.g. `Visa Credit •••• 4242`. */
+  sublabel?: string;
+};
+
+/**
+ * @PrivatePreview Result returned from `initLinkController`.
+ */
+export type InitResult =
+  | { error?: undefined }
+  | { error: StripeError<LinkControllerError> };
+
+/**
+ * @PrivatePreview Result returned from `presentLinkController`.
+ */
+export type PresentResult =
+  | {
+      /** The payment method created from the user's Link selection. */
+      paymentMethod: PaymentMethodResult;
+      /** A preview of the selected payment method for display purposes. */
+      paymentMethodPreview?: PaymentMethodPreview;
+      error?: undefined;
+    }
+  | {
+      paymentMethod?: undefined;
+      paymentMethodPreview?: undefined;
+      /**
+       * Set when the operation failed or was canceled.
+       * Cancellation has `error.code === LinkControllerError.Canceled`.
+       */
+      error: StripeError<LinkControllerError>;
+    };

package/src/types/Onramp.ts

@@ -273,25 +273,11 @@ export type ComplianceIdentifierRequirements = {
  */
 export type OnrampErrorType = 'AppAttestationError' | 'UncategorizedApiError';
 
-/**
- * A native SDK component and version included in Crypto Onramp diagnostics.
- */
-export type SDKVersion = {
-  /** The SDK component name. */
-  name: string;
-  /** The SDK component version. */
-  version: string;
-};
-
 export type OnrampApiError = StripeError<OnrampError> & {
   onrampErrorType: string;
   developerMessage: string;
   userMessage: string;
   reason?: string;
-  operation: string;
-  appPackageName: string;
-  mode?: 'live' | 'test';
-  sdkVersions?: SDKVersion[];
   requestId?: string;
   apiErrorCode?: string;
   apiErrorType?: string;

package/src/types/PaymentMethod.ts

@@ -304,4 +304,6 @@ export type CollectBankAccountTokenParams = {
   style?: UserInterfaceStyle;
   /** An optional event listener to receive @type {FinancialConnectionEvent} for specific events during the process of a user connecting their financial accounts. */
   onEvent?: (event: FinancialConnectionsEvent) => void;
+  /** Optional connected account ID. Used for Stripe Connect embedded components. */
+  connectedAccountId?: string;
 };

package/src/types/PushProvisioning.ts

@@ -49,6 +49,8 @@ export type CanAddCardToWalletParams = {
   primaryAccountIdentifier: string | null;
   /** Last 4 digits of the card number. Required for Android. */
   cardLastFour: string;
+  /** The card brand (e.g. "visa", "mastercard"). Required for Android. */
+  cardBrand: string;
   /** iOS only. Set this to `true` until shipping through TestFlight || App Store. If false, you must be using live cards, and have the proper iOS entitlement set up. See https://stripe.com/docs/issuing/cards/digital-wallets?platform=react-native#requesting-access-for-ios */
   testEnv?: boolean;
   /** iOS only. Set this to `true` if: your user has an Apple Watch device currently paired, and you want to check that device for the presence of the specified card. */

package/src/types/index.ts

@@ -28,6 +28,7 @@ import * as FinancialConnections from './FinancialConnections';
 import * as PlatformPay from './PlatformPay';
 import * as Onramp from './Onramp';
 import * as ConfirmationToken from './ConfirmationToken';
+import * as LinkController from './LinkController';
 
 export {
   ApplePay,
@@ -44,6 +45,7 @@ export {
   PlatformPay,
   Onramp,
   ConfirmationToken,
+  LinkController,
 };
 
 export * from './PushProvisioning';

package/stripe-react-native.podspec

@@ -2,7 +2,7 @@ require 'json'
 
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 # Keep stripe_version in sync with https://github.com/stripe/stripe-identity-react-native/blob/main/stripe-identity-react-native.podspec
-stripe_version = '~> 25.17.0'
+stripe_version = '26.3.0'
 
 fabric_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'