@jimrising/easymerchantsdk-react-native 2.3.9 → 2.4.0

package/README.md

@@ -19,7 +19,7 @@ Add the EasyMerchant SDK to your `package.json` under `dependencies`:
 
 ```json
 "dependencies": {
-  "@jimrising/easymerchantsdk-react-native": "^2.3.9"
+  "@jimrising/easymerchantsdk-react-native": "^2.4.0"
 }
 ```
 
@@ -61,7 +61,11 @@ GITHUB_PASSWORD=your-github-token
 
 ### 3. iOS Configuration
 
-1. **Update AppDelegate.swift**
+1. **Update AppDelegate**
+
+You can configure the `AppDelegate` file in either Swift or Objective-C, depending on your project setup. Below are examples for both.
+
+##### Option 1: Swift (`AppDelegate.swift`)
 
 Modify `ios/AppDelegate.swift` to initialize the React Native bridge and set up the EasyMerchant SDK:
 
@@ -72,50 +76,117 @@ import React
 
 @UIApplicationMain
 class AppDelegate: UIResponder, UIApplicationDelegate {
-  var window: UIWindow?
-
-  func application(
-    _ application: UIApplication,
-    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
-  ) -> Bool {
-    let jsCodeLocation: URL
-
-    #if DEBUG
-      jsCodeLocation = URL(string: "http://localhost:8081/index.bundle?platform=ios")!
-    #else
-      jsCodeLocation = Bundle.main.url(forResource: "main", withExtension: "jsbundle")!
-    #endif
-
-    let bridge = RCTBridge(
-      bundleURL: jsCodeLocation,
-      moduleProvider: nil,
-      launchOptions: launchOptions
-    )
-
-    guard let validBridge = bridge else {
-      fatalError("React Native bridge failed to initialize.")
+    var window: UIWindow?
+
+    func application(
+        _ application: UIApplication,
+        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
+    ) -> Bool {
+        let jsCodeLocation: URL
+
+        #if DEBUG
+        jsCodeLocation = URL(string: "http://localhost:8081/index.bundle?platform=ios")!
+        #else
+        jsCodeLocation = Bundle.main.url(forResource: "main", withExtension: "jsbundle")!
+        #endif
+
+        let bridge = RCTBridge(
+            bundleURL: jsCodeLocation,
+            moduleProvider: nil,
+            launchOptions: launchOptions
+        )
+
+        guard let validBridge = bridge else {
+            fatalError("React Native bridge failed to initialize.")
+        }
+
+        let rootView = RCTRootView(
+            bridge: validBridge,
+            moduleName: "EasyMerchantTestApp", // Replace with your app name
+            initialProperties: nil
+        )
+
+        self.window = UIWindow(frame: UIScreen.main.bounds)
+        let rootViewController = UIViewController()
+        rootViewController.view = rootView
+        self.window?.rootViewController = rootViewController
+        self.window?.makeKeyAndVisible()
+
+        if let easyMerchantSdkPlugin = bridge?.module(for: EasyMerchantSdkPlugin.self) as? EasyMerchantSdkPlugin {
+            easyMerchantSdkPlugin.setViewController(rootViewController)
+        } else {
+            print("Failed to retrieve EasyMerchantSdkPlugin instance from React Native bridge.")
+        }
+        return true
+    }
+    
+    // MARK: - Deep Link Handling for GrailPay
+    
+    func application(
+        _ app: UIApplication,
+        open url: URL,
+        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
+    ) -> Bool {
+        print("🔗 Deep link received: \(url)")
+        
+        if url.scheme == "grailpay" && url.host == "callback" {
+            print("✅ GrailPay callback detected")
+            GrailPayHelper.handleDeepLinkCallback(url: url)
+            return true
+        }
+        
+        return false
     }
+}
+```
 
-    let rootView = RCTRootView(
-      bridge: validBridge,
-      moduleName: "EasyMerchantTestApp", // Replace with your app's module name
-      initialProperties: nil
-    )
+##### Option 2: Objective-C (`AppDelegate.mm`)
 
-    self.window = UIWindow(frame: UIScreen.main.bounds)
-    let rootViewController = UIViewController()
-    rootViewController.view = rootView
-    self.window?.rootViewController = rootViewController
-    self.window?.makeKeyAndVisible()
+For projects using Objective-C, modify `ios/AppDelegate.mm` to initialize the React Native bridge and handle GrailPay deep links:
 
-    if let easyMerchantSdkPlugin = validBridge.module(for: EasyMerchantSdkPlugin.self) as? EasyMerchantSdkPlugin {
-      easyMerchantSdkPlugin.setViewController(rootViewController)
-    } else {
-      print("Failed to retrieve EasyMerchantSdkPlugin instance from React Native bridge.")
-    }
-    return true
-  }
+```objc
+#import "AppDelegate.h"
+#import <React/RCTBundleURLProvider.h>
+#import <easymerchantsdk/EasyMerchantSdk.h>
+
+@implementation AppDelegate
+
+- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+    self.moduleName = @"SampleApp"; // Replace with your app name
+    // You can add your custom initial props in the dictionary below.
+    // They will be passed down to the ViewController used by React Native.
+    self.initialProps = @{};
+
+    return [super application:application didFinishLaunchingWithOptions:launchOptions];
+}
+
+- (NSURL *)sourceURLForBridge:(RCTBridge *)bridge
+{
+    return [self bundleURL];
+}
+
+- (NSURL *)bundleURL
+{
+#if DEBUG
+    return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index"];
+#else
+    return [[NSBundle mainBundle] URLForResource:@"main" withExtension:"jsbundle"];
+#endif
 }
+
+// MARK: - Deep Link Handling for GrailPay
+// Forward deep links to the SDK for handling
+
+- (BOOL)application:(UIApplication *)app
+            openURL:(NSURL *)url
+            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
+{
+    // Let the SDK handle GrailPay deep links
+    return [EasyMerchantSdk handleDeepLink:url];
+}
+
+@end
 ```
 
 2. **Update Podfile**

package/android/build/generated/source/buildConfig/debug/com/reactlibrary/BuildConfig.java

@@ -0,0 +1,10 @@
+/**
+ * Automatically generated file. DO NOT MODIFY
+ */
+package com.reactlibrary;
+
+public final class BuildConfig {
+  public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "com.reactlibrary";
+  public static final String BUILD_TYPE = "debug";
+}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.reactlibrary" >
+
+    <uses-sdk android:minSdkVersion="16" />
+
+</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/output-metadata.json

@@ -0,0 +1,18 @@
+{
+  "version": 3,
+  "artifactType": {
+    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
+    "kind": "Directory"
+  },
+  "applicationId": "com.reactlibrary",
+  "variantName": "debug",
+  "elements": [
+    {
+      "type": "SINGLE",
+      "filters": [],
+      "attributes": [],
+      "outputFile": "AndroidManifest.xml"
+    }
+  ],
+  "elementType": "File"
+}

package/android/build/intermediates/aar_metadata/debug/writeDebugAarMetadata/aar-metadata.properties

@@ -0,0 +1,6 @@
+aarFormatVersion=1.0
+aarMetadataVersion=1.0
+minCompileSdk=1
+minCompileSdkExtension=0
+minAndroidGradlePluginVersion=1.0.0
+coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/javaPreCompileDebug/annotationProcessors.json

@@ -0,0 +1 @@
+{}

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -0,0 +1 @@
+#Wed Oct 01 10:15:45 IST 2025

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~:!&lt;dir>navigation"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~:!&lt;dir>navigation"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/build/generated/res/resValues/debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~:!&lt;dir>navigation"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/incremental/mergeDebugAssets/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/assets"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/debug/assets"/></dataSet><dataSet config="generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/build/intermediates/shader_assets/debug/compileDebugShaders/out"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugJniLibFolders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/jniLibs"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/debug/jniLibs"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/debug/shaders"/></dataSet></merger>

package/android/build/intermediates/local_only_symbol_list/debug/parseDebugLocalResources/R-def.txt

@@ -0,0 +1,2 @@
+R_DEF: Internal format may change without notice
+local

package/android/build/intermediates/manifest_merge_blame_file/debug/processDebugManifest/manifest-merger-blame-debug-report.txt

@@ -0,0 +1,7 @@
+1<?xml version="1.0" encoding="utf-8"?>
+2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+3    package="com.reactlibrary" >
+4
+5    <uses-sdk android:minSdkVersion="16" />
+6
+7</manifest>

package/android/build/intermediates/merged_manifest/debug/processDebugManifest/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.reactlibrary" >
+
+    <uses-sdk android:minSdkVersion="16" />
+
+</manifest>

package/android/build/intermediates/navigation_json/debug/extractDeepLinksDebug/navigation.json

@@ -0,0 +1 @@
+[]

package/android/build/intermediates/nested_resources_validation_report/debug/generateDebugResources/nestedResourcesValidationReport.txt

@@ -0,0 +1 @@
+0 Warning/Error

package/android/build/intermediates/symbol_list_with_package_name/debug/generateDebugRFile/package-aware-r.txt

@@ -0,0 +1 @@
+com.reactlibrary

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -0,0 +1,16 @@
+-- Merging decision tree log ---
+manifest
+ADDED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml:1:1-2:12
+INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml:1:1-2:12
+	package
+		INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml
+	xmlns:android
+		ADDED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml:1:11-69
+uses-sdk
+INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml reason: use-sdk injection requested
+INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml
+INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml
+	android:targetSdkVersion
+		INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml
+	android:minSdkVersion
+		INJECTED from /Users/appdev/Documents/GitHub/lyfecycle-sample-RN-sdk/node_modules/@jimrising/easymerchantsdk-react-native/android/src/main/AndroidManifest.xml

package/android/build.gradle

@@ -65,7 +65,7 @@ repositories {
         url = uri("https://maven.pkg.github.com/EasyMerchant/em-MobileCheckoutSDK-Android")
         credentials {
             username = "EasyMerchant"
-            password = "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"
+            password = "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"
         }
     }
 }
@@ -88,7 +88,8 @@ dependencies {
     implementation 'com.google.android.material:material:1.13.0'
 
     // Third-party libs
-    implementation 'com.app:paysdk:1.6.3.4'
+    implementation 'com.app:paysdk:1.6.3.5'
+    implementation 'androidx.browser:browser:1.8.0'
     implementation 'com.hbb20:ccp:2.7.3'
     implementation 'com.github.bumptech.glide:glide:5.0.4'
     implementation 'com.github.androidmads:QRGenerator:1.0.5'

package/ios/Classes/EasyMerchantSdk.h

@@ -1,4 +1,8 @@
 #import <React/RCTBridgeModule.h>
 
 @interface EasyMerchantSdk : NSObject <RCTBridgeModule>
+
+// Deep link handling for GrailPay
++ (BOOL)handleDeepLink:(NSURL *)url;
+
 @end

package/ios/Classes/EasyMerchantSdk.m

@@ -164,4 +164,10 @@ RCT_EXPORT_METHOD(getPlatformVersion:(RCTPromiseResolveBlock)resolve
   return base;
 }
 
+// MARK: - Deep Link Handling
+
++ (BOOL)handleDeepLink:(NSURL *)url {
+  return [EasyMerchantSdkPlugin handleDeepLinkWithUrl:url];
+}
+
 @end

package/ios/Classes/EasyMerchantSdk.swift

@@ -143,6 +143,20 @@ public class EasyMerchantSdkPlugin: NSObject, RCTBridgeModule {
         resolve("iOS \(UIDevice.current.systemVersion)")
     }
     
+    // MARK: - Deep Link Handling for GrailPay
+    
+    @objc public static func handleDeepLink(url: URL) -> Bool {
+        print("🔗 SDK: Deep link received: \(url)")
+        
+        if url.scheme == "grailpay" && url.host == "callback" {
+            print("✅ SDK: GrailPay callback detected")
+            GrailPayHelper.handleDeepLinkCallback(url: url)
+            return true
+        }
+        
+        return false
+    }
+    
     // MARK: - Helpers
     
     private func getTopViewController() -> UIViewController? {

package/ios/Helper/GrailPayHelper.swift

@@ -5,15 +5,176 @@
 //  Created by Mony's Mac on 02/05/25.
 //
 
-public class GrailPayHelper {
+import SafariServices
+
+@objc public class GrailPayHelper: NSObject {
+    
+    private static var safariViewController: SFSafariViewController?
+    private static var completionHandler: ((SDKResult) -> Void)?
+    private static var presentingViewController: UIViewController?
+    
     public static func presentGrailPay(
         from viewController: UIViewController,
         request: GrailPayRequest,
         completion: @escaping (SDKResult) -> Void
     ) {
-        let grailPayVC = GrailPayVC(request: request)
-        grailPayVC.onCompletion = completion
-        grailPayVC.modalPresentationStyle = .fullScreen
-        viewController.present(grailPayVC, animated: true)
+        // Store references
+        completionHandler = completion
+        presentingViewController = viewController
+        
+        // Launch Safari directly (like Android Chrome Custom Tabs)
+        launchSafariDirectly(from: viewController, request: request, completion: completion)
+    }
+    
+    private static func launchSafariDirectly(
+        from viewController: UIViewController,
+        request: GrailPayRequest,
+        completion: @escaping (SDKResult) -> Void
+    ) {
+        print("🚀 Loading GrailPay with Safari (direct launch, no intermediate VC)")
+        
+        // Build configuration JSON
+        let configDict: [String: Any] = [
+            "token": UserStoreSingleton.shared.bankWidgetKey ?? "",
+            "vendorId": UserStoreSingleton.shared.vendorID ?? "",
+            "role": request.role,
+            "timeout": request.timeout * 1000, // Convert to milliseconds
+            "brandingName": request.brandingName,
+            "finderSubtitle": request.finderSubtitle,
+            "searchPlaceholder": request.searchPlaceholder,
+            "isSandbox": EnvironmentConfig.grailPaySDKURL.contains("sandbox")
+        ]
+        
+        // Encode configuration to Base64
+        guard let jsonData = try? JSONSerialization.data(withJSONObject: configDict, options: []),
+              let jsonString = String(data: jsonData, encoding: .utf8),
+              let base64Config = jsonString.data(using: .utf8)?.base64EncodedString() else {
+            print("❌ Failed to encode configuration")
+            let errorData: NSDictionary = ["status": false, "message": "Failed to encode configuration"]
+            completion(SDKResult(type: .error, data: errorData))
+            return
+        }
+        
+        print("🔧 Base64 Config:", base64Config)
+        
+        // Build URL with Base64 config parameter
+        let serverHTMLURL = "https://js.lyfepay.io/authenticated-ach.html"
+        var components = URLComponents(string: serverHTMLURL)!
+        components.queryItems = [
+            URLQueryItem(name: "config", value: base64Config)
+        ]
+        
+        guard let url = components.url else {
+            print("❌ Failed to build URL")
+            let errorData: NSDictionary = ["status": false, "message": "Invalid URL configuration"]
+            completion(SDKResult(type: .error, data: errorData))
+            return
+        }
+        
+        print("🌐 Safari URL:", url.absoluteString)
+        
+        // Configure Safari View Controller
+        let safari = SFSafariViewController(url: url)
+        safari.delegate = SafariDelegateHandler.shared
+        SafariDelegateHandler.shared.completion = completion
+        
+        if #available(iOS 11.0, *) {
+            safari.dismissButtonStyle = .close
+            safari.preferredBarTintColor = .white
+            safari.preferredControlTintColor = .systemBlue
+        }
+        
+        // Present Safari directly from the current view controller
+        safariViewController = safari
+        viewController.present(safari, animated: true) {
+            print("✅ Safari presented directly (no white screen)")
+        }
+    }
+    
+    // Handle deep link callback
+    @objc public static func handleDeepLinkCallback(url: URL) {
+        guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
+              let dataParam = components.queryItems?.first(where: { $0.name == "data" })?.value else {
+            print("❌ Invalid deep link format")
+            return
+        }
+        
+        print("🔗 Deep link received:", url.absoluteString)
+        print("📦 Data param:", dataParam)
+        
+        // URL decode
+        guard let urlDecoded = dataParam.removingPercentEncoding else {
+            print("❌ Failed to URL decode")
+            return
+        }
+        
+        // Base64 decode
+        guard let decodedData = Data(base64Encoded: urlDecoded),
+              let decodedString = String(data: decodedData, encoding: .utf8) else {
+            print("❌ Failed to Base64 decode")
+            return
+        }
+        
+        print("📋 Decoded JSON:", decodedString)
+        
+        // Parse JSON
+        guard let jsonData = decodedString.data(using: .utf8),
+              let json = try? JSONSerialization.jsonObject(with: jsonData) as? [String: Any],
+              let eventType = json["eventType"] as? String,
+              let data = json["data"] else {
+            print("❌ Failed to parse JSON")
+            return
+        }
+        
+        print("✅ Event type:", eventType)
+        print("📊 Data:", data)
+        
+        // Dismiss Safari
+        safariViewController?.dismiss(animated: true) {
+            print("🚪 Safari dismissed")
+        }
+        
+        // Handle callback based on event type
+        switch eventType {
+        case "defaultAccountSelected", "linkedDefaultAccount":
+            // Wrap account data in an array to match expected format
+            let resultData: NSDictionary = ["data": [data]]
+            let result = SDKResult(type: .success, data: resultData)
+            completionHandler?(result)
+            
+        case "linkExit":
+            if let exitData = data as? [String: Any],
+               let status = exitData["status"] as? String,
+               status == "SUCCESS" {
+                // Wrap account data in an array to match expected format
+                let resultData: NSDictionary = ["data": [data]]
+                let result = SDKResult(type: .success, data: resultData)
+                completionHandler?(result)
+            } else {
+                let resultData: NSDictionary = ["data": data]
+                let result = SDKResult(type: .cancelled, data: resultData)
+                completionHandler?(result)
+            }
+            
+        case "error":
+            let errorData: NSDictionary = ["status": false, "message": "GrailPay error: \(data)"]
+            let result = SDKResult(type: .error, data: errorData)
+            completionHandler?(result)
+            
+        default:
+            print("⚠️ Unknown event type:", eventType)
+        }
+    }
+}
+
+// MARK: - Safari Delegate Handler
+private class SafariDelegateHandler: NSObject, SFSafariViewControllerDelegate {
+    static let shared = SafariDelegateHandler()
+    var completion: ((SDKResult) -> Void)?
+    
+    func safariViewControllerDidFinish(_ controller: SFSafariViewController) {
+        print("🚪 Safari dismissed by user (cancel)")
+        // Only call completion if no deep link was received
+        // (deep link handler will call completion with success)
     }
 }