@stripe/stripe-react-native 0.54.1 → 0.55.1

package/src/types/ConfirmationToken.ts

@@ -0,0 +1,76 @@
+import type { BillingDetails } from './Common';
+import type { FutureUsage } from './PaymentIntent';
+import type { Type as PaymentMethodType } from './PaymentMethod';
+
+/**
+ * ConfirmationToken result type.
+ *
+ * @internal DO NOT USE - This API is under active development and is not ready for use.
+ * The API is subject to breaking changes without notice. Do not use in production or development.
+ */
+export interface Result {
+  /** Unique identifier for the object (e.g. `ctoken_...`). */
+  id: string;
+
+  /** Time at which the object was created. Measured in seconds since the Unix epoch. */
+  created: number;
+
+  /** Time at which this ConfirmationToken expires and can no longer be used to confirm a PaymentIntent or SetupIntent. */
+  expiresAt?: number;
+
+  /** `true` if the object exists in live mode or the value `false` if the object exists in test mode. */
+  liveMode: boolean;
+
+  /** ID of the PaymentIntent this token was used to confirm. */
+  paymentIntentId?: string;
+
+  /** ID of the SetupIntent this token was used to confirm. */
+  setupIntentId?: string;
+
+  /** Return URL used to confirm the intent for redirect-based methods. */
+  returnURL?: string;
+
+  /** Indicates intent to reuse the payment method. */
+  setupFutureUsage?: FutureUsage;
+
+  /** Non-PII preview of payment details captured by the Payment Element. */
+  paymentMethodPreview?: PaymentMethodPreview;
+
+  /** Shipping information collected on this token. */
+  shipping?: ShippingDetails;
+
+  /** All response fields from the API, including any additional or undocumented fields. */
+  allResponseFields: Record<string, any>;
+}
+
+/**
+ * Preview of payment method details captured by the ConfirmationToken.
+ * This represents the transactional checkout state, not a reusable PaymentMethod object.
+ */
+export interface PaymentMethodPreview {
+  /** Type of the payment method. */
+  type: PaymentMethodType;
+
+  /** Billing details for the payment method. */
+  billingDetails?: BillingDetails;
+
+  /** This field indicates whether this payment method can be shown again to its customer in a checkout flow */
+  allowRedisplay?: AllowRedisplay;
+
+  /** The ID of the Customer to which this PaymentMethod is saved. Null when the PaymentMethod has not been saved to a Customer. */
+  customerId?: string;
+
+  /** All response fields from the API, including any additional or undocumented fields. */
+  allResponseFields: Record<string, any>;
+}
+
+export type AllowRedisplay = 'always' | 'limited' | 'unspecified';
+
+export interface ShippingDetails {
+  /** The recipient's address. */
+  address: BillingDetails['address'];
+  /** The recipient's name. */
+  name?: string;
+  /** The recipient's phone (including extension). */
+  phone?: string;
+}

package/src/types/EmbeddedPaymentElement.tsx

@@ -13,6 +13,7 @@ import type {
   CardBrand,
 } from './Common';
 import type { PaymentMethod } from '.';
