@stripe/stripe-react-native 0.58.0 → 0.59.0

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

@@ -215,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/PaymentSheet.ts

@@ -92,6 +92,11 @@ export type SetupParamsBase = IntentParams & {
   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 =
@@ -649,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;

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;