From eda40a916168dd4c07aec7ee3f6ce26d9171176f Mon Sep 17 00:00:00 2001
From: Shivam <ss056989@gmail.com>
Date: Thu, 20 Nov 2025 14:43:22 +0530
Subject: [PATCH 1/2] feat: 3ds via authentication module ios

---
 example/metro.config.js                       |   2 +-
 example/package.json                          |   7 +
 example/src/App.tsx                           |  66 +++++-
 example/src/AuthenticationScreen.tsx          | 187 +++++++++++++++
 .../Hyperswitch3ds.podspec                    |  53 +++++
 .../android/build.gradle                      |  81 +++++++
 .../android/gradle.properties                 |   5 +
 .../android/src/main/AndroidManifest.xml      |   3 +
 .../android/src/main/AndroidManifestNew.xml   |   2 +
 .../hyperswitch3ds/Hyperswitch3dsModule.kt    |  25 ++
 .../hyperswitch3ds/Hyperswitch3dsPackage.kt   |  17 ++
 .../ios/Hyperswitch3ds-Bridging-Header.h      |   2 +
 .../ios/Hyperswitch3ds.mm                     |  30 +++
 .../ios/Hyperswitch3ds.swift                  | 219 ++++++++++++++++++
 .../ios/Hyperswitch3dsChallengeManager.swift  |  78 +++++++
 .../react-native-hyperswitch-3ds/package.json |  25 ++
 .../src/index.tsx                             |  88 +++++++
 yarn.lock                                     |  38 +++
 18 files changed, 926 insertions(+), 2 deletions(-)
 create mode 100644 example/src/AuthenticationScreen.tsx
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/Hyperswitch3ds.podspec
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/android/build.gradle
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/android/gradle.properties
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifest.xml
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifestNew.xml
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsModule.kt
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsPackage.kt
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds-Bridging-Header.h
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.mm
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3dsChallengeManager.swift
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/package.json
 create mode 100644 packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx

diff --git a/example/metro.config.js b/example/metro.config.js
index 0575308..2da198e 100644
--- a/example/metro.config.js
+++ b/example/metro.config.js
@@ -2,7 +2,7 @@ const path = require('path');
 const { getDefaultConfig } = require('@react-native/metro-config');
 const { withMetroConfig } = require('react-native-monorepo-config');
 
