@morefin/cashier-bootstrapper 0.3.3 → 0.3.5

package/README.md

@@ -37,11 +37,12 @@ new CashierBootstrapper('#cashier-root', {
     terminalId: 'terminal-456',
     userId: 'user-789',
     sessionId: 'session-abc',
+    locale: 'sv_SE',
+    channel: 'ios',
     predefinedAmounts: [100, 200, 300],
     layout: 'default',
     transactionType: ('deposit'|'withdrawal'),
     attributes: {
-      channel: 'web',
       campaign: 'spring-launch',
       isVip: true
     }
@@ -62,7 +63,9 @@ new CashierBootstrapper('#cashier-root', {
 });
 ```
 
-`requestParams.attributes` sends custom cashier data as the `attributes` query parameter. Use it for values the cashier should receive as part of the request payload.
+`requestParams.channel` selects the cashier payment method order channel. Supported values are `windows`, `mac`, `ios`, `android`, and `other`; when omitted, the bootstrapper derives it from the user device.
+
+`requestParams.attributes` sends custom cashier data as the `attributes` query parameter. Use it for values the cashier should receive as part of the request payload. It does not control payment method ordering.
 
 `properties.iframe.attributes` applies plain HTML attributes directly to the rendered `<iframe>`. Use it for DOM concerns such as `data-*`, `loading`, or other iframe element attributes.
 
@@ -150,12 +153,16 @@ interface CashierRequestParams {
   terminalId?: string;
   userId?: string;
   sessionId?: string;
+  locale?: string;
+  channel?: CashierRuntimeChannel | string;
   predefinedAmounts?: number[];
   layout?: string;
   transactionType?: string;
   attributes?: Record<string, unknown>;
 }
 
+type CashierRuntimeChannel = 'windows' | 'mac' | 'ios' | 'android' | 'other';
+
 type CashierEnvironment = 'production' | 'uat';
 
 interface CashierIframeOptions {

package/dist/example-usage.js

@@ -18,6 +18,7 @@ export function example2(container) {
             terminalId: 'terminal-456',
             userId: 'user-789',
             sessionId: 'session-abc',
+            locale: 'sv_SE',
             predefinedAmounts: [100, 200, 300],
             layout: 'default'
         },
@@ -46,6 +47,7 @@ export function example4(container) {
             merchantId: 'merchant-123',
             terminalId: 'terminal-456',
             userId: 'user-789',
+            locale: 'sv_SE',
             predefinedAmounts: [100, 200, 300],
             layout: 'default'
         },

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { CashierIframeApi, CashierIframeConfig } from './types';
-export type { CashierCallbacks, CashierEnvironment, CashierRequestParams, CashierIframeApi, CashierIframeConfig, CashierIframeProperties, CashierResultCallbackPayload, CashierRedirectPayload, CashierValidationFailedPayload } from './types';
+export type { CashierCallbacks, CashierEnvironment, CashierRequestParams, CashierRuntimeChannel, CashierIframeApi, CashierIframeConfig, CashierIframeProperties, CashierResultCallbackPayload, CashierRedirectPayload, CashierValidationFailedPayload } from './types';
 type FingerprintJSGlobal = {
     load: () => Promise<{
         get: () => Promise<{

package/dist/index.js

@@ -6,6 +6,7 @@ const TOP_URL_REPLACE_EVENT = 'TOP_URL_REPLACE';
 const CASHIER_IFRAME_OVERLAY_CLOSE_EVENT = 'CASHIER_IFRAME_OVERLAY_CLOSE';
 const CASHIER_RESULT_EVENT = 'CASHIER_RESULT';
 const CASHIER_VALIDATION_FAILED_EVENT = 'CASHIER_VALIDATION_FAILED';
+const CASHIER_RUNTIME_CHANNELS = ['windows', 'mac', 'ios', 'android', 'other'];
 const CASHIER_ENVIRONMENT_CONFIG = {
     production: {
         host: 'https://api.morefin.com',
@@ -64,6 +65,37 @@ async function generateFingerprint() {
         return undefined;
     }
 }
+function normalizeRuntimeChannel(channel) {
+    if (channel == null) {
+        return undefined;
+    }
+    const normalized = channel.trim().toLowerCase();
+    return CASHIER_RUNTIME_CHANNELS.includes(normalized)
+        ? normalized
+        : undefined;
+}
+function detectRuntimeChannel() {
+    if (typeof navigator === 'undefined') {
+        return undefined;
+    }
+    const userAgent = `${navigator.userAgent ?? ''} ${navigator.appVersion ?? ''}`.toLowerCase();
+    if (userAgent.includes('android')) {
+        return 'android';
+    }
+    if (userAgent.includes('iphone') || userAgent.includes('ipad') || userAgent.includes('ipod')) {
+        return 'ios';
+    }
+    if (userAgent.includes('windows')) {
+        return 'windows';
+    }
+    if (userAgent.includes('mac')) {
+        return 'mac';
+    }
+    return 'other';
+}
+function resolveRuntimeChannel(channel) {
+    return channel == null ? detectRuntimeChannel() : normalizeRuntimeChannel(channel);
+}
 function buildQueryString(requestParams, fingerprint) {
     const query = new URLSearchParams();
     if (requestParams.merchantId != null) {
@@ -78,6 +110,13 @@ function buildQueryString(requestParams, fingerprint) {
     if (requestParams.sessionId != null) {
         query.append('sessionId', String(requestParams.sessionId));
     }
+    if (requestParams.locale != null && requestParams.locale !== '' && requestParams.locale !== 'undefined') {
+        query.append('locale', String(requestParams.locale));
+    }
+    const channel = resolveRuntimeChannel(requestParams.channel);
+    if (channel) {
+        query.append('channel', channel);
+    }
     if (Array.isArray(requestParams.predefinedAmounts)) {
         requestParams.predefinedAmounts.forEach(amount => {
             query.append('predefinedAmounts', String(amount));

package/dist/types.d.ts

@@ -6,11 +6,14 @@ export interface CashierRequestParams {
     terminalId?: string;
     userId?: string;
     sessionId?: string;
+    locale?: string;
+    channel?: CashierRuntimeChannel | string;
     predefinedAmounts?: number[];
     layout?: string;
     transactionType?: string;
     attributes?: Record<string, unknown>;
 }
+export type CashierRuntimeChannel = 'windows' | 'mac' | 'ios' | 'android' | 'other';
 export type CashierEnvironment = 'production' | 'uat' | 'local' | 'local4200';
 /**
  * Bootstrap properties configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morefin/cashier-bootstrapper",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Bootstrap service for initializing cashier payment page data from API",
   "main": "dist/index.js",
   "module": "dist/index.js",