@glomopay/react-native-sdk 3.1.0 → 4.0.0

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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).
 
+## [4.0.0] - 2026-06-11
+
+### Breaking Changes
+
+- **Consolidated async payment callbacks**: `onBankTransferSubmitted` and `onPayViaBankCompleted` have been replaced by a single `onUserJourneyCompleted` callback. The new callback receives a `GlomoUserJourneyCompletedPayload` with a `journeyType` field from the `ASYNC_PAYMENT_EVENTS` enum.
+- **Removed `onPayViaBankBankConnectionSuccessful`**: This informational callback has been removed. It may be reintroduced in a future version if merchant demand warrants it.
+- **Removed types**: `GlomoBankTransferPayload` and `GlomoPayViaBankConnectionPayload` are no longer exported.
+- **`onSdkError` is now required**: Previously optional, `onSdkError` must now be provided. This ensures validation errors, device compliance failures, and configuration issues are handled properly.
+
+### Added
+
+- **`ASYNC_PAYMENT_EVENTS` enum**: Enumeration of asynchronous payment event types (`BANK_TRANSFER_SUBMITTED`, `PAY_VIA_BANK_COMPLETED`).
+- **`GlomoUserJourneyCompletedPayload` type**: Flat payload interface with `journeyType`, `orderId?`, `status?`, `senderAccountNumber?`, `transactionReference?`.
+- **`onUserJourneyCompleted` callback**: Single callback for all asynchronous payment flow completions.
+
+### Unchanged
+
+- `CheckoutStatus` values `bank_transfer_submitted` and `pay_via_bank_completed` remain for granular `getStatus()` state checks.
+
 ## [3.1.0] - 2026-06-08
 
 ### Added
@@ -74,6 +93,8 @@ Checkout flows with camera-based bank authentication require native permissions:
 
 These are only required for flows that use camera-based bank authentication.
 
-## [2.0.2]
+## [2.0.2] - 2025-11-26
+
+Private v2 release candidate with experimental features. Not available for general use.
 
-Last v2 release.
+Backwards compatible with `v1.x`

package/MIGRATION.md

@@ -1,5 +1,84 @@
 # Migration Guide
 
+## v3 to v4
+
+v4 consolidates the asynchronous payment flow callbacks into a single generic callback.
+
+### Removed Callbacks
+
+| v3 | v4 |
+|---|---|
+| `onBankTransferSubmitted` | Use `onUserJourneyCompleted` with `journeyType: ASYNC_PAYMENT_EVENTS.BANK_TRANSFER_SUBMITTED` |
+| `onPayViaBankCompleted` | Use `onUserJourneyCompleted` with `journeyType: ASYNC_PAYMENT_EVENTS.PAY_VIA_BANK_COMPLETED` |
+| `onPayViaBankBankConnectionSuccessful` | Removed (no replacement) |
+
+### Removed Types
+
+| v3 | v4 |
+|---|---|
+| `GlomoBankTransferPayload` | Use `GlomoUserJourneyCompletedPayload` |
+| `GlomoPayViaBankConnectionPayload` | Removed |
+
+### New Types
+
+| Type | Purpose |
+|---|---|
+| `ASYNC_PAYMENT_EVENTS` | Enum of asynchronous payment event types |
+| `GlomoUserJourneyCompletedPayload` | Payload for `onUserJourneyCompleted` callback |
+
+### `onSdkError` is now required
+
+`onSdkError` was optional in v3. In v4 it is required. If you were not passing it, add it:
+
+```tsx
+onSdkError={(errors) => {
+  errors.forEach((e) => console.error(e.type, e.message, e.field));
+}}
+```
+
+### Unchanged
+
+- `CheckoutStatus` values `bank_transfer_submitted` and `pay_via_bank_completed` remain unchanged. `getStatus()` continues to return granular status values.
+
+### Before / After
+
+**v3:**
+```tsx
+<GlomoCheckout
+  onBankTransferSubmitted={(payload) => {
+    console.log("Transfer ref:", payload?.transactionReference);
+  }}
+  onPayViaBankCompleted={(payload) => {
+    console.log("Pay via bank:", payload.status);
+  }}
+  onPayViaBankBankConnectionSuccessful={(payload) => {
+    console.log("Bank connected:", payload?.bankName);
+  }}
+  // ...other props
+/>
+```
+
+**v4:**
+```tsx
+import { ASYNC_PAYMENT_EVENTS } from "@glomopay/react-native-sdk";
+
+<GlomoCheckout
+  onUserJourneyCompleted={(payload) => {
+    switch (payload.journeyType) {
+      case ASYNC_PAYMENT_EVENTS.BANK_TRANSFER_SUBMITTED:
+        console.log("Transfer ref:", payload.transactionReference);
+        break;
+      case ASYNC_PAYMENT_EVENTS.PAY_VIA_BANK_COMPLETED:
+        console.log("Pay via bank:", payload.status);
+        break;
+    }
+  }}
+  // ...other props
+/>
+```
+
+---
+
 ## v2 to v3
 
 v3 replaces the LRS-only `GlomoLrsCheckout` with a unified `GlomoCheckout` that auto-detects order type.

