@glomopay/react-native-sdk 3.0.1 → 3.1.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2026-06-08
+
+### Added
+
+- **Subscriptions checkout support** - new `subscriptionId` prop on `GlomoCheckout`. When provided, the SDK bypasses order type detection and renders the subscriptions checkout flow directly. No API call is made - the inner checkout component mounts immediately. The `detecting_order_type` status is not emitted for subscription flows.
+- **Mutual exclusion validation** - `GlomoCheckout` validates that exactly one of `orderId` or `subscriptionId` is provided. If both or neither are set, `onSdkError` fires with a clear message and `start()` returns `false`.
+
+### Changed
+
+- **`orderId` is now optional** on `GlomoCheckoutProps` - required only when `subscriptionId` is absent.
+
+### Deprecated
+
+- **`useGlomoCheckout` hook** - use the `GlomoCheckout` component with a ref instead. The hook does not provide reactive state - `getStatus()` returns a point-in-time snapshot. Will be removed in a future major version.
+
 ## [3.0.1] - 2026-06-02
 
 ### Added

package/MIGRATION.md

@@ -0,0 +1,50 @@
+# Migration Guide
+
+## v2 to v3
+
+v3 replaces the LRS-only `GlomoLrsCheckout` with a unified `GlomoCheckout` that auto-detects order type.
+
+### Renamed Exports
+
+| v2                         | v3                        |
+| -------------------------- | ------------------------- |
+| `GlomoLrsCheckout`         | `GlomoCheckout`           |
+| `GlomoLrsCheckoutRef`      | `GlomoCheckoutRef`        |
+| `GlomoLrsCheckoutProps`    | `GlomoCheckoutProps`      |
+| `GlomoLrsCheckoutPayload`  | `GlomoCheckoutPayload`    |
+| `GlomoLrsServer`           | `GlomoServer`             |
+
+### Breaking Changes
+
+- **`start()` is now async**: Returns `Promise<boolean>` instead of `boolean`. Update call sites to `await ref.current?.start()`.
+- **New statuses**: `bank_transfer_submitted` and `pay_via_bank_completed` are new additions to `CheckoutStatus`.
+- **New callbacks**: `onBankTransferSubmitted`, `onPayViaBankCompleted`, and `onUserRefusedCameraPermissions` are available.
+
+### Before / After
+
+**v2:**
+```tsx
+import { GlomoLrsCheckout, type GlomoLrsCheckoutRef } from "@glomopay/react-native-sdk";
+
+const ref = useRef<GlomoLrsCheckoutRef>(null);
+const started = ref.current?.start(); // boolean
+```
+
+**v3:**
+```tsx
+import { GlomoCheckout, type GlomoCheckoutRef } from "@glomopay/react-native-sdk";
+
+const ref = useRef<GlomoCheckoutRef>(null);
+const started = await ref.current?.start(); // Promise<boolean>
+```
+
+### Platform Configuration (New in v3)
+
+Checkout flows with camera-based bank authentication require native permissions:
+
+- **Android** (`AndroidManifest.xml`): `<uses-permission android:name="android.permission.CAMERA" />`
+- **iOS** (`Info.plist`): `NSCameraUsageDescription` key
+
+These are only required for flows that use camera-based bank authentication.
+
+For the full changelog, see CHANGELOG.md included in this package.

package/README.md

