@glomopay/react-native-sdk 2.0.1 → 3.0.1

package/src/use-lrs-checkout.tsx

@@ -3,11 +3,11 @@
 import React, { useState, useRef, useMemo, useCallback, useEffect } from "react";
 import { Platform, type NativeSyntheticEvent } from "react-native";
 
-import { WebViewNavigation, WebViewMessageEvent, type WebView } from "react-native-webview";
+import { type WebViewNavigation, type WebViewMessageEvent, type WebView } from "react-native-webview";
 
 import { InjectionScripts } from "./injections/index";
 import { initializeSegment } from "./config/segment";
-import { resolveServerConfig, type GlomoLrsServer } from "./config/base";
+import { resolveServerConfig, type GlomoServer } from "./config/base";
 import { isValidPublicKey, isValidOrderId, isValidUrl, isValidPaymentPayload, safeCallback } from "./utils/validation";
 import { checkDeviceCompliance, isComplianceCheckAvailable } from "./utils/device-compliance";
 import {
@@ -21,6 +21,7 @@ import {
     trackPaymentTerminate,
     trackConnectionError,
     trackEducationStepsShown,
+    trackEducationStepsFailedToShow,
     trackSdkError,
     trackInvalidMessageReceived,
     type SdkError,
@@ -41,7 +42,14 @@ export type LrsCheckoutStatus =
     | "payment_failed"
 
     // LRS checkout flow aborted midway. User can retry the flow on the same orderId
-    | "payment_cancelled";
+    | "payment_cancelled"
+
+    /**
+     * These are not currently emitted by LRS flows, but I'm intentionally including them so that the SDK is forwards compatible.
+     * The SDK would also then effectively handle these events without a patch if LRS gains bank transfer / pay-via-bank support in the future.
+     */
+    | "bank_transfer_submitted"
+    | "pay_via_bank_completed";
 
 /**
  * Tracks whether the education carousel WebView has signalled that it has content to show.
@@ -59,7 +67,7 @@ export interface GlomoLrsCheckoutPayload {
 
 /** The options for the useLrsCheckout hook */
 export interface UseLrsCheckoutOptions {
-    server?: GlomoLrsServer;
+    server?: GlomoServer;
     publicKey: string;
     orderId: string;
     onPaymentSuccess: (payload: GlomoLrsCheckoutPayload) => void;
@@ -120,7 +128,7 @@ export function useLrsCheckout(
 
     // Resolving checkout and carousel URLs from the selected SDK server
     const serverConfig = useMemo(() => resolveServerConfig(server), [server]);
-    const baseCheckoutUrl = serverConfig.checkoutBaseUrl;
+    const baseCheckoutUrl = serverConfig.baseUrl.lrsCheckout;
 
     /**
      * The main checkout URL for the LRS flow
@@ -144,45 +152,22 @@ export function useLrsCheckout(
             // Validating the final URL
             if (!isValidUrl(finalUrl)) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Generated invalid checkout URL:", finalUrl);
+                    console.error("[Glomo-RN-SDK LRS] Generated invalid checkout URL:", finalUrl);
                 }
-                const errors: SdkError[] = [
-                    {
-                        type: "validation_error",
-                        message: "Generated invalid checkout URL",
-                    },
-                ];
-                safeCallback(onSdkError, [errors], "onSdkError", devMode);
-                trackSdkError(
-                    errors,
-                    orderId,
-                    publicKey,
-                    devMode,
-                    mockMode,
-                    finalUrl ? finalUrl : finalUrl === null ? "null" : "undefined"
-                );
                 return "";
             }
 
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Checkout URL:", finalUrl);
+                console.log("[Glomo-RN-SDK LRS] Checkout URL:", finalUrl);
             }
             return finalUrl;
         } catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error building checkout URL:", error);
+                console.error("[Glomo-RN-SDK LRS] Error building checkout URL:", error);
             }
-            const errors: SdkError[] = [
-                {
-                    type: "validation_error",
-                    message: `Error building checkout URL: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ];
-            safeCallback(onSdkError, [errors], "onSdkError", devMode);
-            trackSdkError(errors, orderId, publicKey, devMode, mockMode, "");
             return "";
         }
-    }, [baseCheckoutUrl, orderId, publicKey, mockMode, devMode, onSdkError]);
+    }, [baseCheckoutUrl, orderId, publicKey, mockMode, devMode]);
 
     /**
      * The education carousel URL, built from the server config with the current orderId and publicKey.
@@ -190,7 +175,7 @@ export function useLrsCheckout(
      */
     const educationCarouselUrl = useMemo(() => {
         try {
-            const baseEducationCarouselUrl = serverConfig.educationCarouselBaseUrl;
+            const baseEducationCarouselUrl = serverConfig.baseUrl.lrsEducationCarousel;
             const separator = baseEducationCarouselUrl.includes("?") ? "&" : "?";
             const finalUrl =
                 `${baseEducationCarouselUrl}${separator}orderId=${encodeURIComponent(orderId)}` +
@@ -198,43 +183,22 @@ export function useLrsCheckout(
 
             if (!isValidUrl(finalUrl)) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Generated invalid education carousel URL:", finalUrl);
+                    console.error("[Glomo-RN-SDK LRS] Generated invalid education carousel URL:", finalUrl);
                 }
-                const errors: SdkError[] = [
-                    {
-                        type: "validation_error",
-                        message: "Generated invalid education carousel URL",
-                    },
-                ];
-                trackSdkError(
-                    errors,
-                    orderId,
-                    publicKey,
-                    devMode,
-                    mockMode,
-                    finalUrl ? finalUrl : finalUrl === null ? "null" : "undefined"
-                );
                 return "";
             }
 
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Education Carousel URL:", finalUrl);
+                console.log("[Glomo-RN-SDK LRS] Education Carousel URL:", finalUrl);
             }
             return finalUrl;
         } catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error building education carousel URL:", error);
+                console.error("[Glomo-RN-SDK LRS] Error building education carousel URL:", error);
             }
-            const errors: SdkError[] = [
-                {
-                    type: "validation_error",
-                    message: `Error building education carousel URL: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ];
-            trackSdkError(errors, orderId, publicKey, devMode, mockMode, "");
             return "";
         }
-    }, [serverConfig, orderId, publicKey, devMode, mockMode]);
+    }, [serverConfig, orderId, publicKey, devMode]);
 
     // Checkout status state
     const [status, setStatus] = useState<LrsCheckoutStatus>("ready");
@@ -249,11 +213,18 @@ export function useLrsCheckout(
     useEffect(() => {
         if (devMode) {
             console.log(
-                `[GlomoPay RN SDK] Carousel state snapshot: status=${status}, showCheckout=${showCheckout}, showFlowWebView=${showFlowWebView}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}, educationCarouselState=${educationCarouselState}, educationCarouselUrl=${educationCarouselUrl || "<empty>"}`
+                `[Glomo-RN-SDK LRS] Carousel state snapshot: status=${status}, showCheckout=${showCheckout}, showFlowWebView=${showFlowWebView}, flowWebViewUrl=${flowWebViewUrl || "<empty>"}, educationCarouselState=${educationCarouselState}, educationCarouselUrl=${educationCarouselUrl || "<empty>"}`
             );
         }
     }, [devMode, status, showCheckout, showFlowWebView, flowWebViewUrl, educationCarouselState, educationCarouselUrl]);
 
+    // Tracking when the education carousel URL is invalid (empty) despite having valid orderId and publicKey
+    useEffect(() => {
+        if (orderId && publicKey && !educationCarouselUrl) {
+            trackEducationStepsFailedToShow(orderId, publicKey, devMode, mockMode, checkoutUrl, "invalid_url");
+        }
+    }, [educationCarouselUrl, orderId, publicKey, devMode, mockMode, checkoutUrl]);
+
     // Handler for the WebView errors
     const handleError = useCallback(
         (syntheticEvent: NativeSyntheticEvent<{ code?: number; domain?: string; description?: string }>) => {
@@ -283,7 +254,7 @@ export function useLrsCheckout(
 
                 if (isIOSConnectionError || isAndroidConnectionError) {
                     if (devMode) {
-                        console.error("[GlomoPay RN SDK] Connection error:", nativeEvent);
+                        console.error("[Glomo-RN-SDK LRS] Connection error:", nativeEvent);
                     }
 
                     // Closing the checkout modal
@@ -298,12 +269,12 @@ export function useLrsCheckout(
                     trackConnectionError(orderId, nativeEvent?.code, publicKey, devMode, mockMode, checkoutUrl);
                 } else {
                     if (devMode) {
-                        console.error("[GlomoPay RN SDK] WebView error:", nativeEvent);
+                        console.error("[Glomo-RN-SDK LRS] WebView error:", nativeEvent);
                     }
                 }
             } catch (error) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Error in handleError:", error);
+                    console.error("[Glomo-RN-SDK LRS] Error in handleError:", error);
                 }
             }
         },
@@ -316,11 +287,11 @@ export function useLrsCheckout(
             try {
                 const { nativeEvent } = syntheticEvent;
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] WebView HTTP error:", nativeEvent);
+                    console.error("[Glomo-RN-SDK LRS] WebView HTTP error:", nativeEvent);
                 }
             } catch (error) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Error in handleHttpError:", error);
+                    console.error("[Glomo-RN-SDK LRS] Error in handleHttpError:", error);
                 }
             }
         },
@@ -334,7 +305,7 @@ export function useLrsCheckout(
                 const data = event.nativeEvent?.data;
                 if (!data || typeof data !== "string") {
                     if (devMode) {
-                        console.warn("[GlomoPay RN SDK] Invalid message data from MainWebView");
+                        console.warn("[Glomo-RN-SDK LRS] Invalid message data from MainWebView");
                     }
                     // Tracking invalid message received
                     trackInvalidMessageReceived(
@@ -352,13 +323,13 @@ export function useLrsCheckout(
 
                 const message = JSON.parse(data);
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] MainWebView Message received:", message.type, message);
+                    console.log("[Glomo-RN-SDK LRS] MainWebView Message received:", message.type, message);
                 }
 
                 if (message.type === "console") {
                     if (devMode) {
                         const level = message.level || "log";
-                        console.log(`[GlomoPay RN SDK] [WebView ${level.toUpperCase()}]`, message.message);
+                        console.log(`[Glomo-RN-SDK LRS] [WebView ${level.toUpperCase()}]`, message.message);
                     }
                     return;
                 }
@@ -367,7 +338,7 @@ export function useLrsCheckout(
                     const url = message.url;
                     if (url && typeof url === "string" && isValidUrl(url)) {
                         if (devMode) {
-                            console.log(`[GlomoPay RN SDK] window.open called from MainWebView: ${url}`);
+                            console.log(`[Glomo-RN-SDK LRS] window.open called from MainWebView: ${url}`);
                         }
                         setFlowWebViewUrl(url);
                         setShowFlowWebView(true);
@@ -377,7 +348,7 @@ export function useLrsCheckout(
                     } else {
                         if (devMode) {
                             console.log(
-                                "[GlomoPay RN SDK] Invalid URL in window.open from MainWebView:",
+                                "[Glomo-RN-SDK LRS] Invalid URL in window.open from MainWebView:",
                                 url,
                                 typeof url === "undefined" ? "undefined" : ""
                             );
@@ -388,7 +359,7 @@ export function useLrsCheckout(
 
                 if (message.type === "window.close") {
                     if (devMode) {
-                        console.log("[GlomoPay RN SDK] Child window close requested from MainWebView");
+                        console.log("[Glomo-RN-SDK LRS] Child window close requested from MainWebView");
                     }
                     setShowFlowWebView(false);
                     setFlowWebViewUrl("");
@@ -409,7 +380,7 @@ export function useLrsCheckout(
 
                         if (isValidPaymentPayload(payload)) {
                             if (devMode) {
-                                console.log("[GlomoPay RN SDK] Payment successful via merchant callback!");
+                                console.log("[Glomo-RN-SDK LRS] Payment successful via merchant callback!");
                             }
                             setShowCheckout(false);
                             setShowFlowWebView(false);
@@ -428,7 +399,7 @@ export function useLrsCheckout(
                             );
                         } else {
                             if (devMode) {
-                                console.error("[GlomoPay RN SDK] Invalid payment success payload:", payload);
+                                console.error("[Glomo-RN-SDK LRS] Invalid payment success payload:", payload);
                             }
                         }
                         return;
@@ -440,7 +411,7 @@ export function useLrsCheckout(
 
                         if (isValidPaymentPayload(payload)) {
                             if (devMode) {
-                                console.error("[GlomoPay RN SDK] Payment failed via merchant callback");
+                                console.error("[Glomo-RN-SDK LRS] Payment failed via merchant callback");
                             }
                             setShowCheckout(false);
                             setShowFlowWebView(false);
@@ -459,7 +430,7 @@ export function useLrsCheckout(
                             );
                         } else {
                             if (devMode) {
-                                console.error("[GlomoPay RN SDK] Invalid payment failure payload:", payload);
+                                console.error("[Glomo-RN-SDK LRS] Invalid payment failure payload:", payload);
                             }
                         }
                         return;
@@ -468,7 +439,7 @@ export function useLrsCheckout(
                     // Handling checkout.closed events
                     if (messageType === "checkout.closed") {
                         if (devMode) {
-                            console.log("[GlomoPay RN SDK] Checkout closed event received");
+                            console.log("[Glomo-RN-SDK LRS] Checkout closed event received");
                         }
                         setShowCheckout(false);
                         setShowFlowWebView(false);
@@ -482,7 +453,7 @@ export function useLrsCheckout(
                 }
             } catch (error) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Error parsing MainWebView message:", error);
+                    console.error("[Glomo-RN-SDK LRS] Error parsing MainWebView message:", error);
                 }
             }
         },
@@ -496,7 +467,7 @@ export function useLrsCheckout(
                 const data = event.nativeEvent?.data;
                 if (!data || typeof data !== "string") {
                     if (devMode) {
-                        console.warn("[GlomoPay RN SDK] Invalid message data from FlowWebView");
+                        console.warn("[Glomo-RN-SDK LRS] Invalid message data from FlowWebView");
                     }
                     // Tracking invalid message received
                     trackInvalidMessageReceived(
@@ -514,12 +485,12 @@ export function useLrsCheckout(
 
                 const message = JSON.parse(data);
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] FlowWebView Message received:", message.type, message);
+                    console.log("[Glomo-RN-SDK LRS] FlowWebView Message received:", message.type, message);
                 }
 
                 if (message.type === "console") {
                     if (devMode) {
-                        console.log(`[GlomoPay RN SDK] [Flow] ${message.message}`);
+                        console.log(`[Glomo-RN-SDK LRS] [Flow] ${message.message}`);
                     }
                     return;
                 }
@@ -528,7 +499,7 @@ export function useLrsCheckout(
                     const url = message.url;
                     if (url && typeof url === "string" && isValidUrl(url)) {
                         if (devMode) {
-                            console.log(`[GlomoPay RN SDK] window.open called from FlowWebView: ${url}`);
+                            console.log(`[Glomo-RN-SDK LRS] window.open called from FlowWebView: ${url}`);
                         }
                         setFlowWebViewUrl(url);
                         setEducationCarouselState("pending");
@@ -537,7 +508,7 @@ export function useLrsCheckout(
                     } else {
                         if (devMode) {
                             console.log(
-                                "[GlomoPay RN SDK] Invalid URL in window.open from FlowWebView:",
+                                "[Glomo-RN-SDK LRS] Invalid URL in window.open from FlowWebView:",
                                 url,
                                 typeof url === "undefined" ? "undefined" : ""
                             );
@@ -548,7 +519,7 @@ export function useLrsCheckout(
 
                 if (message.type === "window.close") {
                     if (devMode) {
-                        console.log("[GlomoPay RN SDK] FlowWebView close requested");
+                        console.log("[Glomo-RN-SDK LRS] FlowWebView close requested");
                     }
                     setShowFlowWebView(false);
                     setFlowWebViewUrl("");
@@ -568,7 +539,7 @@ export function useLrsCheckout(
 
                         if (isValidPaymentPayload(payload)) {
                             if (devMode) {
-                                console.log("[GlomoPay RN SDK] Payment successful via FlowWebView callback!");
+                                console.log("[Glomo-RN-SDK LRS] Payment successful via FlowWebView callback!");
                             }
                             setShowFlowWebView(false);
                             setShowCheckout(false);
@@ -588,7 +559,7 @@ export function useLrsCheckout(
                         } else {
                             if (devMode) {
                                 console.error(
-                                    "[GlomoPay RN SDK] Invalid payment success payload from FlowWebView:",
+                                    "[Glomo-RN-SDK LRS] Invalid payment success payload from FlowWebView:",
                                     payload
                                 );
                             }
@@ -602,7 +573,7 @@ export function useLrsCheckout(
 
                         if (isValidPaymentPayload(payload)) {
                             if (devMode) {
-                                console.error("[GlomoPay RN SDK] Payment failed via FlowWebView callback");
+                                console.error("[Glomo-RN-SDK LRS] Payment failed via FlowWebView callback");
                             }
                             setShowFlowWebView(false);
                             setShowCheckout(false);
@@ -622,7 +593,7 @@ export function useLrsCheckout(
                         } else {
                             if (devMode) {
                                 console.error(
-                                    "[GlomoPay RN SDK] Invalid payment failure payload from FlowWebView:",
+                                    "[Glomo-RN-SDK LRS] Invalid payment failure payload from FlowWebView:",
                                     payload
                                 );
                             }
@@ -632,7 +603,7 @@ export function useLrsCheckout(
                 }
             } catch (error) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Error parsing FlowWebView message:", error);
+                    console.error("[Glomo-RN-SDK LRS] Error parsing FlowWebView message:", error);
                 }
             }
         },
@@ -646,19 +617,19 @@ export function useLrsCheckout(
                 const data = event.nativeEvent?.data;
                 if (!data || typeof data !== "string") {
                     if (devMode) {
-                        console.warn("[GlomoPay RN SDK] Invalid message data from EducationCarouselWebView");
+                        console.warn("[Glomo-RN-SDK LRS] Invalid message data from EducationCarouselWebView");
                     }
                     return;
                 }
 
                 const message = JSON.parse(data);
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] EducationCarouselWebView Message received:", message.type, message);
+                    console.log("[Glomo-RN-SDK LRS] EducationCarouselWebView Message received:", message.type, message);
                 }
 
                 if (message.type === "console") {
                     if (devMode) {
-                        console.log(`[GlomoPay RN SDK] [EducationCarousel] ${message.message}`);
+                        console.log(`[Glomo-RN-SDK LRS] [EducationCarousel] ${message.message}`);
                     }
                     return;
                 }
@@ -668,7 +639,7 @@ export function useLrsCheckout(
 
                     if (devMode) {
                         console.log(
-                            `[GlomoPay RN SDK] Education carousel signal received: value=${String(message.value)} source=${message.source || "unknown"} payload=${JSON.stringify(message.payload || {})}`
+                            `[Glomo-RN-SDK LRS] Education carousel signal received: value=${String(message.value)} source=${message.source || "unknown"} payload=${JSON.stringify(message.payload || {})}`
                         );
                     }
 
@@ -678,7 +649,7 @@ export function useLrsCheckout(
                 }
             } catch (error) {
                 if (devMode) {
-                    console.error("[GlomoPay RN SDK] Error parsing EducationCarouselWebView message:", error);
+                    console.error("[Glomo-RN-SDK LRS] Error parsing EducationCarouselWebView message:", error);
                 }
             }
         },
@@ -689,7 +660,7 @@ export function useLrsCheckout(
     const handleNavigationStateChange = useCallback(
         (navState: WebViewNavigation) => {
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Navigation state:", navState);
+                console.log("[Glomo-RN-SDK LRS] Navigation state:", navState);
             }
         },
         [devMode]
@@ -699,22 +670,23 @@ export function useLrsCheckout(
     const handleModalBackButton = useCallback(() => {
         try {
             if (devMode) {
-                console.log("[GlomoPay RN SDK] Modal dismissed/back button pressed");
+                console.log("[Glomo-RN-SDK LRS] Modal dismissed/back button pressed");
             }
             if (showFlowWebView) {
                 setShowFlowWebView(false);
                 setFlowWebViewUrl("");
-                setEducationCarouselState("pending");
             }
+            // Resetting carousel state and closing the checkout modal regardless of flow WebView state
+            setEducationCarouselState("pending");
             setShowCheckout(false);
             if (status === "payment_in_progress") {
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] In progress payment cancelled");
+                    console.log("[Glomo-RN-SDK LRS] In progress payment cancelled");
                 }
                 setStatus("payment_cancelled");
             } else {
                 if (devMode) {
-                    console.log("[GlomoPay RN SDK] Ignoring checkout status update for: " + status);
+                    console.log("[Glomo-RN-SDK LRS] Ignoring checkout status update for: " + status);
                 }
             }
             safeCallback(onPaymentTerminate, [], "onPaymentTerminate", devMode);
@@ -723,7 +695,7 @@ export function useLrsCheckout(
             trackPaymentTerminate(orderId, terminateSource, publicKey, devMode, mockMode, checkoutUrl);
         } catch (error) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Error in handleModalBackButton:", error);
+                console.error("[Glomo-RN-SDK LRS] Error in handleModalBackButton:", error);
             }
         }
     }, [showFlowWebView, devMode, onPaymentTerminate, status, orderId, publicKey, mockMode, checkoutUrl]);
@@ -731,7 +703,7 @@ export function useLrsCheckout(
     /** Closes the flow WebView and returns to the main checkout */
     const handleFlowBack = useCallback(() => {
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Flow WebView back button pressed");
+            console.log("[Glomo-RN-SDK LRS] Flow WebView back button pressed");
         }
         setShowFlowWebView(false);
         setFlowWebViewUrl("");
@@ -764,7 +736,7 @@ export function useLrsCheckout(
         };
 
         if (devMode) {
-            console.log(`[GlomoPay RN SDK] Attempting to start checkout of ${checkoutUrl} from status: ${status}`);
+            console.log(`[Glomo-RN-SDK LRS] Attempting to start checkout of ${checkoutUrl} from status: ${status}`);
         }
 
         // Tracking start attempt with current status
@@ -773,7 +745,7 @@ export function useLrsCheckout(
         if (deviceComplianceCheck === true) {
             // Device detected as compromised
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Cannot start checkout. Device is rooted or jailbroken.");
+                console.error("[Glomo-RN-SDK LRS] Cannot start checkout. Device is rooted or jailbroken.");
             }
             const errors: SdkError[] = [
                 {
@@ -797,10 +769,34 @@ export function useLrsCheckout(
         } else if (deviceComplianceCheck === null) {
             // This warning was intentionally not gated behind a devMode check to ensure merchants are aware of the strong recommendation to install jail-monkey for enhanced security compliance.
             console.warn(
-                "[GlomoPay RN SDK] Device security library not installed - the SDK won't be able to automatically detect rooted/jailbroken devices. It is HIGHLY recommended to install jail-monkey as per the README, and prevent LRS checkouts from compromised devices."
+                "[Glomo-RN-SDK LRS] Device security library not installed - the SDK won't be able to automatically detect rooted/jailbroken devices. It is HIGHLY recommended to install jail-monkey as per the README, and prevent LRS checkouts from compromised devices."
             );
         }
 
+        // Enforcing devMode requirement for development servers
+        const resolvedServer = server || "prod";
+        if (!devMode && resolvedServer !== "prod") {
+            const errors: SdkError[] = [
+                {
+                    type: "validation_error",
+                    message: "Development servers can only be used when devMode is enabled.",
+                },
+            ];
+            safeCallback(onSdkError, [errors], "onSdkError", devMode);
+            trackSdkError(errors, orderId, publicKey, devMode, mockMode, checkoutUrl);
+            trackStartFailure(
+                "validation_error",
+                orderId,
+                publicKey,
+                devMode,
+                mockMode,
+                checkoutUrl,
+                jailbreakDetectionInfo
+            );
+            setShowCheckout(false);
+            return false;
+        }
+
         // Checking validation errors with detailed field-level messages
         const errors: SdkError[] = [];
 
@@ -839,7 +835,7 @@ export function useLrsCheckout(
 
         if (errors.length > 0) {
             if (devMode) {
-                console.error(`[GlomoPay RN SDK] Cannot start checkout. Validation failed.`);
+                console.error(`[Glomo-RN-SDK LRS] Cannot start checkout. Validation failed.`);
             }
             safeCallback(onSdkError, [errors], "onSdkError", devMode);
             // Tracking start() failure
@@ -860,7 +856,7 @@ export function useLrsCheckout(
         if (status === "payment_successful") {
             if (devMode) {
                 console.log(
-                    `[GlomoPay RN SDK] Cannot start checkout. Current status: ${status}. Payment already successful.`
+                    `[Glomo-RN-SDK LRS] Cannot start checkout. Current status: ${status}. Payment already successful.`
                 );
             }
             // Tracking start() failure
@@ -881,10 +877,12 @@ export function useLrsCheckout(
             status !== "ready" &&
             status !== "payment_cancelled" &&
             status !== "payment_failed" &&
-            status !== "payment_in_progress"
+            status !== "payment_in_progress" &&
+            status !== "bank_transfer_submitted" &&
+            status !== "pay_via_bank_completed"
         ) {
             if (devMode) {
-                console.log(`[GlomoPay RN SDK] Cannot start checkout. Unknown status: ${status}.`);
+                console.log(`[Glomo-RN-SDK LRS] Cannot start checkout. Unknown status: ${status}.`);
             }
             // Tracking start() failure
             trackStartFailure(
@@ -902,7 +900,7 @@ export function useLrsCheckout(
 
         if (!checkoutUrl) {
             if (devMode) {
-                console.error("[GlomoPay RN SDK] Cannot start checkout. Invalid checkout URL.");
+                console.error("[Glomo-RN-SDK LRS] Cannot start checkout. Invalid checkout URL.");
             }
             // Tracking start() failure
             trackStartFailure(
@@ -919,7 +917,7 @@ export function useLrsCheckout(
         }
 
         if (devMode) {
-            console.log("[GlomoPay RN SDK] Starting checkout from previous state: " + status);
+            console.log("[Glomo-RN-SDK LRS] Starting checkout from previous state: " + status);
         }
 
         setShowFlowWebView(false);
@@ -932,7 +930,7 @@ export function useLrsCheckout(
 
         setShowCheckout(true);
         return true;
-    }, [devMode, status, publicKey, orderId, baseCheckoutUrl, checkoutUrl, mockMode, onSdkError]);
+    }, [devMode, status, publicKey, orderId, baseCheckoutUrl, checkoutUrl, mockMode, onSdkError, server]);
 
     // Initializing Segment analytics
     useEffect(() => {
@@ -943,10 +941,16 @@ export function useLrsCheckout(
     useEffect(() => {
         if (orderId && publicKey) {
             // Only resetting the checkout flow if the current status is that of a terminal state
-            if (status === "payment_successful" || status === "payment_failed" || status === "payment_cancelled") {
+            if (
+                status === "payment_successful" ||
+                status === "payment_failed" ||
+                status === "payment_cancelled" ||
+                status === "bank_transfer_submitted" ||
+                status === "pay_via_bank_completed"
+            ) {
                 if (devMode) {
                     console.log(
-                        `[GlomoPay RN SDK] Resetting checkout status ${status} for new orderId ${orderId} and publicKey ${publicKey}`
+                        `[Glomo-RN-SDK LRS] Resetting checkout status ${status} for new orderId ${orderId} and publicKey ${publicKey}`
                     );
                 }
                 setStatus("ready");