@payrails/web-sdk 5.46.1 → 5.47.1

package/payrails.d.ts

@@ -1,1243 +1,1279 @@
-declare const UI_POSITION_FIELD = "ui:position";
-
-type JSONSchemaType = JSONSchemaProperty & {
-    required?: string[];
-    dependentSchemas?: Record<string, JSONSchemaDependentSchema>;
-};
-interface JSONSchemaDependentSchema {
-    oneOf: Array<{
-        properties: Record<string, {
-            const: string | number;
-        }>;
-        required: string[];
-    }>;
+interface BinLookupResponse {
+    bin: string;
+    network: string;
+    issuer?: string;
+    issuerCountry?: {
+        code?: string;
+        name?: string;
+        iso3?: string;
+    };
+    type?: string;
 }
-interface JSONSchemaProperty {
-    type?: 'string' | 'number' | 'boolean' | 'array' | 'object';
-    title?: string;
-    oneOf?: JSONSchemaOneOfOption[];
-    pattern?: string;
-    minLength?: number;
-    maxLength?: number;
-    errorMessage?: Record<string, string>;
-    $ref?: string;
-    [UI_POSITION_FIELD]?: number;
-    properties?: Record<string, JSONSchemaType>;
+
+declare enum RedactionType {
+    DEFAULT = "DEFAULT",
+    PLAIN_TEXT = "PLAIN_TEXT",
+    MASKED = "MASKED",
+    REDACTED = "REDACTED"
 }
-interface JSONSchemaOneOfOption {
-    const: string | number;
-    title: string;
+declare enum RequestMethod$1 {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE"
 }
-interface JSONSchemaOneOfOption {
-    const: string | number;
-    title: string;
+declare enum EventName {
+    CHANGE = "CHANGE",
+    READY = "READY",
+    FOCUS = "FOCUS",
+    BLUR = "BLUR",
+    SUBMIT = "SUBMIT"
 }
-interface DynamicElementEvents {
-    onReady: () => void;
-    onValidationChange: (isValid: boolean) => void;
+declare enum LogLevel {
+    WARN = "WARN",
+    INFO = "INFO",
+    DEBUG = "DEBUG",
+    ERROR = "ERROR"
 }
-interface DynamicElementFieldTranslation {
-    label?: string;
-    placeholder?: string;
-    errors?: Partial<DynamicElementErrorTranslation>;
+declare enum Env {
+    DEV = "DEV",
+    PROD = "PROD"
 }
-interface DynamicElementErrorTranslation {
-    required: string;
-    minLength: string;
-    maxLength: string;
-    pattern: string;
-    oneOf: string;
+declare enum ValidationRuleType {
+    REGEX_MATCH_RULE = "REGEX_MATCH_RULE",
+    LENGTH_MATCH_RULE = "LENGTH_MATCH_RULE",
+    ELEMENT_VALUE_MATCH_RULE = "ELEMENT_VALUE_MATCH_RULE"
 }
-type DynamicElementTranslations = {
-    fields?: Record<string, DynamicElementFieldTranslation>;
-    errors?: Partial<DynamicElementErrorTranslation>;
-};
-interface DynamicElementElementStyles {
-    base?: Partial<CSSStyleDeclaration>;
-    complete?: Partial<CSSStyleDeclaration>;
-    empty?: Partial<CSSStyleDeclaration>;
-    focus?: Partial<CSSStyleDeclaration>;
-    invalid?: Partial<CSSStyleDeclaration>;
+interface IInsertRecordInput {
+    records: IInsertRecord[];
 }
-type DynamicElementInputFieldStyles = DynamicElementElementStyles;
-type DynamicElementSelectFieldStyles = DynamicElementElementStyles;
-interface DynamicElementTabsFieldStyles {
-    tab: {
-        base?: Partial<CSSStyleDeclaration>;
-        active?: Partial<CSSStyleDeclaration>;
-    };
-    container?: DynamicElementElementStyles;
+interface IInsertRecord {
+    table: string;
+    fields: Record<string, any>;
+    skyflowID?: string;
 }
-interface DynamicElementFieldStyles {
-    base?: Partial<CSSStyleDeclaration>;
-    label?: Partial<CSSStyleDeclaration>;
-    errors?: Partial<CSSStyleDeclaration>;
-    input?: DynamicElementInputFieldStyles;
-    select?: DynamicElementSelectFieldStyles;
-    tabs?: DynamicElementTabsFieldStyles;
+interface Context {
+    logLevel: LogLevel;
+    env: Env;
 }
-interface DynamicElementStyles {
-    all: Omit<DynamicElementFieldStyles, 'label'>;
-    fields?: Record<string, DynamicElementFieldStyles>;
+interface IValidationRule {
+    type: ValidationRuleType;
+    params: any;
 }
 
-declare enum PAYMENT_METHOD_CODES {
-    'CARD' = "card",
-    'GOOGLE_PAY' = "googlePay",
-    'PAYPAL' = "payPal",
-    'APPLE_PAY' = "applePay",
-    'GENERIC_REDIRECT' = "genericRedirect",
-    'LEAN' = "lean",
-    'MERCADO_PAGO' = "mercadoPago",
-    'PIX' = "pix",
-    'BANK_ACCOUNT' = "bankAccount",
-    'IDEAL' = "iDeal",
-    'YAPE' = "yape",
-    'UPI' = "upi",
-    'KLARNA' = "klarna",
-    'ONE_VOUCHER' = "1voucher",
-    'ALFA' = "alfa",
-    'APLAZO' = "aplazo",
-    'BANK_TRANSFER' = "bankTransfer",
-    'CAPITEC_PAY' = "capitecPay",
-    'EASYPAISA' = "easypaisa",
-    'EFT_PRO' = "eftPro",
-    'FAWRY_PAY' = "fawryPay",
-    'JAZZ_CASH' = "jazzCash",
-    'KONNECT' = "konnect",
-    'KUESKI' = "kueski",
-    'MONO_DIRECT_DEBIT' = "monoDirectDebit",
-    'O_PAY_WALLET' = "oPayWallet",
-    'PAGA_WALLET' = "pagaWallet",
-    'PAYFLEX' = "payflex",
-    'PAY_JUST_NOW' = "payjustnow",
-    'WAFA_CASH_WALLET' = "wafaCashWallet",
-    'MERCADO_PAGO_WALLET' = "mercadoPagoWallet",
-    'MERCADO_PAGO_CONSUMER_CREDIT' = "mercadoPagoConsumerCredit",
-    'NET_BANKING' = "netBanking",
-    'CASH_FREE_WALLET' = "cashFreeWallet",
-    'PAYTM_WALLET' = "paytmWallet",
-    'NIBSS_PAY' = "nibssPay",
-    'NIBSS_INSTANT_PAY' = "nibssInstantPay",
-    'MEEZA_WALLET' = "meezaWallet",
-    'VODAFONE_CASH' = "vodafoneCash",
-    'SEPA_DIRECT_DEBIT' = "sepaDirectDebit",
-    'MODO' = "modo",
-    'PAYZONE_CASH' = "payzoneCash",
-    'REVOLUT_PAY' = "revolutPay"
+interface IUpsertOptions {
+    table: string;
+    column: string;
 }
-declare const PAYMENT_METHOD_CODE_BY_METHOD: { readonly [K in keyof typeof PAYMENT_METHOD_CODES]: (typeof PAYMENT_METHOD_CODES)[K]; };
-type PaymentMethodCode = PAYMENT_METHOD_CODES | (typeof PAYMENT_METHOD_CODE_BY_METHOD)[keyof typeof PAYMENT_METHOD_CODE_BY_METHOD] | (string & {});
-declare enum PAYMENT_INSTRUMENT_STATUS {
-    'ENABLED' = "enabled",
-    'CREATED' = "created",
-    'DELETED' = "deleted",
-    'DISABLED' = "disabled",
-    'INVALID' = "invalid",
-    'TRANSIENT' = "transient"
+
+declare enum ElementType$1 {
+    CVV = "CVV",
+    EXPIRATION_DATE = "EXPIRATION_DATE",
+    CARD_NUMBER = "CARD_NUMBER",
+    CARDHOLDER_NAME = "CARDHOLDER_NAME",
+    INPUT_FIELD = "INPUT_FIELD",
+    PIN = "PIN",
+    EXPIRATION_MONTH = "EXPIRATION_MONTH",
+    EXPIRATION_YEAR = "EXPIRATION_YEAR"
 }
-type ExecutionMetaKey = keyof ExecutionMetaByKey;
-interface ExecutionMetaCustomer {
-    phone?: {
-        countryCode?: string;
-        number?: string;
-    };
-    country?: {
-        name?: string;
-        code?: string;
-        iso3?: string;
-    };
-    reference?: string;
-    name?: string;
-    lastName?: string;
-    email?: string;
-    type?: string;
-    birthDate?: string;
-    language?: string;
-    identityCardNumber?: string;
+
+declare abstract class Container {
 }
-interface ExecutionMetaOrder {
-    billingAddress?: {
-        country?: {
-            name?: string;
-            code?: string;
-            iso3?: string;
-        };
-    };
+
+declare class EventEmitter {
+    events: Record<string, {
+        priority: boolean;
+        callback: Function;
+    }[]>;
+    constructor();
+    on(event: string, callback: Function, priority?: boolean): void;
+    off(event: string, callback: Function): void;
+    _emit(event: string, ...args: any[]): void;
+    hasListener(event: string): boolean;
+    resetEvents(): void;
+    static createChild(ChildObject: any): void;
 }
-type ExecutionMetaByKey = {
-    customer: ExecutionMetaCustomer;
-};
-type ExecutionMetaUpdate = {
-    [Key in ExecutionMetaKey]: {
-        key: Key;
-        value: ExecutionMetaByKey[Key];
-    };
-}[ExecutionMetaKey];
-interface ExecutionMeta {
-    customer?: ExecutionMetaCustomer;
-    order?: ExecutionMetaOrder;
+
+declare abstract class SkyflowElement {
+    abstract mount(domElementSelector: any): any;
+    abstract unmount(): any;
+    abstract setError(clientErrorText: string): any;
+    abstract resetError(): any;
+    abstract iframeName(): any;
+    abstract getID(): any;
 }
-declare class WorkflowExecution {
-    private static _updatedMetaKeys;
-    private static _response;
-    static get response(): WorkflowExecutionResponse;
-    static setResponse(response: WorkflowExecutionResponse): typeof WorkflowExecution;
-    static get workflowCode(): string;
-    static get lookup(): {
-        httpCode: number;
-        body: {
-            data: {
-                paymentCompositionOptions?: Array<StorablePaymentCompositionOption>;
-                payoutCompositionOptions?: Array<StorablePaymentCompositionOption>;
-            };
-            links: {
-                execution: string;
-                authorize?: {
-                    href: string;
-                    method: "POST";
-                };
-                payout?: {
-                    href: string;
-                    method: "POST";
-                };
-                startPaymentSession?: {
-                    href: string;
-                    method: "POST";
-                };
-                createInstrument?: {
-                    href: string;
-                    method: "POST";
-                };
-            };
-            name: "lookup";
-        };
-    } | undefined;
-    static get holderReference(): string;
-    static get savedCreditCards(): StoredPaymentInstrument<CardMetadata>[];
-    static get savedPaypalAccounts(): StoredPaymentInstrument<PayPalMetadata>[];
-    static get savedGooglePayAccounts(): StoredPaymentInstrument<CardMetadata>[];
-    static get savedApplePayAccounts(): StoredPaymentInstrument<CardMetadata>[];
-    static get paypalConfig(): PayPalConfig;
-    static get googlePayConfig(): any;
-    static isPaymentMethodAvailable(paymentMethod: PaymentMethodCode): boolean;
-    static get applePayConfig(): {
-        merchantIdentifier: string;
-        supportedNetworks: string[];
-        countryCode: string;
-        merchantCapabilities: ApplePayJS.ApplePayMerchantCapability[];
-        requiredBillingContactFields?: ApplePayJS.ApplePayContactField[];
-        requiredShippingContactFields?: ApplePayJS.ApplePayContactField[];
-    };
-    static get url(): string;
-    static get meta(): ExecutionMeta;
-    static get availablePaymentMethods(): StorablePaymentCompositionOption<CardMetadata | PayPalMetadata, ApplePayConfig | PayPalConfig | GooglePayConfig | undefined>[];
-    static get authorizeLink(): string | undefined;
-    static get payoutLink(): string | undefined;
-    static get createSessionLink(): string | undefined;
-    static get createInstrumentLink(): string | undefined;
-    static get storedPaymentInstruments(): StoredPaymentInstrument<PayPalMetadata & CardMetadata>[];
-    static get storedDropinInstruments(): StoredPaymentInstrument<PayPalMetadata & CardMetadata>[];
-    static getFullPaymentMethodConfig(paymentMethod: PaymentMethodCode): StorablePaymentCompositionOption<CardMetadata | PayPalMetadata, ApplePayConfig | PayPalConfig | GooglePayConfig | undefined> | undefined;
-    static isAddressSelectorEnabled(paymentMethod: PaymentMethodCode): boolean | undefined;
-    static isPaymentInstallmentsEnabled(paymentMethod: PaymentMethodCode): boolean | undefined;
-    static getPaymentInstallmentOptions(paymentMethod: PaymentMethodCode): PaymentInstallmentsConfig;
-    static getStoredInstrumentForPaymentMethod<T = CardMetadata | PayPalMetadata>(paymentMethod: PaymentMethodCode): Array<StoredPaymentInstrument<T>>;
-    static getPaymentMethodForStoredInstrument<T extends CardMetadata | PayPalMetadata>(instrument: StoredPaymentInstrument<T>): {
-        id: string;
-        description?: string;
-        status: PAYMENT_INSTRUMENT_STATUS;
-        integrationType: INTEGRATION_TYPE;
-        config: ApplePayConfig | PayPalConfig | GooglePayConfig | undefined;
-        clientConfig?: {
-            flow?: PAYMENT_CLIENT_FLOW;
-            displayName?: string;
-            supportsInstallments?: boolean;
-            installments?: PaymentInstallmentsConfig;
-            supportsBillingInfo?: boolean;
-            schema?: JSONSchemaType;
-            additionalConfig?: any;
-            instrumentDataSchema?: JSONSchemaType;
-        };
-        payoutInstruments?: StoredPaymentInstrument<CardMetadata | PayPalMetadata>[] | undefined;
-        paymentMethodCode: PaymentMethodCode;
-        payoutMethodCode?: PaymentMethodCode;
-    } | undefined;
-    static getPaymentMethodConfig(paymentMethod: StorablePaymentCompositionOption): {
-        id: string;
-        description?: string;
-        status: PAYMENT_INSTRUMENT_STATUS;
-        integrationType: INTEGRATION_TYPE;
-        config: ApplePayConfig | PayPalConfig | GooglePayConfig | undefined;
-        clientConfig?: {
-            flow?: PAYMENT_CLIENT_FLOW;
-            displayName?: string;
-            supportsInstallments?: boolean;
-            installments?: PaymentInstallmentsConfig;
-            supportsBillingInfo?: boolean;
-            schema?: JSONSchemaType;
-            additionalConfig?: any;
-            instrumentDataSchema?: JSONSchemaType;
-        };
-        payoutInstruments?: StoredPaymentInstrument<CardMetadata | PayPalMetadata>[] | undefined;
-        paymentMethodCode: PaymentMethodCode;
-        payoutMethodCode?: PaymentMethodCode;
-    };
-    static updateInstallmentOptions(installmentOptions?: PaymentInstallmentsConfig): void;
-    static updateMeta<K extends ExecutionMetaKey>(key: K, value: ExecutionMetaByKey[K]): void;
-    static getAllowedMeta(): ExecutionMeta;
-    static getUpdatedMeta(): ExecutionMeta;
-    private static pickMetaByKeys;
-}
-interface WorkflowExecutionResponse {
-    id: string;
-    merchantReference: string;
-    holderReference: string;
-    holderId?: string;
-    actionRequired?: string;
-    meta: ExecutionMeta;
-    status: Array<{
-        code: string;
-        time: string;
-    }>;
-    initialResults: Array<{
-        httpCode: number;
-        body: {
-            data: {
-                paymentCompositionOptions?: Array<StorablePaymentCompositionOption>;
-                payoutCompositionOptions?: Array<StorablePaymentCompositionOption>;
-            };
-            links: {
-                execution: string;
-                authorize?: {
-                    href: string;
-                    method: 'POST';
-                };
-                payout?: {
-                    href: string;
-                    method: 'POST';
-                };
-                startPaymentSession?: {
-                    href: string;
-                    method: 'POST';
-                };
-                createInstrument?: {
-                    href: string;
-                    method: 'POST';
-                };
-            };
-            name: 'lookup';
-        };
-    }>;
-    links: {
-        startPaymentSession?: {
-            href: string;
-            method: 'POST';
-        };
-        createInstrument?: {
-            href: string;
-            method: 'POST';
-        };
-        confirm?: {
-            href: string;
-            action?: {
-                parameters?: {
-                    orderId?: string;
-                    tokenId?: string;
-                };
-                paymentId?: string;
-                sdkToken?: string;
-                appToken?: string;
-                successUrl?: string;
-                failureUrl?: string;
-                sandbox?: boolean;
-            };
-        };
-        redirect?: string;
-        '3ds'?: string;
-        self: string;
-    };
-    workflow: {
-        code: string;
-        version: number;
+
+declare class CollectElement extends SkyflowElement {
+    #private;
+    elementType: string;
+    type: string;
+    containerId: string;
+    constructor(elementId: string, elementGroup: any, metaData: any, container: any, isSingleElementAPI: boolean | undefined, destroyCallback: Function, updateCallback: Function, context: Context, groupEventEmitter?: EventEmitter);
+    getID: () => string;
+    mount: (domElement: any) => void;
+    unmount: () => void;
+    update: (group: any) => void;
+    updateElement: (elementOptions: any) => void;
+    getState: () => {
+        isEmpty: boolean;
+        isComplete: boolean;
+        isValid: boolean;
+        isFocused: boolean;
+        value: string | Object | Blob | undefined;
+        required: boolean;
     };
+    getOptions: () => any;
+    on(eventName: string, handler: any): void;
+    iframeName(): string;
+    isMounted(): boolean;
+    isValidElement(): boolean;
+    setError(clientErrorText: string): void;
+    resetError(): void;
+    setValue(elementValue: string): void;
+    clearValue(): void;
+    setAttribute(attribute: string, value: string | number): void;
+    focus(): void;
 }
-interface BasePaymentMethodConfig {
-    paymentMethodCode: PaymentMethodCode;
-    payoutMethodCode?: PaymentMethodCode;
-}
-interface BaseInstallmentOption {
-    count: number;
-    amount: number;
-}
-interface PaymentInstallmentsConfig {
-    [key: string]: BaseInstallmentOption[];
-}
-interface InstallmentUpdateConfig {
-    defaultInstallment?: number | null;
-    installmentCountry?: string | null;
-    installmentOptions?: BaseInstallmentOption[] | null;
+
+interface CollectElementInput$1 {
+    table?: string;
+    column?: string;
+    inputStyles?: object;
+    label?: string;
+    labelStyles?: object;
+    errorTextStyles?: object;
+    placeholder?: string;
+    type: ElementType$1;
+    altText?: string;
+    validations?: IValidationRule[];
+    skyflowID?: string;
 }
-interface StorablePaymentCompositionOption<I = CardMetadata | PayPalMetadata, C = undefined | ApplePayConfig | PayPalConfig | GooglePayConfig> extends BasePaymentMethodConfig {
-    id: string;
-    description?: string;
-    status: PAYMENT_INSTRUMENT_STATUS;
-    integrationType: INTEGRATION_TYPE;
-    config: C;
-    clientConfig?: {
-        flow?: PAYMENT_CLIENT_FLOW;
-        displayName?: string;
-        supportsInstallments?: boolean;
-        installments?: PaymentInstallmentsConfig;
-        supportsBillingInfo?: boolean;
-        schema?: JSONSchemaType;
-        additionalConfig?: any;
-        instrumentDataSchema?: JSONSchemaType;
-    };
-    paymentInstruments?: Array<StoredPaymentInstrument<I>>;
-    payoutInstruments?: Array<StoredPaymentInstrument<I>>;
+interface ICollectOptions$1 {
+    tokens?: boolean;
+    additionalFields?: IInsertRecordInput;
+    upsert?: Array<IUpsertOptions>;
 }
-interface GooglePayConfig {
-    parameters: {
-        allowedAuthMethods: google.payments.api.CardAuthMethod[];
-        allowedCardNetworks: google.payments.api.CardNetwork[];
-        billingAddressParameters?: {
-            format?: string;
-        };
-        billingAddressRequired?: boolean;
-    };
-    tokenizationSpecification: google.payments.api.PaymentMethodTokenizationSpecification;
-    type: google.payments.api.PaymentMethodType;
-    apiVersion?: number;
-    apiVersionMinor?: number;
-    allowedPaymentMethods?: google.payments.api.PaymentMethodSpecification[];
-    emailRequired?: boolean;
-    shippingAddressRequired?: boolean;
-    shippingAddressParameters?: google.payments.api.ShippingAddressParameters;
-    merchantInfo?: google.payments.api.MerchantInfo;
-    existingPaymentMethodRequired?: boolean;
+declare class CollectContainer extends Container {
+    #private;
+    type: string;
+    private bus;
+    private iframe;
+    constructor(options: any, metaData: any, skyflowElements: any, context: any);
+    create: (input: CollectElementInput$1, options?: any) => CollectElement;
+    validate: () => Promise<unknown>;
+    collect: (options?: ICollectOptions$1) => Promise<unknown>;
+    reset(): void;
+    unmount: () => void;
 }
-interface PayPalConfig {
-    clientId: string;
-    merchantId: string;
-    captureMode: 'Delayed' | 'Instant' | 'Manual';
-    integrationMode: 'express' | 'normal';
+
+/**
+ * Descriptor for a custom font to be injected or referenced by the card/secure-fields iframes.
+ *
+ * This mirrors Stripe-like font configuration where you can provide either a CSS URL that
+ * includes @font-face declarations (cssSrc) or provide full @font-face fields to be injected.
+ *
+ * Examples:
+ *  - { cssSrc: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap' }
+ *  - { family: 'Inter', src: 'https://cdn.example.com/fonts/Inter.woff2', weight: 400, style: 'normal', display: 'swap' }
+ */
+interface FontDescriptor {
+    cssSrc?: string;
+    family?: string;
+    src?: string;
+    style?: string;
+    weight?: string | number;
+    unicodeRange?: string;
+    display?: string;
 }
-interface ApplePayConfig {
-    parameters: {
-        merchantIdentifier: string;
-        supportedNetworks: string[];
-        countryCode: string;
-        merchantCapabilities: ApplePayJS.ApplePayMerchantCapability[];
-        requiredBillingContactFields?: ApplePayJS.ApplePayContactField[];
-        requiredShippingContactFields?: ApplePayJS.ApplePayContactField[];
-    };
+
+declare class ComposableElement {
+    #private;
     type: string;
+    constructor(name: any, eventEmitter: any);
+    on(eventName: string, handler: any): void;
+    focus(): void;
+    update: (options: any) => void;
+    setAttribute(attribute: string, value: string | number): void;
 }
-interface StoredPaymentInstrument<T = CardMetadata | PayPalMetadata | BankAccountMetadata> {
-    id: string;
-    status: PAYMENT_INSTRUMENT_STATUS;
-    paymentMethod: PaymentMethodCode;
-    displayName?: string;
-    data?: T;
-    default?: boolean;
-    createdAt?: string;
-    updatedAt?: string;
-    holderId?: string;
-    fingerprint?: string;
-    futureUsage?: FutureUsages;
+
+/**
+ * Configuration interface for creating collect elements
+ * Defines the structure and styling options for form input elements
+ */
+interface CollectElementInput {
+    table?: string;
+    column?: string;
+    inputStyles?: object;
+    label?: string;
+    labelStyles?: object;
+    errorTextStyles?: object;
+    placeholder?: string;
+    type: ElementType$1;
+    altText?: string;
+    validations?: IValidationRule[];
+    skyflowID?: string;
 }
-interface PayPalMetadata {
-    email?: string;
+/**
+ * Options interface for the collect operation
+ * Controls how data is collected and processed
+ */
+interface ICollectOptions {
+    tokens?: boolean;
+    additionalFields?: IInsertRecordInput;
+    upsert?: Array<IUpsertOptions>;
 }
-interface Country {
-    code: string;
-    name: string;
-    iso3: string;
+/**
+ * ComposableContainer class - Main container for managing secure form elements
+ *
+ * This class extends the base Container and provides functionality to:
+ * - Create and manage secure iframe-based form elements
+ * - Handle secure communication between parent and iframe contexts
+ * - Collect and tokenize sensitive data while maintaining PCI compliance
+ * - Manage element lifecycle (create, mount, validate, collect, destroy)
+ */
+declare class ComposableContainer extends Container {
+    #private;
+    type: string;
+    private bus;
+    private iframe;
+    /**
+     * Constructor - Initializes the composable container
+     *
+     * Sets up the secure iframe, establishes communication channels,
+     * and prepares the container for element creation and management.
+     *
+     * @param options - Container configuration (layout, styles, etc.)
+     * @param metaData - Client metadata and configuration
+     * @param skyflowElements - Global elements registry
+     * @param context - Application context with logging and config
+     */
+    constructor(options: any, metaData: any, skyflowElements: any, context: any);
+    /**
+     * Creates a new composable form element
+     *
+     * This method creates a secure form element (like card number, CVV, etc.)
+     * that will be rendered inside the secure iframe. The element is added to
+     * the container's element list but not yet mounted to the DOM.
+     *
+     * @param input - Element configuration (type, styles, validations, etc.)
+     * @param options - Additional options like required field validation
+     * @returns ComposableElement instance for further configuration
+     */
+    create: (input: CollectElementInput, options?: any) => ComposableElement;
+    /**
+     * Registers an event listener for container events
+     *
+     * Allows the application to listen for events like form submission,
+     * validation errors, or other container-level events.
+     *
+     * @param eventName - The name of the event to listen for
+     * @param handler - The callback function to execute when the event occurs
+     */
+    on: (eventName: string, handler: any) => void;
+    /**
+     * Mounts the container and its elements to a DOM element
+     *
+     * This method organizes the created elements according to the specified layout,
+     * applies styling, and renders them within the provided DOM element.
+     * The elements are rendered inside secure iframes for PCI compliance.
+     *
+     * @param domElement - The DOM element where the form should be mounted
+     */
+    mount: (domElement: any) => void;
+    /**
+     * Mounts the container element to the DOM and triggers a mounted event
+     *
+     * This method mounts the container element to the specified DOM element
+     * and then emits an event to notify the SDK that the container has been mounted.
+     *
+     * @param domElement - The DOM element where the container should be mounted
+     */
+    mountContainerElement: (domElement: string) => void;
+    /**
+     * Unmounts the container and cleans up all resources
+     *
+     * This method removes all elements from the DOM, clears internal state,
+     * and removes the iframe to prevent memory leaks.
+     */
+    unmount: () => void;
+    /**
+     * Validates all elements in the container
+     *
+     * Checks that all elements are mounted and triggers validation
+     * in the secure iframe. Returns a promise that resolves with
+     * validation results.
+     *
+     * @returns Promise that resolves with validation results
+     */
+    validate: () => Promise<unknown>;
+    /**
+     * Collects data from all elements in the container
+     *
+     * This method securely collects sensitive data from all mounted elements,
+     * validates the data, and optionally tokenizes it. The actual data collection
+     * happens within the secure iframe to maintain PCI compliance.
+     *
+     * @param options - Collection options (tokenization, additional fields, etc.)
+     * @returns Promise that resolves with collected/tokenized data
+     */
+    collect: (options?: ICollectOptions) => Promise<unknown>;
+    /**
+     * Resets all form elements to their initial state
+     *
+     * Clears all input values and resets validation states
+     * by sending a reset command to the secure iframe.
+     */
+    reset(): void;
 }
-interface CardMetadata {
-    bin?: string;
-    suffix?: string;
-    network?: string;
-    binLookup?: {
-        issuerCountry: Country;
-    };
+
+declare enum ContainerType {
+    COLLECT = "COLLECT",
+    COMPOSABLE = "COMPOSABLE"
 }
-interface BankAccountMetadata {
-    bankAccount: {
-        holder: HolderData;
-        bank: BankData;
-        account: AccountData;
-    };
+interface ISkyflow {
+    vaultID?: string;
+    vaultURL?: string;
+    getBearerToken: () => Promise<string>;
+    options?: Record<string, any>;
 }
-interface HolderData {
-    firstName?: string;
-    lastName?: string;
-    companyName?: string;
-    address?: Address;
-    email?: string;
-    dob?: string;
-    country?: Country;
-    city?: string;
-    type: HolderType;
+declare class Skyflow {
+    #private;
+    private bus;
+    constructor(config: ISkyflow);
+    static init(config: ISkyflow): Skyflow;
+    container(type: ContainerType, options?: Record<string, any>): CollectContainer | ComposableContainer;
+    static get ContainerType(): typeof ContainerType;
+    static get ElementType(): typeof ElementType$1;
+    static get RedactionType(): typeof RedactionType;
+    static get RequestMethod(): typeof RequestMethod$1;
+    static get LogLevel(): typeof LogLevel;
+    static get EventName(): typeof EventName;
+    static get Env(): typeof Env;
+    static get ValidationRuleType(): typeof ValidationRuleType;
 }
-type HolderType = 'individual' | 'corporate';
-interface BankData {
-    name?: string;
-    branchCode?: string;
-    code?: string;
-    address?: Address;
-    swiftCode?: string;
+
+type IframeEventBusLike = {
+    emit: (...args: any[]) => unknown;
+    on: (...args: any[]) => unknown;
+    off?: (...args: any[]) => unknown;
+};
+interface Mountable {
+    mount(selector: string | PayrailsElement): void;
+    unmount(): void;
 }
-interface AccountData {
-    number?: string;
-    iban?: string;
-    currency?: string;
-    type?: AccountType;
-    country?: Country;
+interface ElementOptions {
+    id?: string;
+    dataTestId?: string;
+    className?: string | string[];
+    styles?: Partial<CSSStyleDeclaration>;
 }
-type AccountType = 'savings' | 'current';
-interface Address {
-    country?: {
-        code?: string;
-        fullName?: string;
-        iso3?: string;
-    };
-    postalCode?: string;
+declare class PayrailsElement implements Mountable {
+    protected element: HTMLElement;
+    protected subElements: Array<Mountable>;
+    readonly id: string | undefined;
+    readonly dataTestId: string | undefined;
+    protected eventBus: IframeEventBusLike;
+    constructor(elementType: string, { id, className, dataTestId }?: ElementOptions);
+    get parentElement(): HTMLElement | null;
+    get selector(): string;
+    mount(location: string): void;
+    protected clean(): void;
+    unmount(): void;
 }
-declare enum PAYMENT_CLIENT_FLOW {
-    'REDIRECT' = "redirect",
-    'DIRECT' = "direct",
-    'EMBEDDED' = "embedded"
+
+interface TokenizeOptions {
+    futureUsage?: FutureUsages;
+    storeInstrument?: boolean;
 }
-declare enum INTEGRATION_TYPE {
-    API = "api",
-    HPP = "hpp"
+declare abstract class Tokenizable extends PayrailsElement {
+    protected abstract collect(): Promise<any>;
+    protected abstract constructSaveInstrumentBody(tokens: any, opts?: TokenizeOptions): Promise<any>;
+    tokenize(_opts?: TokenizeOptions): Promise<any>;
 }
 
-type FutureUsages = 'CardOnFile' | 'Subscription' | 'UnscheduledCardOnFile';
-interface SaveInstrumentResponse {
-    id: string;
-    createdAt: string;
-    holderId: string;
-    paymentMethod: PAYMENT_METHOD_CODES.CARD;
-    status: PAYMENT_INSTRUMENT_STATUS;
-    data: {
-        bin: string;
-        binLookup?: {
-            bin: string;
-            network: string;
-            issuer?: string;
-            issuerCountry?: {
-                code?: string;
-                name?: string;
-                iso3?: string;
-            };
-            type?: string;
-        };
-        holderName?: string;
-        network: string;
-        suffix: string;
-        expiryMonth?: string;
-        expiryYear?: string;
-    };
-    fingerprint?: string;
-    futureUsage?: string;
+declare enum ElementType {
+    CARD_NUMBER = "CARD_NUMBER",
+    CARDHOLDER_NAME = "CARDHOLDER_NAME",
+    CVV = "CVV",
+    EXPIRATION_MONTH = "EXPIRATION_MONTH",
+    EXPIRATION_YEAR = "EXPIRATION_YEAR",
+    EXPIRATION_DATE = "EXPIRATION_DATE",
+    CARD_FORM = "CARD_FORM"
 }
 
-interface SdkConfiguration {
-    token: string;
-    amount: PayrailsAmount;
-    holderReference: string;
-    links?: {
-        binLookup?: Links;
-        instrumentDelete?: Links;
-        instrumentUpdate?: Links;
-    };
-    type?: 'tokenization' | 'dropIn' | 'secureFields';
-    vaultConfiguration: {
-        cardTableName: string;
-        token: string;
-        vaultId: string;
-        vaultUrl: string;
-        providerId: string;
-        providerConfigId: string;
-        vaultType: 'Payrails' | 'Test';
-        encryptionPublicKey?: string;
-        links: {
-            saveInstrument: {
-                href: string;
-            };
+type FieldErrors = Partial<Record<'cardNumber' | 'expiry' | 'cvv' | 'holderName', string>>;
+type ValidateCardFormResult = {
+    isValid: boolean;
+    error?: string;
+    fieldErrors?: FieldErrors;
+};
+interface EncryptedCollectResult {
+    vaultProviderConfigId: string;
+    encryptedData: string;
+}
+interface CollectElementOptions {
+    type: ElementType;
+    label?: string;
+    placeholder?: string;
+    altText?: string;
+    format?: string;
+    inputStyles?: object;
+    labelStyles?: object;
+    errorTextStyles?: object;
+    required?: boolean;
+    enableCardIcon?: boolean;
+    translations?: {
+        error?: {
+            default?: string;
         };
     };
-    execution?: WorkflowExecutionResponse;
-    featureConfig?: SdkFeatureConfig;
 }
-interface SdkFeatureConfig {
-    gpayIframeRollout?: number;
+type PayrailsContainerType = 'COLLECT' | 'COMPOSABLE';
+interface CollectContainerOptions {
+    layout?: number[];
+    cardTableName?: string;
+    containerType?: PayrailsContainerType;
+    containerId?: string;
+    styles?: {
+        base?: Partial<CSSStyleDeclaration>;
+    };
+    errorTextStyles?: {
+        base?: Partial<CSSStyleDeclaration>;
+    };
+    fonts?: FontDescriptor[];
 }
-interface PayrailsAmount {
-    value: string;
-    currency: string;
+type PayrailsSecureFieldEvent = 'CHANGE' | 'FOCUS' | 'BLUR' | 'READY' | 'SUBMIT';
+interface PayrailsSecureField {
+    on(eventName: PayrailsSecureFieldEvent, handler: any): void;
+    mount?: (domElement: any) => void;
+    unmount?: () => void;
+    focus: () => void;
+    getState?: () => {
+        isEmpty: boolean;
+        isComplete: boolean;
+        isValid: boolean;
+        isFocused: boolean;
+        value: unknown;
+        required: boolean;
+    };
+    setError?: (clientErrorText: string) => void;
+    resetError?: () => void;
+    update?: (data: Partial<CollectElementOptions>) => void;
+    setAttribute: (attribute: string, value: string | number) => void;
 }
-interface LookupUpdateOptions {
-    value?: string;
-    currency?: string;
-    installmentConfig?: InstallmentUpdateConfig | null;
-    meta?: ExecutionMetaUpdate;
+interface FramesContainer extends Mountable {
+    createCollectElement: (options: CollectElementOptions) => PayrailsSecureField;
+    fetchBinLookup: (bin: string) => Promise<{
+        bin: string;
+    }>;
+    validate: () => Promise<ValidateCardFormResult>;
+    collect: () => Promise<EncryptedCollectResult>;
+    tokenize: (opts: TokenizeOptions) => Promise<any>;
+    reset: () => void;
+    bin: string;
+    isBinLookupEnabled: boolean;
+    readonly id: string;
+    readonly dataTestId: string;
+    readonly className: string;
 }
-interface Links {
-    method: 'GET' | 'POST';
-    href: string;
+declare class PayrailsCollectContainer implements FramesContainer {
+    bin: string;
+    isBinLookupEnabled: boolean;
+    readonly id = "payrails-container-wrapper";
+    readonly dataTestId = "payrails-container-wrapper";
+    readonly className = "payrails-container-wrapper";
+    private static instance;
+    private readonly __container;
+    private element;
+    private readonly cardTableName;
+    private readonly containerType;
+    private manualErrorElements;
+    constructor(__client: Skyflow, options: CollectContainerOptions);
+    static init(vaultClient: Skyflow, options: CollectContainerOptions): PayrailsCollectContainer;
+    createCollectElement(options: CollectElementOptions): PayrailsSecureField;
+    mount(selector: string): void;
+    unmount(): void;
+    validate(): Promise<ValidateCardFormResult>;
+    collect(): Promise<EncryptedCollectResult>;
+    reset(): void;
+    private collectPayrailsData;
+    tokenize(opts: TokenizeOptions): Promise<SaveInstrumentResponse>;
+    private attachCustomEventHandler;
+    private formatBin;
+    private get elementToFieldMap();
+    fetchBinLookup: (bin: string) => Promise<BinLookupResponse | {
+        bin: string;
+    }>;
 }
 
-interface ReturnInfo {
-    success?: string;
-    cancel?: string;
-    error?: string;
-    pending?: string;
-}
-interface PayoutResponse {
-    name: 'payout';
-    executedAt: string;
-    workspaceId: string;
-    actionId: string;
-    links: {
-        execution: string;
-    };
-}
-type PayoutComposition = Array<{
-    integrationType: string;
-    amount: PayrailsAmount;
-    paymentMethodCode: PaymentMethodCode;
-    paymentInstrumentId?: string;
-}>;
-interface PayoutReqBody {
-    amount: PayrailsAmount;
-    payoutComposition: PayoutComposition;
-}
-type ERROR_RESULT = 'Unknown' | 'UnexpectedProviderResponse' | 'ProviderUnknownError' | 'ProviderConnectionError' | 'Timeout' | 'ProviderTimeout' | 'GenericRejection' | 'DuplicateOperation' | 'OperationNotAllowed' | 'NetworkTransactionReferenceRejected' | 'PayerCanceled' | 'LimitExceeded' | 'InstrumentNotAllowed' | 'InvalidInstrument' | 'InsufficientBalance' | 'BlockedInstrument' | 'ExpiredInstrument' | 'ValidationError' | 'ParamsError' | 'ProviderConfigError' | 'InvalidSignature' | 'InternalServerError' | 'AuthenticationError' | 'PaymentMethodNotSupported' | 'PayerAuthenticationRequired' | 'PayerAuthenticationFailed' | 'FraudRisk';
+declare const UI_POSITION_FIELD = "ui:position";
 
-type IframeEventBusLike = {
-    emit: (...args: any[]) => unknown;
-    on: (...args: any[]) => unknown;
-    off?: (...args: any[]) => unknown;
+type JSONSchemaType = JSONSchemaProperty & {
+    required?: string[];
+    dependentSchemas?: Record<string, JSONSchemaDependentSchema>;
 };
-interface Mountable {
-    mount(selector: string | PayrailsElement): void;
-    unmount(): void;
+interface JSONSchemaOneOfOption {
+    const: string | number;
+    title: string;
 }
-interface ElementOptions {
-    id?: string;
-    dataTestId?: string;
-    className?: string | string[];
-    styles?: Partial<CSSStyleDeclaration>;
+interface JSONSchemaDependentSchema {
+    oneOf: Array<{
+        properties: Record<string, {
+            const: string | number;
+        }>;
+        required: string[];
+    }>;
 }
-declare class PayrailsElement implements Mountable {
-    protected element: HTMLElement;
-    protected subElements: Array<Mountable>;
-    readonly id: string | undefined;
-    readonly dataTestId: string | undefined;
-    protected eventBus: IframeEventBusLike;
-    constructor(elementType: string, { id, className, dataTestId }?: ElementOptions);
-    get parentElement(): HTMLElement | null;
-    get selector(): string;
-    mount(location: string): void;
-    protected clean(): void;
-    unmount(): void;
+interface JSONSchemaProperty {
+    type?: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    title?: string;
+    oneOf?: JSONSchemaOneOfOption[];
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    errorMessage?: Record<string, string>;
+    $ref?: string;
+    [UI_POSITION_FIELD]?: number;
+    properties?: Record<string, JSONSchemaType>;
 }
-
-interface IAddress {
-    country?: {
-        code?: string;
-        fullName?: string;
-        iso3?: string;
-    };
-    postalCode?: string;
+interface DynamicElementEvents {
+    onReady?: () => void;
+    onValidationChange?: (isValid: boolean) => void;
 }
-interface IOnChange {
-    isValid: boolean;
-    billingAddress?: IAddress;
+interface DynamicElementFieldEvents {
+    onChange: (value: any) => void;
+    onReady: (initialValue: any) => void;
+    onBlur: () => void;
 }
-interface AddressSelectorElementOptions extends ElementOptions {
-    translations?: {
-        labels?: {
-            countrySelector?: string;
-            postalCodeInput?: string;
-        };
-        placeholders?: {
-            postalCodeInput?: string;
-            countrySelector?: string;
-        };
-    };
-    styles?: {
-        wrapper?: Partial<CSSStyleDeclaration>;
-        countrySelector?: {
-            wrapper?: Partial<CSSStyleDeclaration>;
-            element?: Partial<CSSStyleDeclaration>;
-            label?: Partial<CSSStyleDeclaration>;
-        };
-        postalCodeInput?: {
-            wrapper?: Partial<CSSStyleDeclaration>;
-            element?: Partial<CSSStyleDeclaration>;
-            label?: Partial<CSSStyleDeclaration>;
-        };
-    };
-    events?: {
-        onBillingAddressChanged?: (e: IOnChange) => void;
-    };
+interface DynamicElementFieldTranslation {
+    label?: string;
+    placeholder?: string;
+    errors?: Partial<DynamicElementErrorTranslation>;
 }
-
-interface StoreInstrumentElementOptions extends ElementOptions {
-    showStoreInstrumentCheckbox?: boolean;
-    alwaysStoreInstrument?: boolean;
-    defaultStoreInstrumentState?: 'checked' | 'unchecked';
-    translations?: {
-        labels?: {
-            storeInstrument?: string;
-            saveInstrument?: string;
-        };
-    };
-    styles?: {
-        storeInstrumentCheckbox?: Partial<CSSStyleDeclaration>;
+interface DynamicElementErrorTranslation {
+    required: string;
+    minLength: string;
+    maxLength: string;
+    pattern: string;
+    oneOf: string;
+}
+type DynamicElementTranslations = {
+    fields?: Record<string, DynamicElementFieldTranslation>;
+    errors?: Partial<DynamicElementErrorTranslation>;
+};
+interface DynamicElementElementStyles {
+    base?: Partial<CSSStyleDeclaration>;
+    complete?: Partial<CSSStyleDeclaration>;
+    empty?: Partial<CSSStyleDeclaration>;
+    focus?: Partial<CSSStyleDeclaration>;
+    invalid?: Partial<CSSStyleDeclaration>;
+}
+type DynamicElementInputFieldStyles = DynamicElementElementStyles;
+type DynamicElementSelectFieldStyles = DynamicElementElementStyles;
+interface DynamicElementTabsFieldStyles {
+    tab: {
+        base?: Partial<CSSStyleDeclaration>;
+        active?: Partial<CSSStyleDeclaration>;
     };
-    events?: PayrailsSDKEvents;
+    container?: DynamicElementElementStyles;
 }
-declare class StoreInstrumentCheckbox extends PayrailsElement {
-    private options;
-    constructor(options: StoreInstrumentElementOptions);
-    get isChecked(): boolean;
-    private createHTML;
-    private applyStyles;
-    private addListeners;
+interface DynamicElementFieldStyles {
+    base?: Partial<CSSStyleDeclaration>;
+    label?: Partial<CSSStyleDeclaration>;
+    errors?: Partial<CSSStyleDeclaration>;
+    input?: DynamicElementInputFieldStyles;
+    select?: DynamicElementSelectFieldStyles;
+    tabs?: DynamicElementTabsFieldStyles;
 }
-declare abstract class PayrailsElementWithStoreInstrumentCheckbox extends PayrailsElement {
-    protected options?: StoreInstrumentElementOptions | undefined;
-    protected storeInstrumentCheckbox: StoreInstrumentCheckbox | null;
-    protected constructor(elementType: string, options?: StoreInstrumentElementOptions | undefined);
-    protected get shouldStoreInstrument(): boolean;
+interface DynamicElementStyles {
+    all: Omit<DynamicElementFieldStyles, 'label'>;
+    fields?: Record<string, DynamicElementFieldStyles>;
 }
 
-interface ApplePayButtonOptions extends StoreInstrumentElementOptions {
-    clientDomain?: string;
-    showPaymentMethodLogo?: boolean;
-    abortAfterAuthorizeFailed?: boolean;
-    translations?: {
-        labels?: {
-            storeInstrument?: string;
-            saveInstrument?: string;
-            paymentScreenLabel?: string;
-        };
-    };
-    events?: PaymentEvents & Pick<UIEvents, 'onDeliveryAddressChanged'> & {
-        onApplePayAvailable?: () => void;
-    };
-    styles?: {
-        type?: 'plain' | 'buy' | 'addMoney' | 'book' | 'checkout' | 'continue' | 'contribute' | 'donate' | 'inStore' | 'order' | 'reload' | 'rent' | 'setUp' | 'subscribe' | 'support' | 'tip' | 'topUp';
-        style?: 'white' | 'whiteOutline' | 'black' | 'automatic';
-        locale?: string;
-    } & StoreInstrumentElementOptions['styles'];
-}
-declare class ApplePayButton extends PayrailsElementWithStoreInstrumentCheckbox {
-    protected options: ApplePayButtonOptions;
-    private appleButton;
-    private paymentExecutor;
-    private action;
-    private isProcessing;
-    private completedSessions;
-    private abortedSessionReasons;
-    static isApplePayAvailable(): Promise<boolean>;
-    constructor(options: ApplePayButtonOptions);
-    mount(location: string): void;
-    unmount(): void;
-    private mountApplePayButton;
-    private onAuthorizeFailedHandler;
-    private completeApplePaySession;
-    private createApplePaySession;
-    /**
-     * Apple Pay only exposes redacted contact fields here for privacy
-     * (`countryCode`, `administrativeArea`, `locality`, `postalCode`); full
-     * address is revealed in `onpaymentauthorized` after the user authorizes.
-     *
-     * The session must be answered with `completeShippingContactSelection`
-     * within ~30s or Apple aborts the sheet — so the merchant's
-     * `onDeliveryAddressChanged` callback must be fast.
-     *
-     * `amount` is passed in (rather than read from `getSDKConfig()`) so the
-     * response carries the same total the session was created with, even if
-     * the SDK config is mutated mid-flow.
-     */
-    private onApplePayShippingContactSelected;
-    private onApplePayAuthorized;
-    private doAuthorizedPayment;
-    private doTokenize;
+declare enum PAYMENT_METHOD_CODES {
+    'CARD' = "card",
+    'GOOGLE_PAY' = "googlePay",
+    'PAYPAL' = "payPal",
+    'APPLE_PAY' = "applePay",
+    'GENERIC_REDIRECT' = "genericRedirect",
+    'LEAN' = "lean",
+    'MERCADO_PAGO' = "mercadoPago",
+    'PIX' = "pix",
+    'BANK_ACCOUNT' = "bankAccount",
+    'IDEAL' = "iDeal",
+    'YAPE' = "yape",
+    'UPI' = "upi",
+    'KLARNA' = "klarna",
+    'ONE_VOUCHER' = "1voucher",
+    'ALFA' = "alfa",
+    'APLAZO' = "aplazo",
+    'BANK_TRANSFER' = "bankTransfer",
+    'CAPITEC_PAY' = "capitecPay",
+    'EASYPAISA' = "easypaisa",
+    'EFT_PRO' = "eftPro",
+    'FAWRY_PAY' = "fawryPay",
+    'JAZZ_CASH' = "jazzCash",
+    'KONNECT' = "konnect",
+    'KUESKI' = "kueski",
+    'MONO_DIRECT_DEBIT' = "monoDirectDebit",
+    'O_PAY_WALLET' = "oPayWallet",
+    'PAGA_WALLET' = "pagaWallet",
+    'PAYFLEX' = "payflex",
+    'PAY_JUST_NOW' = "payjustnow",
+    'WAFA_CASH_WALLET' = "wafaCashWallet",
+    'MERCADO_PAGO_WALLET' = "mercadoPagoWallet",
+    'MERCADO_PAGO_CONSUMER_CREDIT' = "mercadoPagoConsumerCredit",
+    'NET_BANKING' = "netBanking",
+    'CASH_FREE_WALLET' = "cashFreeWallet",
+    'PAYTM_WALLET' = "paytmWallet",
+    'NIBSS_PAY' = "nibssPay",
+    'NIBSS_INSTANT_PAY' = "nibssInstantPay",
+    'MEEZA_WALLET' = "meezaWallet",
+    'VODAFONE_CASH' = "vodafoneCash",
+    'SEPA_DIRECT_DEBIT' = "sepaDirectDebit",
+    'MODO' = "modo",
+    'PAYZONE_CASH' = "payzoneCash",
+    'REVOLUT_PAY' = "revolutPay"
 }
-
-interface BinLookupResponse {
-    bin: string;
-    network: string;
-    issuer?: string;
-    issuerCountry?: {
-        code?: string;
+declare const PAYMENT_METHOD_CODE_BY_METHOD: { readonly [K in keyof typeof PAYMENT_METHOD_CODES]: (typeof PAYMENT_METHOD_CODES)[K]; };
+type PaymentMethodCode = PAYMENT_METHOD_CODES | (typeof PAYMENT_METHOD_CODE_BY_METHOD)[keyof typeof PAYMENT_METHOD_CODE_BY_METHOD] | (string & {});
+declare enum PAYMENT_INSTRUMENT_STATUS {
+    'ENABLED' = "enabled",
+    'CREATED' = "created",
+    'DELETED' = "deleted",
+    'DISABLED' = "disabled",
+    'INVALID' = "invalid",
+    'TRANSIENT' = "transient"
+}
+type ExecutionMetaKey = keyof ExecutionMetaByKey;
+interface ExecutionMetaCustomer {
+    phone?: {
+        countryCode?: string;
+        number?: string;
+    };
+    country?: {
         name?: string;
+        code?: string;
         iso3?: string;
     };
+    reference?: string;
+    name?: string;
+    lastName?: string;
+    email?: string;
     type?: string;
+    birthDate?: string;
+    language?: string;
+    identityCardNumber?: string;
 }
-
-declare enum RedactionType {
-    DEFAULT = "DEFAULT",
-    PLAIN_TEXT = "PLAIN_TEXT",
-    MASKED = "MASKED",
-    REDACTED = "REDACTED"
+interface ExecutionMetaOrder {
+    billingAddress?: {
+        country?: {
+            name?: string;
+            code?: string;
+            iso3?: string;
+        };
+    };
 }
-declare enum RequestMethod$1 {
-    GET = "GET",
-    POST = "POST",
-    PUT = "PUT",
-    PATCH = "PATCH",
-    DELETE = "DELETE"
+type ExecutionMetaByKey = {
+    customer: ExecutionMetaCustomer;
+};
+type ExecutionMetaUpdate = {
+    [Key in ExecutionMetaKey]: {
+        key: Key;
+        value: ExecutionMetaByKey[Key];
+    };
+}[ExecutionMetaKey];
+interface ExecutionMeta {
+    customer?: ExecutionMetaCustomer;
+    order?: ExecutionMetaOrder;
 }
-declare enum EventName {
-    CHANGE = "CHANGE",
-    READY = "READY",
-    FOCUS = "FOCUS",
-    BLUR = "BLUR",
-    SUBMIT = "SUBMIT"
+declare class WorkflowExecution {
+    private static _updatedMetaKeys;
+    private static _response;
+    static get response(): WorkflowExecutionResponse;
+    static setResponse(response: WorkflowExecutionResponse): typeof WorkflowExecution;
+    /**
+     * Non-throwing read of the current execution id. Returns `undefined` when
+     * the workflow execution hasn't been initialized yet. Prefer this over
+     * `WorkflowExecution.response.id` in observational code paths (event
+     * emission, logging, analytics) where the workflow not being loaded should
+     * degrade gracefully instead of throwing.
+     */
+    static get executionId(): string | undefined;
+    static get workflowCode(): string;
+    static get lookup(): {
+        httpCode: number;
+        body: {
+            data: {
+                paymentCompositionOptions?: Array<StorablePaymentCompositionOption>;
+                payoutCompositionOptions?: Array<StorablePaymentCompositionOption>;
+            };
+            links: {
+                execution: string;
+                authorize?: {
+                    href: string;
+                    method: "POST";
+                };
+                payout?: {
+                    href: string;
+                    method: "POST";
+                };
+                startPaymentSession?: {
+                    href: string;
+                    method: "POST";
+                };
+                createInstrument?: {
+                    href: string;
+                    method: "POST";
+                };
+            };
+            name: "lookup";
+        };
+    } | undefined;
+    static get holderReference(): string;
+    static get savedCreditCards(): StoredPaymentInstrument<CardMetadata>[];
+    static get savedPaypalAccounts(): StoredPaymentInstrument<PayPalMetadata>[];
+    static get savedGooglePayAccounts(): StoredPaymentInstrument<CardMetadata>[];
+    static get savedApplePayAccounts(): StoredPaymentInstrument<CardMetadata>[];
+    static get paypalConfig(): PayPalConfig;
+    static get googlePayConfig(): any;
+    static isPaymentMethodAvailable(paymentMethod: PaymentMethodCode): boolean;
+    static get applePayConfig(): {
+        merchantIdentifier: string;
+        supportedNetworks: string[];
+        countryCode: string;
+        merchantCapabilities: ApplePayJS.ApplePayMerchantCapability[];
+        requiredBillingContactFields?: ApplePayJS.ApplePayContactField[];
+        requiredShippingContactFields?: ApplePayJS.ApplePayContactField[];
+    };
+    static get url(): string;
+    static get meta(): ExecutionMeta;
+    static get availablePaymentMethods(): StorablePaymentCompositionOption<CardMetadata | PayPalMetadata, ApplePayConfig | PayPalConfig | GooglePayWorkflowConfig | undefined>[];
+    static get authorizeLink(): string | undefined;
+    static get payoutLink(): string | undefined;
+    static get createSessionLink(): string | undefined;
+    static get createInstrumentLink(): string | undefined;
+    static get storedPaymentInstruments(): StoredPaymentInstrument<PayPalMetadata & CardMetadata>[];
+    static get storedDropinInstruments(): StoredPaymentInstrument<PayPalMetadata & CardMetadata>[];
+    static getFullPaymentMethodConfig(paymentMethod: PaymentMethodCode): StorablePaymentCompositionOption<CardMetadata | PayPalMetadata, ApplePayConfig | PayPalConfig | GooglePayWorkflowConfig | undefined> | undefined;
+    static isAddressSelectorEnabled(paymentMethod: PaymentMethodCode): boolean | undefined;
+    static isPaymentInstallmentsEnabled(paymentMethod: PaymentMethodCode): boolean | undefined;
+    static getPaymentInstallmentOptions(paymentMethod: PaymentMethodCode): PaymentInstallmentsConfig;
+    static getStoredInstrumentForPaymentMethod<T = CardMetadata | PayPalMetadata>(paymentMethod: PaymentMethodCode): Array<StoredPaymentInstrument<T>>;
+    static getPaymentMethodForStoredInstrument<T extends CardMetadata | PayPalMetadata>(instrument: StoredPaymentInstrument<T>): {
+        id: string;
+        description?: string;
+        status: PAYMENT_INSTRUMENT_STATUS;
+        integrationType: INTEGRATION_TYPE;
+        config: ApplePayConfig | PayPalConfig | GooglePayWorkflowConfig | undefined;
+        clientConfig?: {
+            flow?: PAYMENT_CLIENT_FLOW;
+            displayName?: string;
+            supportsInstallments?: boolean;
+            installments?: PaymentInstallmentsConfig;
+            supportsBillingInfo?: boolean;
+            schema?: JSONSchemaType;
+            additionalConfig?: any;
+            instrumentDataSchema?: JSONSchemaType;
+        };
+        payoutInstruments?: StoredPaymentInstrument<CardMetadata | PayPalMetadata>[] | undefined;
+        paymentMethodCode: PaymentMethodCode;
+        payoutMethodCode?: PaymentMethodCode;
+    } | undefined;
+    static getPaymentMethodConfig(paymentMethod: StorablePaymentCompositionOption): {
+        id: string;
+        description?: string;
+        status: PAYMENT_INSTRUMENT_STATUS;
+        integrationType: INTEGRATION_TYPE;
+        config: ApplePayConfig | PayPalConfig | GooglePayWorkflowConfig | undefined;
+        clientConfig?: {
+            flow?: PAYMENT_CLIENT_FLOW;
+            displayName?: string;
+            supportsInstallments?: boolean;
+            installments?: PaymentInstallmentsConfig;
+            supportsBillingInfo?: boolean;
+            schema?: JSONSchemaType;
+            additionalConfig?: any;
+            instrumentDataSchema?: JSONSchemaType;
+        };
+        payoutInstruments?: StoredPaymentInstrument<CardMetadata | PayPalMetadata>[] | undefined;
+        paymentMethodCode: PaymentMethodCode;
+        payoutMethodCode?: PaymentMethodCode;
+    };
+    static updateInstallmentOptions(installmentOptions?: PaymentInstallmentsConfig): void;
+    static updateMeta<K extends ExecutionMetaKey>(key: K, value: ExecutionMetaByKey[K]): void;
+    static getAllowedMeta(): ExecutionMeta;
+    static getUpdatedMeta(): ExecutionMeta;
+    private static pickMetaByKeys;
+}
+interface WorkflowExecutionResponse {
+    id: string;
+    merchantReference: string;
+    holderReference: string;
+    holderId?: string;
+    actionRequired?: string;
+    meta: ExecutionMeta;
+    status: Array<{
+        code: string;
+        time: string;
+    }>;
+    initialResults: Array<{
+        httpCode: number;
+        body: {
+            data: {
+                paymentCompositionOptions?: Array<StorablePaymentCompositionOption>;
+                payoutCompositionOptions?: Array<StorablePaymentCompositionOption>;
+            };
+            links: {
+                execution: string;
+                authorize?: {
+                    href: string;
+                    method: 'POST';
+                };
+                payout?: {
+                    href: string;
+                    method: 'POST';
+                };
+                startPaymentSession?: {
+                    href: string;
+                    method: 'POST';
+                };
+                createInstrument?: {
+                    href: string;
+                    method: 'POST';
+                };
+            };
+            name: 'lookup';
+        };
+    }>;
+    links: {
+        startPaymentSession?: {
+            href: string;
+            method: 'POST';
+        };
+        createInstrument?: {
+            href: string;
+            method: 'POST';
+        };
+        confirm?: {
+            href: string;
+            action?: {
+                parameters?: {
+                    orderId?: string;
+                    tokenId?: string;
+                };
+                paymentId?: string;
+                sdkToken?: string;
+                appToken?: string;
+                successUrl?: string;
+                failureUrl?: string;
+                sandbox?: boolean;
+            };
+        };
+        redirect?: string;
+        '3ds'?: string;
+        self: string;
+    };
+    workflow: {
+        code: string;
+        version: number;
+    };
 }
-declare enum LogLevel {
-    WARN = "WARN",
-    INFO = "INFO",
-    DEBUG = "DEBUG",
-    ERROR = "ERROR"
+interface BasePaymentMethodConfig {
+    paymentMethodCode: PaymentMethodCode;
+    payoutMethodCode?: PaymentMethodCode;
 }
-declare enum Env {
-    DEV = "DEV",
-    PROD = "PROD"
+interface BaseInstallmentOption {
+    count: number;
+    amount: number;
 }
-declare enum ValidationRuleType {
-    REGEX_MATCH_RULE = "REGEX_MATCH_RULE",
-    LENGTH_MATCH_RULE = "LENGTH_MATCH_RULE",
-    ELEMENT_VALUE_MATCH_RULE = "ELEMENT_VALUE_MATCH_RULE"
+interface PaymentInstallmentsConfig {
+    [key: string]: BaseInstallmentOption[];
 }
-interface IInsertRecordInput {
-    records: IInsertRecord[];
+interface InstallmentUpdateConfig {
+    defaultInstallment?: number | null;
+    installmentCountry?: string | null;
+    installmentOptions?: BaseInstallmentOption[] | null;
 }
-interface IInsertRecord {
-    table: string;
-    fields: Record<string, any>;
-    skyflowID?: string;
+interface StorablePaymentCompositionOption<I = CardMetadata | PayPalMetadata, C = undefined | ApplePayConfig | PayPalConfig | GooglePayWorkflowConfig> extends BasePaymentMethodConfig {
+    id: string;
+    description?: string;
+    status: PAYMENT_INSTRUMENT_STATUS;
+    integrationType: INTEGRATION_TYPE;
+    config: C;
+    clientConfig?: {
+        flow?: PAYMENT_CLIENT_FLOW;
+        displayName?: string;
+        supportsInstallments?: boolean;
+        installments?: PaymentInstallmentsConfig;
+        supportsBillingInfo?: boolean;
+        schema?: JSONSchemaType;
+        additionalConfig?: any;
+        instrumentDataSchema?: JSONSchemaType;
+    };
+    paymentInstruments?: Array<StoredPaymentInstrument<I>>;
+    payoutInstruments?: Array<StoredPaymentInstrument<I>>;
 }
-interface Context {
-    logLevel: LogLevel;
-    env: Env;
+interface GooglePayWorkflowConfig {
+    parameters: {
+        allowedAuthMethods: google.payments.api.CardAuthMethod[];
+        allowedCardNetworks: google.payments.api.CardNetwork[];
+        billingAddressParameters?: {
+            format?: string;
+        };
+        billingAddressRequired?: boolean;
+    };
+    tokenizationSpecification: google.payments.api.PaymentMethodTokenizationSpecification;
+    type: google.payments.api.PaymentMethodType;
+    apiVersion?: number;
+    apiVersionMinor?: number;
+    allowedPaymentMethods?: google.payments.api.PaymentMethodSpecification[];
+    emailRequired?: boolean;
+    shippingAddressRequired?: boolean;
+    shippingAddressParameters?: google.payments.api.ShippingAddressParameters;
+    merchantInfo?: google.payments.api.MerchantInfo;
+    existingPaymentMethodRequired?: boolean;
 }
-interface IValidationRule {
-    type: ValidationRuleType;
-    params: any;
+interface PayPalConfig {
+    clientId: string;
+    merchantId: string;
+    captureMode: 'Delayed' | 'Instant' | 'Manual';
+    integrationMode: 'express' | 'normal';
 }
-
-interface IUpsertOptions {
-    table: string;
-    column: string;
+interface ApplePayConfig {
+    parameters: {
+        merchantIdentifier: string;
+        supportedNetworks: string[];
+        countryCode: string;
+        merchantCapabilities: ApplePayJS.ApplePayMerchantCapability[];
+        requiredBillingContactFields?: ApplePayJS.ApplePayContactField[];
+        requiredShippingContactFields?: ApplePayJS.ApplePayContactField[];
+    };
+    type: string;
 }
-
-declare enum ElementType$1 {
-    CVV = "CVV",
-    EXPIRATION_DATE = "EXPIRATION_DATE",
-    CARD_NUMBER = "CARD_NUMBER",
-    CARDHOLDER_NAME = "CARDHOLDER_NAME",
-    INPUT_FIELD = "INPUT_FIELD",
-    PIN = "PIN",
-    EXPIRATION_MONTH = "EXPIRATION_MONTH",
-    EXPIRATION_YEAR = "EXPIRATION_YEAR"
+interface StoredPaymentInstrument<T = CardMetadata | PayPalMetadata | BankAccountMetadata> {
+    id: string;
+    status: PAYMENT_INSTRUMENT_STATUS;
+    paymentMethod: PaymentMethodCode;
+    displayName?: string;
+    data?: T;
+    default?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    holderId?: string;
+    fingerprint?: string;
+    futureUsage?: FutureUsages;
 }
-
-declare abstract class Container {
+interface PayPalMetadata {
+    email?: string;
 }
-
-declare class EventEmitter {
-    events: Record<string, {
-        priority: boolean;
-        callback: Function;
-    }[]>;
-    constructor();
-    on(event: string, callback: Function, priority?: boolean): void;
-    off(event: string, callback: Function): void;
-    _emit(event: string, ...args: any[]): void;
-    hasListener(event: string): boolean;
-    resetEvents(): void;
-    static createChild(ChildObject: any): void;
+interface Country {
+    code: string;
+    name: string;
+    iso3: string;
 }
-
-declare abstract class SkyflowElement {
-    abstract mount(domElementSelector: any): any;
-    abstract unmount(): any;
-    abstract setError(clientErrorText: string): any;
-    abstract resetError(): any;
-    abstract iframeName(): any;
-    abstract getID(): any;
+interface CardMetadata {
+    bin?: string;
+    suffix?: string;
+    network?: string;
+    binLookup?: {
+        issuerCountry: Country;
+    };
 }
-
-declare class CollectElement extends SkyflowElement {
-    #private;
-    elementType: string;
-    type: string;
-    containerId: string;
-    constructor(elementId: string, elementGroup: any, metaData: any, container: any, isSingleElementAPI: boolean | undefined, destroyCallback: Function, updateCallback: Function, context: Context, groupEventEmitter?: EventEmitter);
-    getID: () => string;
-    mount: (domElement: any) => void;
-    unmount: () => void;
-    update: (group: any) => void;
-    updateElement: (elementOptions: any) => void;
-    getState: () => {
-        isEmpty: boolean;
-        isComplete: boolean;
-        isValid: boolean;
-        isFocused: boolean;
-        value: string | Object | Blob | undefined;
-        required: boolean;
+interface BankAccountMetadata {
+    bankAccount: {
+        holder: HolderData;
+        bank: BankData;
+        account: AccountData;
     };
-    getOptions: () => any;
-    on(eventName: string, handler: any): void;
-    iframeName(): string;
-    isMounted(): boolean;
-    isValidElement(): boolean;
-    setError(clientErrorText: string): void;
-    resetError(): void;
-    setValue(elementValue: string): void;
-    clearValue(): void;
-    setAttribute(attribute: string, value: string | number): void;
-    focus(): void;
 }
-
-interface CollectElementInput$1 {
-    table?: string;
-    column?: string;
-    inputStyles?: object;
-    label?: string;
-    labelStyles?: object;
-    errorTextStyles?: object;
-    placeholder?: string;
-    type: ElementType$1;
-    altText?: string;
-    validations?: IValidationRule[];
-    skyflowID?: string;
+interface HolderData {
+    firstName?: string;
+    lastName?: string;
+    companyName?: string;
+    address?: Address;
+    email?: string;
+    dob?: string;
+    country?: Country;
+    city?: string;
+    type: HolderType;
 }
-interface ICollectOptions$1 {
-    tokens?: boolean;
-    additionalFields?: IInsertRecordInput;
-    upsert?: Array<IUpsertOptions>;
+type HolderType = 'individual' | 'corporate';
+interface BankData {
+    name?: string;
+    branchCode?: string;
+    code?: string;
+    address?: Address;
+    swiftCode?: string;
 }
-declare class CollectContainer extends Container {
-    #private;
-    type: string;
-    private bus;
-    private iframe;
-    constructor(options: any, metaData: any, skyflowElements: any, context: any);
-    create: (input: CollectElementInput$1, options?: any) => CollectElement;
-    validate: () => Promise<unknown>;
-    collect: (options?: ICollectOptions$1) => Promise<unknown>;
-    reset(): void;
-    unmount: () => void;
+interface AccountData {
+    number?: string;
+    iban?: string;
+    currency?: string;
+    type?: AccountType;
+    country?: Country;
+}
+type AccountType = 'savings' | 'current';
+interface Address {
+    country?: {
+        code?: string;
+        fullName?: string;
+        iso3?: string;
+    };
+    postalCode?: string;
 }
-
-/**
- * Descriptor for a custom font to be injected or referenced by the card/secure-fields iframes.
- *
- * This mirrors Stripe-like font configuration where you can provide either a CSS URL that
- * includes @font-face declarations (cssSrc) or provide full @font-face fields to be injected.
- *
- * Examples:
- *  - { cssSrc: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap' }
- *  - { family: 'Inter', src: 'https://cdn.example.com/fonts/Inter.woff2', weight: 400, style: 'normal', display: 'swap' }
- */
-interface FontDescriptor {
-    cssSrc?: string;
-    family?: string;
-    src?: string;
-    style?: string;
-    weight?: string | number;
-    unicodeRange?: string;
-    display?: string;
+declare enum PAYMENT_CLIENT_FLOW {
+    'REDIRECT' = "redirect",
+    'DIRECT' = "direct",
+    'EMBEDDED' = "embedded"
 }
-
-declare class ComposableElement {
-    #private;
-    type: string;
-    constructor(name: any, eventEmitter: any);
-    on(eventName: string, handler: any): void;
-    focus(): void;
-    update: (options: any) => void;
-    setAttribute(attribute: string, value: string | number): void;
+declare enum INTEGRATION_TYPE {
+    API = "api",
+    HPP = "hpp"
 }
 
-/**
- * Configuration interface for creating collect elements
- * Defines the structure and styling options for form input elements
- */
-interface CollectElementInput {
-    table?: string;
-    column?: string;
-    inputStyles?: object;
-    label?: string;
-    labelStyles?: object;
-    errorTextStyles?: object;
-    placeholder?: string;
-    type: ElementType$1;
-    altText?: string;
-    validations?: IValidationRule[];
-    skyflowID?: string;
+type FutureUsages = 'CardOnFile' | 'Subscription' | 'UnscheduledCardOnFile';
+interface SaveInstrumentResponse {
+    id: string;
+    createdAt: string;
+    holderId: string;
+    paymentMethod: PAYMENT_METHOD_CODES.CARD;
+    status: PAYMENT_INSTRUMENT_STATUS;
+    data: {
+        bin: string;
+        binLookup?: {
+            bin: string;
+            network: string;
+            issuer?: string;
+            issuerCountry?: {
+                code?: string;
+                name?: string;
+                iso3?: string;
+            };
+            type?: string;
+        };
+        holderName?: string;
+        network: string;
+        suffix: string;
+        expiryMonth?: string;
+        expiryYear?: string;
+    };
+    fingerprint?: string;
+    futureUsage?: string;
 }
-/**
- * Options interface for the collect operation
- * Controls how data is collected and processed
- */
-interface ICollectOptions {
-    tokens?: boolean;
-    additionalFields?: IInsertRecordInput;
-    upsert?: Array<IUpsertOptions>;
+
+interface SdkConfiguration {
+    token: string;
+    amount: PayrailsAmount;
+    holderReference: string;
+    links?: {
+        binLookup?: Links;
+        instrumentDelete?: Links;
+        instrumentUpdate?: Links;
+    };
+    type?: 'tokenization' | 'dropIn' | 'secureFields';
+    vaultConfiguration: {
+        cardTableName: string;
+        token: string;
+        vaultId: string;
+        vaultUrl: string;
+        providerId: string;
+        providerConfigId: string;
+        vaultType: 'Payrails' | 'Test';
+        encryptionPublicKey?: string;
+        links: {
+            saveInstrument: {
+                href: string;
+            };
+        };
+    };
+    execution?: WorkflowExecutionResponse;
+    featureConfig?: SdkFeatureConfig;
+    morData?: MorData;
 }
-/**
- * ComposableContainer class - Main container for managing secure form elements
- *
- * This class extends the base Container and provides functionality to:
- * - Create and manage secure iframe-based form elements
- * - Handle secure communication between parent and iframe contexts
- * - Collect and tokenize sensitive data while maintaining PCI compliance
- * - Manage element lifecycle (create, mount, validate, collect, destroy)
- */
-declare class ComposableContainer extends Container {
-    #private;
-    type: string;
-    private bus;
-    private iframe;
-    /**
-     * Constructor - Initializes the composable container
-     *
-     * Sets up the secure iframe, establishes communication channels,
-     * and prepares the container for element creation and management.
-     *
-     * @param options - Container configuration (layout, styles, etc.)
-     * @param metaData - Client metadata and configuration
-     * @param skyflowElements - Global elements registry
-     * @param context - Application context with logging and config
-     */
-    constructor(options: any, metaData: any, skyflowElements: any, context: any);
-    /**
-     * Creates a new composable form element
-     *
-     * This method creates a secure form element (like card number, CVV, etc.)
-     * that will be rendered inside the secure iframe. The element is added to
-     * the container's element list but not yet mounted to the DOM.
-     *
-     * @param input - Element configuration (type, styles, validations, etc.)
-     * @param options - Additional options like required field validation
-     * @returns ComposableElement instance for further configuration
-     */
-    create: (input: CollectElementInput, options?: any) => ComposableElement;
-    /**
-     * Registers an event listener for container events
-     *
-     * Allows the application to listen for events like form submission,
-     * validation errors, or other container-level events.
-     *
-     * @param eventName - The name of the event to listen for
-     * @param handler - The callback function to execute when the event occurs
-     */
-    on: (eventName: string, handler: any) => void;
-    /**
-     * Mounts the container and its elements to a DOM element
-     *
-     * This method organizes the created elements according to the specified layout,
-     * applies styling, and renders them within the provided DOM element.
-     * The elements are rendered inside secure iframes for PCI compliance.
-     *
-     * @param domElement - The DOM element where the form should be mounted
-     */
-    mount: (domElement: any) => void;
-    /**
-     * Mounts the container element to the DOM and triggers a mounted event
-     *
-     * This method mounts the container element to the specified DOM element
-     * and then emits an event to notify the SDK that the container has been mounted.
-     *
-     * @param domElement - The DOM element where the container should be mounted
-     */
-    mountContainerElement: (domElement: string) => void;
-    /**
-     * Unmounts the container and cleans up all resources
-     *
-     * This method removes all elements from the DOM, clears internal state,
-     * and removes the iframe to prevent memory leaks.
-     */
-    unmount: () => void;
-    /**
-     * Validates all elements in the container
-     *
-     * Checks that all elements are mounted and triggers validation
-     * in the secure iframe. Returns a promise that resolves with
-     * validation results.
-     *
-     * @returns Promise that resolves with validation results
-     */
-    validate: () => Promise<unknown>;
-    /**
-     * Collects data from all elements in the container
-     *
-     * This method securely collects sensitive data from all mounted elements,
-     * validates the data, and optionally tokenizes it. The actual data collection
-     * happens within the secure iframe to maintain PCI compliance.
-     *
-     * @param options - Collection options (tokenization, additional fields, etc.)
-     * @returns Promise that resolves with collected/tokenized data
-     */
-    collect: (options?: ICollectOptions) => Promise<unknown>;
-    /**
-     * Resets all form elements to their initial state
-     *
-     * Clears all input values and resets validation states
-     * by sending a reset command to the secure iframe.
-     */
-    reset(): void;
+interface MorData {
+    billingLines?: {
+        street?: string;
+        line2?: string;
+        city?: string;
+        state?: string;
+        postalCode?: string;
+        email?: string;
+        country?: string;
+        form?: JSONSchemaType;
+    };
 }
-
-declare enum ContainerType {
-    COLLECT = "COLLECT",
-    COMPOSABLE = "COMPOSABLE"
+interface SdkFeatureConfig {
+    gpayIframeRollout?: number;
+    secureFieldsRollout?: number;
 }
-interface ISkyflow {
-    vaultID?: string;
-    vaultURL?: string;
-    getBearerToken: () => Promise<string>;
-    options?: Record<string, any>;
+interface PayrailsAmount {
+    value: string;
+    currency: string;
 }
-declare class Skyflow {
-    #private;
-    private bus;
-    constructor(config: ISkyflow);
-    static init(config: ISkyflow): Skyflow;
-    container(type: ContainerType, options?: Record<string, any>): CollectContainer | ComposableContainer;
-    static get ContainerType(): typeof ContainerType;
-    static get ElementType(): typeof ElementType$1;
-    static get RedactionType(): typeof RedactionType;
-    static get RequestMethod(): typeof RequestMethod$1;
-    static get LogLevel(): typeof LogLevel;
-    static get EventName(): typeof EventName;
-    static get Env(): typeof Env;
-    static get ValidationRuleType(): typeof ValidationRuleType;
+interface LookupUpdateOptions {
+    value?: string;
+    currency?: string;
+    installmentConfig?: InstallmentUpdateConfig | null;
+    meta?: ExecutionMetaUpdate;
+}
+interface Links {
+    method: 'GET' | 'POST';
+    href: string;
 }
 
-interface TokenizeOptions {
-    futureUsage?: FutureUsages;
-    storeInstrument?: boolean;
+interface ReturnInfo {
+    success?: string;
+    cancel?: string;
+    error?: string;
+    pending?: string;
 }
-declare abstract class Tokenizable extends PayrailsElement {
-    protected abstract collect(): Promise<any>;
-    protected abstract constructSaveInstrumentBody(tokens: any, opts?: TokenizeOptions): Promise<any>;
-    tokenize(_opts?: TokenizeOptions): Promise<any>;
+interface PayoutResponse {
+    name: 'payout';
+    executedAt: string;
+    workspaceId: string;
+    actionId: string;
+    links: {
+        execution: string;
+    };
 }
-
-declare enum ElementType {
-    CARD_NUMBER = "CARD_NUMBER",
-    CARDHOLDER_NAME = "CARDHOLDER_NAME",
-    CVV = "CVV",
-    EXPIRATION_MONTH = "EXPIRATION_MONTH",
-    EXPIRATION_YEAR = "EXPIRATION_YEAR",
-    EXPIRATION_DATE = "EXPIRATION_DATE"
+type PayoutComposition = Array<{
+    integrationType: string;
+    amount: PayrailsAmount;
+    paymentMethodCode: PaymentMethodCode;
+    paymentInstrumentId?: string;
+}>;
+interface PayoutReqBody {
+    amount: PayrailsAmount;
+    payoutComposition: PayoutComposition;
 }
+type ERROR_RESULT = 'Unknown' | 'UnexpectedProviderResponse' | 'ProviderUnknownError' | 'ProviderConnectionError' | 'Timeout' | 'ProviderTimeout' | 'GenericRejection' | 'DuplicateOperation' | 'OperationNotAllowed' | 'NetworkTransactionReferenceRejected' | 'PayerCanceled' | 'LimitExceeded' | 'InstrumentNotAllowed' | 'InvalidInstrument' | 'InsufficientBalance' | 'BlockedInstrument' | 'ExpiredInstrument' | 'ValidationError' | 'ParamsError' | 'ProviderConfigError' | 'InvalidSignature' | 'InternalServerError' | 'AuthenticationError' | 'PaymentMethodNotSupported' | 'PayerAuthenticationRequired' | 'PayerAuthenticationFailed' | 'FraudRisk';
 
-type FieldErrors = Partial<Record<'cardNumber' | 'expiry' | 'cvv' | 'holderName', string>>;
-type ValidateCardFormResult = {
+interface IAddress {
+    country?: {
+        code?: string;
+        fullName?: string;
+        iso3?: string;
+    };
+    postalCode?: string;
+}
+interface IOnChange {
     isValid: boolean;
-    error?: string;
-    fieldErrors?: FieldErrors;
-};
-interface EncryptedCollectResult {
-    vaultProviderConfigId: string;
-    encryptedData: string;
+    billingAddress?: IAddress;
 }
-interface CollectElementOptions {
-    type: ElementType;
-    label?: string;
-    placeholder?: string;
-    altText?: string;
-    format?: string;
-    inputStyles?: object;
-    labelStyles?: object;
-    errorTextStyles?: object;
-    required?: boolean;
-    enableCardIcon?: boolean;
+interface AddressSelectorElementOptions extends ElementOptions {
     translations?: {
-        error?: {
-            default?: string;
+        labels?: {
+            countrySelector?: string;
+            postalCodeInput?: string;
+        };
+        placeholders?: {
+            postalCodeInput?: string;
+            countrySelector?: string;
         };
     };
-}
-type PayrailsContainerType = 'COLLECT' | 'COMPOSABLE';
-interface CollectContainerOptions {
-    layout?: number[];
-    cardTableName?: string;
-    containerType?: PayrailsContainerType;
     styles?: {
-        base?: Partial<CSSStyleDeclaration>;
+        wrapper?: Partial<CSSStyleDeclaration>;
+        countrySelector?: {
+            wrapper?: Partial<CSSStyleDeclaration>;
+            element?: Partial<CSSStyleDeclaration>;
+            label?: Partial<CSSStyleDeclaration>;
+        };
+        postalCodeInput?: {
+            wrapper?: Partial<CSSStyleDeclaration>;
+            element?: Partial<CSSStyleDeclaration>;
+            label?: Partial<CSSStyleDeclaration>;
+        };
     };
-    errorTextStyles?: {
-        base?: Partial<CSSStyleDeclaration>;
+    events?: {
+        onBillingAddressChanged?: (e: IOnChange) => void;
     };
-    fonts?: FontDescriptor[];
 }
-type PayrailsSecureFieldEvent = 'CHANGE' | 'FOCUS' | 'BLUR' | 'READY' | 'SUBMIT';
-interface PayrailsSecureField {
-    on(eventName: PayrailsSecureFieldEvent, handler: any): void;
-    mount?: (domElement: any) => void;
-    unmount?: () => void;
-    focus?: () => void;
-    getState?: () => {
-        isEmpty: boolean;
-        isComplete: boolean;
-        isValid: boolean;
-        isFocused: boolean;
-        value: unknown;
-        required: boolean;
+
+interface StoreInstrumentElementOptions extends ElementOptions {
+    showStoreInstrumentCheckbox?: boolean;
+    alwaysStoreInstrument?: boolean;
+    defaultStoreInstrumentState?: 'checked' | 'unchecked';
+    translations?: {
+        labels?: {
+            storeInstrument?: string;
+            saveInstrument?: string;
+        };
     };
-    isValidElement?: () => boolean;
-    setError?: (clientErrorText: string) => void;
-    resetError?: () => void;
-    setValue?: (elementValue: string) => void;
-    clearValue?: () => void;
-    update?: (data: Partial<CollectElementOptions>) => void;
-    setAttribute: (attribute: string, value: string | number) => void;
+    styles?: {
+        storeInstrumentCheckbox?: Partial<CSSStyleDeclaration>;
+    };
+    events?: PayrailsSDKEvents;
 }
-declare class PayrailsCollectContainer implements Mountable {
-    bin: string;
-    isBinLookupEnabled: boolean;
-    readonly id = "payrails-container-wrapper";
-    readonly dataTestId = "payrails-container-wrapper";
-    readonly className = "payrails-container-wrapper";
-    private static instance;
-    private readonly __container;
-    private element;
-    private readonly cardTableName;
-    private readonly containerType;
-    private manualErrorElements;
-    constructor(__client: Skyflow, options: CollectContainerOptions);
-    static init(vaultClient: Skyflow, options: CollectContainerOptions): PayrailsCollectContainer;
-    createCollectElement(options: CollectElementOptions): PayrailsSecureField;
-    mount(selector: string): void;
+declare class StoreInstrumentCheckbox extends PayrailsElement {
+    private options;
+    constructor(options: StoreInstrumentElementOptions);
+    get isChecked(): boolean;
+    private createHTML;
+    private applyStyles;
+    private addListeners;
+}
+declare abstract class PayrailsElementWithStoreInstrumentCheckbox extends PayrailsElement {
+    protected options?: StoreInstrumentElementOptions | undefined;
+    protected storeInstrumentCheckbox: StoreInstrumentCheckbox | null;
+    protected constructor(elementType: string, options?: StoreInstrumentElementOptions | undefined);
+    protected get shouldStoreInstrument(): boolean;
+}
+
+interface ApplePayButtonOptions extends StoreInstrumentElementOptions {
+    clientDomain?: string;
+    showPaymentMethodLogo?: boolean;
+    abortAfterAuthorizeFailed?: boolean;
+    translations?: {
+        labels?: {
+            storeInstrument?: string;
+            saveInstrument?: string;
+            paymentScreenLabel?: string;
+        };
+    };
+    events?: PaymentEvents & Pick<UIEvents, 'onDeliveryAddressChanged'> & {
+        onApplePayAvailable?: () => void;
+    };
+    styles?: {
+        type?: 'plain' | 'buy' | 'addMoney' | 'book' | 'checkout' | 'continue' | 'contribute' | 'donate' | 'inStore' | 'order' | 'reload' | 'rent' | 'setUp' | 'subscribe' | 'support' | 'tip' | 'topUp';
+        style?: 'white' | 'whiteOutline' | 'black' | 'automatic';
+        locale?: string;
+    } & StoreInstrumentElementOptions['styles'];
+}
+declare class ApplePayButton extends PayrailsElementWithStoreInstrumentCheckbox {
+    protected options: ApplePayButtonOptions;
+    private appleButton;
+    private paymentExecutor;
+    private action;
+    private isProcessing;
+    private completedSessions;
+    private abortedSessionReasons;
+    static isApplePayAvailable(): Promise<boolean>;
+    constructor(options: ApplePayButtonOptions);
+    mount(location: string): void;
     unmount(): void;
-    validate(): Promise<ValidateCardFormResult>;
-    collect(): Promise<EncryptedCollectResult>;
-    reset(): void;
-    private collectPayrailsData;
-    tokenize(opts: TokenizeOptions): Promise<SaveInstrumentResponse>;
-    private constructSaveInstrumentBody;
-    private attachCustomEventHandler;
-    private formatBin;
-    private get elementToFieldMap();
-    fetchBinLookup: (bin: string) => Promise<BinLookupResponse | {
-        bin: string;
-    }>;
+    private mountApplePayButton;
+    private onAuthorizeFailedHandler;
+    private completeApplePaySession;
+    private createApplePaySession;
+    /**
+     * Apple Pay only exposes redacted contact fields here for privacy
+     * (`countryCode`, `administrativeArea`, `locality`, `postalCode`); full
+     * address is revealed in `onpaymentauthorized` after the user authorizes.
+     *
+     * The session must be answered with `completeShippingContactSelection`
+     * within ~30s or Apple aborts the sheet — so the merchant's
+     * `onDeliveryAddressChanged` callback must be fast.
+     *
+     * `amount` is passed in (rather than read from `getSDKConfig()`) so the
+     * response carries the same total the session was created with, even if
+     * the SDK config is mutated mid-flow.
+     */
+    private onApplePayShippingContactSelected;
+    private onApplePayAuthorized;
+    private doAuthorizedPayment;
+    private doTokenize;
 }
 
 declare const regexes: {
@@ -1369,13 +1405,25 @@ declare class CardForm extends PayrailsElementWithStoreInstrumentCheckbox {
     private defaultStyles;
     private defaultTranslations;
     private eventsRef?;
-    constructor(collectContainer: PayrailsCollectContainer, options?: CardFormOptions | undefined);
+    constructor(collectContainer: FramesContainer, options?: CardFormOptions | undefined);
     private initializeFormFields;
     getErrorTextStyles(errorTextStyles: any): any;
     private updateStyles;
     private updateTranslations;
     private updateEvents;
     update(options: Partial<Pick<CardFormOptions, 'styles' | 'translations' | 'events'>>): void;
+    /**
+     * Legacy (Skyflow) path: prepare per-field flat payloads and dispatch to
+     * each field's vault element. Skyflow merges shallowly on its side.
+     */
+    private updateSkyflow;
+    /**
+     * Secure-fields path: forward styles/translations to the single CARD_FORM
+     * frame 1:1; the frame fans them out per child via resolveFieldData. Host
+     * defaults are deep-merged so successive updates accumulate symmetrically
+     * with the frame's own accumulation.
+     */
+    private updateSecureFields;
     updateInstallmentConfig(installmentConfig?: InstallmentUpdateConfig): void;
     private createFormField;
     private isFieldRequired;
@@ -1383,7 +1431,7 @@ declare class CardForm extends PayrailsElementWithStoreInstrumentCheckbox {
     private hasFieldBeenUsed;
     private initializeDefaultLayout;
     private throttledFetchBinLookupIfChanged;
-    tokenize(opts: TokenizeOptions): Promise<SaveInstrumentResponse>;
+    tokenize(opts: TokenizeOptions): Promise<any>;
     private createAddressSelector;
     show(): void;
     hide(options?: {
@@ -1501,6 +1549,18 @@ declare enum AuthorizationFailureReasons {
     USER_CANCELLED = "USER_CANCELLED"
 }
 
+type BillingAddressPrefill = Omit<NonNullable<MorData['billingLines']>, 'form'>;
+interface BillingAddressFormOptions {
+    schema: JSONSchemaType;
+    title?: string;
+    prefill?: BillingAddressPrefill;
+    styles?: DynamicElementStyles;
+    translations?: DynamicElementTranslations;
+    events?: {
+        onReady?: () => void;
+    };
+}
+
 interface AuthFailedMsgOptions {
     translations?: {
         label?: string;
@@ -1520,7 +1580,7 @@ interface LoadingScreenStyles {
     [StyleKeys.loader]?: Partial<CSSStyleDeclaration>;
 }
 
-type GooglePayConfigInput = google.payments.api.IsReadyToPayPaymentMethodSpecification[] | GooglePayConfig;
+type GooglePayConfigInput = google.payments.api.IsReadyToPayPaymentMethodSpecification[] | GooglePayWorkflowConfig;
 interface GooglePayButtonOptions extends StoreInstrumentElementOptions {
     environment?: PayrailsEnvironment;
     merchantInfo?: google.payments.api.MerchantInfo;
@@ -1830,7 +1890,9 @@ declare class Dropin extends PayrailsElement {
     private paypal;
     private lean;
     private loadingScreen;
-    constructor(collectContainer: PayrailsCollectContainer, clientConfig: PayrailsClientOptions, dropinConfig: DropinOptions);
+    private billingAddressForm;
+    private billingValidationBlocked;
+    constructor(collectContainer: FramesContainer, clientConfig: PayrailsClientOptions, dropinConfig: DropinOptions);
     private get returnInfo();
     private isHppIntegration;
     private createStoredInstrumentElement;
@@ -1847,6 +1909,7 @@ declare class Dropin extends PayrailsElement {
     private createApplePayButton;
     private createCardPaymentButton;
     private onAuthorizeSuccess;
+    private validateBillingAddress;
     private getElementEvents;
     private onAuthorizePending;
     private getErrorMessage;
@@ -1902,6 +1965,7 @@ interface DropinOptions {
         mercadoPago?: GenericRedirectDropinOptions['translations'];
         revolutPay?: GenericRedirectDropinOptions['translations'];
         addressSelector?: AddressSelectorElementOptions['translations'];
+        billingAddressForm?: BillingAddressFormOptions['translations'];
         applePayButton?: ApplePayDropinOptions['translations'];
         leanButton?: LeanDropinOptions['translations'];
         errorMessages?: {
@@ -1922,6 +1986,7 @@ interface DropinOptions {
         authFailed?: Partial<CSSStyleDeclaration>;
         loadingScreen?: LoadingScreenStyles;
         addressSelector?: AddressSelectorElementOptions['styles'];
+        billingAddressForm?: BillingAddressFormOptions['styles'];
         mercadoPago?: GenericRedirectDropinOptions['styles'];
         revolutPay?: GenericRedirectDropinOptions['styles'];
     };
@@ -1934,11 +1999,28 @@ interface ContainerStyles {
     styles?: Partial<CSSStyleDeclaration>;
 }
 
+interface DynamicElementFieldOptions {
+    id: string;
+    name: string;
+    required?: boolean;
+    property: JSONSchemaProperty;
+    label: string;
+    placeholder: string;
+    value?: string;
+    readOnly?: boolean;
+    errors: DynamicElementErrorTranslation;
+    styles?: DynamicElementFieldStyles;
+    events: DynamicElementFieldEvents;
+}
+
+type FieldOptionsWithoutEvents = Omit<DynamicElementFieldOptions, 'events'>;
+
 interface DynamicElementOptions {
     styles?: DynamicElementStyles;
     translations?: DynamicElementTranslations;
-    paymentMethod: BasePaymentMethodConfig;
+    paymentMethod?: BasePaymentMethodConfig;
     events?: DynamicElementEvents;
+    fieldOverrides?: Record<string, Partial<FieldOptionsWithoutEvents>>;
 }
 interface FormConfig {
     schema: JSONSchemaType;
@@ -1952,7 +2034,7 @@ declare class DynamicElementForm extends Tokenizable {
     private __schema;
     private _previousFormValidState;
     constructor(options: DynamicElementOptions, formConfig: FormConfig, returnInfo?: ReturnInfo | undefined);
-    protected collect(): Promise<Record<string, any>>;
+    collect(): Promise<Record<string, any>>;
     protected constructSaveInstrumentBody(tokens: any, opts?: TokenizeOptions): Promise<any>;
     private isFormValid;
     private isFormValidSilent;
@@ -2088,6 +2170,30 @@ interface PayPalScriptConfig {
     locale?: string;
 }
 
+interface PaymentAttemptContext {
+    readonly executionId: string;
+    readonly paymentMethodCode: PaymentMethodCode;
+}
+declare enum ACTION_REQUIRED_KIND {
+    GENERIC_REDIRECT = "genericRedirect",
+    THREE_DS = "3ds"
+}
+type ActionRequiredKind = `${ACTION_REQUIRED_KIND}`;
+interface ActionRequiredEvent extends PaymentAttemptContext {
+    readonly url: string;
+    readonly kind: ActionRequiredKind;
+    /**
+     * Call to take over the action. The SDK will not perform its default
+     * behavior (navigate, mount the 3DS popup).
+     */
+    preventDefault(): void;
+}
+type PayrailsEvents = {
+    actionRequired: ActionRequiredEvent;
+};
+type PayrailsEventName = keyof PayrailsEvents;
+type PayrailsEventHandler<K extends PayrailsEventName> = (event: PayrailsEvents[K]) => void | Promise<void>;
+
 interface QueryDefinition<T> {
     path: string[];
     returnType: T;
@@ -2128,7 +2234,7 @@ declare class Payrails {
     static preloadCardForm: typeof SdkLoader.preloadCardForm;
     static init(initResponse: InitOptions, options?: PayrailsClientOptions): Payrails;
     update(updateOptions: LookupUpdateOptions): void;
-    collectContainer(containerOptions: CollectContainerOptions): PayrailsCollectContainer;
+    collectContainer(containerOptions: CollectContainerOptions): FramesContainer;
     googlePayButton(options: GooglePayButtonOptions): GooglePayButton;
     isGooglePayAvailable(merchantInfo: google.payments.api.MerchantInfo): Promise<boolean>;
     applePayButton(options: ApplePayButtonOptions): ApplePayButton;
@@ -2151,11 +2257,13 @@ declare class Payrails {
     paypalButton(options?: PaypalButtonOptions): PaypalButton;
     leanButton(options: LeanButtonOptions): LeanButton;
     genericRedirectButton(options: GenericRedirectButtonOptions): GenericRedirectButton;
-    dynamicElement(options: DynamicElementOptions): DynamicElementForm;
+    dynamicElement(options: DynamicElementOptions & Required<Pick<DynamicElementOptions, 'paymentMethod'>>): DynamicElementForm;
     getSavedPaypalAccounts(): StoredPaymentInstrument<PayPalMetadata>[];
     private logIntegrationMode;
     private constructor();
     private getContainerLayout;
+    on<K extends PayrailsEventName>(name: K, handler: PayrailsEventHandler<K>): () => void;
+    off<K extends PayrailsEventName>(name: K, handler: PayrailsEventHandler<K>): void;
     binLookup(): Promise<any>;
 }
 interface ClientEvents {
@@ -2281,5 +2389,5 @@ interface PayrailsClientOptions {
     };
 }
 
-export { AuthorizationFailureReasons, ElementType, INTEGRATION_TYPE, PAYMENT_METHOD_CODES, Payrails, PayrailsCollectContainer, PayrailsEnvironment, REVOLUT_PAY_DEFAULT_LABEL, REVOLUT_PAY_DEFAULT_THEME };
-export type { ApplePayButtonOptions, CardFormOptions, CardListOptions, CardPaymentButtonOptions, CollectContainerOptions, DropinOptions, ExecutionMeta, ExecutionMetaCustomer, ExecutionMetaKey, GenericRedirectButtonOptions, GooglePayButtonOptions, InitOptions, LeanButtonOptions, PaymentEvents, PaypalButtonOptions, PayrailsAmount, PayrailsClientOptions, PayrailsContainerType, PayrailsSecureField, PayrailsSecureFieldEvent, ReturnInfo, RevolutPayButtonTheme, RevolutPayStyles, SaveInstrumentResponse, StorablePaymentCompositionOption, WorkflowExecutionResponse };
+export { ACTION_REQUIRED_KIND, AuthorizationFailureReasons, ElementType, INTEGRATION_TYPE, PAYMENT_METHOD_CODES, Payrails, PayrailsCollectContainer, PayrailsEnvironment, REVOLUT_PAY_DEFAULT_LABEL, REVOLUT_PAY_DEFAULT_THEME };
+export type { ActionRequiredEvent, ActionRequiredKind, ApplePayButtonOptions, CardFormOptions, CardListOptions, CardPaymentButtonOptions, CollectContainerOptions, DropinOptions, ExecutionMeta, ExecutionMetaCustomer, ExecutionMetaKey, GenericRedirectButtonOptions, GooglePayButtonOptions, InitOptions, LeanButtonOptions, PaymentAttemptContext, PaymentEvents, PaypalButtonOptions, PayrailsAmount, PayrailsClientOptions, PayrailsContainerType, PayrailsEventHandler, PayrailsEventName, PayrailsEvents, PayrailsSecureField, PayrailsSecureFieldEvent, ReturnInfo, RevolutPayButtonTheme, RevolutPayStyles, SaveInstrumentResponse, StorablePaymentCompositionOption, WorkflowExecutionResponse };