@stripe/stripe-react-native 0.49.0 → 0.50.1

package/patches/README.md

@@ -0,0 +1,55 @@
+# Old Architecture Codegen Fix
+
+This patch fixes the codegen issue that occurs when using `@stripe/stripe-react-native` with React Native 0.74+ in the old architecture.
+
+## The Problem
+
+When using React Native 0.74+ with the old architecture, you may encounter this error during pod install:
+
+```
+UnsupportedModulePropertyParserError: Module NativeStripeSdkModule: TypeScript interfaces extending TurboModule must only contain 'FunctionTypeAnnotation's. Property 'onConfirmHandlerCallback' refers to a 'TSTypeReference'.
+```
+
+This occurs because the React Native codegen in the old architecture doesn't support `EventEmitter` properties in TurboModule interfaces.
+
+## The Solution
+
+This patch converts all `EventEmitter` properties to callback function methods, making them compatible with the old architecture codegen.
+
+## How to Apply
+
+### Option 1: Manual patch command
+
+```bash
+cd node_modules/@stripe/stripe-react-native
+patch -p0 < patches/old-arch-codegen-fix.patch
+```
+
+### Option 2: Using patch-package (Recommended)
+
+1. Install patch-package as a dev dependency:
+   ```bash
+   npm install --save-dev patch-package
+   ```
+
+2. Apply the patch manually first:
+   ```bash
+   cd node_modules/@stripe/stripe-react-native
+   patch -p0 < ../../patches/old-arch-codegen-fix.patch
+   ```
+
+3. Generate a patch-package patch:
+   ```bash
+   npx patch-package @stripe/stripe-react-native
+   ```
+
+4. Add postinstall script to your `package.json`:
+   ```json
+   {
+     "scripts": {
+       "postinstall": "patch-package"
+     }
+   }
+   ```
+
+This ensures the patch is automatically applied whenever you run `npm install`.

package/patches/old-arch-codegen-fix.patch

@@ -0,0 +1,87 @@
+--- src/specs/NativeStripeSdkModule.ts.orig	2025-07-09 10:31:12.373374861 -0600
++++ src/specs/NativeStripeSdkModule.ts	2025-07-09 10:31:34.254519742 -0600
+@@ -1,7 +1,6 @@
+ import { TurboModuleRegistry } from 'react-native';
+ import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
+ import type {
+-  EventEmitter,
+   Int32,
+ } from 'react-native/Libraries/Types/CodegenTypes';
+ import type {
+@@ -185,35 +184,47 @@
+   ): Promise<void>;
+   clearEmbeddedPaymentOption(viewTag: Int32): Promise<void>;
+ 
+-  // Events
+-  onConfirmHandlerCallback: EventEmitter<{
+-    paymentMethod: UnsafeObject<PaymentMethod.Result>;
+-    shouldSavePaymentMethod: boolean;
+-  }>;
+-  onFinancialConnectionsEvent: EventEmitter<
+-    UnsafeObject<FinancialConnectionsEvent>
+-  >;
+-  onOrderTrackingCallback: EventEmitter<void>;
+-  onCustomerAdapterFetchPaymentMethodsCallback: EventEmitter<void>;
+-  onCustomerAdapterAttachPaymentMethodCallback: EventEmitter<{
+-    paymentMethodId: string;
+-  }>;
+-  onCustomerAdapterDetachPaymentMethodCallback: EventEmitter<{
+-    paymentMethodId: string;
+-  }>;
+-  onCustomerAdapterSetSelectedPaymentOptionCallback: EventEmitter<{
+-    paymentOption: string;
+-  }>;
+-  onCustomerAdapterFetchSelectedPaymentOptionCallback: EventEmitter<void>;
+-  onCustomerAdapterSetupIntentClientSecretForCustomerAttachCallback: EventEmitter<void>;
+-  embeddedPaymentElementDidUpdateHeight: EventEmitter<UnsafeObject<any>>;
+-  embeddedPaymentElementWillPresent: EventEmitter<void>;
+-  embeddedPaymentElementDidUpdatePaymentOption: EventEmitter<UnsafeObject<any>>;
+-  embeddedPaymentElementFormSheetConfirmComplete: EventEmitter<
+-    UnsafeObject<any>
+-  >;
+-  embeddedPaymentElementRowSelectionImmediateAction: EventEmitter<void>;
+-  embeddedPaymentElementLoadingFailed: EventEmitter<UnsafeObject<any>>;
++  // Events (callback form for old architecture)
++  onConfirmHandlerCallback(
++    callback: (event: {
++      paymentMethod: UnsafeObject<PaymentMethod.Result>;
++      shouldSavePaymentMethod: boolean;
++    }) => void
++  ): void;
++  onFinancialConnectionsEvent(
++    callback: (event: UnsafeObject<FinancialConnectionsEvent>) => void
++  ): void;
++  onOrderTrackingCallback(callback: () => void): void;
++  onCustomerAdapterFetchPaymentMethodsCallback(callback: () => void): void;
++  onCustomerAdapterAttachPaymentMethodCallback(
++    callback: (event: { paymentMethodId: string }) => void
++  ): void;
++  onCustomerAdapterDetachPaymentMethodCallback(
++    callback: (event: { paymentMethodId: string }) => void
++  ): void;
++  onCustomerAdapterSetSelectedPaymentOptionCallback(
++    callback: (event: { paymentOption: string }) => void
++  ): void;
++  onCustomerAdapterFetchSelectedPaymentOptionCallback(
++    callback: () => void
++  ): void;
++  onCustomerAdapterSetupIntentClientSecretForCustomerAttachCallback(
++    callback: () => void
++  ): void;
++  embeddedPaymentElementDidUpdateHeight(
++    callback: (event: UnsafeObject<any>) => void
++  ): void;
++  embeddedPaymentElementWillPresent(callback: () => void): void;
++  embeddedPaymentElementDidUpdatePaymentOption(
++    callback: (event: UnsafeObject<any>) => void
++  ): void;
++  embeddedPaymentElementFormSheetConfirmComplete(
++    callback: (event: UnsafeObject<any>) => void
++  ): void;
++  embeddedPaymentElementRowSelectionImmediateAction(callback: () => void): void;
++  embeddedPaymentElementLoadingFailed(
++    callback: (event: UnsafeObject<any>) => void
++  ): void;
+ }
+ 
+ export default TurboModuleRegistry.getEnforcing<Spec>('StripeSdk');

