@stripe/stripe-react-native 0.25.0 → 0.27.0

package/src/types/PaymentIntent.ts

@@ -1,9 +1,10 @@
 import type { StripeError } from '.';
-import type { Address } from './Common';
+import type { Address, BillingDetails } from './Common';
 import type { Result as PaymentMethodResult } from './PaymentMethod';
 import type { NextAction } from './NextAction';
 import type * as PaymentMethod from './PaymentMethod';
-
+import type { FormDetails } from './components/AuBECSDebitFormComponent';
+import type { BankAcccountHolderType, BankAcccountType } from './Token';
 export interface Result {
   id: string;
   amount: number;
@@ -26,7 +27,27 @@ export interface Result {
   nextAction: NextAction | null;
 }
 
-export type ConfirmParams = PaymentMethod.CreateParams;
+export type ConfirmParams =
+  | CardParams
+  | IdealParams
+  | OxxoParams
+  | P24Params
+  | AlipayParams
+  | GiropayParams
+  | SepaParams
+  | EpsParams
+  | AuBecsDebitParams
+  | SofortParams
+  | GrabPayParams
+  | FPXParams
+  | AfterpayClearpayParams
+  | KlarnaParams
+  // | WeChatPayParams
+  | BancontactParams
+  | USBankAccountParams
+  | PayPalParams
+  | AffirmParams
+  | CashAppParams;
 
 export type ConfirmOptions = PaymentMethod.ConfirmOptions;
 
@@ -54,3 +75,206 @@ export enum Status {
   RequiresCapture = 'RequiresCapture',
   Unknown = 'Unknown',
 }
+
+export type MandateData = {
+  customerAcceptance: {
+    online: {
+      ipAddress: string;
+      userAgent: string;
+    };
+  };
+};
+
+export type CardParams =
+  | {
+      paymentMethodType: 'Card';
+      paymentMethodData?: {
+        token?: string;
+        billingDetails?: BillingDetails;
+        mandateData?: MandateData;
+      };
+    }
+  | {
+      paymentMethodType: 'Card';
+      paymentMethodData: {
+        paymentMethodId: string;
+        cvc?: string;
+        billingDetails?: BillingDetails;
+        mandateData?: MandateData;
+      };
+    };
+
+export interface IdealParams {
+  paymentMethodType: 'Ideal';
+  paymentMethodData?: {
+    bankName?: string;
+    billingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface FPXParams {
+  paymentMethodType: 'Fpx';
+  paymentMethodData?: { testOfflineBank?: boolean; mandateData?: MandateData };
+}
+
+export interface AlipayParams {
+  paymentMethodType: 'Alipay';
+  paymentMethodData?: {
+    mandateData?: MandateData;
+  };
+}
+
+export interface OxxoParams {
+  paymentMethodType: 'Oxxo';
+  paymentMethodData: {
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface SofortParams {
+  paymentMethodType: 'Sofort';
+  paymentMethodData: {
+    country: string;
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+export interface GrabPayParams {
+  paymentMethodType: 'GrabPay';
+  paymentMethodData?: {
+    billingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface BancontactParams {
+  paymentMethodType: 'Bancontact';
+  paymentMethodData: {
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface SepaParams {
+  paymentMethodType: 'SepaDebit';
+  paymentMethodData: {
+    iban: string;
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface GiropayParams {
+  paymentMethodType: 'Giropay';
+  paymentMethodData: {
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface AfterpayClearpayParams {
+  paymentMethodType: 'AfterpayClearpay';
+  paymentMethodData: {
+    shippingDetails: BillingDetails;
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export type KlarnaParams = {
+  paymentMethodType: 'Klarna';
+  paymentMethodData: {
+    billingDetails: Pick<Required<BillingDetails>, 'email'> & {
+      address: Pick<Required<Address>, 'country'>;
+    } & BillingDetails;
+    shippingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+};
+
+export interface EpsParams {
+  paymentMethodType: 'Eps';
+  paymentMethodData: {
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface P24Params {
+  paymentMethodType: 'P24';
+  paymentMethodData: {
+    billingDetails: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface WeChatPayParams {
+  paymentMethodType: 'WeChatPay';
+  paymentMethodData: {
+    appId: string;
+    billingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+}
+
+export interface AuBecsDebitParams {
+  paymentMethodType: 'AuBecsDebit';
+  paymentMethodData: { formDetails: FormDetails; mandateData?: MandateData };
+}
+
+export type AffirmParams = {
+  paymentMethodType: 'Affirm';
+  paymentMethodData?: {
+    /** Affirm requires that shipping is present for the payment to succeed because it significantly helps with loan approval rates. Shipping details can either be provided here or via the Payment Intent- https://stripe.com/docs/api/payment_intents/create#create_payment_intent-shipping. */
+    shippingDetails?: BillingDetails;
+    billingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+};
+
+/**
+ * If paymentMethodData is null, it is assumed that the bank account details have already been attached
+ * via `collectBankAccountForPayment` or `collectBankAccountForSetup`.
+ */
+export type USBankAccountParams = {
+  paymentMethodType: 'USBankAccount';
+  paymentMethodData?: {
+    billingDetails: Pick<Required<BillingDetails>, 'name'> & BillingDetails;
+    accountNumber: string;
+    routingNumber: string;
+    /** Defaults to Individual */
+    accountHolderType?: BankAcccountHolderType;
+    /** Defaults to Checking */
+    accountType?: BankAcccountType;
+    mandateData?: MandateData;
+  };
+};
+
+export type PayPalParams = {
+  paymentMethodType: 'PayPal';
+  paymentMethodData?: {
+    billingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+};
+
+export type CashAppParams = {
+  paymentMethodType: 'CashApp';
+  paymentMethodData?: {
+    billingDetails?: BillingDetails;
+    mandateData?: MandateData;
+  };
+};
+
+export type CollectBankAccountParams = {
+  paymentMethodType: 'USBankAccount';
+  paymentMethodData: {
+    billingDetails: {
+      name: string;
+      email?: string;
+    };
+    mandateData?: MandateData;
+  };
+};

package/src/types/PaymentMethod.ts

@@ -43,7 +43,8 @@ export type CreateParams =
   | BancontactParams
   | USBankAccountParams
   | PayPalParams
-  | AffirmParams;
+  | AffirmParams
+  | CashAppParams;
 
 export type ConfirmParams = CreateParams;
 
@@ -210,6 +211,13 @@ export type PayPalParams = {
   };
 };
 
+export type CashAppParams = {
+  paymentMethodType: 'CashApp';
+  paymentMethodData?: {
+    billingDetails?: BillingDetails;
+  };
+};
+
 export interface AuBecsDebitResult {
   fingerprint?: string;
   last4?: string;
@@ -232,6 +240,11 @@ export interface CardResult {
   last4?: string;
   preferredNetwork?: string;
   availableNetworks?: Array<string>;
+  threeDSecureUsage?: ThreeDSecureUsage;
+}
+
+export interface ThreeDSecureUsage {
+  isSupported?: boolean;
 }
 
 export interface FpxResult {

package/src/types/PaymentSheet.ts

@@ -25,6 +25,8 @@ export type SetupParams = ClientSecretParams & {
   style?: 'alwaysLight' | 'alwaysDark' | 'automatic';
   /** 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. */
+  billingDetailsCollectionConfiguration?: BillingDetailsCollectionConfiguration;
   /** PaymentSheet pre-populates the billing fields that are displayed in the Payment Sheet (only country and postal code, as of this version) with the values provided. */
   defaultBillingDetails?: BillingDetails;
   /**
@@ -262,3 +264,34 @@ export type PresentOptions = {
    */
   timeout?: number;
 };
+
+export type BillingDetailsCollectionConfiguration = {
+  /** How to collect the name field. Defaults to `CollectionMode.automatic`. */
+  name?: CollectionMode;
+  /** How to collect the phone field. Defaults to `CollectionMode.automatic`. */
+  phone?: CollectionMode;
+  /** How to collect the email field. Defaults to `CollectionMode.automatic`. */
+  email?: CollectionMode;
+  /** How to collect the billing address. Defaults to `CollectionMode.automatic`. */
+  address?: AddressCollectionMode;
+  /** Whether the values included in `Configuration.defaultBillingDetails` should be attached to the payment method, this includes fields that aren't displayed in the form. If `false` (the default), those values will only be used to prefill the corresponding fields in the form. */
+  attachDefaultsToPaymentMethod?: Boolean;
+};
+
+export enum CollectionMode {
+  /** The field may or may not be collected depending on the Payment Method's requirements. */
+  AUTOMATIC = 'automatic',
+  /** The field will never be collected. If this field is required by the Payment Method, you must provide it as part of `defaultBillingDetails`. */
+  NEVER = 'never',
+  /** The field will always be collected, even if it isn't required for the Payment Method. */
+  ALWAYS = 'always',
+}
+
+export enum AddressCollectionMode {
+  /** Only the fields required by the Payment Method will be collected, which may be none. */
+  AUTOMATIC = 'automatic',
+  /** Billing address will never be collected. If the Payment Method requires a billing address, you must provide it as part of `defaultBillingDetails`. */
+  NEVER = 'never',
+  /** Collect the full billing address, regardless of the Payment Method's requirements. */
+  FULL = 'full',
+}

package/src/types/SetupIntent.ts

@@ -1,5 +1,9 @@
 import type { Type } from './PaymentMethod';
-import type { LastPaymentError } from './PaymentIntent';
+import type {
+  LastPaymentError,
+  ConfirmParams as PaymentIntentConfirmParams,
+  ConfirmOptions as PaymentIntentConfirmOptions,
+} from './PaymentIntent';
 import type { NextAction } from './NextAction';
 import type * as PaymentMethod from './PaymentMethod';
 export interface Result {
@@ -19,26 +23,9 @@ export interface Result {
   nextAction: NextAction | null;
 }
 
-export type ConfirmParams =
-  | PaymentMethod.CardParams
-  | PaymentMethod.IdealParams
-  | PaymentMethod.OxxoParams
-  | PaymentMethod.P24Params
-  | PaymentMethod.AlipayParams
-  | PaymentMethod.GiropayParams
-  | PaymentMethod.SepaParams
-  | PaymentMethod.EpsParams
-  | PaymentMethod.AuBecsDebitParams
-  | PaymentMethod.SofortParams
-  | PaymentMethod.GrabPayParams
-  | PaymentMethod.FPXParams
-  | PaymentMethod.AfterpayClearpayParams
-  | PaymentMethod.KlarnaParams
-  | PaymentMethod.BancontactParams
-  | PaymentMethod.USBankAccountParams;
-// TODO: Change the above back to PaymentMethod.CreateParams when PayPal is supported through SetupIntents
+export type ConfirmParams = PaymentIntentConfirmParams;
 
-export type ConfirmOptions = {};
+export type ConfirmOptions = PaymentIntentConfirmOptions;
 
 export type FutureUsage =
   | 'Unknown'

package/stripe-react-native.podspec

@@ -1,7 +1,7 @@
 require 'json'
 
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
-stripe_version = '~> 23.3.3'
+stripe_version = '23.6.0'
 
 Pod::Spec.new do |s|
   s.name         = 'stripe-react-native'