@tagadapay/plugin-sdk 3.1.22 → 3.1.24

package/dist/v2/react/hooks/useTranslation.js

@@ -85,9 +85,24 @@ export const useTranslation = (options = {}) => {
                 // Even without params, we need to unescape any escaped characters
                 return str.replace(/\\([{}<>])/g, '$1');
             }
+            // Replace escaped characters with sentinels so they are not matched
+            // by tag/placeholder regexes (avoids lookbehind which breaks older Safari)
+            const ESC_LT = '\x00ELT\x00';
+            const ESC_GT = '\x00EGT\x00';
+            const ESC_LB = '\x00ELB\x00';
+            const ESC_RB = '\x00ERB\x00';
+            const restoreSentinels = (s) => s.replace(/\x00ELT\x00/g, '<')
+                .replace(/\x00EGT\x00/g, '>')
+                .replace(/\x00ELB\x00/g, '{')
+                .replace(/\x00ERB\x00/g, '}');
+            str = str
+                .replace(/\\</g, ESC_LT)
+                .replace(/\\>/g, ESC_GT)
+                .replace(/\\{/g, ESC_LB)
+                .replace(/\\}/g, ESC_RB);
             // First, process tag-based interpolation for functions
-            // Match tags like <i>content</i> but not \<i>content</i>
-            const tagRegex = /(?<!\\)<(\w+)>(.*?)(?<!\\)<\/\1>/g;
+            // Match tags like <i>content</i> (escaped tags are already replaced with sentinels)
+            const tagRegex = /<(\w+)>(.*?)<\/\1>/g;
             const hasTags = tagRegex.test(str);
             if (hasTags) {
                 // Reset regex lastIndex for reuse
@@ -125,13 +140,13 @@ export const useTranslation = (options = {}) => {
                             // Process {key} placeholders in string parts
                             let processed = Object.entries(params).reduce((acc, [key, value]) => {
                                 if (typeof value !== 'function') {
-                                    const regex = new RegExp(`(?<!\\\\)\\{${key}\\}`, 'g');
+                                    const regex = new RegExp(`\\{${key}\\}`, 'g');
                                     return acc.replace(regex, String(value));
                                 }
                                 return acc;
                             }, part);
-                            // Unescape escaped characters
-                            processed = processed.replace(/\\([{}<>])/g, '$1');
+                            // Restore sentinels to literal characters
+                            processed = restoreSentinels(processed);
                             return processed;
                         }
                         return part;
@@ -149,13 +164,13 @@ export const useTranslation = (options = {}) => {
             // Process {key} placeholders for string/number values
             let result = Object.entries(params).reduce((acc, [key, value]) => {
                 if (typeof value !== 'function') {
-                    const regex = new RegExp(`(?<!\\\\)\\{${key}\\}`, 'g');
+                    const regex = new RegExp(`\\{${key}\\}`, 'g');
                     return acc.replace(regex, String(value));
                 }
                 return acc;
             }, str);
-            // Remove escape characters from escaped characters (\{ -> {, \} -> }, \< -> <, \> -> >)
-            result = result.replace(/\\([{}<>])/g, '$1');
+            // Restore sentinels to literal characters (\{ -> {, \} -> }, \< -> <, \> -> >)
+            result = restoreSentinels(result);
             return result;
         };
         if (!text)

package/dist/v2/react/index.d.ts

@@ -6,6 +6,7 @@ export { ExpressPaymentMethodsProvider } from './providers/ExpressPaymentMethods
 export { TagadaProvider, useTagadaContext } from './providers/TagadaProvider';
 export type { DebugScript } from './providers/TagadaProvider';
 export { ApplePayButton } from './components/ApplePayButton';
+export { StripeExpressButton } from './components/StripeExpressButton';
 export { GooglePayButton } from './components/GooglePayButton';
 export { PreviewModeIndicator } from './components/PreviewModeIndicator';
 export { WhopCheckout } from './components/WhopCheckout';
@@ -41,6 +42,7 @@ export { usePostPurchasesQuery as usePostPurchases } from './hooks/usePostPurcha
 export { usePreviewOffer } from './hooks/usePreviewOffer';
 export { useProductsQuery as useProducts } from './hooks/useProductsQuery';
 export { usePromotionsQuery as usePromotions } from './hooks/usePromotionsQuery';
+export { useSetPaymentMethod } from './hooks/useSetPaymentMethod';
 export { useShippingRatesQuery as useShippingRates } from './hooks/useShippingRatesQuery';
 export { useStoreConfigQuery as useStoreConfig } from './hooks/useStoreConfigQuery';
 export { useThreeds } from './hooks/useThreeds';
@@ -63,6 +65,7 @@ export type { ExpressPaymentMethodsContextType, ExpressPaymentMethodsProviderPro
 export type { UseGooglePayCheckoutOptions } from './hooks/useGooglePayCheckout';
 export type { UseLoginOptions, UseLoginResult } from './hooks/useLogin';
 export type { ApplePayButtonProps } from './components/ApplePayButton';
+export type { StripeExpressButtonProps } from './components/StripeExpressButton';
 export type { GooglePayButtonProps } from './components/GooglePayButton';
 export type { PreviewModeIndicatorProps } from './components/PreviewModeIndicator';
 export type { WhopCheckoutHandle, WhopCheckoutProps } from './components/WhopCheckout';
@@ -73,11 +76,13 @@ export type { ISOCountry, ISORegion, UseISODataResult } from './hooks/useISOData
 export type { UsePluginConfigOptions, UsePluginConfigResult } from './hooks/usePluginConfig';
 export type { TranslateFunction, UseTranslationOptions, UseTranslationResult } from './hooks/useTranslation';
 export { FunnelActionType } from '../core/resources/funnel';
-export type { UseCheckoutQueryOptions as UseCheckoutOptions, UseCheckoutQueryResult as UseCheckoutResult } from './hooks/useCheckoutQuery';
+export type { CheckoutMessages, UseCheckoutQueryOptions as UseCheckoutOptions, UseCheckoutQueryResult as UseCheckoutResult } from './hooks/useCheckoutQuery';
 export type { UseDiscountsQueryOptions as UseDiscountsOptions, UseDiscountsQueryResult as UseDiscountsResult } from './hooks/useDiscountsQuery';
 export type { FunnelAction, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext } from '../core/resources/funnel';
 export type { FunnelContextValue, StepConfigValue } from './hooks/useFunnel';
 export type { UseStepConfigResult } from './hooks/useStepConfig';
+export type { RuntimeStepConfig, PaymentMethodConfig, PaymentSetupConfig, PaymentSetupMethod } from '../core/funnelClient';
+export { getEnabledMethods, getExpressMethods, getExpressMethodsByProcessor, findMethod, isMethodEnabled } from '../core/funnelClient';
 export type { UseFunnelOptions as UseFunnelLegacyOptions, UseFunnelResult as UseFunnelLegacyResult } from './hooks/useFunnelLegacy';
 export type { AvailableVariant, LineItemSelection, OfferLineItem, OfferPreviewSummary, UseOfferQueryOptions as UseOfferOptions, UseOfferQueryResult as UseOfferResult } from './hooks/useOfferQuery';
 export type { UseOrderBumpQueryOptions as UseOrderBumpOptions, UseOrderBumpQueryResult as UseOrderBumpResult } from './hooks/useOrderBumpQuery';
@@ -88,6 +93,7 @@ export type { UsePostPurchasesQueryOptions as UsePostPurchasesOptions, UsePostPu
 export type { PreviewOfferSummary, UsePreviewOfferOptions, UsePreviewOfferResult } from './hooks/usePreviewOffer';
 export type { UseProductsQueryOptions as UseProductsOptions, UseProductsQueryResult as UseProductsResult } from './hooks/useProductsQuery';
 export type { UsePromotionsQueryOptions as UsePromotionsOptions, UsePromotionsQueryResult as UsePromotionsResult } from './hooks/usePromotionsQuery';
+export type { UseSetPaymentMethodOptions, UseSetPaymentMethodResult } from './hooks/useSetPaymentMethod';
 export type { UseShippingRatesQueryOptions as UseShippingRatesOptions, UseShippingRatesQueryResult as UseShippingRatesResult } from './hooks/useShippingRatesQuery';
 export type { UseStoreConfigQueryOptions as UseStoreConfigOptions, UseStoreConfigQueryResult as UseStoreConfigResult } from './hooks/useStoreConfigQuery';
 export type { PaymentInstrument, ThreedsChallenge, ThreedsHook, ThreedsOptions, ThreedsProvider, ThreedsSession } from './hooks/useThreeds';
@@ -95,5 +101,6 @@ export type { UseVipOffersQueryOptions as UseVipOffersOptions, UseVipOffersQuery
 export { formatMoney } from '../../react/utils/money';
 export { TagadaError, TagadaApiError, TagadaNetworkError, TagadaAuthError, TagadaValidationError, TagadaCircuitBreakerError, TagadaErrorCode, } from '../core/errors';
 export type { TagadaErrorOptions, TagadaErrorCodeValue } from '../core/errors';
+export type { PaymentMethodName } from '../core/resources/checkout';
 export type { Order, OrderItem as CoreOrderItem, OrderAddress, OrderSummary, OrderWithRelations, PaymentSummary, PromotionSummary, Subscription, DeviceInfo, PromotionCode, Customer, Store, PickupPoint, } from '../core/types';
 export type OrderItem = import('../core/utils/order').OrderLineItem;

package/dist/v2/react/index.js

@@ -7,6 +7,7 @@ export { ExpressPaymentMethodsProvider } from './providers/ExpressPaymentMethods
 export { TagadaProvider, useTagadaContext } from './providers/TagadaProvider';
 // Components
 export { ApplePayButton } from './components/ApplePayButton';
+export { StripeExpressButton } from './components/StripeExpressButton';
 export { GooglePayButton } from './components/GooglePayButton';
 export { PreviewModeIndicator } from './components/PreviewModeIndicator';
 export { WhopCheckout } from './components/WhopCheckout';
@@ -43,6 +44,7 @@ export { usePostPurchasesQuery as usePostPurchases } from './hooks/usePostPurcha
 export { usePreviewOffer } from './hooks/usePreviewOffer';
 export { useProductsQuery as useProducts } from './hooks/useProductsQuery';
 export { usePromotionsQuery as usePromotions } from './hooks/usePromotionsQuery';
+export { useSetPaymentMethod } from './hooks/useSetPaymentMethod';
 export { useShippingRatesQuery as useShippingRates } from './hooks/useShippingRatesQuery';
 export { useStoreConfigQuery as useStoreConfig } from './hooks/useStoreConfigQuery';
 export { useThreeds } from './hooks/useThreeds';
@@ -58,6 +60,7 @@ export { useStepConfig } from './hooks/useStepConfig';
 export { useFunnel as useFunnelLegacy, useSimpleFunnel } from './hooks/useFunnelLegacy';
 // TanStack Query types
 export { FunnelActionType } from '../core/resources/funnel';
+export { getEnabledMethods, getExpressMethods, getExpressMethodsByProcessor, findMethod, isMethodEnabled } from '../core/funnelClient';
 // Re-export utilities from main react
 export { formatMoney } from '../../react/utils/money';
 // Error types

package/dist/v2/react/providers/ExpressPaymentMethodsProvider.d.ts

@@ -22,6 +22,7 @@ interface ExpressPaymentMethodsContextType {
     googlePayPaymentMethod?: PaymentMethod;
     paypalPaymentMethod?: PaymentMethod;
     klarnaPaymentMethod?: PaymentMethod;
+    stripeExpressPaymentMethod?: PaymentMethod;
     availableExpressPaymentMethodIds: string[];
     setAvailableExpressPaymentMethodIds: (value: string[]) => void;
     handleAddExpressId: (id: string) => void;

package/dist/v2/react/providers/ExpressPaymentMethodsProvider.js

@@ -170,6 +170,13 @@ export const ExpressPaymentMethodsProvider = ({ children, customerId, checkout,
     const googlePayPaymentMethod = useMemo(() => paymentMethods?.find((p) => p.type === 'google_pay'), [paymentMethods]);
     const paypalPaymentMethod = useMemo(() => paymentMethods?.find((p) => p.type === 'paypal'), [paymentMethods]);
     const klarnaPaymentMethod = useMemo(() => paymentMethods?.find((p) => p.type === 'klarna'), [paymentMethods]);
+    // Find a stripe_apm or tagadapay_apm integration with any express method enabled in any processor group.
+    // Backward compatible: existing configs with only apple_pay/google_pay continue to match.
+    const stripeExpressPaymentMethod = useMemo(() => {
+        const EXPRESS_METHOD_KEYS = ['apple_pay', 'google_pay', 'paypal', 'link', 'klarna_express'];
+        return paymentMethods?.find((p) => (p.type === 'stripe_apm' || p.type === 'tagadapay_apm') &&
+            p.settings?.processors?.some((g) => EXPRESS_METHOD_KEYS.some((key) => g?.methods?.[key]?.enabled === true)));
+    }, [paymentMethods]);
     const loading = !paymentMethods || isLoadingPaymentMethods;
     const tagadaError = useMemo(() => error ? new TagadaError(error, { code: TagadaErrorCode.PAYMENT_FAILED }) : null, [error]);
     const contextValue = {
@@ -180,6 +187,7 @@ export const ExpressPaymentMethodsProvider = ({ children, customerId, checkout,
         googlePayPaymentMethod,
         paypalPaymentMethod,
         klarnaPaymentMethod,
+        stripeExpressPaymentMethod,
         shippingMethods,
         lineItems,
         reComputeOrderSummary,
@@ -190,6 +198,6 @@ export const ExpressPaymentMethodsProvider = ({ children, customerId, checkout,
         error: tagadaError,
         setError,
     };
-    const hasAnyEnabled = Boolean(applePayPaymentMethod || googlePayPaymentMethod || paypalPaymentMethod || klarnaPaymentMethod);
+    const hasAnyEnabled = Boolean(applePayPaymentMethod || googlePayPaymentMethod || paypalPaymentMethod || klarnaPaymentMethod || stripeExpressPaymentMethod);
     return (_jsx(ExpressPaymentMethodsContext.Provider, { value: contextValue, children: hasAnyEnabled ? _jsx(_Fragment, { children: children }) : _jsx(_Fragment, {}) }));
 };

package/dist/v2/react/providers/TagadaProvider.js

@@ -4,14 +4,14 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * TagadaProvider - Main provider component for the Tagada Pay React SDK
  */
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { Suspense, createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { Suspense, createContext, lazy, useCallback, useContext, useEffect, useMemo, useState } from 'react';
 import { ApiService } from '../../../react/services/apiService';
 import { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from '../../../react/utils/money';
 import { TagadaClient } from '../../core/client';
-import { default as DebugDrawer } from '../components/DebugDrawer';
-import { FunnelScriptInjector } from '../components/FunnelScriptInjector';
 import { setGlobalApiClient } from '../hooks/useApiQuery';
 import { PixelTrackingProvider } from '../hooks/usePixelTracking';
+const FunnelScriptInjector = lazy(() => import('../components/FunnelScriptInjector').then(m => ({ default: m.FunnelScriptInjector })));
+const DebugDrawer = lazy(() => import('../components/DebugDrawer'));
 // Professional, subtle loading component for initialization
 const InitializationLoader = () => (_jsxs("div", { style: {
         position: 'fixed',
@@ -389,7 +389,7 @@ export function TagadaProvider({ children, environment, customApiConfig, debugMo
     // Loading State Logic
     const shouldShowLoading = state.isLoading || state.pluginConfigLoading || (blockUntilSessionReady && !state.isSessionInitialized);
     const canRenderChildren = !state.pluginConfigLoading && (!blockUntilSessionReady || state.isSessionInitialized);
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(TagadaContext.Provider, { value: contextValue, children: _jsxs(PixelTrackingProvider, { children: [_jsx(FunnelScriptInjector, { ...funnelState }), shouldShowLoading && _jsx(InitializationLoader, {}), state.debugMode && canRenderChildren && (_jsxs(_Fragment, { children: [_jsx("button", { onClick: () => setIsDebugDrawerOpen(true), style: {
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(TagadaContext.Provider, { value: contextValue, children: _jsxs(PixelTrackingProvider, { children: [_jsx(Suspense, { fallback: null, children: _jsx(FunnelScriptInjector, { ...funnelState }) }), shouldShowLoading && _jsx(InitializationLoader, {}), state.debugMode && canRenderChildren && (_jsxs(_Fragment, { children: [_jsx("button", { onClick: () => setIsDebugDrawerOpen(true), style: {
                                     position: 'fixed',
                                     bottom: '16px',
                                     right: '16px',

package/dist/v2/standalone/index.d.ts

@@ -9,6 +9,7 @@
 import { TagadaClient, TagadaClientConfig, TagadaState } from '../core/client';
 import { ApiClient } from '../core/resources/apiClient';
 import { CheckoutResource } from '../core/resources/checkout';
+import { getAssignedPaymentFlowId } from '../core/funnelClient';
 /**
  * Auto-inject all stepConfig scripts
  * Called automatically when SDK loads
@@ -24,8 +25,13 @@ export { TagadaClient, ApiClient, CheckoutResource };
 export { ShippingRatesResource } from '../core/resources/shippingRates';
 export { PaymentsResource } from '../core/resources/payments';
 export { OrdersResource } from '../core/resources/orders';
+export { ExpressPaymentMethodsResource } from '../core/resources/expressPaymentMethods';
+export type { PaymentMethod as ExpressPaymentMethod } from '../core/resources/expressPaymentMethods';
 export type { ShippingRate, ShippingRatesResponse, ShippingRatesPreviewParams } from '../core/resources/shippingRates';
-export type { Payment, PaymentResponse, CardPaymentMethod, BasisTheoryInstance, GooglePayToken, PaymentInstrumentInput, } from '../core/resources/payments';
+export type { Payment, PaymentResponse, CardPaymentMethod, BasisTheoryInstance, GooglePayToken, ApplePayToken, PaymentInstrumentInput, PaymentInstrumentResponse, PaymentInstrumentCustomerResponse, } from '../core/resources/payments';
+export { StoreConfigResource } from '../core/resources/storeConfig';
+export type { StoreConfig } from '../core/resources/storeConfig';
+export { ThreedsResource } from '../core/resources/threeds';
 export { ISODataCore } from '../core/isoData';
 export type { ISOCountry, ISORegion } from '../core/isoData';
 export { GoogleAutocompleteCore } from '../core/googleAutocomplete';
@@ -39,7 +45,19 @@ export type { CheckoutData, CheckoutSession, CheckoutSummary, CheckoutSummaryIte
 export type { Order, OrderItem, OrderAddress, OrderSummary, OrderWithRelations, PaymentSummary, PromotionSummary, Subscription, DeviceInfo, PromotionCode, Customer, Store, PickupPoint, } from '../core/types';
 export * from '../core/utils';
 export { matchRoute, getInternalPath, isPathRemapped, getPathInfo, } from '../core/pathRemapping';
-export { resolvePixelEvents, mapMetaEvent, mapTikTokEvent, mapSnapchatEvent, mapPinterestEvent, mapGTMEvent, isEventEnabled, getEligiblePixels, applyGoogleAdsConversion, } from '../core/pixelMapping';
-export type { StandardPixelEvent, PixelProviderKey, MappedEvent, ProviderEvent, } from '../core/pixelMapping';
+export { getAssignedPaymentFlowId };
+export { getAssignedStepConfig } from '../core/funnelClient';
+export type { RuntimeStepConfig } from '../core/funnelClient';
+export { PaymentService } from './payment-service';
+export type { PaymentServiceConfig, PaymentResult, PaymentCallbacks, CardData, ApmData, } from './payment-service';
+/**
+ * Get BasisTheory public API key based on hostname detection.
+ * Delegates to the centralized isProductionBasisTheory() logic.
+ */
+export declare function getBasisTheoryApiKey(): string;
+/**
+ * Get BasisTheory tenant ID based on hostname detection.
+ */
+export declare function getBasisTheoryTenantId(): string;
 export { TagadaTracker, TagadaExternalTracker, } from './external-tracker';
 export type { TagadaTrackerConfig, ExternalTrackerSession, NavigateOptions, } from './external-tracker';

package/dist/v2/standalone/index.js

@@ -9,7 +9,8 @@
 import { TagadaClient } from '../core/client';
 import { ApiClient } from '../core/resources/apiClient';
 import { CheckoutResource } from '../core/resources/checkout';
-import { getAssignedStepConfig } from '../core/funnelClient';
+import { getAssignedStepConfig, getAssignedPaymentFlowId } from '../core/funnelClient';
+import { getBasisTheoryApiKey as _getBtApiKey, getBasisTheoryTenantId as _getBtTenantId } from '../../react/config/payment';
 /**
  * Parse step config from window variable or meta tag
  */
@@ -133,6 +134,11 @@ export { TagadaClient, ApiClient, CheckoutResource };
 export { ShippingRatesResource } from '../core/resources/shippingRates';
 export { PaymentsResource } from '../core/resources/payments';
 export { OrdersResource } from '../core/resources/orders';
+export { ExpressPaymentMethodsResource } from '../core/resources/expressPaymentMethods';
+// Re-export Store Config (for standalone resolvers / builders)
+export { StoreConfigResource } from '../core/resources/storeConfig';
+// Re-export 3DS Resource (for standalone resolvers / builders)
+export { ThreedsResource } from '../core/resources/threeds';
 // Re-export ISO Data Core (for standalone address form / resolvers)
 export { ISODataCore } from '../core/isoData';
 // Re-export Google Autocomplete Core (for standalone address form)
@@ -144,8 +150,24 @@ export { FunnelActionType } from '../core/resources/funnel';
 export * from '../core/utils';
 // Re-export path remapping utilities (for SPA routing)
 export { matchRoute, getInternalPath, isPathRemapped, getPathInfo, } from '../core/pathRemapping';
-// Re-export pixel mapping (for standalone pixel tracking)
-export { resolvePixelEvents, mapMetaEvent, mapTikTokEvent, mapSnapchatEvent, mapPinterestEvent, mapGTMEvent, isEventEnabled, getEligiblePixels, applyGoogleAdsConversion, } from '../core/pixelMapping';
+// Re-export Step Config / Payment Flow helpers (for standalone resolvers / builders)
+export { getAssignedPaymentFlowId };
+export { getAssignedStepConfig } from '../core/funnelClient';
+// Re-export Payment Service (standalone payment processing — no React)
+export { PaymentService } from './payment-service';
+/**
+ * Get BasisTheory public API key based on hostname detection.
+ * Delegates to the centralized isProductionBasisTheory() logic.
+ */
+export function getBasisTheoryApiKey() {
+    return _getBtApiKey();
+}
+/**
+ * Get BasisTheory tenant ID based on hostname detection.
+ */
+export function getBasisTheoryTenantId() {
+    return _getBtTenantId();
+}
 // ============================================================================
 // EXTERNAL PAGE TRACKER
 // ============================================================================

package/dist/v2/standalone/payment-service.d.ts

@@ -0,0 +1,134 @@
+/**
+ * PaymentService (Standalone / Vanilla JS)
+ *
+ * Complete standalone equivalent of the React SDK's payment system:
+ * - usePaymentQuery (orchestration)
+ * - usePaymentPolling (status polling)
+ * - usePaymentActionHandler (action routing)
+ * - usePaymentProcessors (card, APM, Apple Pay, Google Pay, saved instruments)
+ * - usePaymentInstruments (instrument creation)
+ * - useThreeds (3DS session + challenge)
+ * - useGenericPaymentReturn (generic redirect return)
+ * - useAirwallex3dsReturn (Airwallex-specific redirect return)
+ * - All action handlers: redirect, threeds_auth, processor_auth, error,
+ *   kesspay_auth, trustflow_auth, finix_radar, stripe_radar, airwallex radar,
+ *   mastercard_auth
+ *
+ * No React. No hooks. No DOM framework dependency.
+ */
+import { PaymentsResource, type Payment, type CardPaymentMethod, type ApplePayToken, type GooglePayToken, type PaymentInstrumentResponse, type PaymentInstrumentCustomerResponse } from '../core/resources/payments';
+import type { ApiClient } from '../core/resources/apiClient';
+export interface PaymentServiceConfig {
+    apiClient: ApiClient;
+    storeId?: string;
+}
+export interface CardData {
+    cardNumber: string;
+    expiryDate: string;
+    cvc: string;
+}
+export interface ApmData {
+    processorId: string;
+    paymentMethod: string;
+    initiatedBy?: 'customer' | 'merchant';
+    source?: 'upsell' | 'checkout' | 'offer' | 'missing_club' | 'forced';
+}
+export interface PaymentResult {
+    success: boolean;
+    payment?: Payment;
+    order?: {
+        id: string;
+        checkoutSessionId?: string;
+    } | null;
+    error?: string;
+    /** True if the browser is being redirected (page will unload) */
+    redirecting?: boolean;
+}
+export interface PaymentCallbacks {
+    onProcessing?: (processing: boolean) => void;
+    onError?: (error: string | null) => void;
+    onCurrentPaymentId?: (paymentId: string | null) => void;
+    onSuccess?: (payment: Payment) => void;
+    onFailure?: (error: string) => void;
+    onRedirectReturn?: (paymentId: string) => void;
+}
+export interface PollingCallbacks {
+    onSuccess: (payment: Payment) => void;
+    onFailure: (error: string) => void;
+    onRequireAction?: (payment: Payment) => void;
+}
+export declare class PaymentService {
+    private paymentsResource;
+    private threedsResource;
+    private storeConfigResource;
+    private storeId?;
+    private callbacks;
+    private basisTheory;
+    private btInitPromise;
+    private bt3dsClass;
+    private bt3dsInitPromise;
+    private storeConfig;
+    private storeConfigPromise;
+    private pollTimer;
+    private pollAttempts;
+    private isPollingActive;
+    private redirectReturnProcessed;
+    constructor(config: PaymentServiceConfig);
+    /** Expose paymentsResource for advanced consumers */
+    get payments(): PaymentsResource;
+    setCallbacks(callbacks: PaymentCallbacks): void;
+    /** Pre-warm BasisTheory + store config (non-blocking). */
+    warmup(): void;
+    destroy(): void;
+    private initBasisTheory;
+    private getBtApiKey;
+    /** Lazy-load @basis-theory/web-threeds (BasisTheory3ds class) */
+    private initBt3ds;
+    private fetchStoreConfig;
+    stopPolling(): void;
+    startPolling(paymentId: string, callbacks: PollingCallbacks, maxAttempts?: number, interval?: number): void;
+    /**
+     * Internal: call processPaymentDirect and handle requireAction / polling.
+     * Shared by processCardPayment, processApplePayPayment, etc.
+     */
+    private processAndHandle;
+    /**
+     * After radar / completePaymentAfterAction, handle the resumed payment.
+     */
+    private handleResumedPayment;
+    handlePaymentAction(payment: Payment): Promise<void>;
+    private handleKessPayAuth;
+    private handleTrustFlowAuth;
+    private handleFinixRadar;
+    private handleStripeRadar;
+    private handleAirwallexRadar;
+    private handleMasterCardAuth;
+    private loadScript;
+    private waitFor;
+    /**
+     * Detect ALL redirect return types and resume.
+     * Handles both generic returns and Airwallex-specific 3DS returns.
+     * Call once during initialization. Returns true if a return was detected.
+     */
+    detectRedirectReturn(): boolean;
+    private detectGenericRedirectReturn;
+    private detectAirwallex3dsReturn;
+    private handleAirwallex3dsRedirectReturn;
+    cleanPaymentUrlParams(): void;
+    createCardPaymentInstrument(cardData: CardPaymentMethod): Promise<PaymentInstrumentResponse>;
+    createApplePayPaymentInstrument(token: ApplePayToken): Promise<PaymentInstrumentResponse>;
+    createGooglePayPaymentInstrument(token: GooglePayToken): Promise<PaymentInstrumentResponse>;
+    getCardPaymentInstruments(): Promise<PaymentInstrumentCustomerResponse>;
+    createThreedsSession(paymentInstrument: {
+        id: string;
+        token: string | null;
+    }): Promise<{
+        id: string;
+        sessionId: string;
+    }>;
+    processCardPayment(checkoutSessionId: string, cardData: CardData): Promise<PaymentResult>;
+    processApplePayPayment(checkoutSessionId: string, applePayToken: ApplePayToken): Promise<PaymentResult>;
+    processGooglePayPayment(checkoutSessionId: string, googlePayToken: GooglePayToken): Promise<PaymentResult>;
+    processPaymentWithInstrument(checkoutSessionId: string, paymentInstrumentId: string): Promise<PaymentResult>;
+    processApmPayment(checkoutSessionId: string, apmData: ApmData): Promise<PaymentResult>;
+}