@stripe/stripe-react-native 0.57.3 → 0.59.0

package/src/functions.ts

@@ -31,6 +31,7 @@ import type {
   CanAddCardToWalletResult,
   FinancialConnections,
   PlatformPay,
+  CreateRadarSessionResult,
 } from './types';
 import { Platform, EventSubscription } from 'react-native';
 import type { CollectFinancialConnectionsAccountsParams } from './types/FinancialConnections';
@@ -910,6 +911,15 @@ export const openPlatformPaySetup = async (): Promise<void> => {
   }
 };
 
+/**
+ * Creates a [Radar session](https://docs.stripe.com/radar/radar-session).
+ * @returns A promise that resolves to a Radar session id, or an error.
+ */
+export const createRadarSession =
+  async (): Promise<CreateRadarSessionResult> => {
+    return await NativeStripeSdk.createRadarSession();
+  };
+
 export const setFinancialConnectionsForceNativeFlow = async (
   enabled: boolean
 ): Promise<void> => {

package/src/hooks/useStripe.tsx

@@ -27,6 +27,7 @@ import type {
   FinancialConnections,
   PlatformPay,
   PlatformPayError,
+  CreateRadarSessionResult,
 } from '../types';
 import { useCallback } from 'react';
 import {
@@ -59,6 +60,7 @@ import {
   createPlatformPayToken,
   updatePlatformPaySheet,
   openPlatformPaySetup,
+  createRadarSession,
 } from '../functions';
 import type { CollectBankAccountTokenParams } from '../types/PaymentMethod';
 import type { CollectFinancialConnectionsAccountsParams } from '../types/FinancialConnections';
@@ -320,6 +322,11 @@ export function useStripe() {
     return openPlatformPaySetup();
   }, []);
 
+  const _createRadarSession =
+    useCallback(async (): Promise<CreateRadarSessionResult> => {
+      return createRadarSession();
+    }, []);
+
   return {
     retrievePaymentIntent: _retrievePaymentIntent,
     retrieveSetupIntent: _retrieveSetupIntent,
@@ -355,5 +362,6 @@ export function useStripe() {
     createPlatformPayToken: _createPlatformPayToken,
     updatePlatformPaySheet: _updatePlatformPaySheet,
     openPlatformPaySetup: _openPlatformPaySetup,
+    createRadarSession: _createRadarSession,
   };
 }

package/src/specs/NativePaymentMethodMessagingElement.ts

@@ -0,0 +1,25 @@
+import type { HostComponent, ViewProps } from 'react-native';
+import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+import {
+  PaymentMethodMessagingElementAppearance,
+  PaymentMethodMessagingElementConfiguration,
+  PaymentMethodMessagingElementState,
+} from '../types/components/PaymentMethodMessagingElementComponent';
+import { UnsafeMixed } from './utils';
+
+interface StateChangeEvent {
+  result: UnsafeMixed<PaymentMethodMessagingElementState>;
+}
+
+export interface NativeProps extends ViewProps {
+  appearance?: UnsafeMixed<PaymentMethodMessagingElementAppearance>;
+  configuration: UnsafeMixed<PaymentMethodMessagingElementConfiguration>;
+  onStateChange: DirectEventHandler<StateChangeEvent>;
+}
+
+type ComponentType = HostComponent<NativeProps>;
+
+export default codegenNativeComponent<NativeProps>(
+  'PaymentMethodMessagingElementView'
+) as ComponentType;

package/src/specs/NativeStripeSdkModule.ts

@@ -34,6 +34,7 @@ import type {
   StripeError,
   Token,
   VerifyMicrodepositsParams,
+  CreateRadarSessionResult,
 } from '../types';
 import type {
   EmbeddedPaymentElementConfiguration,
@@ -108,7 +109,16 @@ export interface Spec extends TurboModule {
       Omit<PaymentMethod.CollectBankAccountParams, 'onEvent'>
     >
   ): Promise<ConfirmSetupIntentResult | ConfirmPaymentResult>;
-  getConstants(): { API_VERSIONS: { CORE: string; ISSUING: string } };
+  getConstants(): {
+    API_VERSIONS: { CORE: string; ISSUING: string };
+    SYSTEM_INFO: {
+      sdkVersion: string;
+      osVersion: string;
+      deviceType: string;
+      appName: string;
+      appVersion: string;
+    };
+  };
   canAddCardToWallet(
     params: UnsafeObject<CanAddCardToWalletParams>
   ): Promise<CanAddCardToWalletResult>;
@@ -193,6 +203,7 @@ export interface Spec extends TurboModule {
     intentConfig: UnsafeObject<IntentConfiguration>
   ): Promise<void>;
   clearEmbeddedPaymentOption(viewTag: Int32): Promise<void>;
+  createRadarSession(): Promise<CreateRadarSessionResult>;
 
   setFinancialConnectionsForceNativeFlow(enabled: boolean): Promise<void>;
 
@@ -201,6 +212,15 @@ export interface Spec extends TurboModule {
     url: string
   ): Promise<{ url?: string } | null>;
 
+  downloadAndShareFile(
+    url: string,
+    filename?: string | null
+  ): Promise<{ success: boolean; error?: string }>;
+  authWebViewDeepLinkHandled(id: string): Promise<void>;
+
+  storeStripeConnectDeepLink(url: string): Promise<void>;
+  pollAndClearPendingStripeConnectUrls(): Promise<string[]>;
+
   // Events
   addListener: (eventType: string) => void;
   removeListeners: (count: number) => void;

package/src/types/CustomerSheet.ts

@@ -43,6 +43,11 @@ type CustomerSheetOptionalInitParams = {
    * Note: Card brand filtering is not currently supported in Link.
    */
   cardBrandAcceptance?: PaymentSheet.CardBrandAcceptance;
+  /** By default, CustomerSheet offers a card scan button within the new card entry form.
+   * When opensCardScannerAutomatically is set to true,
+   * the card entry form will initialize with the card scanner already open.
+   * Defaults to false. */
+  opensCardScannerAutomatically?: boolean;
 };
 
 /**

package/src/types/EmbeddedPaymentElement.tsx

@@ -195,7 +195,12 @@ export interface EmbeddedPaymentElementConfiguration {
    * Note: Card brand filtering is not currently supported in Link.
    */
   cardBrandAcceptance?: PaymentSheetTypes.CardBrandAcceptance;
-  /** The view can display payment methods like “Card” that, when tapped, open a sheet where customers enter their payment method details.
+  /**
+   * Configuration for filtering cards by funding type.
+   * @note This is a private preview API and will have no effect unless your Stripe account is enrolled in the private preview.
+   */
+  cardFundingFiltering?: PaymentSheetTypes.CardFundingFiltering;
+  /** The view can display payment methods like "Card" that, when tapped, open a sheet where customers enter their payment method details.
    * The sheet has a button at the bottom. `formSheetAction` controls the action the button performs. Defaults to 'continue'.
    */
   formSheetAction?: EmbeddedFormSheetAction;
@@ -210,6 +215,11 @@ export interface EmbeddedPaymentElementConfiguration {
    * Defaults to `true`.
    */
   embeddedViewDisplaysMandateText?: boolean;
+  /** By default, EmbeddedPaymentElement offers a card scan button within the new card entry form.
+   * When opensCardScannerAutomatically is set to true,
+   * the card entry form will initialize with the card scanner already open.
+   * Defaults to false. */
+  opensCardScannerAutomatically?: boolean;
 }
 
 // -----------------------------------------------------------------------------

package/src/types/Errors.ts

@@ -107,3 +107,8 @@ export enum PlatformPayError {
   Failed = 'Failed',
   Unknown = 'Unknown',
 }
+
+export enum RadarError {
+  Failed = 'Failed',
+  Unknown = 'Unknown',
+}

package/src/types/FinancialConnections.ts

@@ -7,6 +7,8 @@ export type CollectFinancialConnectionsAccountsParams = {
   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 to use for this Financial Connections session. Used for Stripe Connect embedded components. */
+  connectedAccountId?: string;
 };
 
 export type SessionResult =

package/src/types/PaymentSheet.ts

@@ -85,8 +85,18 @@ export type SetupParamsBase = IntentParams & {
    * Note: Card brand filtering is not currently supported in Link.
    */
   cardBrandAcceptance?: CardBrandAcceptance;
+  /**
+   * Configuration for filtering cards by funding type.
+   * @note This is a private preview API and will have no effect unless your Stripe account is enrolled in the private preview.
+   */
+  cardFundingFiltering?: CardFundingFiltering;
   /** Configuration for custom payment methods in PaymentSheet */
   customPaymentMethodConfiguration?: CustomPaymentMethodConfiguration;
+  /** By default, PaymentSheet offers a card scan button within the new card entry form.
+   * When opensCardScannerAutomatically is set to true,
+   * the card entry form will initialize with the card scanner already open.
+   * Defaults to false. */
+  opensCardScannerAutomatically?: boolean;
 };
 
 export type SetupParams =
@@ -644,7 +654,7 @@ export type PaymentMode = {
 };
 
 export type PaymentMethodOptions = {
-  /* This is an experimental feature that may be removed at any time
+  /* This feature is in Public Preview. It may not be feature complete and have breaking changes as we develop and update functionality.
   A map of payment method types to setup_future_usage value. (e.g. card: 'OffSession') */
   setupFutureUsageValues: {
     [key: string]: FutureUsage;
@@ -680,6 +690,33 @@ export enum PaymentMethodLayout {
   Automatic = 'Automatic',
 }
 
+/**
+ * Card funding types that can be filtered.
+ * @note This is a private preview API and will have no effect unless your Stripe account is enrolled in the private preview.
+ */
+export enum CardFundingType {
+  /** Debit cards */
+  Debit = 'debit',
+  /** Credit cards */
+  Credit = 'credit',
+  /** Prepaid cards */
+  Prepaid = 'prepaid',
+  /**
+   * Unknown or undetermined funding type.
+   * Include this if you want to accept cards where the funding type cannot be determined from card metadata.
+   */
+  Unknown = 'unknown',
+}
+
+/**
+ * Configuration for filtering cards by funding type.
+ * @note This is a private preview API and will have no effect unless your Stripe account is enrolled in the private preview.
+ */
+export type CardFundingFiltering = {
+  /** List of allowed card funding types. If not set, all types are accepted. */
+  allowedCardFundingTypes?: CardFundingType[];
+};
+
 /** Card brand categories that can be allowed or disallowed */
 export enum CardBrandCategory {
   /** Visa branded cards */

package/src/types/components/PaymentMethodMessagingElementComponent.tsx

@@ -0,0 +1,74 @@
+import { NativeSyntheticEvent, StyleProp, ViewStyle } from 'react-native';
+
+import * as PaymentSheetTypes from '../PaymentSheet';
+
+// -----------------------------------------------------------------------------
+// Types
+// -----------------------------------------------------------------------------
+
+/**
+ * The current state of the PaymentMethodMessagingElement view. Typically loading, succeeded, no_content, or failed.
+ */
+export type PaymentMethodMessagingElementState =
+  | { status: 'loading' }
+  | { status: 'loaded' }
+  | { status: 'no_content' }
+  | { status: 'failed'; error: Error };
+
+/** Style for the images displayed by the element. */
+export enum PaymentMethodMessagingElementStyle {
+  /** A flat style */
+  Flat = 'flat',
+  /** A dark style */
+  Dark = 'dark',
+  /** A light style */
+  Light = 'light',
+}
+
+export interface PaymentMethodMessagingElementAppearance {
+  /** Font settings for the element. */
+  font?: PaymentSheetTypes.FontConfig;
+  /** The color used for the element text. */
+  textColor?: PaymentSheetTypes.ThemedColor;
+  /** The color used for the text that links to available BNPL plans. */
+  linkTextColor?: PaymentSheetTypes.ThemedColor;
+  /** The theme of the images displayed by the element. */
+  style?: PaymentMethodMessagingElementStyle;
+}
+
+/**
+ * Configuration object.
+ */
+export interface PaymentMethodMessagingElementConfiguration {
+  /** Amount intended to be collected in the smallest currency unit (e.g. 100 cents to charge $1.00). */
+  amount: number;
+  /** Three-letter ISO currency code, in lowercase. Must be a supported currency. */
+  currency: string;
+  /**
+   * Language code used to localize message displayed in the element.
+   * See [the Stripe documentation](https://docs.stripe.com/js/appendix/supported_locales) for a list of
+   * supported values. Defaults to the current device locale language.
+   * **Note**: Not all device locales are supported by Stripe, and English will be used in the case of
+   * an unsupported locale. If you want to ensure a specific locale is used, pass it explicitly.
+   */
+  locale?: string;
+  /** Two letter country code of the customer's location. If not provided, country will be determined based on IP Address. */
+  country?: string;
+  /**
+   * The payment methods to request messaging for. Supported values are "affirm", "afterpay_clearpay", and "klarna".
+   * If null, uses your preferences from the [Stripe dashboard](https://dashboard.stripe.com/settings/payment_methods) to show the relevant payment methods.
+   * See [Dynamic payment methods](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods) for more details.
+   */
+  paymentMethodTypes?: Array<string>;
+}
+
+export type OnStateChangeEvent = NativeSyntheticEvent<{
+  result: PaymentMethodMessagingElementState;
+}>;
+
+export interface NativeProps {
+  style?: StyleProp<ViewStyle>;
+  appearance?: PaymentMethodMessagingElementAppearance;
+  configuration: PaymentMethodMessagingElementConfiguration;
+  onStateChange(event: OnStateChangeEvent): void;
+}

package/src/types/index.ts

@@ -12,6 +12,7 @@ import type {
   StripeError,
   VerifyMicrodepositsError,
   CollectBankAccountError,
+  RadarError,
 } from './Errors';
 import * as ApplePay from './ApplePay';
 import * as PaymentIntent from './PaymentIntent';
@@ -176,6 +177,16 @@ export type ConfirmPaymentSheetPaymentResult = {
   error?: StripeError<PaymentSheetError>;
 };
 
+export type CreateRadarSessionResult =
+  | {
+      id: string;
+      error?: undefined;
+    }
+  | {
+      id?: undefined;
+      error: StripeError<RadarError>;
+    };
+
 export type ApplePayResult =
   | {
       paymentMethod: PaymentMethod.Result;

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.0.1'
+stripe_version = '~> 25.6.0'
 
 fabric_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'