package/src/components/PlatformPayButton.tsx

@@ -141,6 +141,17 @@ export function PlatformPayButton({
       }
     : undefined;
 
+  const callbackProps: any = {
+    onShippingMethodSelectedAction: shippingMethodCallback,
+    onShippingContactSelectedAction: shippingContactCallback,
+    onCouponCodeEnteredAction: couponCodeCallback,
+    onOrderTrackingAction: orderTrackingCallback,
+    hasShippingMethodCallback: !!onShippingMethodSelected,
+    hasShippingContactCallback: !!onShippingContactSelected,
+    hasCouponCodeCallback: !!onCouponCodeEntered,
+    hasOrderTrackingCallback: !!setOrderTracking,
+  };
+
   return (
     <TouchableOpacity
       disabled={disabled}
@@ -154,11 +165,8 @@ export function PlatformPayButton({
           buttonStyle={appearance}
           borderRadius={borderRadius}
           disabled={disabled ?? false}
-          onShippingMethodSelectedAction={shippingMethodCallback}
-          onShippingContactSelectedAction={shippingContactCallback}
-          onCouponCodeEnteredAction={couponCodeCallback}
-          onOrderTrackingAction={orderTrackingCallback}
           style={styles.nativeButtonStyle}
+          {...callbackProps}
           {...props}
         />
       ) : (

package/src/events.ts

@@ -37,7 +37,8 @@ type Events =
   | 'embeddedPaymentElementRowSelectionImmediateAction'
   | 'embeddedPaymentElementDidUpdatePaymentOption'
   | 'embeddedPaymentElementDidUpdateHeight'
-  | 'embeddedPaymentElementLoadingFailed';
+  | 'embeddedPaymentElementLoadingFailed'
+  | 'onCustomPaymentMethodConfirmHandlerCallback';
 
 export function addListener<EventT extends Events>(
   event: EventT,

package/src/functions.ts

@@ -185,7 +185,10 @@ export const handleNextAction = async (
             paymentIntentClientSecret,
             returnURL ?? null
           )
-        : await NativeStripeSdk.handleNextAction(paymentIntentClientSecret);
+        : await NativeStripeSdk.handleNextAction(
+            paymentIntentClientSecret,
+            returnURL ?? null
+          );
     if (error) {
       return {
         error,
@@ -352,6 +355,8 @@ export const verifyMicrodepositsForSetup = async (
 let confirmHandlerCallback: EventSubscription | null = null;
 let orderTrackingCallbackListener: EventSubscription | null = null;
 let financialConnectionsEventListener: EventSubscription | null = null;
+let paymentSheetCustomPaymentMethodConfirmCallback: EventSubscription | null =
+  null;
 
 export const initPaymentSheet = async (
   params: PaymentSheet.SetupParams
@@ -372,6 +377,36 @@ export const initPaymentSheet = async (
     );
   }
 
+  // Setup custom payment method confirmation handler for PaymentSheet
+  if (params.customPaymentMethodConfiguration) {
+    const customPaymentMethodHandler =
+      params.customPaymentMethodConfiguration
+        .confirmCustomPaymentMethodCallback;
+    if (customPaymentMethodHandler) {
+      paymentSheetCustomPaymentMethodConfirmCallback?.remove();
+      paymentSheetCustomPaymentMethodConfirmCallback = addListener(
+        'onCustomPaymentMethodConfirmHandlerCallback',
+        ({
+          customPaymentMethod,
+          billingDetails,
+        }: {
+          customPaymentMethod: PaymentSheet.CustomPaymentMethod;
+          billingDetails: import('./types').BillingDetails | null;
+        }) => {
+          // Call the user's handler with a result handler callback
+          customPaymentMethodHandler(
+            customPaymentMethod,
+            billingDetails,
+            (cpmResult: PaymentSheet.CustomPaymentMethodResult) => {
+              // Send the result back to the native side
+              NativeStripeSdk.customPaymentMethodResultCallback(cpmResult);
+            }
+          );
+        }
+      );
+    }
+  }
+
   const orderTrackingCallback = params?.applePay?.setOrderTracking;
   if (orderTrackingCallback) {
     orderTrackingCallbackListener?.remove();

package/src/specs/NativeApplePayButton.ts

@@ -31,6 +31,11 @@ export interface NativeProps extends ViewProps {
   onShippingContactSelectedAction?: DirectEventHandler<OnShippingContactSelectedActionEvent>;
   onCouponCodeEnteredAction?: DirectEventHandler<OnCouponCodeEnteredActionEvent>;
   onOrderTrackingAction?: DirectEventHandler<OnOrderTrackingActionEvent>;
+  // Boolean flags to indicate which callbacks are provided
+  hasShippingMethodCallback?: WithDefault<boolean, false>;
+  hasShippingContactCallback?: WithDefault<boolean, false>;
+  hasCouponCodeCallback?: WithDefault<boolean, false>;
+  hasOrderTrackingCallback?: WithDefault<boolean, false>;
 }
 
 type ComponentType = HostComponent<NativeProps>;

package/src/specs/NativeStripeSdkModule.ts

@@ -83,6 +83,9 @@ export interface Spec extends TurboModule {
   intentCreationCallback(
     result: UnsafeObject<PaymentSheet.IntentCreationCallbackParams>
   ): Promise<void>;
+  customPaymentMethodResultCallback(
+    result: UnsafeObject<PaymentSheet.CustomPaymentMethodResult>
+  ): Promise<void>;
   presentPaymentSheet(
     options: UnsafeObject<PaymentSheet.PresentOptions>
   ): Promise<PresentPaymentSheetResult>;
@@ -214,6 +217,7 @@ export interface Spec extends TurboModule {
   >;
   embeddedPaymentElementRowSelectionImmediateAction: EventEmitter<void>;
   embeddedPaymentElementLoadingFailed: EventEmitter<UnsafeObject<any>>;
+  onCustomPaymentMethodConfirmHandlerCallback: EventEmitter<UnsafeObject<any>>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('StripeSdk');

package/src/types/EmbeddedPaymentElement.tsx

@@ -192,6 +192,8 @@ export interface EmbeddedPaymentElementConfiguration {
    * The sheet has a button at the bottom. `formSheetAction` controls the action the button performs.
    */
   formSheetAction?: EmbeddedFormSheetAction;
+  /** Configuration for custom payment methods in EmbeddedPaymentElement */
+  customPaymentMethodConfiguration?: PaymentSheetTypes.CustomPaymentMethodConfiguration;
   /** The view can display payment methods that, when tapped, do not open a sheet to collect additional details.
    * `rowSelectionBehavior` controls the behavior tapping on these payment methods performs.
    */
@@ -239,6 +241,7 @@ class EmbeddedPaymentElement {
 // -----------------------------------------------------------------------------
 let confirmHandlerCallback: EventSubscription | null = null;
 let formSheetActionConfirmCallback: EventSubscription | null = null;
+let customPaymentMethodConfirmCallback: EventSubscription | null = null;
 let rowSelectionCallback: EventSubscription | null = null;
 
 async function createEmbeddedPaymentElement(
@@ -294,6 +297,36 @@ function setupConfirmAndSelectionHandlers(
     }
   }
 
+  // Setup custom payment method confirmation handler
+  if (configuration.customPaymentMethodConfiguration) {
+    const customPaymentMethodHandler =
+      configuration.customPaymentMethodConfiguration
+        .confirmCustomPaymentMethodCallback;
+    if (customPaymentMethodHandler) {
+      customPaymentMethodConfirmCallback?.remove();
+      customPaymentMethodConfirmCallback = addListener(
+        'onCustomPaymentMethodConfirmHandlerCallback',
+        ({
+          customPaymentMethod,
+          billingDetails,
+        }: {
+          customPaymentMethod: PaymentSheetTypes.CustomPaymentMethod;
+          billingDetails: BillingDetails | null;
+        }) => {
+          // Call the user's handler with a result handler callback
+          customPaymentMethodHandler(
+            customPaymentMethod,
+            billingDetails,
+            (result: PaymentSheetTypes.CustomPaymentMethodResult) => {
+              // Send the result back to the native side
+              NativeStripeSdkModule.customPaymentMethodResultCallback(result);
+            }
+          );
+        }
+      );
+    }
+  }
+
   if (configuration.rowSelectionBehavior?.type === 'immediateAction') {
     const rowSelectionHandler =
       configuration.rowSelectionBehavior.onSelectPaymentOption;

package/src/types/PaymentIntent.ts

@@ -39,7 +39,6 @@ export type ConfirmParams =
   | SepaParams
   | EpsParams
   | AuBecsDebitParams
-  | SofortParams
   | GrabPayParams
   | FPXParams
   | AfterpayClearpayParams
@@ -149,15 +148,6 @@ export interface OxxoParams {
   };
 }
 
-export interface SofortParams {
-  paymentMethodType: 'Sofort';
-  paymentMethodData: {
-    country: string;
-    billingDetails: BillingDetails;
-    mandateData?: MandateData;
-    metadata?: MetaData;
-  };
-}
 export interface GrabPayParams {
   paymentMethodType: 'GrabPay';
   paymentMethodData?: {

package/src/types/PaymentMethod.ts

@@ -20,7 +20,6 @@ export interface Result {
   Fpx: FpxResult;
   Ideal: IdealResult;
   SepaDebit: SepaDebitResult;
-  Sofort: SofortResult;
   Upi: UpiResult;
   USBankAccount: USBankAccountResult;
 }
@@ -35,7 +34,6 @@ export type CreateParams =
   | SepaParams
   | EpsParams
   | AuBecsDebitParams
-  | SofortParams
   | GrabPayParams
   | FPXParams
   | AfterpayClearpayParams
@@ -98,13 +96,6 @@ export interface OxxoParams {
   };
 }
 
-export interface SofortParams {
-  paymentMethodType: 'Sofort';
-  paymentMethodData: {
-    country: string;
-    billingDetails: BillingDetails;
-  };
-}
 export interface GrabPayParams {
   paymentMethodType: 'GrabPay';
   paymentMethodData?: {
@@ -264,10 +255,6 @@ export interface SepaDebitResult {
   last4?: string;
 }
 
-export interface SofortResult {
-  country?: string;
-}
-
 export interface UpiResult {
   vpa?: string;
 }
@@ -300,7 +287,6 @@ export type Type =
   | 'Eps'
   | 'Bancontact'
   | 'Oxxo'
-  | 'Sofort'
   | 'Upi'
   | 'USBankAccount'
   | 'PayPal'

package/src/types/PaymentSheet.ts

@@ -84,6 +84,8 @@ export type SetupParamsBase = IntentParams & {
    * Note: Card brand filtering is not currently supported in Link.
    */
   cardBrandAcceptance?: CardBrandAcceptance;
+  /** Configuration for custom payment methods in PaymentSheet */
+  customPaymentMethodConfiguration?: CustomPaymentMethodConfiguration;
 };
 
 export type SetupParams =
@@ -666,3 +668,60 @@ export type CardBrandAcceptance =
        */
       brands: CardBrandCategory[];
     };
+
+/**
+ * Configuration for a custom payment method.
+ */
+export interface CustomPaymentMethod {
+  /** The custom payment method ID (beginning with `cpmt_`) as created in your Stripe Dashboard. */
+  id: string;
+  /** Optional subtitle to display beneath the custom payment method name. */
+  subtitle?: string;
+  /** Whether to disable billing detail collection for this custom payment method. Defaults to true. */
+  disableBillingDetailCollection?: boolean;
+}
+
+/**
+ * Custom payment method confirmation result type for PaymentSheet.
+ */
+export enum CustomPaymentMethodResultStatus {
+  /** The custom payment method transaction was completed successfully */
+  Completed = 'completed',
+  /** The custom payment method transaction was canceled by the user */
+  Canceled = 'canceled',
+  /** The custom payment method transaction failed */
+  Failed = 'failed',
+}
+
+/**
+ * Result object returned when a custom payment method transaction completes.
+ * Contains the transaction status and, in case of failure, an error message.
+ */
+export type CustomPaymentMethodResult =
+  | { status: CustomPaymentMethodResultStatus.Completed }
+  | { status: CustomPaymentMethodResultStatus.Canceled }
+  | { status: CustomPaymentMethodResultStatus.Failed; error: string };
+
+/**
+ * Callback function called when a custom payment method is selected and confirmed.
+ * Your implementation should complete the payment using your custom payment provider's SDK.
+ */
+export type ConfirmCustomPaymentMethodCallback = (
+  customPaymentMethod: CustomPaymentMethod,
+  billingDetails: BillingDetails | null,
+  /**
+   * Call this function with the result of your custom payment method transaction.
+   * @param result The result of the custom payment method confirmation
+   */
+  resultHandler: (result: CustomPaymentMethodResult) => void
+) => void;
+
+/**
+ * Configuration for custom payment methods in PaymentSheet.
+ */
+export interface CustomPaymentMethodConfiguration {
+  /** Array of custom payment methods to display in the Payment Sheet */
+  customPaymentMethods: CustomPaymentMethod[];
+  /** Callback function to handle custom payment method confirmation */
+  confirmCustomPaymentMethodCallback: ConfirmCustomPaymentMethodCallback;
+}

package/.env

@@ -1,19 +0,0 @@
-# Stripe API keys - see https://stripe.com/docs/development/quickstart#api-keys
-STRIPE_PUBLISHABLE_KEY=pk_test
-STRIPE_SECRET_KEY=sk_test
-
-STRIPE_PUBLISHABLE_KEY_MY=pk_test
-STRIPE_SECRET_KEY_MY=sk_test
-
-STRIPE_PUBLISHABLE_KEY_MX=pk_test
-STRIPE_SECRET_KEY_MX=sk_test
-
-STRIPE_PUBLISHABLE_KEY_AU=pk_test
-STRIPE_SECRET_KEY_AU=sk_test
-
-STRIPE_PUBLISHABLE_KEY_WECHAT=pk_test
-STRIPE_SECRET_KEY_WECHAT=sk_test
-
-# Required for webhook forwarding
-# See the README on how to do this with the Stripe CLI
-STRIPE_WEBHOOK_SECRET=whsec_

package/ios/StripeSdk.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<Workspace
-   version = "1.0">
-   <FileRef
-      location = "self:">
-   </FileRef>
-</Workspace>

package/ios/StripeSdk.xcodeproj/xcuserdata/wooj.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -1,19 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>SchemeUserState</key>
-	<dict>
-		<key>StripeSdk.xcscheme_^#shared#^_</key>
-		<dict>
-			<key>orderHint</key>
-			<integer>1</integer>
-		</dict>
-		<key>Tests.xcscheme_^#shared#^_</key>
-		<dict>
-			<key>orderHint</key>
-			<integer>0</integer>
-		</dict>
-	</dict>
-</dict>
-</plist>