@stripe/stripe-react-native 0.42.0 → 0.43.0

package/src/functions.ts

@@ -121,9 +121,8 @@ export const retrieveSetupIntent = async (
   clientSecret: string
 ): Promise<RetrieveSetupIntentResult> => {
   try {
-    const { setupIntent, error } = await NativeStripeSdk.retrieveSetupIntent(
-      clientSecret
-    );
+    const { setupIntent, error } =
+      await NativeStripeSdk.retrieveSetupIntent(clientSecret);
     if (error) {
       return {
         error,
@@ -271,9 +270,8 @@ export const createTokenForCVCUpdate = async (
   cvc: string
 ): Promise<CreateTokenForCVCUpdateResult> => {
   try {
-    const { tokenId, error } = await NativeStripeSdk.createTokenForCVCUpdate(
-      cvc
-    );
+    const { tokenId, error } =
+      await NativeStripeSdk.createTokenForCVCUpdate(cvc);
     if (error) {
       return {
         error,
@@ -423,9 +421,8 @@ export const presentPaymentSheet = async (
   options: PaymentSheet.PresentOptions = {}
 ): Promise<PresentPaymentSheetResult> => {
   try {
-    const { paymentOption, error } = await NativeStripeSdk.presentPaymentSheet(
-      options
-    );
+    const { paymentOption, error } =
+      await NativeStripeSdk.presentPaymentSheet(options);
     if (error) {
       return {
         error,
@@ -565,7 +562,7 @@ export const collectBankAccountToken = async (
 
   try {
     const { session, token, error } =
-      await NativeStripeSdk.collectBankAccountToken(clientSecret);
+      await NativeStripeSdk.collectBankAccountToken(clientSecret, params);
 
     financialConnectionsEventListener?.remove();
 
@@ -608,7 +605,10 @@ export const collectFinancialConnectionsAccounts = async (
 
   try {
     const { session, error } =
-      await NativeStripeSdk.collectFinancialConnectionsAccounts(clientSecret);
+      await NativeStripeSdk.collectFinancialConnectionsAccounts(
+        clientSecret,
+        params
+      );
 
     financialConnectionsEventListener?.remove();
 
@@ -662,9 +662,8 @@ export const isCardInWallet = async (params: {
   cardLastFour: string;
 }): Promise<IsCardInWalletResult> => {
   try {
-    const { isInWallet, token, error } = await NativeStripeSdk.isCardInWallet(
-      params
-    );
+    const { isInWallet, token, error } =
+      await NativeStripeSdk.isCardInWallet(params);
 
     if (error) {
       return {

package/src/types/Common.ts

@@ -38,3 +38,6 @@ export enum CardBrand {
   Visa = 7,
   Unknown = 8,
 }
+
+/** Theme options for colors used in our UI. */
+export type UserInterfaceStyle = 'alwaysLight' | 'alwaysDark' | 'automatic';

package/src/types/CustomerSheet.ts

@@ -47,6 +47,13 @@ export type CustomerSheetInitParams = {
    *  If false, the customer can't delete if they only have one saved payment method remaining.
    */
   allowsRemovalOfLastSavedPaymentMethod?: boolean;
+  /**
+   * By default, CustomerSheet will accept all supported cards by Stripe.
+   * You can specify card brands CustomerSheet should block or allow payment for by providing an array of those card brands.
+   * Note: This is only a client-side solution.
+   * Note: Card brand filtering is not currently supported in Link.
+   */
+  cardBrandAcceptance?: PaymentSheet.CardBrandAcceptance;
 };
 
 export type CustomerSheetPresentParams = {

package/src/types/FinancialConnections.ts

@@ -1,7 +1,10 @@
+import type { UserInterfaceStyle } from './Common';
 import type { BankAccount } from './Token';
 import type { StripeError } from './Errors';
 
 export type CollectFinancialConnectionsAccountsParams = {
+  /** iOS Only. Style options for colors in Financial Connections. By default, the bank account collector will automatically switch between light and dark mode compatible colors based on device settings. */
+  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;
 };

package/src/types/PaymentMethod.ts

@@ -5,7 +5,7 @@ import type {
   BankAcccountType,
 } from './Token';
 import type { FutureUsage } from './PaymentIntent';
-import type { Address, BillingDetails } from './Common';
+import type { Address, BillingDetails, UserInterfaceStyle } from './Common';
 import type { FinancialConnectionsEvent } from './FinancialConnections';
 
 export interface Result {
@@ -314,11 +314,15 @@ export type CollectBankAccountParams = {
       email?: string;
     };
   };
+  /** iOS only. Style options for colors in Financial Connections. By default, the bank account collector will automatically switch between light and dark mode compatible colors based on device settings. */
+  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;
 };
 
 export type CollectBankAccountTokenParams = {
+  /** iOS only. Style options for colors in Financial Connections. By default, the bank account collector will automatically switch between light and dark mode compatible colors based on device settings. */
+  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;
 };

package/src/types/PaymentSheet.ts

@@ -1,4 +1,9 @@
-import type { BillingDetails, AddressDetails, CardBrand } from './Common';
+import type {
+  BillingDetails,
+  AddressDetails,
+  CardBrand,
+  UserInterfaceStyle,
+} from './Common';
 import type { CartSummaryItem } from './ApplePay';
 import type {
   ButtonType,
@@ -23,7 +28,7 @@ export type SetupParamsBase = IntentParams & {
   /** Android only. Enable Google Pay in the Payment Sheet by passing a GooglePayParams object.  */
   googlePay?: GooglePayParams;
   /** The color styling to use for PaymentSheet UI. Defaults to 'automatic'. */
-  style?: 'alwaysLight' | 'alwaysDark' | 'automatic';
+  style?: UserInterfaceStyle;
   /** A URL that redirects back to your app that PaymentSheet can use to auto-dismiss web views used for additional authentication, e.g. 3DS2 */
   returnURL?: string;
   /** Configuration for how billing details are collected during checkout. */
@@ -70,6 +75,13 @@ export type SetupParamsBase = IntentParams & {
    * - Note: Defaults to `Automatic` if not set
    */
   paymentMethodLayout?: PaymentMethodLayout;
+  /**
+   * By default, PaymentSheet will accept all supported cards by Stripe.
+   * You can specify card brands PaymentSheet should block or allow payment for by providing an array of those card brands.
+   * Note: This is only a client-side solution.
+   * Note: Card brand filtering is not currently supported in Link.
+   */
+  cardBrandAcceptance?: CardBrandAcceptance;
 };
 
 export type SetupParams =
@@ -303,8 +315,8 @@ type RecursivePartial<T> = {
   [P in keyof T]?: T[P] extends (infer U)[]
     ? RecursivePartial<U>[]
     : T[P] extends object
-    ? RecursivePartial<T[P]>
-    : T[P];
+      ? RecursivePartial<T[P]>
+      : T[P];
 };
 export interface PaymentOption {
   label: string;
@@ -441,3 +453,51 @@ export enum PaymentMethodLayout {
    */
   Automatic = 'Automatic',
 }
+
+/** Card brand categories that can be allowed or disallowed */
+export enum CardBrandCategory {
+  /** Visa branded cards */
+  Visa = 'visa',
+  /** Mastercard branded cards */
+  Mastercard = 'mastercard',
+  /** American Express branded cards */
+  Amex = 'amex',
+  /**
+   * Discover branded cards
+   * Note: Encompasses all of Discover Global Network (Discover, Diners, JCB, UnionPay, Elo)
+   */
+  Discover = 'discover',
+}
+
+/** Filter types for card brand acceptance */
+export enum CardBrandAcceptanceFilter {
+  /** Accept all card brands supported by Stripe */
+  All = 'all',
+  /** Accept only the specified card brands */
+  Allowed = 'allowed',
+  /** Accept all card brands except the specified ones */
+  Disallowed = 'disallowed',
+}
+
+/** Options to block certain card brands on the client */
+export type CardBrandAcceptance =
+  | {
+      /** Accept all card brands supported by Stripe */
+      filter: CardBrandAcceptanceFilter.All;
+    }
+  | {
+      /** Accept only the specified card brands */
+      filter: CardBrandAcceptanceFilter.Allowed;
+      /** List of card brands to accept
+       * Note: Any card brands that do not map to a CardBrandCategory will be blocked when using an allow list
+       */
+      brands: CardBrandCategory[];
+    }
+  | {
+      /** Accept all card brands except the specified ones */
+      filter: CardBrandAcceptanceFilter.Disallowed;
+      /** List of card brands to block
+       * Note: Any card brands that do not map to a CardBrandCategory will be accepted when using a disallow list
+       */
+      brands: CardBrandCategory[];
+    };

package/src/types/components/CardFieldInput.ts

@@ -51,6 +51,12 @@ export interface Placeholders {
   postalCode?: string;
 }
 
+export type OnFocusChangeEvent = NativeSyntheticEvent<{
+  focusedField: FieldName | null;
+}>;
+
+export type OnCardChangeEvent = NativeSyntheticEvent<Details>;
+
 /**
  * @ignore
  */
@@ -60,10 +66,8 @@ export interface NativeProps {
   postalCodeEnabled?: boolean;
   autofocus?: boolean;
   countryCode: string | null;
-  onCardChange(event: NativeSyntheticEvent<Details>): void;
-  onFocusChange(
-    event: NativeSyntheticEvent<{ focusedField: FieldName | null }>
-  ): void;
+  onCardChange(event: OnCardChangeEvent): void;
+  onFocusChange(event: OnFocusChangeEvent): void;
   cardStyle?: Styles;
   placeholders?: Placeholders;
   disabled?: boolean;

package/src/types/components/CardFormView.ts

@@ -49,6 +49,12 @@ export type DefaultValues = {
   countryCode?: string;
 };
 
+export type OnFocusChangeEvent = NativeSyntheticEvent<{
+  focusedField: FieldName | null;
+}>;
+
+export type OnFormCompleteEvent = NativeSyntheticEvent<Details>;
+
 /**
  * @ignore
  */
@@ -61,10 +67,8 @@ export interface NativeProps {
   /** Android only */
   defaultValues?: DefaultValues;
   // postalCodeEnabled: boolean;
-  onFocusChange(
-    event: NativeSyntheticEvent<{ focusedField: FieldName | null }>
-  ): void;
-  onFormComplete(event: NativeSyntheticEvent<Details>): void;
+  onFocusChange(event: OnFocusChangeEvent): void;
+  onFormComplete(event: OnFormCompleteEvent): void;
   disabled?: boolean;
 }
 

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 = '~> 24.4.0'
+stripe_version = '~> 24.7.0'
 
 Pod::Spec.new do |s|
   s.name         = 'stripe-react-native'
@@ -19,6 +19,7 @@ Pod::Spec.new do |s|
   s.exclude_files = 'ios/Tests/'
 
   s.test_spec 'Tests' do |test_spec|
+    test_spec.platforms    = { ios: '15.1' }
     test_spec.source_files = 'ios/Tests/**/*.{m,swift}'
   end