+import type * as ConfirmationToken from './ConfirmationToken';
 import * as PaymentSheetTypes from './PaymentSheet';
 import NativeStripeSdkModule from '../specs/NativeStripeSdkModule';
 import {
@@ -253,6 +254,7 @@ class EmbeddedPaymentElement {
 // JS Factory: createEmbeddedPaymentElement
 // -----------------------------------------------------------------------------
 let confirmHandlerCallback: EventSubscription | null = null;
+let confirmationTokenHandlerCallback: EventSubscription | null = null;
 let formSheetActionConfirmCallback: EventSubscription | null = null;
 let customPaymentMethodConfirmCallback: EventSubscription | null = null;
 let rowSelectionCallback: EventSubscription | null = null;
@@ -295,6 +297,25 @@ function setupConfirmAndSelectionHandlers(
     );
   }
 
+  const confirmationTokenConfirmHandler =
+    intentConfig.confirmationTokenConfirmHandler;
+  if (confirmationTokenConfirmHandler) {
+    confirmationTokenHandlerCallback?.remove();
+    confirmationTokenHandlerCallback = addListener(
+      'onConfirmationTokenHandlerCallback',
+      ({
+        confirmationToken,
+      }: {
+        confirmationToken: ConfirmationToken.Result;
+      }) => {
+        confirmationTokenConfirmHandler(
+          confirmationToken,
+          NativeStripeSdkModule.confirmationTokenCreationCallback
+        );
+      }
+    );
+  }
+
   if (configuration.formSheetAction?.type === 'confirm') {
     const confirmFormSheetHandler =
       configuration.formSheetAction.onFormSheetConfirmComplete;

package/src/types/PaymentSheet.ts

@@ -14,6 +14,7 @@ import type {
 import type { FutureUsage } from './PaymentIntent';
 import type { Result } from './PaymentMethod';
 import type { StripeError } from './Errors';
+import type { Result as ConfirmationTokenResult } from './ConfirmationToken';
 
 export type SetupParamsBase = IntentParams & {
   /** Your customer-facing business name. On Android, this is required and cannot be an empty string. */
@@ -192,8 +193,12 @@ export type AppearanceParams = RecursivePartial<{
     | { light: GlobalColorConfig; dark: GlobalColorConfig };
   /** Describes the appearance of shapes in the PaymentSheet, such as buttons, inputs, and tabs. */
   shapes: {
-    /** The border radius used for buttons, inputs, and tabs in your PaymentSheet.
-     * @default 6.0
+    /** The border radius used for buttons, inputs, tabs in PaymentSheet
+     *   - Note: On iOS, the behavior of this property is consistent with the behavior of corner radius on `CALayer`
+     *   - Note: On iOS, When `nil`, the behavior depends:
+     *     - iOS 26+ and `UIDesignRequiresCompatibility = NO`: Various `UICornerConfiguration` values are used to match Liquid Glass.
+     *     - Pre-iOS 26: A 6.0 corner radius is applied.
+     *   - Note: On Android, a 6.0 corner radius is applied.
      */
     borderRadius: number;
     /** The border width used for inputs and tabs in your PaymentSheet.
@@ -211,8 +216,29 @@ export type AppearanceParams = RecursivePartial<{
 
   /** Describes the inset values applied to Mobile Payment Element forms */
   formInsetValues: EdgeInsetsConfig;
+
+  /** Setting this boolean to `true` will call the iOS applyLiquidGlass() method
+   * (https://stripe.dev/stripe-ios/stripepaymentsheet/documentation/stripepaymentsheet/paymentsheet/appearance/applyliquidglass())
+   * on the Appearance object prior to applying other appearance customizations set on AppearanceParams.
+   * Requires iOS26 and Xcode 26, and will be ignored if these requirements are not met.
+   * @default false
+   */
+  applyLiquidGlass?: boolean;
+
+  /** Describes the navigation bar style (iOS only)
+   *  @default Plain
+   */
+  navigationBarStyle?: NavigationBarStyle;
 }>;
 
+/** Display styles for the navigation bar (iOS only) */
+export enum NavigationBarStyle {
+  /** Default style */
+  Plain = 'plain',
+  /** Style to match iOS 26 Liquid Glass. Requires: iOS26 and Xcode 26, and will be ignored if these requirements are not met. */
+  Glass = 'glass',
+}
+
 export type FontConfig = {
   /**
    * The font used for regular text. PaymentSheet will attempt to use medium and bold versions of this font if they exist.
@@ -538,19 +564,42 @@ export type IntentCreationCallbackParams =
     };
 
 export type IntentConfiguration = {
-  /*
-    Called when the customer confirms payment. Your implementation should create a PaymentIntent or SetupIntent on your server and call the `intentCreationCallback` with its client secret or an error if one occurred.
-    - Note: You must create the PaymentIntent or SetupIntent with the same values used as the `IntentConfiguration` e.g. the same amount, currency, etc.
-    - Parameters:
-      - paymentMethod: The PaymentMethod representing the customer's payment details.
-      - shouldSavePaymentMethod: This is `true` if the customer selected the "Save this payment method for future use" checkbox. Set `setup_future_usage` on the PaymentIntent to `off_session` if this is `true`.
-      - intentCreationCallback: Call this with the `client_secret` of the PaymentIntent or SetupIntent created by your server or the error that occurred. If you're using customFlow: false (default), the error's localizedMessage will be displayed to the customer in the sheet. If you're using customFlow: true, the `confirm` method fails with the error.
-  */
-  confirmHandler: (
+  /**
+   * Called when the customer confirms payment. Your implementation should create a PaymentIntent or SetupIntent on your server and call the `intentCreationCallback` with its client secret or an error if one occurred.
+   * - Note: You must create the PaymentIntent or SetupIntent with the same values used as the `IntentConfiguration` e.g. the same amount, currency, etc.
+   * - Note: Either `confirmHandler` or `confirmationTokenConfirmHandler` must be provided, but not both.
+   * - Parameters:
+   *   - paymentMethod: The PaymentMethod representing the customer's payment details.
+   *   - shouldSavePaymentMethod: This is `true` if the customer selected the "Save this payment method for future use" checkbox. Set `setup_future_usage` on the PaymentIntent to `off_session` if this is `true`.
+   *   - intentCreationCallback: Call this with the `client_secret` of the PaymentIntent or SetupIntent created by your server or the error that occurred. If you're using customFlow: false (default), the error's localizedMessage will be displayed to the customer in the sheet. If you're using customFlow: true, the `confirm` method fails with the error.
+   */
+  confirmHandler?: (
     paymentMethod: Result,
     shouldSavePaymentMethod: boolean,
     intentCreationCallback: (result: IntentCreationCallbackParams) => void
   ) => void;
+
+  /**
+   * @internal DO NOT USE - This API is under active development and is not ready for use.
+   * The API is subject to breaking changes without notice. Do not use in production or development.
+   *
+   * Called when the customer confirms payment using confirmation tokens.
+   * Your implementation should follow the guide to create (and optionally confirm) a PaymentIntent or SetupIntent on your server and call the `intentCreationCallback` with its client secret or an error if one occurred.
+   *
+   * - Note: You must create the PaymentIntent or SetupIntent with the same values used as the `IntentConfiguration` e.g. the same amount, currency, etc.
+   * - Note: When confirming the PaymentIntent or SetupIntent on your server, use the confirmation token ID (`confirmationToken.id`) as the `confirmation_token` parameter.
+   * - Note: Either `confirmHandler` or `confirmationTokenConfirmHandler` must be provided, but not both.
+   *
+   * @param confirmationToken - The ConfirmationToken representing the customer's payment details and any additional information collected during checkout (e.g., billing details, shipping address). This token contains a secure, non-PII preview of the payment method that can be safely passed to your server. Use `confirmationToken.id` when confirming the intent on your server.
+   * @param intentCreationCallback - Call this with the `client_secret` of the PaymentIntent or SetupIntent created by your server or the error that occurred. If you're using PaymentSheet, the error's localizedMessage will be displayed to the customer in the sheet. If you're using PaymentSheet.FlowController, the `confirm` method fails with the error.
+   *
+   * @see https://stripe.com/docs/api/confirmation_tokens
+   */
+  confirmationTokenConfirmHandler?: (
+    confirmationToken: ConfirmationTokenResult,
+    intentCreationCallback: (result: IntentCreationCallbackParams) => void
+  ) => void;
+
   /* Information about the payment (PaymentIntent) or setup (SetupIntent).*/
   mode: Mode;
   /* A list of payment method types to display to the customer. If undefined or empty, we dynamically determine the payment methods using your Stripe Dashboard settings. */

package/src/types/index.ts

@@ -25,6 +25,7 @@ import * as CardFormView from './components/CardFormView';
 import * as Token from './Token';
 import * as FinancialConnections from './FinancialConnections';
 import * as PlatformPay from './PlatformPay';
+import * as ConfirmationToken from './ConfirmationToken';
 
 export {
   ApplePay,
@@ -39,6 +40,7 @@ export {
   Token,
   FinancialConnections,
   PlatformPay,
+  ConfirmationToken,
 };
 
 export * from './PushProvisioning';

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.23.0'
+stripe_version = '~> 24.24.0'
 
 fabric_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'
 

package/android/.idea/AndroidProjectSystem.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AndroidProjectSystem">
-    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
-  </component>
-</project>