@paydock/client-sdk 1.141.0 → 1.143.0-beta

package/bundles/index.cjs.d.ts

@@ -1361,76 +1361,169 @@ declare class MultiWidget {
     }): void;
 }
 
-interface IEventMetaData extends IEventData$1 {
-    configuration_token: string;
-    type: string;
-    account_name?: string;
-    account_number?: string;
+/**
+ *
+ * Class PaymentSourceWidget include method for for creating iframe url
+ * @constructor
+ *
+ * @param {string} publicKey - PayDock users public key
+ * @param {string} customer - PayDock's customer_id or customer_reference (In order to use the customer_reference, you must explicitly specify useReference as true)
+ * @param {boolean} [useReference=false]
+ *
+ * @example
+ * var widget = new PaymentSourceWidget('publicKey','customerId');
+ * // or
+ * var widget = new PaymentSourceWidget('publicKey', customerReference, true);
+ */
+declare class PaymentSourceWidget {
+    protected link: Link;
+    protected configs: Configuration[];
+    protected configTokens: string[];
+    protected publicKey: string;
+    /** @constructs */ constructor(accessToken: string, queryToken: string);
+    /**
+     * Object contain styles for widget
+     *
+     * @example
+     * widget.setStyles({
+     *       background_color: 'rgb(0, 0, 0)',
+     *       border_color: 'yellow',
+     *       text_color: '#FFFFAA',
+     *       icon_size: 'small',
+     *       font_size: '20px'
+     *   });
+     * @param {IStyles} fields - name of styles which can be shown in widget [STYLE]{@link STYLE}
+     */
+    setStyles(styles: IStyles$1): void;
+    setStyle(param: string, value: string): void;
+    /**
+     * Current method can set custom ID to identify the data in the future
+     *
+     * @example
+     * widget.setRefId('id');
+     *
+     * @param {string} refId - custom id
+     */
+    setRefId(refId: string): void;
+    /**
+     * Current method can set limit for payment sources count. In case when limit sets less then general count will be shown pagination buttons prev and next.
+     *
+     * @param {string} count - payment source count
+     */
+    setLimit(count: number): void;
+    /**
+     * Current method can change environment. By default environment = sandbox
+     * Also we can change domain alias for this environment. By default domain_alias = paydock.com
+     *
+     * @example
+     * widget.setEnv('production');
+     * @param {string} env - sandbox, production
+     * @param {string} [alias] - Own domain alias
+     */
+    setEnv(env: string, alias?: string): void;
+    getEnv(): void;
+    /**
+     * Method for getting iframe's url
+     */
+    getIFrameUrl(): string;
+    /**
+     * Show payment source inside widget only with requested gateway ids
+     *
+     *
+     * @param {string[]} ids - List of gateway_id
+     */
+    filterByGatewayIds(ids: string[]): void;
+    /**
+     *
+     * Show payment source inside widget only with requested payment source types
+     *
+     * @param types - List of payment source types. Available parameters [PAYMENT_TYPE]{@link PAYMENT_TYPE}
+     */
+    filterByTypes(types: string[]): void;
+    /**
+     * Method for setting a custom language code
+     *
+     * @example
+     * config.setLanguage('en');
+     * @param {string} code - ISO 639-1
+     */
+    setLanguage(code: any): void;
+}
+
+interface IEventSelectData extends IEventData$1 {
+    customer_id: string;
+    payment_source_id: string;
+    gateway_id: string;
+    primary: boolean;
     card_number_last4?: string;
-    card_number_length?: number;
     card_scheme?: string;
+    checkout_email?: string;
     gateway_type?: string;
+    payment_source_type: string;
+    account_name?: string;
+    account_number?: string;
 }
-interface IEventFinishData extends IEventData$1 {
-    address_city?: string;
-    address_country?: string;
-    address_line1?: string;
-    address_line2?: string;
-    address_postcode?: string;
-    address_state?: string;
-    card_scheme?: string;
-    email?: string;
-    expire_month?: string;
-    expire_year?: string;
-    first_name?: string;
-    last_name?: string;
-    payment_source: string;
-    payment_source_token?: string;
-    phone?: string;
-    save_card_consent_accepted?: boolean;
+interface IEventPaginationData extends IEventData$1 {
+    total_item: number;
+    skip: number;
+    limit: number;
+}
+interface IEventAfterLoadData$1 extends IEventData$1 {
+    total_item: number;
+    skip: number;
+    limit: number;
+}
+interface IEventSizeData extends IEventData$1 {
+    height: number;
+    width: number;
 }
 /**
- * Interface of data from validation event.
+ * Interface of data from event.
  *
- * @interface IFormValidation
+ * @interface IEventSelectData
  *
- * @param {string} event The name of the event.
- * @param {string} message_source A system variable that identifies the event source.
- * @param {string} purpose A system variable that states the purpose of the event.
- * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
- * @param {boolean} [form_valid] Indicates wether or not the form is valid.
- * @param {Array<string>} [invalid_fields] Names of form fields with invalid data.
- * @param {Array<string>} [invalid_showed_fields] Names of invalid form fields which are already displaying the error.
- * @param {Partial<Record<CardValidatorValue | GenericValidatorValue, Array<string>>>} [validators] Object containing validator identifiers as keys and the fields subject to that validator as an array of form field names.
- *  See list of available [Generic Vallidators]{@link GENERIC_VALIDATORS} and [Card Validators]{@link CARD_VALIDATORS},
- */
+ * @param {string} event
+ * @param {string} purpose
+ * @param {string} message_source
+ * @param {string} [ref_id]
+ * @param {string} customer_id
+ * @param {string} payment_source_id
+ * @param {string} gateway_id
+ * @param {boolean} primary
+ * @param {string} [widget_id]
+ * @param {string} [card_number_last4]
+ * @param {string} [card_scheme]
+ * @param {string} gateway_type
+ * @param {string} [checkout_email]
+ * @param {string} payment_source_type
+ * @param {string} [account_name]
+ * @param {string} [account_number]
+ * */
 /**
- * Contains basic information associated with the event and additional meta data
- * specific to the event. E.g., card info, gateway info, etc.
+ * Interface of data from event.
  *
- * @interface IEventMetaData
+ * @interface IEventPaginationData
  *
- * @param {string} event The name of the event.
- * @param {string} purpose A system variable that states the purpose of the event.
- * @param {string} message_source A system variable that identifies the event source.
- * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
- * @param {string} configuration_token Token received from our API with widget data
- * @param {string} type Payment type 'card', 'bank_account'
- * @param {string} gateway_type Gateway type
- * @param {string} [card_number_last4] Last 4 digit of your card
- * @param {string} [card_scheme] Card scheme, e.g., (Visa, Mastercard and American Express (AmEx))
- * @param {number} [card_number_length] Card number length
- * @param {string} [account_name] Bank account account name
- * @param {string} [account_number] Bank account account number
+ * @param {string} event
+ * @param {string} purpose
+ * @param {string} message_source
+ * @param {string} [ref_id]
+ * @param {number} total_item
+ * @param {number} skip
+ * @param {number} limit
  * */
 /**
  * Interface of data from event.
+ *
  * @interface IEventAfterLoadData
  *
  * @param {string} event The name of the event.
  * @param {string} purpose A system variable that states the purpose of the event.
  * @param {string} message_source A system variable that identifies the event source.
  * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {number} total_item Pagination param. Total item count
+ * @param {number} skip Pagination param. Skip items from first item
+ * @param {number} limit Pagination param. Query limit
  * */
 /**
  * Interface of data from event.
@@ -1440,66 +1533,271 @@ interface IEventFinishData extends IEventData$1 {
  * @param {string} purpose A system variable that states the purpose of the event.
  * @param {string} message_source A system variable that identifies the event source.
  * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
- * @param {string} payment_source One time token. Result from this endpoint [API docs](https://docs.paydock.com/#tokens)
  * */
+/**
+* Interface of data from event.
+* @interface IEventSizeData
+*
+* @param {number} event The name of the event.
+* @param {number} purpose A system variable that states the purpose of the event.
+* @param {string} message_source A system variable that identifies the event source.
+* @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+* @param {number} height Height of iFrame
+* @param {number} width Width of iFrame
+* */
 /**
  * List of available event's name
+ *
  * @const EVENT
  *
  * @type {object}
  * @param {string} AFTER_LOAD=afterLoad
- * @param {string} SUBMIT=submit
- * @param {string} FINISH=finish
- * @param {string} VALIDATION=validation
- * @param {string} VALIDATION_ERROR=validationError
  * @param {string} SYSTEM_ERROR=systemError
+ * @param {string} SELECT=select
+ * @param {string} UNSELECT=unselect
+ * @param {string} NEXT=next
+ * @param {string} PREV=prev
  * @param {string} META_CHANGE=metaChange
  * @param {string} RESIZE=resize
  */
 /**
- * List of available event's name
- * @const VAULT_DISPLAY_EVENT
- *
- * @type {object}
- * @param {string} AFTER_LOAD=afterLoad
- * @param {string} SYSTEM_ERROR=system_error
- * @param {string} CVV_SECURE_CODE_REQUESTED=cvv_secure_code_requested
- * @param {string} CARD_NUMBER_SECURE_CODE_REQUESTED=card_number_secure_code_requested
- * @param {string} ACCESS_FORBIDDEN=access_forbidden
- * @param {string} SESSION_EXPIRED=systemError
- * @param {string} SYSTEM_ERROR=session_expired
- * @param {string} OPERATION_FORBIDDEN=operation_forbidden
- */
-/**
- * Class HtmlMultiWidget include method for working with html
+ * Class HtmlPaymentSourceWidget include method for working on html
  * @constructor
- * @extends MultiWidget
+ * @extends PaymentSourceWidget
  *
  * @param {string} selector - Selector of html element. Container for widget
  * @param {string} publicKey - PayDock users public key
- * @param {(Configuration | string | Configuration[] | string[])} conf - exemplar[s] Configuration class OR configuration token
+ * @param {string} queryToken - PayDock's query token that represents params to search customer by id or reference
  * @example
- * var widget = new MultiWidget('#widget', 'publicKey','configurationToken'); // With a pre-created configuration token
- *
- * var widget = new MultiWidget('#widget', 'publicKey',['configurationToken', 'configurationToken2']); // With pre-created configuration tokens
- *
- * var widget = new MultiWidget('#widget', 'publicKey', new Configuration('gatewayId')); With Configuration
- *
- * var widget = new MultiWidget('#widget', 'publicKey',[ With Configurations
- *      Configuration(), // default gateway_id,
- *      Configuration('not_configured'), // without gateway,
- *      Configuration('gatewayId'),
- *      Configuration('gatewayId', 'bank_account')
- * ]);
+ *  * var widget = new HtmlPaymentSourceWidget('#widget', 'publicKey','queryToken');
+
  */
-declare class HtmlMultiWidget extends MultiWidget {
+declare class HtmlPaymentSourceWidget extends PaymentSourceWidget {
     protected container: Container;
     protected iFrame: IFrame;
-    protected triggerElement: Trigger;
-    protected validationData: IFormValidation;
-    /** @constructs */ constructor(selector: string, publicKey: string, conf: any);
+    protected event: IFrameEvent;
+    /** @constructs */ constructor(selector: string, publicKey: string, queryToken: string);
     /**
-     * Loads the widget.
+     * The final method to beginning, the load process of widget to html
+     *
+     */
+    load(): void;
+    /**
+     * This callback will be called for each event in payment source widget
+     *
+     * @callback listener--PaymentSourceWidget
+     * @param {IEventData | IEventSelectData | IEventPaginationData | IEventAfterLoadData} response
+     */
+    /**
+     * Listen to events of widget
+     *
+     * @example
+     *
+     * widget.on('select', function (data) {
+     *      console.log(data);
+     * });
+     * @param {string} eventName - Available event names [EVENT]{@link EVENT}
+     * @param {listener--PaymentSourceWidget} cb
+     */
+    on(eventName: string, cb: (data: IEventData$1 | IEventSelectData | IEventPaginationData | IEventAfterLoadData$1 | IEventSizeData) => void): void;
+    /**
+     * Using this method you can hide widget after load
+     * @param {boolean} [saveSize=false] - using this param you can save iframe's size
+     */
+    hide(saveSize: boolean): void;
+    /**
+     * Using this method you can show widget after using hide method
+     *
+     */
+    show(): void;
+    /**
+     * Using this method you can reload widget
+     *
+     */
+    reload(): void;
+    /**
+     * After select event of widget, data (dataType) will be insert to input (selector)
+     *
+     * @param {string} selector - css selector . [] #
+     * @param {string} dataType - data type of [IEventSelectData]{@link IEventSelectData}.
+     */
+    onSelectInsert(selector: string, dataType: string): void;
+}
+
+/**
+ * Maps widget event names to their callback data types.
+ *
+ * When using `widget.on(EVENT.FINISH, (data) => { ... })`, TypeScript will
+ * automatically narrow `data` to `IEventFinishData` based on this map.
+ */
+interface WidgetEventMap {
+    afterLoad: IEventAfterLoadData;
+    submit: IEventData$1;
+    finish: IEventFinishData;
+    validationError: IEventData$1;
+    systemError: IEventData$1;
+    error: IEventData$1;
+    /** @deprecated Use checkoutReady instead */
+    checkoutSuccess: IEventData$1;
+    checkoutReady: IEventData$1;
+    checkoutError: IEventData$1;
+    checkoutCompleted: IEventData$1;
+    checkoutPopupOpen: IEventData$1;
+    checkoutPopupClose: IEventData$1;
+    recognitionTokenRequested: IEventData$1;
+    recognitionTokenDropped: IEventData$1;
+    validation: IFormValidation;
+    select: IEventData$1;
+    unselect: IEventData$1;
+    next: IEventData$1;
+    prev: IEventData$1;
+    metaChange: IEventMetaData;
+    resize: IEventSizeData;
+}
+/** Union of all known widget event names */
+type WidgetEventName = keyof WidgetEventMap;
+
+interface IEventMetaData extends IEventData$1 {
+    configuration_token: string;
+    type: string;
+    account_name?: string;
+    account_number?: string;
+    card_number_last4?: string;
+    card_number_length?: number;
+    card_scheme?: string;
+    gateway_type?: string;
+}
+interface IEventAfterLoadData extends IEventData$1 {
+}
+interface IEventFinishData extends IEventData$1 {
+    address_city?: string;
+    address_country?: string;
+    address_line1?: string;
+    address_line2?: string;
+    address_postcode?: string;
+    address_state?: string;
+    card_scheme?: string;
+    email?: string;
+    expire_month?: string;
+    expire_year?: string;
+    first_name?: string;
+    last_name?: string;
+    payment_source: string;
+    payment_source_token?: string;
+    phone?: string;
+    save_card_consent_accepted?: boolean;
+}
+/**
+ * Interface of data from validation event.
+ *
+ * @interface IFormValidation
+ *
+ * @param {string} event The name of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {boolean} [form_valid] Indicates wether or not the form is valid.
+ * @param {Array<string>} [invalid_fields] Names of form fields with invalid data.
+ * @param {Array<string>} [invalid_showed_fields] Names of invalid form fields which are already displaying the error.
+ * @param {Partial<Record<CardValidatorValue | GenericValidatorValue, Array<string>>>} [validators] Object containing validator identifiers as keys and the fields subject to that validator as an array of form field names.
+ *  See list of available [Generic Vallidators]{@link GENERIC_VALIDATORS} and [Card Validators]{@link CARD_VALIDATORS},
+ */
+/**
+ * Contains basic information associated with the event and additional meta data
+ * specific to the event. E.g., card info, gateway info, etc.
+ *
+ * @interface IEventMetaData
+ *
+ * @param {string} event The name of the event.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {string} configuration_token Token received from our API with widget data
+ * @param {string} type Payment type 'card', 'bank_account'
+ * @param {string} gateway_type Gateway type
+ * @param {string} [card_number_last4] Last 4 digit of your card
+ * @param {string} [card_scheme] Card scheme, e.g., (Visa, Mastercard and American Express (AmEx))
+ * @param {number} [card_number_length] Card number length
+ * @param {string} [account_name] Bank account account name
+ * @param {string} [account_number] Bank account account number
+ * */
+/**
+ * Interface of data from event.
+ * @interface IEventAfterLoadData
+ *
+ * @param {string} event The name of the event.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * */
+/**
+ * Interface of data from event.
+ * @interface IEventFinishData
+ *
+ * @param {string} event The name of the event.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {string} payment_source One time token. Result from this endpoint [API docs](https://docs.paydock.com/#tokens)
+ * */
+/**
+ * List of available event's name
+ * @const EVENT
+ *
+ * @type {object}
+ * @param {string} AFTER_LOAD=afterLoad
+ * @param {string} SUBMIT=submit
+ * @param {string} FINISH=finish
+ * @param {string} VALIDATION=validation
+ * @param {string} VALIDATION_ERROR=validationError
+ * @param {string} SYSTEM_ERROR=systemError
+ * @param {string} META_CHANGE=metaChange
+ * @param {string} RESIZE=resize
+ */
+/**
+ * List of available event's name
+ * @const VAULT_DISPLAY_EVENT
+ *
+ * @type {object}
+ * @param {string} AFTER_LOAD=afterLoad
+ * @param {string} SYSTEM_ERROR=system_error
+ * @param {string} CVV_SECURE_CODE_REQUESTED=cvv_secure_code_requested
+ * @param {string} CARD_NUMBER_SECURE_CODE_REQUESTED=card_number_secure_code_requested
+ * @param {string} ACCESS_FORBIDDEN=access_forbidden
+ * @param {string} SESSION_EXPIRED=systemError
+ * @param {string} SYSTEM_ERROR=session_expired
+ * @param {string} OPERATION_FORBIDDEN=operation_forbidden
+ */
+/**
+ * Class HtmlMultiWidget include method for working with html
+ * @constructor
+ * @extends MultiWidget
+ *
+ * @param {string} selector - Selector of html element. Container for widget
+ * @param {string} publicKey - PayDock users public key
+ * @param {(Configuration | string | Configuration[] | string[])} conf - exemplar[s] Configuration class OR configuration token
+ * @example
+ * var widget = new MultiWidget('#widget', 'publicKey','configurationToken'); // With a pre-created configuration token
+ *
+ * var widget = new MultiWidget('#widget', 'publicKey',['configurationToken', 'configurationToken2']); // With pre-created configuration tokens
+ *
+ * var widget = new MultiWidget('#widget', 'publicKey', new Configuration('gatewayId')); With Configuration
+ *
+ * var widget = new MultiWidget('#widget', 'publicKey',[ With Configurations
+ *      Configuration(), // default gateway_id,
+ *      Configuration('not_configured'), // without gateway,
+ *      Configuration('gatewayId'),
+ *      Configuration('gatewayId', 'bank_account')
+ * ]);
+ */
+declare class HtmlMultiWidget extends MultiWidget {
+    protected container: Container;
+    protected iFrame: IFrame;
+    protected triggerElement: Trigger;
+    protected validationData: IFormValidation;
+    /** @constructs */ constructor(selector: string, publicKey: string, conf: any);
+    /**
+     * Loads the widget.
      *
      * Calling this method results in an iframe element being inserted and rendered in the DOM.
      */
@@ -1534,8 +1832,10 @@ declare class HtmlMultiWidget extends MultiWidget {
      *
      * @return {Promise<IEventData | IEventMetaData | IEventFinishData | IFormValidation> | void}
      */
+    on<E extends WidgetEventName>(eventName: E, cb: (data: WidgetEventMap[E]) => void): void;
+    on<E extends WidgetEventName>(eventName: E): Promise<WidgetEventMap[E]>;
+    on(eventName: string, cb: (data: IEventData$1 | IEventMetaData | IEventFinishData | IFormValidation) => void): void;
     on(eventName: string): Promise<IEventData$1 | IEventMetaData | IEventFinishData | IFormValidation>;
-    on(eventName: string, cb: (data: IEventData$1 | IEventMetaData | IEventFinishData | IFormValidation) => void): any;
     /**
      * Registers callback that will be invoked for every trigger.
      *
@@ -4470,354 +4770,91 @@ interface GooglePayCardConfig {
         type: 'DIRECT';
         parameters: {
             protocol_version: string;
-            public_key: string;
-        };
-    };
-}
-
-/**
- * @classdesc Google Pay wallet button that creates One-Time Tokens (OTT) via Google Pay.
- *
- * Provides a fully typed Google Pay integration with Google Pay-specific metadata
- * and validates that the service configuration corresponds to a Google Pay service.
- * On `load()`, the button fetches the service configuration and raises an error via `onError`
- * if the service type does not match Google Pay.
- *
- * @class GooglePayOpenWalletButton
- * @extends OpenWalletButtons
- *
- * @param {string} selector - CSS selector of the HTML element that will contain the Google Pay button.
- * @param {string} publicKeyOrAccessToken - Public key or access token for API authentication.
- * @param {string} serviceId - The Google Pay service ID configured in PayDock dashboard.
- * @param {GooglePayOpenWalletMeta} meta - Google Pay-specific metadata (amount, currency, country, card_config, merchant_name, style, etc.).
- *
- * @example
- * const button = new GooglePayOpenWalletButton(
- *   '#wallet-container',
- *   publicKeyOrAccessToken,
- *   serviceId,
- *   {
- *     amount: 100,
- *     currency: 'AUD',
- *     country: 'AU',
- *     merchant_name: 'Your Store',
- *   },
- * );
- * button.setEnv('sandbox');
- * button.onSuccess((data) => console.log('OTT:', data.token));
- * button.onError((error) => console.error('Error:', error));
- * button.load();
- */
-declare class GooglePayOpenWalletButton extends OpenWalletButtons<GooglePayOpenWalletMeta> {
-    /** @private */
-    readonly walletType: WalletType;
-    /**
-     * Validates Google Pay-specific required metadata fields.
-     * Google Pay has no additional required fields beyond the base (amount, currency, country).
-     * @private
-     */
-    protected validateWalletMeta(): void;
-    /**
-     * Validates that the service configuration type is Google Pay.
-     *
-     * @private
-     * @param serviceConfig - The service configuration response from the API.
-     * @throws {Error} If the service type is not Google Pay.
-     */
-    protected validateServiceType(serviceConfig: GetConfigResponse): void;
-    /**
-     * Creates a Google Pay wallet service instance.
-     *
-     * @private
-     * @param serviceConfig - The service configuration response from the API.
-     * @returns The Google Pay wallet service instance.
-     */
-    protected createWalletService(serviceConfig: GetConfigResponse): OpenWalletService;
-}
-
-declare const TYPE: {
-    EXTERNAL_CHECKOUT_TOKEN: string;
-    CHECKOUT_TOKEN: string;
-    BANK_ACCOUNT: string;
-    CARD: string;
-};
-interface IBody {
-    gateway_id: string;
-    type: string;
-    checkout_token?: string;
-}
-declare class Builder extends HttpCore {
-    private body;
-    constructor(gatewayID: string, checkoutToken: string, type: string);
-    constructor(gatewayID: string, externalCheckoutToken: string, type: string);
-    constructor(gatewayID: string, card: any, type: string);
-    constructor(gatewayID: string, bankAccount: any, type: string);
-    protected getLink(): string;
-    send(accessToken: string, cb: (token: string) => void, errorCb?: (error: any) => void): void;
-    getConfigs(): IBody;
-}
-
-/**
- *
- * Class PaymentSourceWidget include method for for creating iframe url
- * @constructor
- *
- * @param {string} publicKey - PayDock users public key
- * @param {string} customer - PayDock's customer_id or customer_reference (In order to use the customer_reference, you must explicitly specify useReference as true)
- * @param {boolean} [useReference=false]
- *
- * @example
- * var widget = new PaymentSourceWidget('publicKey','customerId');
- * // or
- * var widget = new PaymentSourceWidget('publicKey', customerReference, true);
- */
-declare class PaymentSourceWidget {
-    protected link: Link;
-    protected configs: Configuration[];
-    protected configTokens: string[];
-    protected publicKey: string;
-    /** @constructs */ constructor(accessToken: string, queryToken: string);
-    /**
-     * Object contain styles for widget
-     *
-     * @example
-     * widget.setStyles({
-     *       background_color: 'rgb(0, 0, 0)',
-     *       border_color: 'yellow',
-     *       text_color: '#FFFFAA',
-     *       icon_size: 'small',
-     *       font_size: '20px'
-     *   });
-     * @param {IStyles} fields - name of styles which can be shown in widget [STYLE]{@link STYLE}
-     */
-    setStyles(styles: IStyles$1): void;
-    setStyle(param: string, value: string): void;
-    /**
-     * Current method can set custom ID to identify the data in the future
-     *
-     * @example
-     * widget.setRefId('id');
-     *
-     * @param {string} refId - custom id
-     */
-    setRefId(refId: string): void;
-    /**
-     * Current method can set limit for payment sources count. In case when limit sets less then general count will be shown pagination buttons prev and next.
-     *
-     * @param {string} count - payment source count
-     */
-    setLimit(count: number): void;
-    /**
-     * Current method can change environment. By default environment = sandbox
-     * Also we can change domain alias for this environment. By default domain_alias = paydock.com
-     *
-     * @example
-     * widget.setEnv('production');
-     * @param {string} env - sandbox, production
-     * @param {string} [alias] - Own domain alias
-     */
-    setEnv(env: string, alias?: string): void;
-    getEnv(): void;
-    /**
-     * Method for getting iframe's url
-     */
-    getIFrameUrl(): string;
-    /**
-     * Show payment source inside widget only with requested gateway ids
-     *
-     *
-     * @param {string[]} ids - List of gateway_id
-     */
-    filterByGatewayIds(ids: string[]): void;
-    /**
-     *
-     * Show payment source inside widget only with requested payment source types
-     *
-     * @param types - List of payment source types. Available parameters [PAYMENT_TYPE]{@link PAYMENT_TYPE}
-     */
-    filterByTypes(types: string[]): void;
-    /**
-     * Method for setting a custom language code
-     *
-     * @example
-     * config.setLanguage('en');
-     * @param {string} code - ISO 639-1
-     */
-    setLanguage(code: any): void;
-}
-
-interface IEventSelectData extends IEventData$1 {
-    customer_id: string;
-    payment_source_id: string;
-    gateway_id: string;
-    primary: boolean;
-    card_number_last4?: string;
-    card_scheme?: string;
-    checkout_email?: string;
-    gateway_type?: string;
-    payment_source_type: string;
-    account_name?: string;
-    account_number?: string;
-}
-interface IEventPaginationData extends IEventData$1 {
-    total_item: number;
-    skip: number;
-    limit: number;
-}
-interface IEventAfterLoadData extends IEventData$1 {
-    total_item: number;
-    skip: number;
-    limit: number;
-}
-interface IEventSizeData extends IEventData$1 {
-    height: number;
-    width: number;
-}
-/**
- * Interface of data from event.
- *
- * @interface IEventSelectData
- *
- * @param {string} event
- * @param {string} purpose
- * @param {string} message_source
- * @param {string} [ref_id]
- * @param {string} customer_id
- * @param {string} payment_source_id
- * @param {string} gateway_id
- * @param {boolean} primary
- * @param {string} [widget_id]
- * @param {string} [card_number_last4]
- * @param {string} [card_scheme]
- * @param {string} gateway_type
- * @param {string} [checkout_email]
- * @param {string} payment_source_type
- * @param {string} [account_name]
- * @param {string} [account_number]
- * */
-/**
- * Interface of data from event.
- *
- * @interface IEventPaginationData
- *
- * @param {string} event
- * @param {string} purpose
- * @param {string} message_source
- * @param {string} [ref_id]
- * @param {number} total_item
- * @param {number} skip
- * @param {number} limit
- * */
-/**
- * Interface of data from event.
- *
- * @interface IEventAfterLoadData
- *
- * @param {string} event The name of the event.
- * @param {string} purpose A system variable that states the purpose of the event.
- * @param {string} message_source A system variable that identifies the event source.
- * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
- * @param {number} total_item Pagination param. Total item count
- * @param {number} skip Pagination param. Skip items from first item
- * @param {number} limit Pagination param. Query limit
- * */
-/**
- * Interface of data from event.
- * @interface IEventFinishData
- *
- * @param {string} event The name of the event.
- * @param {string} purpose A system variable that states the purpose of the event.
- * @param {string} message_source A system variable that identifies the event source.
- * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
- * */
-/**
-* Interface of data from event.
-* @interface IEventSizeData
-*
-* @param {number} event The name of the event.
-* @param {number} purpose A system variable that states the purpose of the event.
-* @param {string} message_source A system variable that identifies the event source.
-* @param {string} [ref_id] Custom unique value that identifies result of processed operation.
-* @param {number} height Height of iFrame
-* @param {number} width Width of iFrame
-* */
+            public_key: string;
+        };
+    };
+}
+
 /**
- * List of available event's name
+ * @classdesc Google Pay wallet button that creates One-Time Tokens (OTT) via Google Pay.
  *
- * @const EVENT
+ * Provides a fully typed Google Pay integration with Google Pay-specific metadata
+ * and validates that the service configuration corresponds to a Google Pay service.
+ * On `load()`, the button fetches the service configuration and raises an error via `onError`
+ * if the service type does not match Google Pay.
  *
- * @type {object}
- * @param {string} AFTER_LOAD=afterLoad
- * @param {string} SYSTEM_ERROR=systemError
- * @param {string} SELECT=select
- * @param {string} UNSELECT=unselect
- * @param {string} NEXT=next
- * @param {string} PREV=prev
- * @param {string} META_CHANGE=metaChange
- * @param {string} RESIZE=resize
- */
-/**
- * Class HtmlPaymentSourceWidget include method for working on html
- * @constructor
- * @extends PaymentSourceWidget
+ * @class GooglePayOpenWalletButton
+ * @extends OpenWalletButtons
+ *
+ * @param {string} selector - CSS selector of the HTML element that will contain the Google Pay button.
+ * @param {string} publicKeyOrAccessToken - Public key or access token for API authentication.
+ * @param {string} serviceId - The Google Pay service ID configured in PayDock dashboard.
+ * @param {GooglePayOpenWalletMeta} meta - Google Pay-specific metadata (amount, currency, country, card_config, merchant_name, style, etc.).
  *
- * @param {string} selector - Selector of html element. Container for widget
- * @param {string} publicKey - PayDock users public key
- * @param {string} queryToken - PayDock's query token that represents params to search customer by id or reference
  * @example
- *  * var widget = new HtmlPaymentSourceWidget('#widget', 'publicKey','queryToken');
-
+ * const button = new GooglePayOpenWalletButton(
+ *   '#wallet-container',
+ *   publicKeyOrAccessToken,
+ *   serviceId,
+ *   {
+ *     amount: 100,
+ *     currency: 'AUD',
+ *     country: 'AU',
+ *     merchant_name: 'Your Store',
+ *   },
+ * );
+ * button.setEnv('sandbox');
+ * button.onSuccess((data) => console.log('OTT:', data.token));
+ * button.onError((error) => console.error('Error:', error));
+ * button.load();
  */
-declare class HtmlPaymentSourceWidget extends PaymentSourceWidget {
-    protected container: Container;
-    protected iFrame: IFrame;
-    protected event: IFrameEvent;
-    /** @constructs */ constructor(selector: string, publicKey: string, queryToken: string);
-    /**
-     * The final method to beginning, the load process of widget to html
-     *
-     */
-    load(): void;
-    /**
-     * This callback will be called for each event in payment source widget
-     *
-     * @callback listener--PaymentSourceWidget
-     * @param {IEventData | IEventSelectData | IEventPaginationData | IEventAfterLoadData} response
-     */
-    /**
-     * Listen to events of widget
-     *
-     * @example
-     *
-     * widget.on('select', function (data) {
-     *      console.log(data);
-     * });
-     * @param {string} eventName - Available event names [EVENT]{@link EVENT}
-     * @param {listener--PaymentSourceWidget} cb
-     */
-    on(eventName: string, cb: (data: IEventData$1 | IEventSelectData | IEventPaginationData | IEventAfterLoadData | IEventSizeData) => void): void;
-    /**
-     * Using this method you can hide widget after load
-     * @param {boolean} [saveSize=false] - using this param you can save iframe's size
-     */
-    hide(saveSize: boolean): void;
+declare class GooglePayOpenWalletButton extends OpenWalletButtons<GooglePayOpenWalletMeta> {
+    /** @private */
+    readonly walletType: WalletType;
     /**
-     * Using this method you can show widget after using hide method
-     *
+     * Validates Google Pay-specific required metadata fields.
+     * Google Pay has no additional required fields beyond the base (amount, currency, country).
+     * @private
      */
-    show(): void;
+    protected validateWalletMeta(): void;
     /**
-     * Using this method you can reload widget
+     * Validates that the service configuration type is Google Pay.
      *
+     * @private
+     * @param serviceConfig - The service configuration response from the API.
+     * @throws {Error} If the service type is not Google Pay.
      */
-    reload(): void;
+    protected validateServiceType(serviceConfig: GetConfigResponse): void;
     /**
-     * After select event of widget, data (dataType) will be insert to input (selector)
+     * Creates a Google Pay wallet service instance.
      *
-     * @param {string} selector - css selector . [] #
-     * @param {string} dataType - data type of [IEventSelectData]{@link IEventSelectData}.
+     * @private
+     * @param serviceConfig - The service configuration response from the API.
+     * @returns The Google Pay wallet service instance.
      */
-    onSelectInsert(selector: string, dataType: string): void;
+    protected createWalletService(serviceConfig: GetConfigResponse): OpenWalletService;
+}
+
+declare const TYPE: {
+    EXTERNAL_CHECKOUT_TOKEN: string;
+    CHECKOUT_TOKEN: string;
+    BANK_ACCOUNT: string;
+    CARD: string;
+};
+interface IBody {
+    gateway_id: string;
+    type: string;
+    checkout_token?: string;
+}
+declare class Builder extends HttpCore {
+    private body;
+    constructor(gatewayID: string, checkoutToken: string, type: string);
+    constructor(gatewayID: string, externalCheckoutToken: string, type: string);
+    constructor(gatewayID: string, card: any, type: string);
+    constructor(gatewayID: string, bankAccount: any, type: string);
+    protected getLink(): string;
+    send(accessToken: string, cb: (token: string) => void, errorCb?: (error: any) => void): void;
+    getConfigs(): IBody;
 }
 
 declare enum ErrorCodes$1 {
@@ -5750,62 +5787,6 @@ declare class WalletButtons {
     private setupAuthTokensChangedCallback;
 }
 
-interface BaseGatewayConfig<T> {
-    type: string;
-    mode: string;
-    credentials?: T;
-}
-
-interface BaseWalletMeta {
-    amount: number;
-    currency: string;
-}
-
-interface ChargeWalletTokenMeta {
-    charge: {
-        id: string;
-        amount: number;
-        currency: string;
-        capture?: boolean;
-        reference?: string;
-        shipping?: {
-            amount?: number;
-            currency?: string;
-            address_line1?: string;
-            address_line2?: string;
-            address_line3?: string;
-            address_city?: string;
-            address_postcode?: string;
-            address_state?: string;
-            address_country?: string;
-            address_country_code?: string;
-            address_company?: string;
-            address_origin_postcode?: string;
-            method?: string;
-            type?: string;
-            options?: Array<{
-                id?: string;
-                label?: string;
-                detail?: string;
-                amount?: string;
-                currency?: string;
-                type?: string;
-            }>;
-            contact?: {
-                first_name?: string;
-                last_name?: string;
-                email?: string;
-                phone?: string;
-                phone2?: string;
-            };
-        };
-    };
-    gateway: {
-        mode: string;
-        type: string;
-    };
-}
-
 declare enum EVENT {
     UNAVAILABLE = "unavailable",
     ERROR = "error",
@@ -5818,6 +5799,11 @@ declare enum EVENT {
     ON_SHIPPING_OPTIONS_CHANGE = "onShippingOptionsChange"
 }
 
+interface BaseWalletMeta {
+    amount: number;
+    currency: string;
+}
+
 interface BaseEventData<T> {
     event: string;
     chargeId?: string;
@@ -5906,6 +5892,57 @@ interface OnUnavailableEventData extends BaseEventData<undefined> {
     event: EVENT.UNAVAILABLE;
 }
 
+interface BaseGatewayConfig<T> {
+    type: string;
+    mode: string;
+    credentials?: T;
+}
+
+interface ChargeWalletTokenMeta {
+    charge: {
+        id: string;
+        amount: number;
+        currency: string;
+        capture?: boolean;
+        reference?: string;
+        shipping?: {
+            amount?: number;
+            currency?: string;
+            address_line1?: string;
+            address_line2?: string;
+            address_line3?: string;
+            address_city?: string;
+            address_postcode?: string;
+            address_state?: string;
+            address_country?: string;
+            address_country_code?: string;
+            address_company?: string;
+            address_origin_postcode?: string;
+            method?: string;
+            type?: string;
+            options?: Array<{
+                id?: string;
+                label?: string;
+                detail?: string;
+                amount?: string;
+                currency?: string;
+                type?: string;
+            }>;
+            contact?: {
+                first_name?: string;
+                last_name?: string;
+                email?: string;
+                phone?: string;
+                phone2?: string;
+            };
+        };
+    };
+    gateway: {
+        mode: string;
+        type: string;
+    };
+}
+
 interface Contact {
     first_name?: string;
     last_name?: string;
@@ -5957,6 +5994,7 @@ declare abstract class BaseWalletButton<T extends BaseWalletMeta> {
     protected meta: T;
     protected eventEmitter: EventEmitter;
     protected chargeWalletTokenMeta?: ChargeWalletTokenMeta;
+    protected isDisabled: boolean;
     private onShippingOptionsChangeHandlerRegistered;
     constructor(selector: string, publicKeyOrAccessToken: string, gatewayId: string, meta: T, requiredMetaFields: string[]);
     private getApiAuthType;
@@ -5971,6 +6009,20 @@ declare abstract class BaseWalletButton<T extends BaseWalletMeta> {
      * @param {string} [alias] - Own domain alias
      */
     setEnv(env: string, alias?: string): void;
+    /**
+     * Enables the wallet button, restoring interactivity and visual appearance.
+     *
+     * @example
+     * button.enable();
+     */
+    enable(): void;
+    /**
+     * Disables the wallet button, preventing clicks and applying a visual disabled state.
+     *
+     * @example
+     * button.disable();
+     */
+    disable(): void;
     /**
      * Callback for onClick method.
      *
@@ -6178,6 +6230,7 @@ declare abstract class BaseWalletButton<T extends BaseWalletMeta> {
     protected handleOnUnavailable(): void;
     protected handleOnError(error?: Error): void;
     protected eventDataFromApiError(err: any): OnPaymentErrorEventData['data'];
+    protected applyDisabledStyles(): void;
     protected validateRequiredMetaFields(requiredMetaFields: string[]): void;
 }
 
@@ -6555,4 +6608,5 @@ declare global {
     }
 }
 
-export { AfterpayCheckoutButton, AfterpayOnSiteMessaging, Api, ApplePayOpenWalletButton, ApplePayWalletButtonExpress, type Billing, CHECKOUT_BUTTON_EVENT, Canvas3ds, Checkout, CheckoutActionCode, type CheckoutResponse, ClickToPay, Configuration, type CreateOTTData, type CreateOTTRequest, type CreateOTTResponse, type CreateSessionRequest, type CreateSessionResponse, ELEMENT, ERROR_OPERATION, EVENT$2 as EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, FRAUD_PREVENTION_EVENTS, type FraudPreventionEvent, type FraudPreventionEventType, type FraudPreventionProvider, FraudPreventionService, GooglePayOpenWalletButton, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, type ICheckout, type IClickToPayMeta, type IDetails, type IElementStyleInput, type IEventCheckoutFinishData, type IEventData, type IOpenWalletProvider, type IPayPalMeta, type IStyles$1 as IStyles, type ITexts, type IWalletMeta, type IWalletOnClickEvent, type IWalletPaymentSuccessfulEvent, type IWalletUnavailableEvent, type IWalletUpdateData, type IWalletUpdateEvent, InstructionDebugger, MultiWidget, type OTTResponse, type OnCancelEventData, type OnClickEventData$1 as OnClickEventData, type OnCreateOTTErrorEventData, type OnCreateOTTErrorPayload, type OnCreateOTTSuccessPayload, type OnCreateOTTSuccessfulEventData, type OnErrorEventData$1 as OnErrorEventData, type OnErrorPayload, type OnLoadedEventData, type OnUnavailableDetails, type OnUnavailableEventData$1 as OnUnavailableEventData, type OnUnavailablePayload, type OpenWalletBaseEvent, OpenWalletButtons, type OpenWalletDataEvent, type OpenWalletEventType, type OpenWalletMeta, PAYMENT_TYPE, PURPOSE, PayPalDataCollector, PayPalSavePaymentSourceWidget, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, PaypalWalletButtonExpress, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, type Shipping, TEXT, TOKEN_TYPE, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, type VaultDisplayStyle, VaultDisplayWidget, WALLET_TYPES, WalletButtons, type WalletType, ZipmoneyCheckoutButton };
+export { AfterpayCheckoutButton, AfterpayOnSiteMessaging, Api, ApplePayOpenWalletButton, ApplePayWalletButtonExpress, CHECKOUT_BUTTON_EVENT, Canvas3ds, Checkout, CheckoutActionCode, ClickToPay, Configuration, ContactShippingEditingMode, ELEMENT, ERROR_OPERATION, EVENT$2 as EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, FRAUD_PREVENTION_EVENTS, FraudPreventionService, GooglePayOpenWalletButton, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, InstructionDebugger, MultiWidget, OpenWalletButtons, PAYMENT_TYPE, PURPOSE, PayPalDataCollector, PayPalSavePaymentSourceWidget, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, PaypalWalletButtonExpress, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, TEXT, TOKEN_TYPE, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, VaultDisplayWidget, EVENT as WALLET_BUTTONS_EXPRESS_EVENT, WALLET_TYPES, WalletButtons, ZipmoneyCheckoutButton };
+export type { ApplePayButtonStyle, ApplePayButtonType, ApplePayWalletMeta, AppleShippingType, BaseWalletMeta, Billing, CheckoutResponse, CreateOTTData, CreateOTTRequest, CreateOTTResponse, CreateSessionRequest, CreateSessionResponse, EventTypes, FraudPreventionEvent, FraudPreventionEventType, FraudPreventionProvider, IApplePayShippingOption, ICheckout, IClickToPayMeta, IDetails, IElementStyleInput, IEventAfterLoadData, IEventCheckoutFinishData, IEventData$1 as IEventData, IEventFinishData, IEventMetaData, IEventSizeData, IFormValidation, IOpenWalletProvider, IPayPalMeta, IStyles$1 as IStyles, ITexts, IWalletMeta, IWalletOnClickEvent, IWalletPaymentSuccessfulEvent, IWalletUnavailableEvent, IWalletUpdateData, IWalletUpdateEvent, OTTResponse, OnCancelEventData, OnClickEventData$1 as OnClickEventData, OnCreateOTTErrorEventData, OnCreateOTTErrorPayload, OnCreateOTTSuccessPayload, OnCreateOTTSuccessfulEventData, OnErrorEventData$1 as OnErrorEventData, OnErrorPayload, OnLoadedEventData, OnUnavailableDetails, OnUnavailableEventData$1 as OnUnavailableEventData, OnUnavailablePayload, OpenWalletBaseEvent, OpenWalletDataEvent, OpenWalletEventType, OpenWalletMeta, PaypalWalletMeta, Shipping, VaultDisplayStyle, OnClickEventData as WalletExpressOnClickEventData, OnCloseEventData as WalletExpressOnCloseEventData, OnErrorEventData as WalletExpressOnErrorEventData, OnPaymentErrorEventData as WalletExpressOnPaymentErrorEventData, OnPaymentInReviewEventData as WalletExpressOnPaymentInReviewEventData, OnPaymentSuccessfulEventData as WalletExpressOnPaymentSuccessfulEventData, OnShippingAddressChangeEventData as WalletExpressOnShippingAddressChangeEventData, OnShippingAddressChangeEventResponse as WalletExpressOnShippingAddressChangeEventResponse, OnShippingOptionChangeEventData as WalletExpressOnShippingOptionChangeEventData, OnShippingOptionChangeEventResponse as WalletExpressOnShippingOptionChangeEventResponse, OnUnavailableEventData as WalletExpressOnUnavailableEventData, WalletType, WidgetEventMap, WidgetEventName };