package/README.md

@@ -53,6 +53,7 @@ import React, { useRef } from "react";
 import { View, Button } from "react-native";
 import {
   GlomoCheckout,
+  ASYNC_PAYMENT_EVENTS,
   type GlomoCheckoutRef,
   type GlomoCheckoutPayload,
   type SdkError,
@@ -88,14 +89,15 @@ export default function PaymentScreen() {
         onConnectionError={(error) => {
           console.log("Connection error:", error);
         }}
-        onBankTransferSubmitted={(payload) => {
-          console.log("Bank transfer submitted:", payload?.transactionReference);
-        }}
-        onPayViaBankCompleted={(payload) => {
-          console.log("Pay via bank completed:", payload.status);
-        }}
-        onPayViaBankBankConnectionSuccessful={(payload) => {
-          console.log("Bank connected:", payload?.bankName);
+        onUserJourneyCompleted={(payload) => {
+          switch (payload.journeyType) {
+            case ASYNC_PAYMENT_EVENTS.BANK_TRANSFER_SUBMITTED:
+              console.log("Bank transfer submitted:", payload.transactionReference);
+              break;
+            case ASYNC_PAYMENT_EVENTS.PAY_VIA_BANK_COMPLETED:
+              console.log("Pay via bank completed:", payload.status);
+              break;
+          }
         }}
         onUserRefusedCameraPermissions={() => {
           console.log("User refused camera - cannot proceed with bank authentication");
@@ -109,13 +111,19 @@ export default function PaymentScreen() {
 }
 ```
 
-## Breaking Changes (v3)
+## Breaking Changes (v4)
 
 - `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`)
+- `onBankTransferSubmitted` and `onPayViaBankCompleted` replaced by a single `onUserJourneyCompleted` callback
+- `onPayViaBankBankConnectionSuccessful` removed entirely
+- `GlomoBankTransferPayload` and `GlomoPayViaBankConnectionPayload` types removed
+- `onSdkError` is now **required** - previously optional, now must be provided to ensure validation and device compliance errors are always surfaced
+- New exports: `ASYNC_PAYMENT_EVENTS` enum and `GlomoUserJourneyCompletedPayload` type
+- `CheckoutStatus` values `bank_transfer_submitted` and `pay_via_bank_completed` are unchanged
 
-For migration details, see the [Migration from v2](#migration-from-v2) section below or MIGRATION.md included in this package.
+For migration details, see MIGRATION.md included in this package.
 
 ## Subscriptions Checkout
 
@@ -141,7 +149,6 @@ To process subscription payments, pass a `subscriptionId` instead of an `orderId
 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
 
@@ -150,8 +157,7 @@ When `subscriptionId` is provided:
 - **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
+- **Asynchronous payment flows** - single `onUserJourneyCompleted` callback for bank transfer and pay via bank events
 - **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
@@ -209,10 +215,8 @@ The unified checkout component. Place it in your render tree and control it via
 | `onPaymentFailure`               | `(payload: GlomoCheckoutPayload) => void`       | Yes      | Called when payment fails                                           |
 | `onConnectionError`              | `(error: unknown) => void`                      | No       | Called on network/connection errors                                 |
 | `onPaymentTerminate`             | `() => void`                                    | No       | Called when user dismisses checkout (back button or swipe)          |
-| `onSdkError`                     | `(errors: SdkError[]) => void`                  | No       | Called on validation errors or device compliance failures           |
-| `onBankTransferSubmitted`        | `(payload: GlomoBankTransferPayload \| null \| undefined) => void` | No | Called when user submits bank transfer details |
-| `onPayViaBankCompleted`          | `(payload: { status: string }) => void`         | No       | Called when pay via bank flow completes         |
-| `onPayViaBankBankConnectionSuccessful` | `(payload: GlomoPayViaBankConnectionPayload \| null \| undefined) => void` | No | Called when bank connection is established during pay via bank flow |
+| `onSdkError`                     | `(errors: SdkError[]) => void`                  | Yes      | Called on validation errors or device compliance failures           |
+| `onUserJourneyCompleted`         | `(payload: GlomoUserJourneyCompletedPayload) => void` | No | Called when an asynchronous payment flow completes (bank transfer submission, pay via bank completion). Check `payload.journeyType` to determine the 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`.
@@ -249,25 +253,24 @@ interface GlomoCheckoutPayload {
 }
 ```
 
-#### GlomoBankTransferPayload
+#### ASYNC_PAYMENT_EVENTS
 
 ```ts
-interface GlomoBankTransferPayload {
-  orderId: string;
-  senderAccountNumber: string;
-  transactionReference: string;
+enum ASYNC_PAYMENT_EVENTS {
+  BANK_TRANSFER_SUBMITTED = "bank_transfer_submitted",
+  PAY_VIA_BANK_COMPLETED = "pay_via_bank_completed",
 }
 ```
 
-#### GlomoPayViaBankConnectionPayload
+#### GlomoUserJourneyCompletedPayload
 
 ```ts
-interface GlomoPayViaBankConnectionPayload {
-  bankIdentifier: string;
-  cooldownPeriodInMinutes: number;
-  bankName: string;
-  bankImageSrc: string;
-  bankImageAlt: string;
+interface GlomoUserJourneyCompletedPayload {
+  journeyType: ASYNC_PAYMENT_EVENTS;
+  orderId?: string;
+  status?: string;
+  senderAccountNumber?: string;
+  transactionReference?: string;
 }
 ```
 
@@ -281,41 +284,34 @@ interface SdkError {
 }
 ```
 
-## Bank Transfer Support
+## Asynchronous Payment Flows
 
-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`:
+The SDK fires `onUserJourneyCompleted` when an asynchronous payment flow completes. Use `payload.journeyType` to determine which flow triggered the callback:
 
 ```tsx
-onBankTransferSubmitted={(payload) => {
-  // payload may be null/undefined if the checkout page omits it
-  console.log("Transfer ref:", payload?.transactionReference);
+onUserJourneyCompleted={(payload) => {
+  switch (payload.journeyType) {
+    case ASYNC_PAYMENT_EVENTS.BANK_TRANSFER_SUBMITTED:
+      /**
+       * User submitted bank transfer details.
+       * Relevant fields: orderId, senderAccountNumber, transactionReference
+       * Note: fields may be absent if the checkout page omits them.
+       */
+      console.log("Transfer ref:", payload.transactionReference);
+      break;
+    case ASYNC_PAYMENT_EVENTS.PAY_VIA_BANK_COMPLETED:
+      /**
+       * Pay via bank journey completed.
+       * Relevant fields: orderId, status
+       * The SDK deduplicates this event - fires only once per session.
+       */
+      console.log("Pay via bank status:", payload.status);
+      break;
+  }
 }}
 ```
 
-The checkout status transitions to `bank_transfer_submitted`.
-
-## Pay via Bank Support
-
-The SDK fires `onPayViaBankCompleted` when the pay-via-bank journey completes:
-
-```tsx
-onPayViaBankCompleted={(payload) => {
-  // payload.status - e.g. "success", "failed", "unknown"
-  console.log("Pay via bank status:", payload.status);
-}}
-```
-
-The checkout status transitions to `pay_via_bank_completed`. The SDK deduplicates this event internally - the callback fires only once per checkout session.
-
-Additionally, `onPayViaBankBankConnectionSuccessful` fires when a bank account is successfully connected when initiating a pay-via-bank checkout, before the actual payment completes. This is informational only - it does not change the checkout status. Can be used to show a "bank connected" confirmation UI if desirable, while the payment continues in the background:
-
-```tsx
-onPayViaBankBankConnectionSuccessful={(payload) => {
-  // payload may be null/undefined if the checkout page omits it
-  console.log("Connected to:", payload?.bankName);
-  console.log("Cooldown:", payload?.cooldownPeriodInMinutes, "minutes");
-}}
-```
+The checkout status transitions to `bank_transfer_submitted` or `pay_via_bank_completed` respectively. Use `getStatus()` for granular programmatic checks.
 
 ## Camera Permissions
 
@@ -391,27 +387,9 @@ Validation failures fire `onSdkError` with `type: "validation_error"` and the re
 
 Providing both `orderId` and `subscriptionId` (or neither) also fires `onSdkError`.
 
-## Migration from v2
-
-v3 replaces the LRS-only `GlomoLrsCheckout` with a unified `GlomoCheckout`.
-
-### 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.
+## Migration from v1/v3
 
-See MIGRATION.md included in this package for a standalone migration guide with before/after code examples.
+See MIGRATION.md included in this package for migration guides with before/after code examples.
 
 ## Troubleshooting
 
@@ -432,11 +410,7 @@ Check `onSdkError` for details. Common causes:
 ### Camera permission denied
 
 - Ensure `AndroidManifest.xml` and `Info.plist` include camera permission declarations
-- The `onUserRefusedCameraPermissions` callback will fire when the user denies
-
-### `onPayViaBankCompleted` not firing
-
-- Ensure you are passing `onPayViaBankCompleted` as a prop to `GlomoCheckout`
+- The `onUserRefusedCameraPermissions` callback will fire when the user denies camera permissions to your app
 
 ## Exports
 
@@ -447,14 +421,16 @@ export { GlomoCheckout } from "@glomopay/react-native-sdk";
 // Hooks (deprecated - use GlomoCheckout component with ref instead)
 export { useGlomoCheckout } from "@glomopay/react-native-sdk";
 
+// Enums
+export { ASYNC_PAYMENT_EVENTS } from "@glomopay/react-native-sdk";
+
 // Types
 export type {
   GlomoCheckoutRef,
   GlomoCheckoutProps,
   GlomoCheckoutPayload,
   CheckoutStatus,
-  GlomoBankTransferPayload,
-  GlomoPayViaBankConnectionPayload,
+  GlomoUserJourneyCompletedPayload,
   UseGlomoCheckoutReturn,  // deprecated
   SdkError,
 } from "@glomopay/react-native-sdk";
@@ -462,19 +438,12 @@ export type {
 
 ## 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.
+To report a security vulnerability, email security@glomopay.com.
 
 ## Support
 
-- GitHub Issues: https://github.com/glomopay/glomopay-rn-sdk/issues
 - Email: developer@glomopay.com
 
 ## License

package/lib/glomo-checkout.d.ts

@@ -1,6 +1,7 @@
 /**
- * The unified GlomoPay Checkout Component (v3).
+ * The unified GlomoPay Checkout Component (v4).
  * Detects order type (LRS vs Standard) and delegates rendering to the appropriate inner component.
+ * Enforces error handling via `onSdkError()` as a mandatory prop.
  */
 import React from "react";
 import { type GlomoCheckoutRef, type GlomoCheckoutProps } from "./types/checkout";

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,KAAsE,MAAM,OAAO,CAAC;AAG3F,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAwIlF,eAAO,MAAM,aAAa,6FAA2E,CAAC"}
+{"version":3,"file":"glomo-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-checkout.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAsE,MAAM,OAAO,CAAC;AAG3F,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAqHlF,eAAO,MAAM,aAAa,6FAA2E,CAAC"}

package/lib/glomo-checkout.js

@@ -1,7 +1,8 @@
 "use strict";
 /**
- * The unified GlomoPay Checkout Component (v3).
+ * The unified GlomoPay Checkout Component (v4).
  * Detects order type (LRS vs Standard) and delegates rendering to the appropriate inner component.
+ * Enforces error handling via `onSdkError()` as a mandatory prop.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -57,43 +58,27 @@ function GlomoCheckoutComponent(props, ref) {
     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;
+    // Extracting stable boolean for the tracking effect to avoid depending on passedProps object
+    const hasUserJourneyCallback = !!passedProps.onUserJourneyCompleted;
     (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, "");
+        if (hasUserJourneyCallback) {
+            (0, analytics_1.trackUseOfUnsupportedFunctionality)("onUserJourneyCompleted", passedProps.subscriptionId, passedProps.publicKey, devMode, mockMode, "");
         }
-    }, [
-        orderType,
-        hasBankTransferCallback,
-        hasPayViaBankCallback,
-        hasBankConnectionCallback,
-        passedProps.subscriptionId,
-        passedProps.publicKey,
-        devMode,
-        mockMode,
-    ]);
+    }, [orderType, hasUserJourneyCallback, 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}/>);
     }
     // Delegating to the Standard checkout component once order type is resolved as Standard
     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}/>);
+        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} onUserJourneyCompleted={passedProps.onUserJourneyCompleted} 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}/>);
+        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} onUserJourneyCompleted={passedProps.onUserJourneyCompleted} onUserRefusedCameraPermissions={passedProps.onUserRefusedCameraPermissions} devMode={passedProps.devMode}/>);
     }
     /**
      * No modal for detecting state - avoids iOS pageSheet conflict where

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

@@ -4,7 +4,7 @@ import { type UseLrsCheckoutOptions, type LrsCheckoutStatus } from "./use-lrs-ch
 import { type SdkError } from "./utils/analytics";
 export interface GlomoLrsCheckoutProps extends UseLrsCheckoutOptions {
     visible?: boolean;
-    onSdkError?: (error: Array<SdkError>) => void;
+    onSdkError: (error: Array<SdkError>) => void;
 }
 export interface GlomoLrsCheckoutRef {
     start: () => boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"glomo-lrs-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-lrs-checkout.tsx"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,iBAAiB,CAAC;CACtC;AA2WD,eAAO,MAAM,gBAAgB,mGAAoF,CAAC"}
+{"version":3,"file":"glomo-lrs-checkout.d.ts","sourceRoot":"","sources":["../src/glomo-lrs-checkout.tsx"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,iBAAiB,CAAC;CACtC;AA2WD,eAAO,MAAM,gBAAgB,mGAAoF,CAAC"}

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;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"}
+{"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;AA+PD;;;;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

@@ -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, _analyticsTrackers, _skipOrderIdValidation, }, ref) {
+function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentSuccess, onPaymentFailure, onConnectionError, onPaymentTerminate, onSdkError, onUserJourneyCompleted, onUserRefusedCameraPermissions, devMode = false, _analyticsTrackers, _skipOrderIdValidation, }, ref) {
     // Computing mockMode based on the publicKey prefix
     const mockMode = (0, react_1.useMemo)(() => {
         var _a;
@@ -76,9 +76,7 @@ function GlomoStandardCheckoutComponent({ server, publicKey, orderId, onPaymentS
         onConnectionError,
         onPaymentTerminate,
         onSdkError,
-        onBankTransferSubmitted,
-        onPayViaBankCompleted,
-        onPayViaBankBankConnectionSuccessful,
+        onUserJourneyCompleted,
         onUserRefusedCameraPermissions,
         devMode,
     }, mockMode, { analyticsTrackers: _analyticsTrackers, _skipOrderIdValidation });

package/lib/index.d.ts

@@ -1,6 +1,6 @@
-/** The GlomoPay RN SDK v3 exports */
+/** The GlomoPay RN SDK v4 exports */
 export { GlomoCheckout } from "./glomo-checkout";
-export { type GlomoCheckoutRef, type GlomoCheckoutProps, type GlomoCheckoutPayload, type CheckoutStatus, type GlomoBankTransferPayload, type GlomoPayViaBankConnectionPayload, } from "./types/checkout";
+export { type GlomoCheckoutRef, type GlomoCheckoutProps, type GlomoCheckoutPayload, type CheckoutStatus, type GlomoUserJourneyCompletedPayload, ASYNC_PAYMENT_EVENTS, } from "./types/checkout";
 export { type GlomoServer } from "./config/base";
 export { type SdkError } from "./utils/analytics";
 export { useGlomoCheckout, type UseGlomoCheckoutReturn } from "./use-glomo-checkout";

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,GACxC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,gCAAgC,EACrC,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/index.js

@@ -1,9 +1,11 @@
 "use strict";
-/** The GlomoPay RN SDK v3 exports */
+/** The GlomoPay RN SDK v4 exports */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useGlomoCheckout = exports.GlomoCheckout = void 0;
-// v3 public API - unified checkout
+exports.useGlomoCheckout = exports.ASYNC_PAYMENT_EVENTS = exports.GlomoCheckout = void 0;
+// v4 public API - unified checkout
 var glomo_checkout_1 = require("./glomo-checkout");
 Object.defineProperty(exports, "GlomoCheckout", { enumerable: true, get: function () { return glomo_checkout_1.GlomoCheckout; } });
+var checkout_1 = require("./types/checkout");
+Object.defineProperty(exports, "ASYNC_PAYMENT_EVENTS", { enumerable: true, get: function () { return checkout_1.ASYNC_PAYMENT_EVENTS; } });
 var use_glomo_checkout_1 = require("./use-glomo-checkout");
 Object.defineProperty(exports, "useGlomoCheckout", { enumerable: true, get: function () { return use_glomo_checkout_1.useGlomoCheckout; } });

package/lib/types/checkout.d.ts

@@ -1,4 +1,4 @@
-/** Unified v3 type definitions for GlomoCheckout */
+/** Unified v4 type definitions for GlomoCheckout */
 import { type GlomoServer } from "../config/base";
 import { type SdkError } from "../utils/analytics";
 /** The payload for a successful or failed payment (unified across LRS and standard) */
@@ -7,19 +7,22 @@ export interface GlomoCheckoutPayload {
     paymentId: string;
     signature: string;
 }
-/** The payload for a bank transfer submission */
-export interface GlomoBankTransferPayload {
-    orderId: string;
-    senderAccountNumber: string;
-    transactionReference: string;
+/**
+ * Enum of asynchronous payment events that trigger the
+ * onUserJourneyCompleted callback. New events will be added
+ * here as additional flows are supported.
+ */
+export declare enum ASYNC_PAYMENT_EVENTS {
+    BANK_TRANSFER_SUBMITTED = "bank_transfer_submitted",
+    PAY_VIA_BANK_COMPLETED = "pay_via_bank_completed"
 }
-/** The payload for a pay via bank - bank connection successful event */
-export interface GlomoPayViaBankConnectionPayload {
-    bankIdentifier: string;
-    cooldownPeriodInMinutes: number;
-    bankName: string;
-    bankImageSrc: string;
-    bankImageAlt: string;
+/** The payload for the onUserJourneyCompleted callback */
+export interface GlomoUserJourneyCompletedPayload {
+    journeyType: ASYNC_PAYMENT_EVENTS;
+    orderId?: string;
+    status?: string;
+    senderAccountNumber?: string;
+    transactionReference?: string;
 }
 /** Unified checkout statuses - superset of LRS + standard statuses */
 export type CheckoutStatus = "ready" | "detecting_order_type" | "payment_in_progress" | "payment_successful" | "payment_failed" | "payment_cancelled" | "bank_transfer_submitted" | "pay_via_bank_completed";
@@ -40,12 +43,8 @@ interface GlomoCheckoutBaseProps {
     onPaymentFailure: (payload: GlomoCheckoutPayload) => void;
     onConnectionError?: (error: unknown) => void;
     onPaymentTerminate?: () => void;
-    onSdkError?: (error: Array<SdkError>) => void;
-    onBankTransferSubmitted?: (payload: GlomoBankTransferPayload | null | undefined) => void;
-    onPayViaBankCompleted?: (payload: {
-        status: string;
-    }) => void;
-    onPayViaBankBankConnectionSuccessful?: (payload: GlomoPayViaBankConnectionPayload | null | undefined) => void;
+    onSdkError: (error: Array<SdkError>) => void;
+    onUserJourneyCompleted?: (payload: GlomoUserJourneyCompletedPayload) => void;
     onUserRefusedCameraPermissions?: () => void;
     devMode?: boolean;
 }

package/lib/types/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/types/checkout.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,wEAAwE;AACxE,MAAM,WAAW,gCAAgC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,MAAM,cAAc,GACpB,OAAO,GACP,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;CACnC;AAED,iFAAiF;AACjF,UAAU,sBAAsB;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC9C,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IACzF,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9D,oCAAoC,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9G,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GACnD,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/types/checkout.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,oBAAY,oBAAoB;IAC5B,uBAAuB,4BAA4B;IACnD,sBAAsB,2BAA2B;CACpD;AAED,0DAA0D;AAC1D,MAAM,WAAW,gCAAgC;IAC7C,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,sEAAsE;AACtE,MAAM,MAAM,cAAc,GACpB,OAAO,GACP,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,cAAc,CAAC;CACnC;AAED,iFAAiF;AACjF,UAAU,sBAAsB;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC7C,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gCAAgC,KAAK,IAAI,CAAC;IAC7E,8BAA8B,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GACnD,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC"}

package/lib/types/checkout.js

@@ -1,3 +1,14 @@
 "use strict";
-/** Unified v3 type definitions for GlomoCheckout */
+/** Unified v4 type definitions for GlomoCheckout */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASYNC_PAYMENT_EVENTS = void 0;
+/**
+ * Enum of asynchronous payment events that trigger the
+ * onUserJourneyCompleted callback. New events will be added
+ * here as additional flows are supported.
+ */
+var ASYNC_PAYMENT_EVENTS;
+(function (ASYNC_PAYMENT_EVENTS) {
+    ASYNC_PAYMENT_EVENTS["BANK_TRANSFER_SUBMITTED"] = "bank_transfer_submitted";
+    ASYNC_PAYMENT_EVENTS["PAY_VIA_BANK_COMPLETED"] = "pay_via_bank_completed";
+})(ASYNC_PAYMENT_EVENTS || (exports.ASYNC_PAYMENT_EVENTS = ASYNC_PAYMENT_EVENTS = {}));