🐛 Bug: Enum type mismatch causes build failure on Xcode 26+

[shubhanshubb]

StripeSwiftInterop.h forward-declares STPPaymentStatus using NSUInteger (unsigned), while the actual definition in StripePayments is:

@objc public enum STPPaymentStatus: Int

This maps to NSInteger (signed).

With Xcode 26+, this mismatch is now treated as a hard compile-time error, whereas older Xcode versions only raised a warning.

To Reproduce
Create a React Native project
Install:
@stripe/stripe-react-native@0.59.2 (also reproducible on 0.60.0)

Enable:

use_frameworks! :linkage => :static

Run:

pod install
Build the project in Xcode 26.4
Actual Result

Build fails with:

stripe_react_native-Swift.h:690: error:
enumeration redeclared with different underlying type
'NSInteger' (aka 'long') (was 'NSUInteger' (aka 'unsigned long'))
Expected Result

The project should compile successfully without enum type conflicts.

Root Cause

Mismatch between:

// StripeSwiftInterop.h (incorrect)
typedef NS_ENUM(NSUInteger, STPPaymentStatus);

and actual Swift enum:

@objc public enum STPPaymentStatus: Int
Proposed Fix

Update the forward declaration in:

ios/StripeSwiftInterop.h

• typedef NS_ENUM(NSUInteger, STPPaymentStatus);

• typedef NS_ENUM(NSInteger, STPPaymentStatus);
  Environment
  macOS: 26.4 (Darwin 25.4.0)
  Xcode: 26.4 (17E192)
  CocoaPods: 1.16.2
  Ruby: 4.0.1
  React Native Stripe: 0.59.2 / 0.60.0
  Additional Context
  This issue appears only on Xcode 26+
  Likely due to stricter compiler enforcement of enum ABI compatibility
  Affects projects using use_frameworks! :linkage => :static

[JayantSharma17]

I’m encountering the same issue. I found a workaround that involves applying a patch, but I’d prefer not to modify the library source. Is there an official or proper solution for this?

[alexferrermano]

Same issue, had to patch the same line

[shubhanshubb]

✅ Best Fix (No manual edits every time)

Instead of changing node_modules manually, patch it via Podfile post_install so it survives pod install + CI.

🔧 Add this to your Podfile (inside post_install)

`# 🔥 Stripe fix for Xcode 26+
file_path = 'node_modules/@stripe/stripe-react-native/ios/StripeSwiftInterop.h'

if File.exist?(file_path)
text = File.read(file_path)
new_text = text.gsub(
'typedef NS_ENUM(NSUInteger, STPPaymentStatus);',
'typedef NS_ENUM(NSInteger, STPPaymentStatus);'
)
File.open(file_path, 'w') { |file| file.puts new_text }
puts "✅ Patched StripeSwiftInterop.h for Xcode 26 compatibility"
end`

[porter-stripe]

Hi all, thanks for reporting this, we have a fix merged that will be in the next release.

[hqasmei]

Do you know when that will merged in? Running into the same issue

[kasim-rangwala-openxcell]

@shubhanshubb #2357 (comment)

Here is the note:

I have to add navigate up .. in the file_path in order to work.
file_path = './../node_modules/@stripe/stripe-react-native/ios/StripeSwiftInterop.h'

Thanks for reporting this 👍

[porter-stripe]

Now fixed in https://github.com/stripe/stripe-react-native/releases/tag/v0.61.0