@stripe/stripe-react-native 0.38.6 → 0.40.0

package/src/components/CardField.tsx

@@ -46,6 +46,8 @@ export interface Props extends AccessibilityProps {
   /** The list of preferred networks that should be used to process payments made with a co-branded card.
    * This value will only be used if your user hasn't selected a network themselves. */
   preferredNetworks?: Array<CardBrand>;
+  /** The account (if any) for which the funds of the intent are intended. */
+  onBehalfOf?: string;
   /**
    * WARNING: If set to `true` the full card number will be returned in the `onCardChange` handler.
    * Only do this if you're certain that you fulfill the necessary PCI compliance requirements.

package/src/components/CustomerSheet.tsx

@@ -257,7 +257,7 @@ export type Props = {
  * @returns JSX.Element
  * @category ReactComponents
  */
-function CustomerSheet({
+function Component({
   visible,
   presentationStyle,
   animationStyle,
@@ -319,8 +319,8 @@ function CustomerSheet({
 /**
  * The Customer Sheet is a prebuilt UI component that lets your customers manage their saved payment methods.
  */
-export const CustomerSheetBeta = {
-  CustomerSheet,
+export const CustomerSheet = {
+  Component,
   initialize,
   present,
   retrievePaymentOptionSelection,

package/src/types/PaymentSheet.ts

@@ -10,13 +10,11 @@ import type { FutureUsage } from './PaymentIntent';
 import type { Result } from './PaymentMethod';
 import type { StripeError } from './Errors';
 
-export type SetupParams = IntentParams & {
+type SetupParamsBase = IntentParams & {
   /** Your customer-facing business name. On Android, this is required and cannot be an empty string. */
   merchantDisplayName: string;
   /** The identifier of the Stripe Customer object. See https://stripe.com/docs/api/customers/object#customer_object-id */
   customerId?: string;
-  /** A short-lived token that allows the SDK to access a Customer’s payment methods. */
-  customerEphemeralKeySecret?: string;
   /** When set to true, separates out the payment method selection & confirmation steps.
    * If true, you must call `confirmPaymentSheetPayment` on your own. Defaults to false. */
   customFlow?: boolean;
@@ -67,8 +65,28 @@ export type SetupParams = IntentParams & {
    *  If false, the customer can't delete if they only have one saved payment method remaining.
    */
   allowsRemovalOfLastSavedPaymentMethod?: boolean;
+  /**
+   * Defines the layout orientations available for displaying payment methods in PaymentSheet.
+   * - Note: Defaults to `Automatic` if not set
+   */
+  paymentMethodLayout?: PaymentMethodLayout;
 };
 
+export type SetupParams =
+  | (SetupParamsBase & {
+      /** A short-lived token that allows the SDK to access a Customer’s payment methods. */
+      customerEphemeralKeySecret: string;
+      customerSessionClientSecret?: never;
+    })
+  | (SetupParamsBase & {
+      customerEphemeralKeySecret?: never;
+      /** (Experimental) This parameter can be changed or removed at any time (use at your own risk).
+       *  The client secret of this Customer Session. Used on the client to set up secure access to the given customer.
+       */
+      customerSessionClientSecret: string;
+    })
+  | SetupParamsBase;
+
 export type IntentParams =
   | {
       paymentIntentClientSecret: string;
@@ -404,3 +422,22 @@ export type SetupMode = {
   Seealso: https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage */
   setupFutureUsage: FutureUsage;
 };
+
+export enum PaymentMethodLayout {
+  /**
+   * Payment methods are arranged horizontally.
+   * Users can swipe left or right to navigate through different payment methods.
+   */
+  Horizontal = 'Horizontal',
+
+  /**
+   * Payment methods are arranged vertically.
+   * Users can scroll up or down to navigate through different payment methods.
+   */
+  Vertical = 'Vertical',
+
+  /**
+   * This lets Stripe choose the best layout for payment methods in the sheet.
+   */
+  Automatic = 'Automatic',
+}

package/src/types/index.ts

@@ -46,6 +46,7 @@ export * from './Errors';
 export * from './CustomerSheet';
 export type { Address, BillingDetails, AddressDetails } from './Common';
 export { CardBrand } from './Common';
+export { PaymentMethodLayout } from './PaymentSheet';
 
 /**
  * @ignore

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.28.0'
+stripe_version = '~> 23.32.0'
 
 Pod::Spec.new do |s|
   s.name         = 'stripe-react-native'