@@ -1,28 +1,16 @@
-# GlomoPay React Native SDK 💳
+# GlomoPay React Native SDK
 
 [![npm version](https://img.shields.io/npm/v/@glomopay/react-native-sdk.svg)](https://www.npmjs.com/package/@glomopay/react-native-sdk)
 [![License](https://img.shields.io/npm/l/@glomopay/react-native-sdk.svg)](LICENSE)
 
 Official React Native SDK for integrating GlomoPay payment checkout flows into your mobile applications.
 
-## ✨ Features
-
-- 📱 **Cross-platform** - works on both iOS and Android
-- 🔷 **TypeScript** - full type definitions for all exports
-- ⚡ **Unified checkout** - renders the correct checkout flow automatically based on your order
-- 💰 **Bank transfer support** - callback for bank transfer submission events
-- 🏦 **Pay via bank** - bank payment flow completion and connection callbacks
-- 📷 **Camera permissions** - built-in handling for bank authentication
-- 🔒 **Device security** - optional **(but strongly recommended)** `jail-monkey` integration for rooted/jailbroken device detection
-- 🛡️ **Input validation** - publicKey and orderId format enforcement before checkout starts
-- 🧪 **Mock mode** - test with `test_` / `mock_` prefixed keys without hitting production
-
-## 📋 Prerequisites
+## Prerequisites
 
 - API credentials (Public Key) from your GlomoPay dashboard
 - An order ID created via the GlomoPay API
 
-## 🛠️ System Requirements
+## System Requirements
 
 | Requirement            | Version      |
 | ---------------------- | ------------ |
@@ -33,15 +21,7 @@ Official React Native SDK for integrating GlomoPay payment checkout flows into y
 | react-native-webview   | ^13.0.0      |
 | jail-monkey (optional) | ^2.6.0       |
 
-## ⚠️ Breaking Changes (v3)
-
-- `GlomoLrsCheckout` has been replaced by `GlomoCheckout` - the new component now works for all checkout orders (including LRS)
-- `start()` is now async - returns `Promise<boolean>` instead of `boolean`
-- All LRS-specific exports have been renamed (e.g. `GlomoLrsCheckoutRef` -> `GlomoCheckoutRef`)
-
-For the full list of changes and migration details, see [CHANGELOG.md](./CHANGELOG.md) and [Migration from v2](#-migration-from-v2).
-
-## 📦 Installation
+## Installation
 
 ### React Native CLI
 
@@ -66,7 +46,7 @@ npm install jail-monkey
 
 The SDK works without `jail-monkey`, but installing it enables automatic device security checks. Without it, the SDK logs a warning on every `start()` call.
 
-## 🚀 Quick Start
+## Quick Start
 
 ```tsx
 import React, { useRef } from "react";
@@ -129,7 +109,86 @@ export default function PaymentScreen() {
 }
 ```
 
-## 📚 API Reference
+## Breaking Changes (v3)
+
+- `GlomoLrsCheckout` has been replaced by `GlomoCheckout` - the new component now works for all checkout orders (including LRS)
+- `start()` is now async - returns `Promise<boolean>` instead of `boolean`
+- All LRS-specific exports have been renamed (e.g. `GlomoLrsCheckoutRef` -> `GlomoCheckoutRef`)
+
+For migration details, see the [Migration from v2](#migration-from-v2) section below or MIGRATION.md included in this package.
+
+## Subscriptions Checkout
+
+To process subscription payments, pass a `subscriptionId` instead of an `orderId`:
+
+```tsx
+<GlomoCheckout
+  ref={checkoutRef}
+  publicKey="live_pk_abc123"
+  subscriptionId="sub_xyz789"
+  onPaymentSuccess={(payload) => {
+    console.log("Subscription payment success:", payload.paymentId);
+  }}
+  onPaymentFailure={(payload) => {
+    console.log("Subscription payment failed:", payload.paymentId);
+  }}
+  onSdkError={(errors) => {
+    errors.forEach((e) => console.error(e.type, e.message));
+  }}
+/>
+```
+
+When `subscriptionId` is provided:
+- The SDK skips order type detection (no API call)
+- The `subscriptionId` must start with `sub_`
+- Bank transfer callbacks (`onBankTransferSubmitted`, `onPayViaBankCompleted`) are not applicable - subscriptions are card-only
+- Do not pass both `orderId` and `subscriptionId` - the SDK will fire `onSdkError`
+- The `detecting_order_type` status is not emitted for subscription flows
+
+## Features
+
+- **Cross-platform** - works on both iOS and Android
+- **TypeScript** - full type definitions for all exports
+- **Unified checkout** - renders the correct checkout flow automatically based on your order
+- **Bank transfer support** - callback for bank transfer submission events
+- **Pay via bank** - bank payment flow completion and connection callbacks
+- **Camera permissions** - built-in handling for bank authentication
+- **Device security** - optional **(but strongly recommended)** `jail-monkey` integration for rooted/jailbroken device detection
+- **Input validation** - publicKey and orderId format enforcement before checkout starts
+- **Mock mode** - test with `test_` / `mock_` prefixed keys without hitting production
+
+## useGlomoCheckout Hook (Deprecated)
+
+> **Deprecated** - Legacy hook, will be removed in a future major version.
+
+`useGlomoCheckout` is a legacy placeholder from the v1.x hook-based API. In v1.x, the equivalent
+hook (`useLrsCheckout`) provided reactive WebView state and rendering primitives that merchants used
+to build custom checkout UIs. In v3, the inner checkout components are no longer exported, making
+this hook ineffective for custom rendering.
+
+The hook's public return type (`UseGlomoCheckoutReturn`) exposes:
+- `start()` - identical to `GlomoCheckoutRef.start()`. Returns `Promise<boolean>`.
+- `getStatus()` - returns a point-in-time `CheckoutStatus` snapshot. **Not reactive** - does not
+  trigger re-renders when status changes.
+
+**Use the `GlomoCheckout` component with a ref instead:**
+
+```tsx
+import React, { useRef } from "react";
+import { GlomoCheckout, type GlomoCheckoutRef } from "@glomopay/react-native-sdk";
+
+const checkoutRef = useRef<GlomoCheckoutRef>(null);
+
+// Start checkout
+const started = await checkoutRef.current?.start();
+
+// Check status (point-in-time, same as hook)
+const status = checkoutRef.current?.getStatus();
+```
+
+The component-based API provides the same functionality with proper lifecycle management.
+
+## API Reference
 
 ### GlomoCheckout Component
 
@@ -144,7 +203,8 @@ The unified checkout component. Place it in your render tree and control it via
 | Prop                             | Type                                            | Required | Description                                                         |
 | -------------------------------- | ----------------------------------------------- | -------- | ------------------------------------------------------------------- |
 | `publicKey`                      | `string`                                        | Yes      | Your GlomoPay public key (must start with `live_`, `mock_`, or `test_`) |
-| `orderId`                        | `string`                                        | Yes      | Order ID from the GlomoPay API (must start with `order_`)          |
+| `orderId`                        | `string`                                        | No*      | Order ID from the GlomoPay API (must start with `order_`)          |
+| `subscriptionId`                 | `string`                                        | No*      | Subscription ID (must start with `sub_`). Bypasses order type detection. |
 | `onPaymentSuccess`               | `(payload: GlomoCheckoutPayload) => void`       | Yes      | Called when payment succeeds                                        |
 | `onPaymentFailure`               | `(payload: GlomoCheckoutPayload) => void`       | Yes      | Called when payment fails                                           |
 | `onConnectionError`              | `(error: unknown) => void`                      | No       | Called on network/connection errors                                 |
@@ -155,6 +215,8 @@ The unified checkout component. Place it in your render tree and control it via
 | `onPayViaBankBankConnectionSuccessful` | `(payload: GlomoPayViaBankConnectionPayload \| null \| undefined) => void` | No | Called when bank connection is established during pay via bank flow |
 | `onUserRefusedCameraPermissions` | `() => void`                                    | No       | Called when user denies camera access needed for bank authentication                |
 
+*Exactly one of `orderId` or `subscriptionId` must be provided. If both or neither are set, `onSdkError` fires and `start()` returns `false`.
+
 #### Ref Methods (`GlomoCheckoutRef`)
 
 | Method       | Signature                | Description                                                                                               |
@@ -167,6 +229,7 @@ The unified checkout component. Place it in your render tree and control it via
 | Status                     | Description                                                    |
 | -------------------------- | -------------------------------------------------------------- |
 | `ready`                    | Initial state - checkout can be started                        |
+| `detecting_order_type`     | Order type detection in progress (after `start()`, before checkout opens) |
 | `payment_in_progress`      | Checkout modal is open, user is interacting                    |
 | `payment_successful`       | Payment completed successfully. Cannot restart with same order |
 | `payment_failed`           | Payment failed. Can retry with same order                      |
@@ -214,11 +277,11 @@ interface GlomoPayViaBankConnectionPayload {
 interface SdkError {
   type: "validation_error" | "device_forbidden";
   message: string;
-  field?: string;
+  field?: "publicKey" | "orderId" | "subscriptionId" | "baseCheckoutUrl" | "generatedCheckoutUrl";
 }
 ```
 
-## 💰 Bank Transfer Support
+## Bank Transfer Support
 
 When the checkout flow includes a bank transfer option, the user submits transfer details (account number, reference) through the checkout UI. The SDK fires `onBankTransferSubmitted` with a `GlomoBankTransferPayload`:
 
@@ -231,7 +294,7 @@ onBankTransferSubmitted={(payload) => {
 
 The checkout status transitions to `bank_transfer_submitted`.
 
-## 🏦 Pay via Bank Support
+## Pay via Bank Support
 
 The SDK fires `onPayViaBankCompleted` when the pay-via-bank journey completes:
 
@@ -254,7 +317,7 @@ onPayViaBankBankConnectionSuccessful={(payload) => {
 }}
 ```
 
-## 📷 Camera Permissions for bank authentication
+## Camera Permissions
 
 Some checkout flows may require camera access for bank authentication. The SDK handles permission prompts automatically, but you must declare the permissions in your native project config.
 
@@ -280,12 +343,12 @@ Add to `ios/<YourApp>/Info.plist`:
 - **Android**: SDK prompts the user via a native permission dialog. If denied, checkout closes and `onUserRefusedCameraPermissions` fires.
 - **iOS**: SDK grants the WebView permission request; iOS shows its own system prompt. If the user denies at the system level, the WebView handles the denial.
 
-## 📱 Platform Behavior
+## Platform Behavior
 
 - **iOS**: Checkout opens as a `pageSheet` modal (swipe-down to dismiss). Dismissing fires `onPaymentTerminate`.
 - **Android**: Checkout opens fullscreen. The hardware back button dismisses it and fires `onPaymentTerminate`.
 
-## 🔒 Device Security Compliance
+## Device Security Compliance
 
 The SDK optionally integrates with `jail-monkey` to detect rooted (Android) or jailbroken (iOS) devices.
 
@@ -293,7 +356,7 @@ The SDK optionally integrates with `jail-monkey` to detect rooted (Android) or j
 - If `jail-monkey` is installed and the device is clean: checkout proceeds normally.
 - If `jail-monkey` is not installed: SDK logs a warning and proceeds without checking. This is not recommended for production deployments handling regulated transactions.
 
-## 🧪 Mock Mode
+## Mock Mode
 
 The SDK infers mock mode from the `publicKey` prefix:
 
@@ -305,7 +368,7 @@ The SDK infers mock mode from the `publicKey` prefix:
 
 Mock mode keys route to the sandbox backend. No real transactions are created.
 
-## 🌐 Connection Handling
+## Connection Handling
 
 The SDK detects connection errors from the WebView and fires `onConnectionError`:
 
@@ -314,18 +377,21 @@ The SDK detects connection errors from the WebView and fires `onConnectionError`
 
 The checkout modal is automatically dismissed on connection errors.
 
-## 🛡️ Input Validation
+## Input Validation
 
 The SDK validates inputs before starting the checkout:
 
-| Field       | Rule                                            |
-| ----------- | ----------------------------------------------- |
-| `publicKey` | Must start with `live_`, `mock_`, or `test_`. Min 6 characters. |
-| `orderId`   | Must start with `order_`. Min 7 characters.     |
+| Field            | Rule                                            |
+| ---------------- | ----------------------------------------------- |
+| `publicKey`      | Must start with `live_`, `mock_`, or `test_`. Min 6 characters. |
+| `orderId`        | Must start with `order_`. Min 7 characters. Required when `subscriptionId` is absent. |
+| `subscriptionId` | Must start with `sub_`. Trimmed and checked for emptiness. Required when `orderId` is absent. |
 
 Validation failures fire `onSdkError` with `type: "validation_error"` and the relevant `field` name. `start()` returns `false`.
 
-## 🔄 Migration from v2
+Providing both `orderId` and `subscriptionId` (or neither) also fires `onSdkError`.
+
+## Migration from v2
 
 v3 replaces the LRS-only `GlomoLrsCheckout` with a unified `GlomoCheckout`.
 
@@ -345,15 +411,17 @@ v3 replaces the LRS-only `GlomoLrsCheckout` with a unified `GlomoCheckout`.
 - **New statuses**: `bank_transfer_submitted` and `pay_via_bank_completed` are new additions to `CheckoutStatus`.
 - **New callbacks**: `onBankTransferSubmitted`, `onPayViaBankCompleted`, and `onUserRefusedCameraPermissions` are available.
 
-For the full list of changes, see [CHANGELOG.md](./CHANGELOG.md).
+See MIGRATION.md included in this package for a standalone migration guide with before/after code examples.
 
-## 🚨 Troubleshooting
+## Troubleshooting
 
 ### `start()` returns `false`
 
 Check `onSdkError` for details. Common causes:
 - Invalid `publicKey` format (must start with `live_`, `mock_`, or `test_`)
 - Invalid `orderId` format (must start with `order_`)
+- Invalid `subscriptionId` format (must start with `sub_`, non-empty after trimming)
+- Both `orderId` and `subscriptionId` provided (or neither)
 - Device is rooted/jailbroken (when `jail-monkey` is installed)
 
 ### Checkout opens but shows a blank screen
@@ -370,12 +438,15 @@ Check `onSdkError` for details. Common causes:
 
 - Ensure you are passing `onPayViaBankCompleted` as a prop to `GlomoCheckout`
 
-## 🔍 Exports
+## Exports
 
 ```ts
-// Component
+// Components
 export { GlomoCheckout } from "@glomopay/react-native-sdk";
 
+// Hooks (deprecated - use GlomoCheckout component with ref instead)
+export { useGlomoCheckout } from "@glomopay/react-native-sdk";
+
 // Types
 export type {
   GlomoCheckoutRef,
@@ -384,18 +455,28 @@ export type {
   CheckoutStatus,
   GlomoBankTransferPayload,
   GlomoPayViaBankConnectionPayload,
+  UseGlomoCheckoutReturn,  // deprecated
   SdkError,
 } from "@glomopay/react-native-sdk";
-
-// Hook (advanced usage)
-export { useGlomoCheckout } from "@glomopay/react-native-sdk";
 ```
 
-## 💬 Support
+## Security
+
+The SDK loads checkout pages in an isolated WebView. No PAN, CVV, or sensitive payment data passes through the React Native bridge - all sensitive input is handled within the WebView's sandboxed context.
+
+Device integrity checking is available via optional `jail-monkey` integration (see [Device Security Compliance](#device-security-compliance)).
+
+To report a security vulnerability, email security@glomopay.com. Do not open a public GitHub issue for security reports.
+
+## Contributing
+
+This SDK is maintained by GlomoPay. We do not accept external contributions at this time.
+
+## Support
 
 - GitHub Issues: https://github.com/glomopay/glomopay-rn-sdk/issues
 - Email: developer@glomopay.com
 
-## 📄 License
+## License
 
 Apache-2.0. See [LICENSE](LICENSE) for details.

package/lib/glomo-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glomo-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-checkout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA0C,MAAM,OAAO,CAAC;AAG/D,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AA8DlF,eAAO,MAAM,aAAa,6FAA2E,CAAC"}
+{"version":3,"file":"glomo-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-checkout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAsE,MAAM,OAAO,CAAC;AAG3F,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAwIlF,eAAO,MAAM,aAAa,6FAA2E,CAAC"}

package/lib/glomo-checkout.js

@@ -40,16 +40,49 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GlomoCheckout = void 0;
 const react_1 = __importStar(require("react"));
 const use_glomo_checkout_1 = require("./use-glomo-checkout");
+const analytics_1 = require("./utils/analytics");
 const glomo_lrs_checkout_1 = require("./glomo-lrs-checkout");
 const glomo_standard_checkout_1 = require("./glomo-standard-checkout");
+const glomo_subscriptions_checkout_1 = require("./glomo-subscriptions-checkout");
 function GlomoCheckoutComponent(props, ref) {
+    var _a;
     // useGlomoCheckout handles order type detection and exposes start/getStatus for the ref
-    const { orderType, start, getStatus, innerLrsRef, innerStandardRef, props: passedProps } = (0, use_glomo_checkout_1.useGlomoCheckout)(props);
+    const { orderType, start, getStatus, innerLrsRef, innerStandardRef, innerSubscriptionsRef, props: passedProps, } = (0, use_glomo_checkout_1.useGlomoCheckout)(props, { _suppressDeprecationWarning: true });
     // Exposing start() and getStatus() via the forwarded ref for the merchant to call
     (0, react_1.useImperativeHandle)(ref, () => ({
         start,
         getStatus,
     }));
+    // Tracking unsupported callback props on subscription flows (fires once per mount)
+    const hasTrackedUnsupportedRef = (0, react_1.useRef)(false);
+    const devMode = (_a = passedProps.devMode) !== null && _a !== void 0 ? _a : false;
+    const mockMode = (0, react_1.useMemo)(() => { var _a, _b; return (_b = (_a = passedProps.publicKey) === null || _a === void 0 ? void 0 : _a.toLowerCase().startsWith("test_")) !== null && _b !== void 0 ? _b : false; }, [passedProps.publicKey]);
+    // Extracting stable booleans for the tracking effect to avoid depending on passedProps object
+    const hasBankTransferCallback = !!passedProps.onBankTransferSubmitted;
+    const hasPayViaBankCallback = !!passedProps.onPayViaBankCompleted;
+    const hasBankConnectionCallback = !!passedProps.onPayViaBankBankConnectionSuccessful;
+    (0, react_1.useEffect)(() => {
+        if (orderType !== "subscriptions" || hasTrackedUnsupportedRef.current)
+            return;
+        hasTrackedUnsupportedRef.current = true;
+        const unsupported = [
+            hasBankTransferCallback && "onBankTransferSubmitted",
+            hasPayViaBankCallback && "onPayViaBankCompleted",
+            hasBankConnectionCallback && "onPayViaBankBankConnectionSuccessful",
+        ].filter(Boolean);
+        for (const name of unsupported) {
+            (0, analytics_1.trackUseOfUnsupportedFunctionality)(name, passedProps.subscriptionId, passedProps.publicKey, devMode, mockMode, "");
+        }
+    }, [
+        orderType,
+        hasBankTransferCallback,
+        hasPayViaBankCallback,
+        hasBankConnectionCallback,
+        passedProps.subscriptionId,
+        passedProps.publicKey,
+        devMode,
+        mockMode,
+    ]);
     // Delegating to the LRS checkout component once order type is resolved as LRS
     if (orderType === "lrs") {
         return (<glomo_lrs_checkout_1.GlomoLrsCheckout ref={innerLrsRef} server={passedProps.server} publicKey={passedProps.publicKey} orderId={passedProps.orderId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} devMode={passedProps.devMode}/>);
@@ -58,6 +91,10 @@ function GlomoCheckoutComponent(props, ref) {
     if (orderType === "standard") {
         return (<glomo_standard_checkout_1.GlomoStandardCheckout ref={innerStandardRef} server={passedProps.server} publicKey={passedProps.publicKey} orderId={passedProps.orderId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} onBankTransferSubmitted={passedProps.onBankTransferSubmitted} onPayViaBankCompleted={passedProps.onPayViaBankCompleted} onPayViaBankBankConnectionSuccessful={passedProps.onPayViaBankBankConnectionSuccessful} onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions} devMode={passedProps.devMode}/>);
     }
+    // Delegating to the Subscriptions checkout component when subscriptionId is provided (no API call)
+    if (orderType === "subscriptions") {
+        return (<glomo_subscriptions_checkout_1.GlomoSubscriptionsCheckout ref={innerSubscriptionsRef} server={passedProps.server} publicKey={passedProps.publicKey} subscriptionId={passedProps.subscriptionId} onPaymentSuccess={passedProps.onPaymentSuccess} onPaymentFailure={passedProps.onPaymentFailure} onConnectionError={passedProps.onConnectionError} onPaymentTerminate={passedProps.onPaymentTerminate} onSdkError={passedProps.onSdkError} onPayViaBankBankConnectionSuccessful={passedProps.onPayViaBankBankConnectionSuccessful} onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions} devMode={passedProps.devMode}/>);
+    }
     /**
      * No modal for detecting state - avoids iOS pageSheet conflict where
      * dismissing the detecting modal interferes with the checkout modal presentation.

package/lib/glomo-standard-checkout.d.ts

@@ -1,5 +1,25 @@
 /** The GlomoPay Standard Checkout Component */
 import React from "react";
 import { type GlomoStandardCheckoutRef, type GlomoStandardCheckoutProps } from "./types/standard-checkout";
+import { type CheckoutAnalyticsTrackers } from "./utils/analytics";
+/**
+ * Internal-only props for GlomoStandardCheckout.
+ * Used by GlomoSubscriptionsCheckout to inject subscription analytics trackers.
+ * Not exported to merchants via index.ts.
+ */
+export interface GlomoStandardCheckoutInternalProps extends GlomoStandardCheckoutProps {
+    _analyticsTrackers?: CheckoutAnalyticsTrackers;
+    _skipOrderIdValidation?: boolean;
+}
+/**
+ * Widening the internal type to GlomoStandardCheckoutInternalProps for internal SDK use,
+ * then narrowing the public export to GlomoStandardCheckoutProps so merchants cannot
+ * pass internal-only props like _analyticsTrackers.
+ */
 export declare const GlomoStandardCheckout: React.ForwardRefExoticComponent<GlomoStandardCheckoutProps & React.RefAttributes<GlomoStandardCheckoutRef>>;
+/**
+ * Internal reference - accepts GlomoStandardCheckoutInternalProps.
+ * Not re-exported from index.ts.
+ */
+export declare const GlomoStandardCheckoutInternal: React.ForwardRefExoticComponent<GlomoStandardCheckoutInternalProps & React.RefAttributes<GlomoStandardCheckoutRef>>;
 //# sourceMappingURL=glomo-standard-checkout.d.ts.map

package/lib/glomo-standard-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glomo-standard-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-standard-checkout.tsx"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAiQ3G,eAAO,MAAM,qBAAqB,6GAEjC,CAAC"}
+{"version":3,"file":"glomo-standard-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-standard-checkout.tsx"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC3G,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGnE;;;;GAIG;AACH,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B;IAClF,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC;AAmQD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAiD,KAAK,CAAC,yBAAyB,CAC9G,0BAA0B,GAAG,KAAK,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAC7E,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,qHAEzC,CAAC"}

package/lib/glomo-standard-checkout.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GlomoStandardCheckout = void 0;
+exports.GlomoStandardCheckoutInternal = exports.GlomoStandardCheckout = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const react_native_webview_1 = require("react-native-webview");
@@ -57,7 +57,7 @@ const validation_1 = require("./utils/validation");
  * @param ref - The ref for the component
  * @param devMode - Turn on to see all logs, warnings, and errors in the console. Off by default
  */
-function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode = false, }, ref) {
+function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onBankTransferSubmitted, onPayViaBankCompleted, onPayViaBankBankConnectionSuccessful, onUserRefusedCameraPermissions, devMode = false, _analyticsTrackers, _skipOrderIdValidation, }, ref) {
     // Computing mockMode based on the publicKey prefix
     const mockMode = (0, react_1.useMemo)(() => {
         var _a;
@@ -81,7 +81,7 @@ function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentS
         onPayViaBankBankConnectionSuccessful,
         onUserRefusedCameraPermissions,
         devMode,
-    }, mockMode);
+    }, mockMode, { analyticsTrackers: _analyticsTrackers, _skipOrderIdValidation });
     // Exposing the start() and getStatus() methods via the ref
     (0, react_1.useImperativeHandle)(ref, () => ({
         start,
@@ -160,8 +160,19 @@ function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentS
             </react_native_1.View>
         </ModalComponent>);
 }
+/**
+ * Widening the internal type to GlomoStandardCheckoutInternalProps for internal SDK use,
+ * then narrowing the public export to GlomoStandardCheckoutProps so merchants cannot
+ * pass internal-only props like _analyticsTrackers.
+ */
 exports.GlomoStandardCheckout = (0, react_1.forwardRef)(GlomoStandardCheckoutComponent);
 exports.GlomoStandardCheckout.displayName = "GlomoStandardCheckout";
+/**
+ * Internal reference - accepts GlomoStandardCheckoutInternalProps.
+ * Not re-exported from index.ts.
+ */
+exports.GlomoStandardCheckoutInternal = (0, react_1.forwardRef)(GlomoStandardCheckoutComponent);
+exports.GlomoStandardCheckoutInternal.displayName = "GlomoStandardCheckoutInternal";
 const styles = react_native_1.StyleSheet.create({
     modalContainer: {
         flex: 1,

package/lib/glomo-subscriptions-checkout.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GlomoSubscriptionsCheckout - thin wrapper around GlomoStandardCheckout
+ * that accepts a subscriptionId (sub_*) instead of an orderId (order_*).
+ */
+import React from "react";
+import { type GlomoSubscriptionsCheckoutProps, type GlomoSubscriptionsCheckoutRef } from "./types/subscriptions-checkout";
+export declare const GlomoSubscriptionsCheckout: React.ForwardRefExoticComponent<GlomoSubscriptionsCheckoutProps & React.RefAttributes<GlomoSubscriptionsCheckoutRef>>;
+//# sourceMappingURL=glomo-subscriptions-checkout.d.ts.map

package/lib/glomo-subscriptions-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glomo-subscriptions-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-subscriptions-checkout.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA6D,MAAM,OAAO,CAAC;AAIlF,OAAO,EACH,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EACrC,MAAM,gCAAgC,CAAC;AAkExC,eAAO,MAAM,0BAA0B,uHAEtC,CAAC"}

package/lib/glomo-subscriptions-checkout.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * GlomoSubscriptionsCheckout - thin wrapper around GlomoStandardCheckout
+ * that accepts a subscriptionId (sub_*) instead of an orderId (order_*).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlomoSubscriptionsCheckout = void 0;
+const react_1 = __importStar(require("react"));
+const glomo_standard_checkout_1 = require("./glomo-standard-checkout");
+const analytics_1 = require("./utils/analytics");
+const validation_1 = require("./utils/validation");
+function GlomoSubscriptionsCheckoutComponent(props, ref) {
+    const { subscriptionId: rawSubscriptionId, onSdkError, devMode = false, ...rest } = props;
+    const innerRef = (0, react_1.useRef)(null);
+    const onSdkErrorRef = (0, react_1.useRef)(onSdkError);
+    onSdkErrorRef.current = onSdkError;
+    const subscriptionId = rawSubscriptionId.trim();
+    /** Validating subscriptionId - firing onSdkError via useEffect to avoid side effects during render */
+    const validationError = (() => {
+        if (subscriptionId.length === 0) {
+            return "subscriptionId must not be empty";
+        }
+        if (!subscriptionId.startsWith("sub_")) {
+            return "subscriptionId must start with 'sub_'";
+        }
+        return null;
+    })();
+    (0, react_1.useEffect)(() => {
+        if (validationError) {
+            (0, validation_1.safeCallback)(onSdkErrorRef.current, [[{ type: "validation_error", message: validationError }]], "onSdkError", devMode);
+        }
+    }, [validationError, devMode]);
+    (0, react_1.useImperativeHandle)(ref, () => ({
+        start: () => {
+            var _a, _b;
+            if (validationError) {
+                return false;
+            }
+            return (_b = (_a = innerRef.current) === null || _a === void 0 ? void 0 : _a.start()) !== null && _b !== void 0 ? _b : false;
+        },
+        getStatus: () => {
+            var _a, _b;
+            return (_b = (_a = innerRef.current) === null || _a === void 0 ? void 0 : _a.getStatus()) !== null && _b !== void 0 ? _b : "ready";
+        },
+    }));
+    if (validationError) {
+        return null;
+    }
+    return (<glomo_standard_checkout_1.GlomoStandardCheckoutInternal ref={innerRef} {...rest} orderId={subscriptionId} onSdkError={onSdkError} devMode={devMode} _analyticsTrackers={analytics_1.subscriptionCheckoutTrackers} _skipOrderIdValidation={true}/>);
+}
+exports.GlomoSubscriptionsCheckout = (0, react_1.forwardRef)(GlomoSubscriptionsCheckoutComponent);
+exports.GlomoSubscriptionsCheckout.displayName = "GlomoSubscriptionsCheckout";