@stripe/stripe-react-native 0.29.0 → 0.30.0

package/lib/typescript/src/NativeStripeSdk.d.ts

@@ -1,8 +1,9 @@
-import type { PaymentMethod, PaymentIntent, PlatformPay, PaymentSheet, SetupIntent, InitialiseParams, CreatePaymentMethodResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, ConfirmPaymentResult, HandleNextActionResult, ConfirmSetupIntentResult, CreateTokenForCVCUpdateResult, InitPaymentSheetResult, PresentPaymentSheetResult, ConfirmPaymentSheetPaymentResult, CreateTokenResult, OpenApplePaySetupResult, Token, VerifyMicrodepositsParams, IsCardInWalletResult, CanAddCardToWalletParams, CanAddCardToWalletResult, FinancialConnections } from './types';
+import type { PaymentMethod, PaymentIntent, PlatformPay, PaymentSheet, SetupIntent, InitialiseParams, CreatePaymentMethodResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, ConfirmPaymentResult, HandleNextActionResult, HandleNextActionForSetupResult, ConfirmSetupIntentResult, CreateTokenForCVCUpdateResult, InitPaymentSheetResult, PresentPaymentSheetResult, ConfirmPaymentSheetPaymentResult, CreateTokenResult, OpenApplePaySetupResult, Token, VerifyMicrodepositsParams, IsCardInWalletResult, CanAddCardToWalletParams, CanAddCardToWalletResult, FinancialConnections } from './types';
 declare type NativeStripeSdkType = {
     initialise(params: InitialiseParams): Promise<void>;
     createPaymentMethod(params: PaymentMethod.CreateParams, options: PaymentMethod.CreateOptions): Promise<CreatePaymentMethodResult>;
     handleNextAction(paymentIntentClientSecret: string, returnURL?: string | null): Promise<HandleNextActionResult>;
+    handleNextActionForSetup(setupIntentClientSecret: string, returnURL?: string | null): Promise<HandleNextActionForSetupResult>;
     confirmPayment(paymentIntentClientSecret: string, params?: PaymentIntent.ConfirmParams, options?: PaymentIntent.ConfirmOptions): Promise<ConfirmPaymentResult>;
     confirmSetupIntent(paymentIntentClientSecret: string, params: SetupIntent.ConfirmParams, options: SetupIntent.ConfirmOptions): Promise<ConfirmSetupIntentResult>;
     retrievePaymentIntent(clientSecret: string): Promise<RetrievePaymentIntentResult>;

package/lib/typescript/src/functions.d.ts

@@ -1,4 +1,4 @@
-import type { PlatformPayError, ConfirmPaymentResult, ConfirmPaymentSheetPaymentResult, SetupIntent, PaymentIntent, ConfirmSetupIntentResult, CreatePaymentMethodResult, CreateTokenForCVCUpdateResult, CreateTokenResult, HandleNextActionResult, InitPaymentSheetResult, PaymentMethod, PaymentSheet, PresentPaymentSheetResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, StripeError, Token, VerifyMicrodepositsParams, VerifyMicrodepositsForPaymentResult, VerifyMicrodepositsForSetupResult, CollectBankAccountForPaymentResult, CollectBankAccountForSetupResult, IsCardInWalletResult, CanAddCardToWalletParams, CanAddCardToWalletResult, FinancialConnections, PlatformPay } from './types';
+import type { PlatformPayError, ConfirmPaymentResult, ConfirmPaymentSheetPaymentResult, SetupIntent, PaymentIntent, ConfirmSetupIntentResult, CreatePaymentMethodResult, CreateTokenForCVCUpdateResult, CreateTokenResult, HandleNextActionResult, HandleNextActionForSetupResult, InitPaymentSheetResult, PaymentMethod, PaymentSheet, PresentPaymentSheetResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, StripeError, Token, VerifyMicrodepositsParams, VerifyMicrodepositsForPaymentResult, VerifyMicrodepositsForSetupResult, CollectBankAccountForPaymentResult, CollectBankAccountForSetupResult, IsCardInWalletResult, CanAddCardToWalletParams, CanAddCardToWalletResult, FinancialConnections, PlatformPay } from './types';
 export declare const createPaymentMethod: (params: PaymentMethod.CreateParams, options?: PaymentMethod.CreateOptions) => Promise<CreatePaymentMethodResult>;
 export declare const createToken: (params: Token.CreateParams) => Promise<CreateTokenResult>;
 export declare const retrievePaymentIntent: (clientSecret: string) => Promise<RetrievePaymentIntentResult>;
@@ -19,6 +19,13 @@ export declare const confirmPayment: (paymentIntentClientSecret: string, params?
  * @param {string=} returnURL An optional return URL so the Stripe SDK can redirect back to your app after authentication. This should match the `return_url` you specified during PaymentIntent confirmation.
  * */
 export declare const handleNextAction: (paymentIntentClientSecret: string, returnURL?: string | undefined) => Promise<HandleNextActionResult>;
+/** Handles any nextAction required to authenticate the SetupIntent.
+ * Call this method if you are confirming the SetupIntent on your backend and get a status of requires_action.
+ *
+ * @param {string} setupIntentClientSecret The client secret associated with the SetupIntent.
+ * @param {string=} returnURL An optional return URL so the Stripe SDK can redirect back to your app after authentication. This should match the `return_url` you specified during PaymentIntent confirmation.
+ * */
+export declare const handleNextActionForSetup: (setupIntentClientSecret: string, returnURL?: string | undefined) => Promise<HandleNextActionForSetupResult>;
 export declare const confirmSetupIntent: (paymentIntentClientSecret: string, params: SetupIntent.ConfirmParams, options?: SetupIntent.ConfirmOptions) => Promise<ConfirmSetupIntentResult>;
 export declare const createTokenForCVCUpdate: (cvc: string) => Promise<CreateTokenForCVCUpdateResult>;
 /**

package/lib/typescript/src/hooks/useStripe.d.ts

@@ -1,4 +1,4 @@
-import type { PaymentMethod, PaymentIntent, PaymentSheet, CreatePaymentMethodResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, ConfirmPaymentResult, HandleNextActionResult, ConfirmSetupIntentResult, CreateTokenForCVCUpdateResult, StripeError, InitPaymentSheetResult, PresentPaymentSheetResult, ConfirmPaymentSheetPaymentResult, SetupIntent, CreateTokenResult, Token, VerifyMicrodepositsParams, VerifyMicrodepositsForPaymentResult, VerifyMicrodepositsForSetupResult, CollectBankAccountForSetupResult, CollectBankAccountForPaymentResult, CanAddCardToWalletParams, CanAddCardToWalletResult, FinancialConnections, PlatformPay, PlatformPayError } from '../types';
+import type { PaymentMethod, PaymentIntent, PaymentSheet, CreatePaymentMethodResult, RetrievePaymentIntentResult, RetrieveSetupIntentResult, ConfirmPaymentResult, HandleNextActionResult, HandleNextActionForSetupResult, ConfirmSetupIntentResult, CreateTokenForCVCUpdateResult, StripeError, InitPaymentSheetResult, PresentPaymentSheetResult, ConfirmPaymentSheetPaymentResult, SetupIntent, CreateTokenResult, Token, VerifyMicrodepositsParams, VerifyMicrodepositsForPaymentResult, VerifyMicrodepositsForSetupResult, CollectBankAccountForSetupResult, CollectBankAccountForPaymentResult, CanAddCardToWalletParams, CanAddCardToWalletResult, FinancialConnections, PlatformPay, PlatformPayError } from '../types';
 /**
  * useStripe hook
  */
@@ -8,6 +8,7 @@ export declare function useStripe(): {
     confirmPayment: (paymentIntentClientSecret: string, data?: PaymentIntent.ConfirmParams | undefined, options?: PaymentIntent.ConfirmOptions) => Promise<ConfirmPaymentResult>;
     createPaymentMethod: (data: PaymentMethod.CreateParams, options?: PaymentMethod.CreateOptions) => Promise<CreatePaymentMethodResult>;
     handleNextAction: (paymentIntentClientSecret: string, returnURL?: string | undefined) => Promise<HandleNextActionResult>;
+    handleNextActionForSetup: (setupIntentClientSecret: string, returnURL?: string | undefined) => Promise<HandleNextActionForSetupResult>;
     confirmSetupIntent: (paymentIntentClientSecret: string, data: SetupIntent.ConfirmParams, options?: SetupIntent.ConfirmOptions) => Promise<ConfirmSetupIntentResult>;
     createTokenForCVCUpdate: (cvc: string) => Promise<CreateTokenForCVCUpdateResult>;
     handleURLCallback: (url: string) => Promise<boolean>;

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

@@ -1,11 +1,19 @@
 import type { StripeError, GooglePayError } from './Errors';
 export declare type GooglePayCardToken = {
+    /** The token reference ID. */
     id: string;
-    cardLastFour: string;
+    /** Last four digits of the FPAN */
+    fpanLastFour: string;
+    /** Last four digits of the DPAN */
+    dpanLastFour: string;
     network: number;
     serviceProvider: number;
+    /** The name of the issuer. */
     issuer: string;
+    /** The GooglePayCardTokenStatus. */
     status: GooglePayCardTokenStatus;
+    /** Deprecated. Use fpanLastFour or dpanLastFour. */
+    cardLastFour: string;
 };
 export declare enum GooglePayCardTokenStatus {
     /**  */

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

@@ -62,6 +62,13 @@ export declare type HandleNextActionResult = {
     paymentIntent?: undefined;
     error: StripeError<CardActionError>;
 };
+export declare type HandleNextActionForSetupResult = {
+    setupIntent: SetupIntent.Result;
+    error?: undefined;
+} | {
+    setupIntent?: undefined;
+    error: StripeError<CardActionError>;
+};
 export declare type ConfirmSetupIntentResult = {
     setupIntent: SetupIntent.Result;
     error?: undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-react-native",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "author": "Stripe",
   "description": "Stripe SDK for React Native",
   "main": "lib/commonjs/index",

package/src/NativeStripeSdk.tsx

@@ -11,6 +11,7 @@ import type {
   RetrieveSetupIntentResult,
   ConfirmPaymentResult,
   HandleNextActionResult,
+  HandleNextActionForSetupResult,
   ConfirmSetupIntentResult,
   CreateTokenForCVCUpdateResult,
   InitPaymentSheetResult,
@@ -36,6 +37,10 @@ type NativeStripeSdkType = {
     paymentIntentClientSecret: string,
     returnURL?: string | null
   ): Promise<HandleNextActionResult>;
+  handleNextActionForSetup(
+    setupIntentClientSecret: string,
+    returnURL?: string | null
+  ): Promise<HandleNextActionForSetupResult>;
   confirmPayment(
     paymentIntentClientSecret: string,
     params?: PaymentIntent.ConfirmParams,

package/src/functions.ts

@@ -12,6 +12,7 @@ import type {
   CreateTokenForCVCUpdateResult,
   CreateTokenResult,
   HandleNextActionResult,
+  HandleNextActionForSetupResult,
   InitPaymentSheetResult,
   PaymentMethod,
   PaymentSheet,
@@ -203,6 +204,41 @@ export const handleNextAction = async (
   }
 };
 
+/** Handles any nextAction required to authenticate the SetupIntent.
+ * Call this method if you are confirming the SetupIntent on your backend and get a status of requires_action.
+ *
+ * @param {string} setupIntentClientSecret The client secret associated with the SetupIntent.
+ * @param {string=} returnURL An optional return URL so the Stripe SDK can redirect back to your app after authentication. This should match the `return_url` you specified during PaymentIntent confirmation.
+ * */
+export const handleNextActionForSetup = async (
+  setupIntentClientSecret: string,
+  returnURL?: string
+): Promise<HandleNextActionForSetupResult> => {
+  try {
+    const { setupIntent, error } =
+      Platform.OS === 'ios'
+        ? await NativeStripeSdk.handleNextActionForSetup(
+            setupIntentClientSecret,
+            returnURL ?? null
+          )
+        : await NativeStripeSdk.handleNextActionForSetup(
+            setupIntentClientSecret
+          );
+    if (error) {
+      return {
+        error,
+      };
+    }
+    return {
+      setupIntent: setupIntent!,
+    };
+  } catch (error: any) {
+    return {
+      error: createError(error),
+    };
+  }
+};
+
 export const confirmSetupIntent = async (
   paymentIntentClientSecret: string,
   params: SetupIntent.ConfirmParams,

package/src/hooks/useFinancialConnectionsSheet.tsx

@@ -1,4 +1,4 @@
-import { useState } from 'react';
+import { useState, useCallback } from 'react';
 import { useStripe } from './useStripe';
 
 /**
@@ -12,19 +12,25 @@ export function useFinancialConnectionsSheet() {
   const { collectBankAccountToken, collectFinancialConnectionsAccounts } =
     useStripe();
 
-  const _collectBankAccountToken = async (clientSecret: string) => {
-    setLoading(true);
-    const result = await collectBankAccountToken(clientSecret);
-    setLoading(false);
-    return result;
-  };
+  const _collectBankAccountToken = useCallback(
+    async (clientSecret: string) => {
+      setLoading(true);
+      const result = await collectBankAccountToken(clientSecret);
+      setLoading(false);
+      return result;
+    },
+    [collectBankAccountToken]
+  );
 
-  const _collectFinancialConnectionsAccounts = async (clientSecret: string) => {
-    setLoading(true);
-    const result = await collectFinancialConnectionsAccounts(clientSecret);
-    setLoading(false);
-    return result;
-  };
+  const _collectFinancialConnectionsAccounts = useCallback(
+    async (clientSecret: string) => {
+      setLoading(true);
+      const result = await collectFinancialConnectionsAccounts(clientSecret);
+      setLoading(false);
+      return result;
+    },
+    [collectFinancialConnectionsAccounts]
+  );
 
   return {
     collectBankAccountToken: _collectBankAccountToken,

package/src/hooks/usePaymentSheet.tsx

@@ -1,7 +1,8 @@
-import type { PaymentSheet } from '../types';
-import { useState } from 'react';
+import { useState, useCallback } from 'react';
 import { useStripe } from './useStripe';
 
+import type { PaymentSheet } from '../types';
+
 /**
  * usePaymentSheet hook
  */
@@ -14,33 +15,39 @@ export function usePaymentSheet() {
   } = useStripe();
   const [loading, setLoading] = useState(false);
 
-  const initPaymentSheet = async (params: PaymentSheet.SetupParams) => {
-    setLoading(true);
-    const result = await initPaymentSheetNative(params);
-    setLoading(false);
-    return result;
-  };
+  const initPaymentSheet = useCallback(
+    async (params: PaymentSheet.SetupParams) => {
+      setLoading(true);
+      const result = await initPaymentSheetNative(params);
+      setLoading(false);
+      return result;
+    },
+    [initPaymentSheetNative]
+  );
 
-  const presentPaymentSheet = async (options?: PaymentSheet.PresentOptions) => {
-    setLoading(true);
-    const result = await presentPaymentSheetNative(options);
-    setLoading(false);
-    return result;
-  };
+  const presentPaymentSheet = useCallback(
+    async (options?: PaymentSheet.PresentOptions) => {
+      setLoading(true);
+      const result = await presentPaymentSheetNative(options);
+      setLoading(false);
+      return result;
+    },
+    [presentPaymentSheetNative]
+  );
 
-  const confirmPaymentSheetPayment = async () => {
+  const confirmPaymentSheetPayment = useCallback(async () => {
     setLoading(true);
     const result = await confirmPaymentSheetPaymentNative();
     setLoading(false);
     return result;
-  };
+  }, [confirmPaymentSheetPaymentNative]);
 
-  const resetPaymentSheetCustomer = async () => {
+  const resetPaymentSheetCustomer = useCallback(async () => {
     setLoading(true);
     const result = await resetPaymentSheetCustomerNative();
     setLoading(false);
     return result;
-  };
+  }, [resetPaymentSheetCustomerNative]);
 
   return {
     loading,

package/src/hooks/useStripe.tsx

@@ -7,6 +7,7 @@ import type {
   RetrieveSetupIntentResult,
   ConfirmPaymentResult,
   HandleNextActionResult,
+  HandleNextActionForSetupResult,
   ConfirmSetupIntentResult,
   CreateTokenForCVCUpdateResult,
   StripeError,
@@ -36,6 +37,7 @@ import {
   confirmSetupIntent,
   createTokenForCVCUpdate,
   handleNextAction,
+  handleNextActionForSetup,
   handleURLCallback,
   initPaymentSheet,
   presentPaymentSheet,
@@ -115,6 +117,16 @@ export function useStripe() {
     []
   );
 
+  const _handleNextActionForSetup = useCallback(
+    async (
+      setupIntentClientSecret: string,
+      returnURL?: string
+    ): Promise<HandleNextActionForSetupResult> => {
+      return handleNextActionForSetup(setupIntentClientSecret, returnURL);
+    },
+    []
+  );
+
   const _confirmSetupIntent = useCallback(
     async (
       paymentIntentClientSecret: string,
@@ -308,6 +320,7 @@ export function useStripe() {
     confirmPayment: _confirmPayment,
     createPaymentMethod: _createPaymentMethod,
     handleNextAction: _handleNextAction,
+    handleNextActionForSetup: _handleNextActionForSetup,
     confirmSetupIntent: _confirmSetupIntent,
     createTokenForCVCUpdate: _createTokenForCVCUpdate,
     handleURLCallback: _handleURLCallback,

package/src/types/PushProvisioning.ts

@@ -1,12 +1,20 @@
 import type { StripeError, GooglePayError } from './Errors';
 
 export type GooglePayCardToken = {
+  /** The token reference ID. */
   id: string;
-  cardLastFour: string;
+  /** Last four digits of the FPAN */
+  fpanLastFour: string;
+  /** Last four digits of the DPAN */
+  dpanLastFour: string;
   network: number;
   serviceProvider: number;
+  /** The name of the issuer. */
   issuer: string;
+  /** The GooglePayCardTokenStatus. */
   status: GooglePayCardTokenStatus;
+  /** Deprecated. Use fpanLastFour or dpanLastFour. */
+  cardLastFour: string;
 };
 
 export enum GooglePayCardTokenStatus {

package/src/types/index.ts

@@ -109,6 +109,16 @@ export type HandleNextActionResult =
       error: StripeError<CardActionError>;
     };
 
+export type HandleNextActionForSetupResult =
+  | {
+      setupIntent: SetupIntent.Result;
+      error?: undefined;
+    }
+  | {
+      setupIntent?: undefined;
+      error: StripeError<CardActionError>;
+    };
+
 export type ConfirmSetupIntentResult =
   | {
       setupIntent: SetupIntent.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 = '~> 23.10.0'
+stripe_version = '~> 23.12.0'
 
 Pod::Spec.new do |s|
   s.name         = 'stripe-react-native'