-const root = path.resolve(__dirname, '..', 'packages', '@juspay-tech', 'react-native-hyperswitch');
+const root = path.resolve(__dirname, '..');
 
 /**
  * Metro configuration
diff --git a/example/package.json b/example/package.json
index 9442e95..2b87172 100644
--- a/example/package.json
+++ b/example/package.json
@@ -12,6 +12,8 @@
     "adb": "adb reverse tcp:8081 tcp:8081"
   },
   "dependencies": {
+    "@juspay-tech/react-native-hyperswitch": "*",
+    "@juspay-tech/react-native-hyperswitch-3ds": "*",
     "@sentry/react-native": "^6.20.0",
     "react": "19.0.0",
     "react-native": "0.79.2",
@@ -36,5 +38,10 @@
     "react-native-builder-bob": "^0.40.8",
     "react-native-dotenv": "^3.4.11",
     "react-native-monorepo-config": "^0.1.9"
+  },
+  "hyperswitch": {
+    "ios": {
+      "authProvider": "trident"
+    }
   }
 }
diff --git a/example/src/App.tsx b/example/src/App.tsx
index 1ad09f0..8579d07 100644
--- a/example/src/App.tsx
+++ b/example/src/App.tsx
@@ -1,12 +1,76 @@
+import { useState } from 'react';
+import { View, StyleSheet, TouchableOpacity, Text } from 'react-native';
 import { HyperProvider } from '@juspay-tech/react-native-hyperswitch';
 import PaymentScreen from './PaymentScreen';
+import AuthenticationScreen from './AuthenticationScreen';
+
+type Screen = 'payment' | 'authentication';
 
 export default function App() {
+  const [activeScreen, setActiveScreen] = useState<Screen>('payment');
+
   return (
     <HyperProvider
       publishableKey={process.env.HYPERSWITCH_PUBLISHABLE_KEY || ''}
     >
-      <PaymentScreen />
+      <View style={styles.container}>
+        <View style={styles.tabBar}>
+          <TouchableOpacity
+            style={[styles.tab, activeScreen === 'payment' && styles.activeTab]}
+            onPress={() => setActiveScreen('payment')}
+          >
+            <Text style={[styles.tabText, activeScreen === 'payment' && styles.activeTabText]}>
+              Payment
+            </Text>
+          </TouchableOpacity>
+          <TouchableOpacity
+            style={[styles.tab, activeScreen === 'authentication' && styles.activeTab]}
+            onPress={() => setActiveScreen('authentication')}
+          >
+            <Text style={[styles.tabText, activeScreen === 'authentication' && styles.activeTabText]}>
+              Authentication
+            </Text>
+          </TouchableOpacity>
+        </View>
+        <View style={styles.content}>
+          {activeScreen === 'payment' ? <PaymentScreen /> : <AuthenticationScreen />}
+        </View>
+      </View>
     </HyperProvider>
   );
 }
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#fff',
+  },
+  tabBar: {
+    flexDirection: 'row',
+    backgroundColor: '#fff',
+    borderBottomWidth: 1,
+    borderBottomColor: '#e0e0e0',
+    paddingTop: 50,
+  },
+  tab: {
+    flex: 1,
+    paddingVertical: 15,
+    alignItems: 'center',
+    borderBottomWidth: 2,
+    borderBottomColor: 'transparent',
+  },
+  activeTab: {
+    borderBottomColor: '#007AFF',
+  },
+  tabText: {
+    fontSize: 16,
+    color: '#666',
+  },
+  activeTabText: {
+    color: '#007AFF',
+    fontWeight: '600',
+  },
+  content: {
+    flex: 1,
+  },
+});
diff --git a/example/src/AuthenticationScreen.tsx b/example/src/AuthenticationScreen.tsx
new file mode 100644
index 0000000..054a2f4
--- /dev/null
+++ b/example/src/AuthenticationScreen.tsx
@@ -0,0 +1,187 @@
+import {
+    isAvailable,
+    initializeThreeDS,
+    generateAReqParams,
+    recieveChallengeParamsFromRN,
+    generateChallenge,
+    threeDSProvider
+} from '@juspay-tech/react-native-hyperswitch-3ds';
+import { Text, View, StyleSheet, Button, ScrollView, Platform } from 'react-native';
+import { useState } from 'react';
+
+export default function AuthenticationScreen() {
+    const [threeDsResult, setThreeDsResult] = useState<string>('');
+    const [aReqResult, setAReqResult] = useState<string>('');
+    const [challengeParamsResult, setChallengeParamsResult] = useState<string>('');
+    const [challengeResult, setChallengeResult] = useState<string>('');
+
+    const handleInitThreeDs = () => {
+        try {
+            const configuration = {
+                provider: threeDSProvider.trident,
+                publishableKey: "pk_snd_test",
+            };
+
+            initializeThreeDS(configuration, 'sandbox', (status) => {
+                console.log('3DS Status:', status);
+                setThreeDsResult(`Status: ${status.status}\nMessage: ${status.message}`);
+            });
+        } catch (error) {
+            setThreeDsResult(`Error: ${error}`);
+            console.error('Failed to initialize 3DS session:', error);
+        }
+    };
+
+    const handleGenerateAReqParams = () => {
+        try {
+            const messageVersion = '2.1.0';
+            const directoryServerId = 'A0000001';
+            const cardBrand = 'visa';
+
+            generateAReqParams(
+                messageVersion,
+                (status, aReqParams) => {
+                    const result = `Status: ${status.status}\nMessage: ${status.message}\n\nAReq Params:\n${JSON.stringify(aReqParams, null, 2)}`;
+                    setAReqResult(result);
+                },
+                directoryServerId,
+                cardBrand
+            );
+        } catch (error) {
+            setAReqResult(`Error: ${error}`);
+        }
+    };
+
+    const handleReceiveChallengeParams = () => {
+        try {
+            const acsSignedContent = 'test_acs_signed_content';
+            const acsRefNumber = 'test_acs_ref_number';
+            const acsTransactionId = 'test_acs_transaction_id';
+            const threeDSRequestorAppURL = 'hyperswitch://challenge';
+            const threeDSServerTransId = 'test_server_trans_id';
+
+            recieveChallengeParamsFromRN(
+                acsSignedContent,
+                acsRefNumber,
+                acsTransactionId,
+                threeDSRequestorAppURL,
+                threeDSServerTransId,
+                (status) => {
+                    setChallengeParamsResult(`Status: ${status.status}\nMessage: ${status.message}`);
+                }
+            );
+        } catch (error) {
+            setChallengeParamsResult(`Error: ${error}`);
+        }
+    };
+
+    const handleGenerateChallenge = () => {
+        try {
+            generateChallenge((status) => {
+                setChallengeResult(`Status: ${status.status}\nMessage: ${status.message}`);
+            });
+        } catch (error) {
+            setChallengeResult(`Error: ${error}`);
+        }
+    };
+
+    return (
+        <ScrollView style={styles.container} contentContainerStyle={styles.contentContainer}>
+            <Text style={styles.headerText}>Hyperswitch Auth Module Test</Text>
+            <Text style={styles.infoText}>Module Available: {isAvailable ? '✓ Yes' : '✗ No'}</Text>
+
+            <View style={styles.section}>
+                <Text style={styles.sectionTitle}>1. Initialize 3DS Session</Text>
+                <Button
+                    title="Initialize 3DS"
+                    onPress={handleInitThreeDs}
+                />
+                {threeDsResult ? (
+                    <Text style={styles.resultText}>{threeDsResult}</Text>
+                ) : null}
+            </View>
+
+            <View style={styles.section}>
+                <Text style={styles.sectionTitle}>2. Generate AReq Params</Text>
+                <Button
+                    title="Generate AReq Params"
+                    onPress={handleGenerateAReqParams}
+                />
+                {aReqResult ? (
+                    <Text style={styles.resultText}>{aReqResult}</Text>
+                ) : null}
+            </View>
+
+            <View style={styles.section}>
+                <Text style={styles.sectionTitle}>3. Receive Challenge Params</Text>
+                <Button
+                    title="Receive Challenge Params"
+                    onPress={handleReceiveChallengeParams}
+                />
+                {challengeParamsResult ? (
+                    <Text style={styles.resultText}>{challengeParamsResult}</Text>
+                ) : null}
+            </View>
+
+            <View style={styles.section}>
+                <Text style={styles.sectionTitle}>4. Generate Challenge</Text>
+                <Button
+                    title="Generate Challenge"
+                    onPress={handleGenerateChallenge}
+                />
+                {challengeResult ? (
+                    <Text style={styles.resultText}>{challengeResult}</Text>
+                ) : null}
+            </View>
+        </ScrollView>
+    );
+}
+
+const styles = StyleSheet.create({
+    container: {
+        flex: 1,
+        backgroundColor: '#fff',
+    },
+    contentContainer: {
+        padding: 20,
+        paddingTop: 50,
+    },
+    headerText: {
+        fontSize: 24,
+        fontWeight: 'bold',
+        textAlign: 'center',
+        marginBottom: 10,
+        color: '#333',
+    },
+    infoText: {
+        fontSize: 16,
+        textAlign: 'center',
+        marginBottom: 20,
+        color: '#666',
+    },
+    section: {
+        marginBottom: 30,
+        padding: 15,
+        backgroundColor: '#f8f8f8',
+        borderRadius: 10,
+        borderWidth: 1,
+        borderColor: '#e0e0e0',
+    },
+    sectionTitle: {
+        fontSize: 16,
+        fontWeight: '600',
+        marginBottom: 10,
+        color: '#333',
+    },
+    resultText: {
+        marginTop: 10,
+        padding: 12,
+        backgroundColor: '#fff',
+        borderRadius: 5,
+        borderWidth: 1,
+        borderColor: '#ddd',
+        fontSize: 12,
+        fontFamily: Platform.select({ ios: 'Courier', android: 'monospace' }),
+        color: '#333',
+    },
+});
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/Hyperswitch3ds.podspec b/packages/@juspay-tech/react-native-hyperswitch-3ds/Hyperswitch3ds.podspec
new file mode 100644
index 0000000..5461bd5
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/Hyperswitch3ds.podspec
@@ -0,0 +1,53 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+# Read provider configuration from consumer app's package.json
+# Use CocoaPods installation_root to reliably find the project root
+provider = 'core'
+
+begin
+  # Get the project root (where Podfile is located) and go up one level to find package.json
+  project_root = Pod::Config.instance.installation_root
+  app_package_path = File.join(project_root, "..", "package.json")
+  
+  if File.exist?(app_package_path)
+    app_package = JSON.parse(File.read(app_package_path))
+    provider = app_package.dig('hyperswitch', 'ios', 'authProvider') || 'core'
+  end
+rescue => e
+  # Fallback to 'core' if there's any error reading the configuration
+  provider = 'core'
+end
+
+Pod::Spec.new do |s|
+  s.name         = "Hyperswitch3ds"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => ".git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  if provider == 'netcetera'
+    s.dependency "hyperswitch-sdk-ios-authentication/netcetera3ds"
+  elsif provider == 'trident'
+    s.dependency "hyperswitch-sdk-ios-authentication/trident"
+  elsif provider == 'cardinal'
+    s.dependency "hyperswitch-sdk-ios-authentication/cardinal"
+  else
+    s.dependency "hyperswitch-sdk-ios-authentication"
+  end
+
+# Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+# See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+if respond_to?(:install_modules_dependencies, true)
+  install_modules_dependencies(s)
+else
+  s.dependency "React-Core"
+end
+end
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/android/build.gradle b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/build.gradle
new file mode 100644
index 0000000..ad0a3c2
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/build.gradle
@@ -0,0 +1,81 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['Hyperswitch3ds_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Hyperswitch3ds_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.hyperswitch3ds"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+}
+
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/android/gradle.properties b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/gradle.properties
new file mode 100644
index 0000000..e69f78f
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/gradle.properties
@@ -0,0 +1,5 @@
+Hyperswitch3ds_kotlinVersion=2.0.21
+Hyperswitch3ds_minSdkVersion=24
+Hyperswitch3ds_targetSdkVersion=34
+Hyperswitch3ds_compileSdkVersion=35
+Hyperswitch3ds_ndkVersion=27.1.12297006
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifest.xml b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..4ef6aa4
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifest.xml
@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.hyperswitch3ds">
+</manifest>
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifestNew.xml b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifestNew.xml
new file mode 100644
index 0000000..a2f47b6
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/AndroidManifestNew.xml
@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsModule.kt b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsModule.kt
new file mode 100644
index 0000000..ba2ae6d
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsModule.kt
@@ -0,0 +1,25 @@
+package com.hyperswitch3ds
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.Promise
+
+class Hyperswitch3dsModule(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  // Example method
+  // See https://reactnative.dev/docs/native-modules-android
+  @ReactMethod
+  fun multiply(a: Double, b: Double, promise: Promise) {
+    promise.resolve(a * b)
+  }
+
+  companion object {
+    const val NAME = "Hyperswitch3ds"
+  }
+}
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsPackage.kt b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsPackage.kt
new file mode 100644
index 0000000..fbd687d
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/android/src/main/java/com/hyperswitch3ds/Hyperswitch3dsPackage.kt
@@ -0,0 +1,17 @@
+package com.hyperswitch3ds
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class Hyperswitch3dsPackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(Hyperswitch3dsModule(reactContext))
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return emptyList()
+  }
+}
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds-Bridging-Header.h b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds-Bridging-Header.h
new file mode 100644
index 0000000..dea7ff6
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds-Bridging-Header.h
@@ -0,0 +1,2 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTViewManager.h>
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.mm b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.mm
new file mode 100644
index 0000000..51fcdc8
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.mm
@@ -0,0 +1,30 @@
+#import <React/RCTBridgeModule.h>
+
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(Hyperswitch3ds, NSObject)
+
+RCT_EXTERN_METHOD(initializeThreeDS:(NSDictionary *)configuration
+                  :(NSString *)hsSDKEnvironment
+                  :(RCTResponseSenderBlock)callback)
+
+RCT_EXTERN_METHOD(generateAReqParams:(NSString *)messageVersion
+                  :(NSString *)directoryServerId
+                  :(NSString *)cardBrand
+                  :(RCTResponseSenderBlock)callback)
+
+RCT_EXTERN_METHOD(recieveChallengeParamsFromRN:(NSString *)acsSignedContent
+                  :(NSString *)acsRefNumber
+                  :(NSString *)acsTransactionId
+                  :(NSString *)threeDSRequestorAppURL
+                  :(NSString *)threeDSServerTransId
+                  :(RCTResponseSenderBlock)callback)
+
+RCT_EXTERN_METHOD(generateChallenge:(RCTResponseSenderBlock)callback)
+
++ (BOOL)requiresMainQueueSetup
+{
+    return NO;
+}
+
+@end
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift
new file mode 100644
index 0000000..4f38d98
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift
@@ -0,0 +1,219 @@
+//
+//  Hyperswitch3ds.swift
+//  
+//
+//  Created by Shivam Nan on 12/11/25.
+//
+
+import HyperswitchAuthentication
+
+@objc(Hyperswitch3ds)
+class Hyperswitch3ds: NSObject {
+    private var authSession: AuthenticationSession?
+    private var threeDSSession: ThreeDSSession?
+    private var authConfiguration: AuthenticationConfiguration?
+    private var transaction: Transaction?
+    private var viewController: UIViewController?
+    private var challengeParameters: ChallengeParameters?
+    private let challengeStatusReceiver = Hyperswitch3dsChallengeManager()
+    
+    @objc
+    func initializeThreeDS(
+        _ configuration: NSDictionary,
+        _ hsSDKEnvironment: String,
+        _ callback: @escaping RCTResponseSenderBlock) {
+            
+            guard let _publishableKey = configuration["publishableKey"] as? String else {
+                let initStatus: [String:Any] = [
+                    "status": "failure",
+                    "message": "sdk initialization failed: Publishable key missing"
+                ]
+                callback([initStatus])
+                return
+            }
+            
+            self.authSession = AuthenticationSession(
+                publishableKey: _publishableKey
+            )
+            
+            let _provider: ThreeDSProviderType? = switch configuration["provider"] as? String {
+            case "cardinal":
+                    .cardinal
+            case "netcetera":
+                    .netcetera
+            case "trident":
+                    .trident
+            default:
+                nil
+            }
+            
+            let _apiKey: String? = switch _provider {
+            case .cardinal:
+                configuration["jwtToken"] as? String
+            case .netcetera:
+                configuration["netceteraSdkApiKey"] as? String
+            default:
+                nil
+            }
+            
+            let _env: EnvironmentType = switch hsSDKEnvironment.uppercased() {
+            case "SANDBOX", "INTEG":
+                    .sandbox
+            case "PROD":
+                    .production
+            default:
+                    .production
+            }
+            
+            self.authConfiguration = AuthenticationConfiguration(
+                apiKey: _apiKey,
+                preferredProvider: _provider,
+                environment: _env
+            )
+            
+            let clientSecret = configuration["authIntentClientSecret"] as? String ?? "client_secret_placeholder"
+            
+            Task {
+                do {
+                    self.threeDSSession = try await authSession?.initThreeDSSession(
+                        authIntentClientSecret: clientSecret,
+                        configuration: self.authConfiguration
+                    )
+                    
+                    await MainActor.run {
+                        let initStatus: [String:Any] = [
+                            "status": "success",
+                            "message": "sdk initialization successful"
+                        ]
+                        callback([initStatus])
+                    }
+                } catch {
+                    await MainActor.run {
+                        let initStatus: [String:Any] = [
+                            "status": "failure",
+                            "message": "sdk initialization failed: \(error.localizedDescription)"
+                        ]
+                        callback([initStatus])
+                    }
+                }
+            }
+        }
+    
+    @objc
+    func generateAReqParams(
+        _ messageVersion: String,
+        _ directoryServerId: String?,
+        _ cardBrand: String?,
+        _ callback: @escaping RCTResponseSenderBlock
+    ) {
+        Task {
+            do {
+                guard let threeDSSession = threeDSSession else {
+                    await MainActor.run {
+                        let response: [String: Any] = [
+                            "status": "error",
+                            "message": "ThreeDS session not initialized"
+                        ]
+                        callback([response])
+                    }
+                    return
+                }
+                
+                let _transaction = try await threeDSSession.createTransaction(
+                    messageVersion: messageVersion,
+                    directoryServerId: directoryServerId,
+                    cardNetwork: cardBrand
+                )
+                self.transaction = _transaction
+                
+                let _aReqParams = try await _transaction.getAuthenticationRequestParameters()
+                
+                await MainActor.run {
+                    let authReqMap: [String: String] = [
+                        "deviceData": _aReqParams.deviceData ?? "",
+                        "messageVersion": _aReqParams.messageVersion ?? "",
+                        "sdkTransId": _aReqParams.sdkTransactionID ?? "",
+                        "sdkAppId": _aReqParams.sdkAppID ?? "",
+                        "sdkEphemeralKey": _aReqParams.sdkEphemeralPublicKey ?? "",
+                        "sdkReferenceNo": _aReqParams.sdkReferenceNumber ?? ""
+                    ]
+                    
+                    let response: [String: Any] = [
+                        "status": "success",
+                        "message": "AReq Params generation successful"
+                    ]
+                    callback([response, authReqMap])
+                }
+            } catch {
+                await MainActor.run {
+                    let response: [String: Any] = [
+                        "status": "error",
+                        "message": "AReq Params generation failure. Error: \(error.localizedDescription)"
+                    ]
+                    callback([response])
+                }
+            }
+        }
+    }
+    
+    @objc
+    func recieveChallengeParamsFromRN(
+        _ acsSignedContent: String,
+        _ acsRefNumber: String,
+        _ acsTransactionId: String,
+        _ threeDSRequestorAppURL: String?,
+        _ threeDSServerTransId: String,
+        _ callback: @escaping RCTResponseSenderBlock
+    ) {
+        let _challengeParameters = ChallengeParameters(
+            threeDSServerTransactionID: threeDSServerTransId,
+            acsTransactionID: acsTransactionId,
+            acsRefNumber: acsRefNumber,
+            acsSignedContent: acsSignedContent,
+            threeDSRequestorAppURL: threeDSRequestorAppURL
+        )
+        self.challengeParameters = _challengeParameters
+        
+        let response: [String: Any] = [
+            "status": "success",
+            "message": "challenge params receive successful"
+        ]
+        callback([response])
+    }
+    
+    @objc
+    func generateChallenge(
+        _ callback: @escaping RCTResponseSenderBlock
+    ) {
+        self.viewController = RCTPresentedViewController()
+        
+        guard let challengeParams = self.challengeParameters,
+              let transaction = self.transaction,
+              let vc = self.viewController
+        else {
+            let map: [String: String] = [
+                "status": "error",
+                "message": "doChallenge call unsuccessful - missing parameters or transaction"
+            ]
+            callback([map])
+            return
+        }
+        
+        self.challengeStatusReceiver.setPostHSChallengeCallback(transaction, callback)
+        
+        do {
+            try transaction.doChallenge(
+                viewController: vc,
+                challengeParameters: challengeParams,
+                challengeStatusReceiver: self.challengeStatusReceiver,
+                timeOut: 5
+            )
+        } catch {
+            let map: [String: String] = [
+                "status": "error",
+                "message": "Failed to start challenge: \(error.localizedDescription)"
+            ]
+            callback([map])
+        }
+    }
+}
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3dsChallengeManager.swift b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3dsChallengeManager.swift
new file mode 100644
index 0000000..7c01ac8
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3dsChallengeManager.swift
@@ -0,0 +1,78 @@
+//
+//  Hyperswitch3dsChallengeManager.swift
+//  
+//
+//  Created by Shivam Nan on 12/11/25.
+//
+
+import Foundation
+import HyperswitchAuthentication
+
+class Hyperswitch3dsChallengeManager: ChallengeStatusReceiver {
+    var postChallengeCallback: RCTResponseSenderBlock?
+    private var transactionRef: Transaction?
+    
+    func setPostHSChallengeCallback(_ transactionRef: Transaction, _ callback: @escaping RCTResponseSenderBlock) {
+        self.transactionRef = transactionRef
+        self.postChallengeCallback = callback
+    }
+    
+    func completed(_ completionEvent: CompletionEvent) {
+        // Handle successful or unsuccessful completion of challenge flow
+        let map: [String: Any] = [
+            "status" : "success",
+            "message" : "challenge completed successfully"
+        ]
+        postChallengeCallback?([map]);
+        transactionRef?.close()
+    }
+    
+    func cancelled() {
+        // Handle challenge canceled by the user
+        let map: [String: Any] = [
+            "status": "error",
+            "message": "challenge cancelled by user"
+        ]
+        postChallengeCallback?([map]);
+        transactionRef?.close()
+    }
+    
+    func timedout() {
+        // Handle challenge timeout
+        let map: [String: Any] = [
+            "status": "error",
+            "message": "challenge timeout"
+        ]
+        postChallengeCallback?([map]);
+        transactionRef?.close()
+    }
+    
+    func protocolError(_ protocolErrorEvent: ProtocolErrorEvent) {
+        // Handle protocol error that has been sent by the ACS
+        let errorMessage = protocolErrorEvent.getErrorMessage()
+        let map: [String: Any] = [
+            "status": "error",
+            "message": errorMessage
+        ]
+        postChallengeCallback?([map]);
+        transactionRef?.close()
+    }
+    
+    func runtimeError(_ runtimeErrorEvent: RuntimeErrorEvent) {
+        // Handle error that has occurred in the SDK at runtime
+        var message: String = "";
+        message.append("Description: \(runtimeErrorEvent.getErrorMessage())\n")
+        
+        if let errorCode = runtimeErrorEvent.getErrorCode() {
+            message.append("Error code: \(errorCode)\n")
+        }
+        
+        let map: [String: Any] = [
+            "status": "error",
+            "message": message
+        ]
+        postChallengeCallback?([map]);
+        transactionRef?.close()
+    }
+}
+
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/package.json b/packages/@juspay-tech/react-native-hyperswitch-3ds/package.json
new file mode 100644
index 0000000..7bdd365
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/package.json
@@ -0,0 +1,25 @@
+{
+  "name": "@juspay-tech/react-native-hyperswitch-3ds",
+  "version": "0.0.0",
+  "description": "react-native wrapper for three ds via authentication module",
+  "main": "src/index",
+  "author": "Hyperswitch",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/juspay/react-native-hyperswitch-libraries/tree/main/packages/react-native-hyperswitch-3ds#readme",
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-native": "0.72.8",
+    "react": "19.0.0",
+    "react-native": "0.78.2",
+    "typescript": "^5.9.2"
+  },
+  "create-react-native-library": {
+    "type": "legacy-module",
+    "languages": "kotlin-swift",
+    "version": "0.49.8"
+  }
+}
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx b/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx
new file mode 100644
index 0000000..72306ad
--- /dev/null
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx
@@ -0,0 +1,88 @@
+import { NativeModules } from 'react-native';
+
+const Hyperswitch3ds = NativeModules.Hyperswitch3ds || null
+const isAvailable = Hyperswitch3ds && Hyperswitch3ds.initializeThreeDS;
+
+export enum threeDSProvider {
+  netcetera = 'netcetera',
+  trident = 'trident',
+  cardinal = 'cardinal',
+};
+
+type Configuration = {
+  publishableKey: string;
+  authIntentClientSecret?: string, 
+  provider?: threeDSProvider;
+  jwtToken?: string;
+  netceteraSdkApiKey?: string;
+}
+
+function initializeThreeDS(
+  configuration: Configuration,
+  hsSDKEnvironment: string,
+  callback: (status: statusType) => void
+) {
+  return Hyperswitch3ds.initializeThreeDS(
+    configuration,
+    hsSDKEnvironment,
+    callback
+  );
+}
+
+function generateAReqParams(
+  messageVersion: string,
+  callback: (status: statusType, aReqParams: AReqParams) => void,
+  directoryServerId?: string,
+  cardBrand?: string,
+) {
+  return Hyperswitch3ds.generateAReqParams(
+    messageVersion,
+    directoryServerId,
+    cardBrand,
+    callback
+  );
+}
+
+function recieveChallengeParamsFromRN(
+  acsSignedContent: string,
+  acsRefNumber: string,
+  acsTransactionId: string,
+  threeDSRequestorAppURL: string | undefined,
+  threeDSServerTransId: string,
+  callback: (status: statusType) => void
+) {
+  return Hyperswitch3ds.recieveChallengeParamsFromRN(
+    acsSignedContent,
+    acsRefNumber,
+    acsTransactionId,
+    threeDSRequestorAppURL,
+    threeDSServerTransId,
+    callback
+  );
+}
+
+function generateChallenge(callback: (status: statusType) => void) {
+  return Hyperswitch3ds.generateChallenge(callback);
+}
+
+export type statusType = {
+  status: string;
+  message: string;
+};
+
+export type AReqParams = {
+  deviceData?: string;
+  messageVersion?: string;
+  sdkTransId?: string;
+  sdkAppId?: string;
+  sdkEphemeralKey?: any;
+  sdkReferenceNo?: string;
+};
+
+export {
+  isAvailable,
+  initializeThreeDS,
+  generateAReqParams,
+  recieveChallengeParamsFromRN,
+  generateChallenge,
+};
diff --git a/yarn.lock b/yarn.lock
index 5fbbaf7..78933ba 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -3224,6 +3224,21 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@juspay-tech/react-native-hyperswitch-3ds@*, @juspay-tech/react-native-hyperswitch-3ds@workspace:packages/@juspay-tech/react-native-hyperswitch-3ds":
+  version: 0.0.0-use.local
+  resolution: "@juspay-tech/react-native-hyperswitch-3ds@workspace:packages/@juspay-tech/react-native-hyperswitch-3ds"
+  dependencies:
+    "@types/react": ^19.0.0
+    "@types/react-native": 0.72.8
+    react: 19.0.0
+    react-native: 0.78.2
+    typescript: ^5.9.2
+  peerDependencies:
+    react: "*"
+    react-native: "*"
+  languageName: unknown
+  linkType: soft
+
 "@juspay-tech/react-native-hyperswitch-click-to-pay@workspace:packages/@juspay-tech/react-native-hyperswitch-click-to-pay":
   version: 0.0.0-use.local
   resolution: "@juspay-tech/react-native-hyperswitch-click-to-pay@workspace:packages/@juspay-tech/react-native-hyperswitch-click-to-pay"
@@ -5585,6 +5600,18 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@react-native/virtualized-lists@npm:^0.72.4":
+  version: 0.72.8
+  resolution: "@react-native/virtualized-lists@npm:0.72.8"
+  dependencies:
+    invariant: ^2.2.4
+    nullthrows: ^1.1.1
+  peerDependencies:
+    react-native: "*"
+  checksum: ad9628a04e72420326fd5ef09c746ad9cd6cff745b73850c7297429e3c42927043d1310896a72aa94497dc6b7f1abc2be1081b465734f7673f0e7d36aaae5e53
+  languageName: node
+  linkType: hard
+
 "@release-it/conventional-changelog@npm:^10.0.1":
   version: 10.0.1
   resolution: "@release-it/conventional-changelog@npm:10.0.1"
@@ -6488,6 +6515,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/react-native@npm:0.72.8":
+  version: 0.72.8
+  resolution: "@types/react-native@npm:0.72.8"
+  dependencies:
+    "@react-native/virtualized-lists": ^0.72.4
+    "@types/react": "*"
+  checksum: a9fdf0a11ed42f800eb646d038702d3652d0732aa017ecd8203fb2aee77a782fa7ef388433e5cfcb6ab658a1642e1286698fecedcbc379547e4aeefa681ed685
+  languageName: node
+  linkType: hard
+
 "@types/react@npm:*, @types/react@npm:^19.0.0, @types/react@npm:^19.1.0, @types/react@npm:^19.1.11":
   version: 19.2.2
   resolution: "@types/react@npm:19.2.2"
@@ -18972,6 +19009,7 @@ __metadata:
     "@babel/core": ^7.25.2
     "@babel/preset-env": ^7.25.3
     "@babel/runtime": ^7.25.0
+    "@juspay-tech/react-native-hyperswitch-3ds": "*"
     "@react-native-community/cli": 18.0.0
     "@react-native-community/cli-platform-android": 18.0.0
     "@react-native-community/cli-platform-ios": 18.0.0

From d8311c72de9e0555a466ecb11fd3e34f3496727a Mon Sep 17 00:00:00 2001
From: Shivam <ss056989@gmail.com>
Date: Wed, 10 Dec 2025 13:52:34 +0530
Subject: [PATCH 2/2] fix: threeDS config object type and structure

---
 .../ios/Hyperswitch3ds.swift                          | 11 ++---------
 .../react-native-hyperswitch-3ds/src/index.tsx        |  5 ++---
 2 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift
index 4f38d98..af4201a 100644
--- a/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/ios/Hyperswitch3ds.swift
@@ -36,7 +36,7 @@ class Hyperswitch3ds: NSObject {
                 publishableKey: _publishableKey
             )
             
-            let _provider: ThreeDSProviderType? = switch configuration["provider"] as? String {
+            let _provider: ThreeDSProviderType? = switch configuration["threeDSProvider"] as? String {
             case "cardinal":
                     .cardinal
             case "netcetera":
@@ -47,14 +47,7 @@ class Hyperswitch3ds: NSObject {
                 nil
             }
             
-            let _apiKey: String? = switch _provider {
-            case .cardinal:
-                configuration["jwtToken"] as? String
-            case .netcetera:
-                configuration["netceteraSdkApiKey"] as? String
-            default:
-                nil
-            }
+            let _apiKey: String? = configuration["threeDSProviderApiKey"] as? String
             
             let _env: EnvironmentType = switch hsSDKEnvironment.uppercased() {
             case "SANDBOX", "INTEG":
diff --git a/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx b/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx
index 72306ad..f88ff04 100644
--- a/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx
+++ b/packages/@juspay-tech/react-native-hyperswitch-3ds/src/index.tsx
@@ -12,9 +12,8 @@ export enum threeDSProvider {
 type Configuration = {
   publishableKey: string;
   authIntentClientSecret?: string, 
-  provider?: threeDSProvider;
-  jwtToken?: string;
-  netceteraSdkApiKey?: string;
+  threeDSProvider?: threeDSProvider;
+  threeDSProviderApiKey?: string;
 }
 
 function initializeThreeDS(