@paydock/client-sdk 1.128.2 → 1.131.0-beta

package/bundles/widget.umd.js.d.ts

@@ -239,7 +239,7 @@ declare const CARD_VALIDATORS: {
     readonly NUMBER: "cardNumberValidator";
     readonly PIN: "cardPinValidator";
 };
-type CardValidatorValue = typeof CARD_VALIDATORS[keyof typeof CARD_VALIDATORS];
+type CardValidatorValue = (typeof CARD_VALIDATORS)[keyof typeof CARD_VALIDATORS];
 /**
  * List of available generic form field validators and their definition
  *
@@ -253,7 +253,7 @@ type CardValidatorValue = typeof CARD_VALIDATORS[keyof typeof CARD_VALIDATORS];
 declare const GENERIC_VALIDATORS: {
     readonly REQUIRED: "required";
 };
-type GenericValidatorValue = typeof GENERIC_VALIDATORS[keyof typeof GENERIC_VALIDATORS];
+type GenericValidatorValue = (typeof GENERIC_VALIDATORS)[keyof typeof GENERIC_VALIDATORS];
 
 declare const FORM_FIELD: {
     CARD_NAME: string;
@@ -282,6 +282,8 @@ declare const FORM_FIELD: {
     ADDRESS_POSTCODE: string;
     ADDRESS_COMPANY: string;
     SAVE_CARD_CONSENT_ACCEPTED: string;
+    ENABLE_CVV_TOKENIZATION_MODE: string;
+    CARD_NUMBER_LAST4: string;
 };
 declare const STYLE: {
     BACKGROUND_COLOR: string;
@@ -364,6 +366,7 @@ interface IFormPropertyOption {
     address_city?: string;
     address_postcode?: string;
     address_company?: string;
+    card_number_last4?: string;
 }
 interface IFormValues extends IFormPropertyOption {
 }
@@ -457,6 +460,8 @@ interface IParams extends IStyles$1, ITexts, ICommonParams {
     sdk_origin?: boolean;
     hide_ui_errors?: boolean;
     save_card_consent_accepted?: string;
+    enable_cvv_tokenization_mode?: string;
+    card_number_last4?: string;
 }
 interface ICountryPhoneMask {
     preferred_countries?: string[];
@@ -564,7 +569,7 @@ interface VaultDisplayStyle {
     font_size?: string;
     font_family?: string;
 }
-interface IApplePayShippingOption {
+interface IApplePayShippingOption$1 {
     id: string;
     label: string;
     detail: string;
@@ -584,7 +589,7 @@ interface IPayPalShippingOption {
     currency: string;
     type: 'SHIPPING' | 'PICKUP';
 }
-type IShippingOption = IApplePayShippingOption | IGooglePayShippingOption | IPayPalShippingOption;
+type IShippingOption = IApplePayShippingOption$1 | IGooglePayShippingOption | IPayPalShippingOption;
 declare enum WALLET_TYPE {
     GOOGLE = "google",
     APPLE = "apple",
@@ -723,6 +728,7 @@ interface IGeneral {
     meta?: IPayPalMeta;
     label?: string;
     dynamic_fields_position?: boolean;
+    disable_result_message?: boolean;
 }
 interface IPredefinedFields {
     gateway_id: string;
@@ -846,6 +852,7 @@ declare class Configuration {
     private getUrl;
     private getDefaultGatewayUrl;
     setGiftCardSchemeData(giftCardScheme: any, processingNetwork: any): void;
+    disableResultMessage(): void;
 }
 
 /**
@@ -1225,6 +1232,14 @@ declare class MultiWidget {
      *
      */
     enableSaveCardConsentCheckbox(): void;
+    /**
+     * The Current method enable the cvv mode for card form
+     *
+     * @example
+     * widget.enableCvvTokenizationMode();
+     *
+     */
+    enableCvvTokenizationMode(): void;
 }
 
 interface ITriggerData {
@@ -1284,6 +1299,8 @@ interface IEventMetaData extends IEventData$1 {
 interface IEventFinishData extends IEventData$1 {
     payment_source: string;
     payment_source_token?: string;
+    card_scheme?: string;
+    save_card_consent_accepted?: boolean;
 }
 /**
  * Interface of data from validation event.
@@ -1700,6 +1717,7 @@ declare class HtmlWidget extends HtmlMultiWidget {
        */
     setMeta(meta: IPayPalMeta | IBamboraMeta): void;
     setGiftCardScheme(giftCardScheme: any, processingNetwork: any): void;
+    disableResultMessage(): void;
 }
 
 /**
@@ -1724,7 +1742,7 @@ interface IEventData$1 {
     ref_id?: string;
     error?: IEventError;
 }
-declare const EVENT$1: {
+declare const EVENT$2: {
     readonly AFTER_LOAD: "afterLoad";
     readonly SUBMIT: "submit";
     readonly FINISH: "finish";
@@ -1756,7 +1774,7 @@ declare const EVENT$1: {
     readonly DISPATCH_SUCCESS: "dispatchSuccess";
     readonly DISPATCH_ERROR: "dispatchError";
 };
-type EventTypes = typeof EVENT$1[keyof typeof EVENT$1];
+type EventTypes = typeof EVENT$2[keyof typeof EVENT$2];
 interface Listener {
     event: string;
     listener: (event: any) => void;
@@ -2855,110 +2873,6 @@ declare class HtmlPaymentSourceWidget extends PaymentSourceWidget {
     onSelectInsert(selector: string, dataType: string): void;
 }
 
-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;
-}
-
-interface IBaseSRCMeta {
-    customizations?: IStyles;
-    dpa_data?: {
-        dpa_presentation_name?: string;
-        dpa_uri?: string;
-    };
-    dpa_transaction_options?: {
-        dpa_locale?: string;
-        dpa_accepted_billing_countries?: string[];
-        consumer_name_requested?: boolean;
-        consumer_email_address_requested?: boolean;
-        consumer_phone_number_requested?: boolean;
-        transaction_amount?: {
-            transaction_amount?: number;
-            transaction_currency_code?: string;
-        };
-        merchant_order_id?: string;
-        merchant_category_code?: string;
-        merchant_country_code?: string;
-    };
-}
-interface PhoneNumber {
-    country_code: string;
-    phone_number: string;
-}
-interface Customer {
-    email?: string;
-    phone?: {
-        country_code?: string;
-        phone?: string;
-    };
-    first_name?: string;
-    last_name?: string;
-}
-interface DpaConfig {
-    dpa_id: string;
-    dpa_name: string;
-    dpa_supported_card_schemes: ('MASTERCARD' | 'VISA' | 'AMEX' | 'DISCOVER')[];
-    mode: 'sandbox' | 'live';
-}
-interface IClickToPayMeta extends IBaseSRCMeta {
-    dpa_data?: IBaseSRCMeta['dpa_data'] & {
-        dpa_address?: string;
-        dpa_email_address?: string;
-        dpa_phone_number?: PhoneNumber;
-        dpa_logo_uri?: string;
-        dpa_supported_email_address?: string;
-        dpa_supported_phone_number?: PhoneNumber;
-        dpa_uri?: string;
-        dpa_support_uri?: string;
-        application_type?: 'WEB_BROWSER' | 'MOBILE_APP';
-    };
-    disable_summary_screen?: boolean;
-    co_brand_names?: string[];
-    checkout_experience?: 'WITHIN_CHECKOUT' | 'PAYMENT_SETTINGS';
-    services?: 'INLINE_CHECKOUT' | 'INLINE_INSTALLMENTS';
-    dpa_transaction_options?: IBaseSRCMeta['dpa_transaction_options'] & {
-        dpa_billing_preference?: MASTERCARD_DPA_SHIPPING_BILLING_PREFERENCE;
-        payment_options?: Array<{
-            dynamic_data_type?: string;
-        }>;
-        order_type?: MASTERCARD_ORDER_TYPE;
-        three_ds_preference?: string;
-        confirm_payment?: boolean;
-    };
-    customer?: Customer;
-    unaccepted_card_type?: 'CREDIT' | 'DEBIT';
-    recognition_token?: string;
-    dpa_config?: DpaConfig;
-    hold_for_customer_data?: boolean;
-}
-type MASTERCARD_DPA_SHIPPING_BILLING_PREFERENCE = 'FULL' | 'POSTAL_COUNTRY' | 'NONE';
-type MASTERCARD_ORDER_TYPE = 'SPLIT_SHIPMENT' | 'PREFERRED_CARD';
-interface IStyles {
-    primary_button_color?: string;
-    secondary_button_color?: string;
-    primary_button_text_color?: string;
-    secondary_button_text_color?: string;
-    font_family?: string;
-    enable_src_popup?: boolean;
-}
-
 declare class ApiChargeInternal {
     protected api: ApiInternal;
     constructor(api: ApiInternal);
@@ -3056,6 +2970,15 @@ interface ProcessAuthenticationResponse {
     };
 }
 
+declare class ApiCheckoutInternal {
+    protected api: ApiInternal;
+    constructor(api: ApiInternal);
+    instructions(): Observable<object>;
+    private getInstructionLink;
+    callback(payload: Object): Promise<Object>;
+    status(id: string): Promise<Object>;
+}
+
 declare class ApiGatewayInternal {
     protected api: ApiInternal;
     constructor(api: ApiInternal);
@@ -3067,6 +2990,36 @@ interface GetWalletConfigResponse {
     credentials?: object;
 }
 
+interface CreateOTTResponse {
+    status: number;
+    error: string | null;
+    resource: {
+        type: string;
+        data: {
+            token: string;
+            '3ds_required': boolean;
+        };
+    };
+}
+interface CreateOTTRequest {
+    checkoutData: CheckoutResponse;
+}
+type CheckoutResponse = ApplePayJS.ApplePayPaymentAuthorizedEvent | google.payments.api.PaymentAuthorizationResult;
+declare enum CheckoutActionCode {
+    COMPLETE = "COMPLETE",
+    CANCEL = "CANCEL",
+    ERROR = "ERROR",
+    CHANGE_CARD = "CHANGE_CARD",
+    ADD_CARD = "ADD_CARD",
+    SWITCH_CONSUMER = "SWITCH_CONSUMER"
+}
+
+declare class ApiPaymentSourceInternal {
+    protected api: ApiInternal;
+    constructor(api: ApiInternal);
+    createOTT(payload: CreateOTTRequest): Promise<CreateOTTResponse>;
+}
+
 declare class ApiServiceInternal {
     protected api: ApiInternal;
     constructor(api: ApiInternal);
@@ -3081,20 +3034,242 @@ interface GetConfigResponse {
     certificate_passphrase: string;
 }
 
-declare class ApiCheckoutInternal {
-    protected api: ApiInternal;
-    constructor(api: ApiInternal);
-    instructions(): Observable<object>;
-    private getInstructionLink;
-    callback(payload: Object): Promise<Object>;
-    status(id: string): Promise<Object>;
-}
-
 declare class ApiInternal extends ApiBase {
     charge(): ApiChargeInternal;
     service(): ApiServiceInternal;
     checkout(): ApiCheckoutInternal;
     gateway(): ApiGatewayInternal;
+    paymentSource(): ApiPaymentSourceInternal;
+}
+
+type WalletType = WALLET_TYPES;
+declare enum WALLET_TYPES {
+    APPLE_PAY = "ApplePay",
+    GOOGLE_PAY = "GooglePay"
+}
+
+interface OTTResponse {
+    token: string;
+    token_type: string;
+    three_ds_required?: boolean;
+    wallet_type: WalletType;
+}
+
+interface BaseServiceConfig<T = Record<string, unknown>> {
+    type: string;
+    credentials?: T;
+    meta?: Record<string, unknown>;
+}
+interface ApplePayServiceConfig {
+    apple: {
+        merchant: {
+            merchant_id: string;
+            domain_name: string;
+            display_name: string;
+        };
+        certificate: {
+            certificate_id: string;
+            private_key: string;
+        };
+    };
+}
+interface GooglePayServiceConfig {
+    google_pay: {
+        merchant: {
+            merchant_id: string;
+            merchant_name: string;
+        };
+        gateway_merchant_id: string;
+        allowed_auth_methods: string[];
+        allowed_card_networks: string[];
+    };
+}
+
+interface BaseWalletMeta$1 {
+    amount: number;
+    currency: string;
+}
+
+interface BaseEventData<T> {
+    event: string;
+    chargeId?: string;
+    data?: T | undefined;
+}
+
+declare enum EVENT$1 {
+    ON_CLICK = "onClick",
+    SUCCESS = "success",
+    UNAVAILABLE = "unavailable",
+    ERROR = "error"
+}
+type OpenWalletEventType = EVENT$1;
+
+interface OnClickEventData$1 {
+    request_type: string;
+    wallet_type?: string;
+    meta?: Record<string, unknown>;
+}
+interface OnCrateOTTSuccessfulEventData {
+    token: string;
+    token_type: string;
+    checkoutData?: CheckoutResponse | unknown;
+    three_ds_required?: boolean;
+    wallet_type: string;
+}
+interface OnCreateOTTErrorEventData extends BaseEventData<{
+    message?: string;
+    code?: string;
+}> {
+    event: EVENT$1.ERROR;
+}
+interface OnUnavailableEventData$1 {
+    wallet_type: string;
+    reason: string;
+    details?: Record<string, unknown>;
+}
+interface OnErrorEventData$1 {
+    error: Error;
+    context?: {
+        operation?: string;
+        wallet_type?: string;
+    };
+}
+
+interface WalletPaymentSource {
+    load(): void;
+    setMeta(meta: object): void;
+}
+
+declare abstract class BaseOpenWallet<T extends BaseWalletMeta$1> implements WalletPaymentSource {
+    protected container: Container;
+    protected api: ApiInternal;
+    protected env: string;
+    protected serviceId: string;
+    protected meta: T;
+    protected eventEmitter: EventEmitter;
+    abstract readonly walletType: WalletType;
+    constructor(selector: string, publicKeyOrAccessToken: string, serviceId: string, meta: T, requiredMetaFields: string[]);
+    private getApiAuthType;
+    setEnv(env: string, alias?: string): void;
+    private validateRequiredMetaFields;
+    abstract load(): void;
+    abstract setMeta(meta: object): void;
+    onClick(handler: (data: OnClickEventData$1) => Promise<string>): () => void;
+    onSuccess(handler?: (data: OnCrateOTTSuccessfulEventData) => void): Promise<unknown> | (() => void);
+    onUnavailable(handler?: (data: OnUnavailableEventData$1) => void): Promise<unknown> | (() => void);
+    onError(handler?: (data: OnErrorEventData$1) => void): Promise<unknown> | (() => void);
+    protected getServiceWalletConfig<K>(): Promise<BaseServiceConfig<K>>;
+    protected executeOpenWalletCallback<K, U extends {
+        request_type: string;
+    }>(data: U): Promise<K>;
+    protected createOTT(data: CreateOTTRequest): Promise<CreateOTTResponse>;
+    protected handleOnError(error: Error): void;
+    protected handleOnUnavailable(reason?: string): void;
+    destroy(): void;
+}
+
+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;
+}
+
+interface IBaseSRCMeta {
+    customizations?: IStyles;
+    dpa_data?: {
+        dpa_presentation_name?: string;
+        dpa_uri?: string;
+    };
+    dpa_transaction_options?: {
+        dpa_locale?: string;
+        dpa_accepted_billing_countries?: string[];
+        consumer_name_requested?: boolean;
+        consumer_email_address_requested?: boolean;
+        consumer_phone_number_requested?: boolean;
+        transaction_amount?: {
+            transaction_amount?: number;
+            transaction_currency_code?: string;
+        };
+        merchant_order_id?: string;
+        merchant_category_code?: string;
+        merchant_country_code?: string;
+    };
+}
+interface PhoneNumber {
+    country_code: string;
+    phone_number: string;
+}
+interface Customer {
+    email?: string;
+    phone?: {
+        country_code?: string;
+        phone?: string;
+    };
+    first_name?: string;
+    last_name?: string;
+}
+interface DpaConfig {
+    dpa_id: string;
+    dpa_name: string;
+    dpa_supported_card_schemes: ('MASTERCARD' | 'VISA' | 'AMEX' | 'DISCOVER')[];
+    mode: 'sandbox' | 'live';
+}
+interface IClickToPayMeta extends IBaseSRCMeta {
+    dpa_data?: IBaseSRCMeta['dpa_data'] & {
+        dpa_address?: string;
+        dpa_email_address?: string;
+        dpa_phone_number?: PhoneNumber;
+        dpa_logo_uri?: string;
+        dpa_supported_email_address?: string;
+        dpa_supported_phone_number?: PhoneNumber;
+        dpa_uri?: string;
+        dpa_support_uri?: string;
+        application_type?: 'WEB_BROWSER' | 'MOBILE_APP';
+    };
+    disable_summary_screen?: boolean;
+    co_brand_names?: string[];
+    checkout_experience?: 'WITHIN_CHECKOUT' | 'PAYMENT_SETTINGS';
+    services?: 'INLINE_CHECKOUT' | 'INLINE_INSTALLMENTS';
+    dpa_transaction_options?: IBaseSRCMeta['dpa_transaction_options'] & {
+        dpa_billing_preference?: MASTERCARD_DPA_SHIPPING_BILLING_PREFERENCE;
+        payment_options?: Array<{
+            dynamic_data_type?: string;
+        }>;
+        order_type?: MASTERCARD_ORDER_TYPE;
+        three_ds_preference?: string;
+        confirm_payment?: boolean;
+    };
+    customer?: Customer;
+    unaccepted_card_type?: 'CREDIT' | 'DEBIT';
+    recognition_token?: string;
+    dpa_config?: DpaConfig;
+    hold_for_customer_data?: boolean;
+}
+type MASTERCARD_DPA_SHIPPING_BILLING_PREFERENCE = 'FULL' | 'POSTAL_COUNTRY' | 'NONE';
+type MASTERCARD_ORDER_TYPE = 'SPLIT_SHIPMENT' | 'PREFERRED_CARD';
+interface IStyles {
+    primary_button_color?: string;
+    secondary_button_color?: string;
+    primary_button_text_color?: string;
+    secondary_button_text_color?: string;
+    font_family?: string;
+    enable_src_popup?: boolean;
 }
 
 type CustomerData = Customer;
@@ -3307,6 +3482,64 @@ declare class VaultDisplayWidget {
     load(): void;
 }
 
+declare enum EventEnum {
+    UNAVAILABLE = "unavailable",
+    UPDATE = "update",
+    PAYMENT_SUCCESSFUL = "paymentSuccessful",
+    PAYMENT_ERROR = "paymentError",
+    PAYMENT_IN_REVIEW = "paymentInReview",
+    AUTH_TOKENS_CHANGED = "authTokensChanged",
+    ON_CLICK = "onClick",
+    ON_CHECKOUT_OPEN = "onCheckoutOpen",
+    ON_CHECKOUT_CLOSE = "onCheckoutClose",
+    ON_WALLET_LOADED = "onWalletLoaded"
+}
+
+interface IWalletPaymentSuccessful {
+    id: string;
+    amount: number;
+    currency: string;
+    status: string;
+    payer_name?: string;
+    payer_email?: string;
+    payer_phone?: string;
+}
+interface IWalletUnavailable {
+    wallet?: WALLET_TYPE;
+}
+interface IWalletOnClick {
+    attachResult: (result: Promise<void> | boolean) => void;
+}
+interface IWalletUpdate {
+    wallet_response_code?: string;
+    wallet_order_id?: string;
+    wallet_session_id?: string;
+    payment_source?: {
+        wallet_payment_method_id?: string;
+        card_number_last4?: string;
+        card_scheme?: string;
+    };
+    wallet_loyalty_account?: {
+        id?: string;
+        barcode?: string;
+    };
+    shipping?: {
+        address_line1?: string;
+        address_line2?: string;
+        address_postcode?: string;
+        address_city?: string;
+        address_state?: string;
+        address_country?: string;
+        address_company?: string;
+        post_office_box_number?: string;
+        wallet_address_id?: string;
+        wallet_address_name?: string;
+        wallet_address_created_timestamp?: string;
+        wallet_address_updated_timestamp?: string;
+    };
+    selected_shipping_option?: IShippingOption;
+}
+
 interface IWalletServiceUpdateData {
     amount: number;
     shipping_options?: IShippingOption[];
@@ -3359,8 +3592,7 @@ interface IPaymentMethod {
         };
     };
 }
-interface IUnavailableWalletEventBody {
-}
+type IUnavailableWalletEventBody = Record<string, never>;
 interface IPaymentMethodSelectedWalletEventBody {
     data: IPaymentMethod;
     onSuccess: () => void;
@@ -3373,64 +3605,7 @@ interface IWalletService {
     enable(): void;
     disable(): void;
     setEnv(env: string): any;
-    on(eventName: string, cb?: (data: IUnavailableWalletEventBody | IPaymentMethodSelectedWalletEventBody | any) => void): any;
-}
-
-interface IWalletPaymentSuccessful {
-    id: string;
-    amount: number;
-    currency: string;
-    status: string;
-    payer_name?: string;
-    payer_email?: string;
-    payer_phone?: string;
-}
-interface IWalletUnavailable {
-    wallet?: WALLET_TYPE;
-}
-interface IWalletOnClick {
-    attachResult: (result: Promise<void> | boolean) => void;
-}
-interface IWalletUpdate {
-    wallet_response_code?: string;
-    wallet_order_id?: string;
-    wallet_session_id?: string;
-    payment_source?: {
-        wallet_payment_method_id?: string;
-        card_number_last4?: string;
-        card_scheme?: string;
-    };
-    wallet_loyalty_account?: {
-        id?: string;
-        barcode?: string;
-    };
-    shipping?: {
-        address_line1?: string;
-        address_line2?: string;
-        address_postcode?: string;
-        address_city?: string;
-        address_state?: string;
-        address_country?: string;
-        address_company?: string;
-        post_office_box_number?: string;
-        wallet_address_id?: string;
-        wallet_address_name?: string;
-        wallet_address_created_timestamp?: string;
-        wallet_address_updated_timestamp?: string;
-    };
-    selected_shipping_option?: IShippingOption;
-}
-
-declare enum EventEnum {
-    UNAVAILABLE = "unavailable",
-    UPDATE = "update",
-    PAYMENT_SUCCESSFUL = "paymentSuccessful",
-    PAYMENT_ERROR = "paymentError",
-    PAYMENT_IN_REVIEW = "paymentInReview",
-    AUTH_TOKENS_CHANGED = "authTokensChanged",
-    ON_CLICK = "onClick",
-    ON_CHECKOUT_OPEN = "onCheckoutOpen",
-    ON_CHECKOUT_CLOSE = "onCheckoutClose"
+    on(eventName: string, cb?: (data: IUnavailableWalletEventBody | IPaymentMethodSelectedWalletEventBody | unknown) => void): any;
 }
 
 interface IEventData<T = any> {
@@ -3711,6 +3886,7 @@ declare class WalletButtons {
      */
     onCheckoutClose(handler?: (err: IEventData) => void): Promise<unknown> | (() => void);
     private setupServiceCallbacks;
+    private setupOnWalletLoadedCallback;
     private setupUnavailableCallback;
     private setupUpdateCallback;
     private setupOnClickCallback;
@@ -3724,7 +3900,7 @@ declare class WalletButtons {
     private setupAuthTokensChangedCallback;
 }
 
-type Instruction = new (selector: string, formSelector: string, api: ApiInternal, checkoutWidget: Checkout) => InstructionHandler & InstructionDestroyable & InstructionDecorated;
+type Instruction = new (selector: string, api: ApiInternal, checkoutWidget: Checkout, formSelector?: string) => InstructionHandler & InstructionDestroyable & InstructionDecorated;
 interface InstructionHandleable {
     handle(payload: object, eventEmitter: EventEmitter): void;
 }
@@ -3736,13 +3912,13 @@ interface InstructionDestroyable {
 }
 declare abstract class InstructionHandler implements InstructionHandleable, InstructionDestroyable, InstructionDecorated {
     selector: string;
-    formSelector: string;
     api: ApiInternal;
     protected checkoutWidget?: Checkout;
-    constructor(selector: string, formSelector: string, api: ApiInternal, checkoutWidget?: Checkout);
+    formSelector?: string;
+    constructor(selector: string, api: ApiInternal, checkoutWidget?: Checkout, formSelector?: string);
     instruction: string;
     abstract handle(context: object, eventEmitter?: any): void;
-    abstract destroy(): void;
+    destroy(): void;
     getEnv(instruction_token: string): string;
 }
 
@@ -3769,7 +3945,7 @@ interface IntentTokenPayload {
  * var widget = new Checkout('#widget', 'intent_token');
  **/
 declare class Checkout {
-    protected formSelector: string;
+    protected selector: string;
     protected intentToken: string;
     protected debug: boolean;
     protected window: Window;
@@ -3780,11 +3956,12 @@ declare class Checkout {
     protected checkoutApi: ApiCheckoutInternal;
     protected instructions: InstructionModule;
     protected currentInstruction: InstructionDestroyable & InstructionHandleable;
+    private checkoutVersionHandler;
     private timeoutTimer;
     private requestInFlight;
     private inTimeoutRange;
     private checkoutFinished;
-    constructor(formSelector: string, intentToken: string, debug?: boolean);
+    constructor(selector: string, intentToken: string, debug?: boolean);
     fetchInstruction(): void;
     finaliseCheckout(): void;
     private setupTimeoutTimer;
@@ -3829,10 +4006,11 @@ declare class Checkout {
      */
     onPaymentExpired(handler: (data: IEventData$1) => void): () => void;
     createWidgetStructure(): void;
-    private setStyles;
+    private changeLoadingSpinnerVisibility;
 }
+
 declare class InstructionDebugger {
-    constructor(selector: string, formSelector: string, version: number, instructionName: string, context: object, token?: string);
+    constructor(selector: string, version: number, instructionName: string, context: object, token?: string);
 }
 
 declare enum EVENT {
@@ -3847,12 +4025,6 @@ declare enum EVENT {
     ON_SHIPPING_OPTIONS_CHANGE = "onShippingOptionsChange"
 }
 
-interface BaseEventData<T> {
-    event: string;
-    chargeId?: string;
-    data?: T | undefined;
-}
-
 interface OnClickEventData extends BaseEventData<undefined> {
     event: EVENT.ON_CLICK;
 }
@@ -3881,6 +4053,13 @@ interface OnPaymentErrorEventData extends BaseEventData<{
     event: EVENT.PAYMENT_ERROR;
 }
 
+interface Contact {
+    first_name?: string;
+    last_name?: string;
+    email?: string;
+    phone?: string;
+    phone2?: string;
+}
 interface WalletCaptureRequest {
     payment_method_id?: string;
     customer: {
@@ -3901,6 +4080,18 @@ interface WalletCaptureRequest {
             wallet_express?: boolean;
         };
     };
+    shipping?: {
+        address_line1?: string;
+        address_line2?: string;
+        address_line3?: string;
+        address_country?: string;
+        address_city?: string;
+        address_postcode?: string;
+        address_state?: string;
+        options?: IShippingOption[];
+        method?: string;
+        contact?: Contact;
+    };
 }
 
 interface OnUnavailableEventData extends BaseEventData<undefined> {
@@ -3930,6 +4121,7 @@ interface ChargeWalletTokenMeta {
             address_postcode?: string;
             address_state?: string;
             address_country?: string;
+            address_country_code?: string;
             address_company?: string;
             address_origin_postcode?: string;
             method?: string;
@@ -4264,10 +4456,19 @@ interface AppleShippingType {
     };
     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;
+    options?: IApplePayShippingOption[];
+}
+interface IApplePayShippingOption {
+    id?: string;
+    label?: string;
+    detail?: string;
+    amount?: string;
 }
 
 interface ApplePayWalletMeta extends BaseWalletMeta {
@@ -4820,4 +5021,4 @@ declare global {
     }
 }
 
-export { AfterpayCheckoutButton, Api, ApplePayWalletButtonExpress, CHECKOUT_BUTTON_EVENT, Canvas3ds, Checkout, ClickToPay, Configuration, ELEMENT, EVENT$1 as EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, FRAUD_PREVENTION_EVENTS, type FraudPreventionEvent, type FraudPreventionEventType, type FraudPreventionProvider, FraudPreventionService, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, type ICheckout, type IClickToPayMeta, type IDetails, type IElementStyleInput, type IEventCheckoutFinishData, type IEventData, type IPayPalMeta, type IStyles$1 as IStyles, type ITexts, type IWalletMeta, type IWalletOnClickEvent, type IWalletPaymentSuccessfulEvent, type IWalletUnavailableEvent, type IWalletUpdateData, type IWalletUpdateEvent, InstructionDebugger, MultiWidget, PAYMENT_TYPE, PURPOSE, PayPalDataCollector, PayPalSavePaymentSourceWidget, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, PaypalWalletButtonExpress, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, TEXT, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, type VaultDisplayStyle, VaultDisplayWidget, WalletButtons, ZipmoneyCheckoutButton };
+export { AfterpayCheckoutButton, Api, type ApplePayServiceConfig, ApplePayWalletButtonExpress, BaseOpenWallet, type BaseServiceConfig, type BaseWalletMeta$1 as BaseWalletMeta, CHECKOUT_BUTTON_EVENT, Canvas3ds, Checkout, CheckoutActionCode, type CheckoutResponse, ClickToPay, Configuration, type CreateOTTRequest, type CreateOTTResponse, ELEMENT, EVENT$2 as EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, FRAUD_PREVENTION_EVENTS, type FraudPreventionEvent, type FraudPreventionEventType, type FraudPreventionProvider, FraudPreventionService, type GooglePayServiceConfig, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, type ICheckout, type IClickToPayMeta, type IDetails, type IElementStyleInput, type IEventCheckoutFinishData, type IEventData, 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 OnClickEventData$1 as OnClickEventData, type OnCrateOTTSuccessfulEventData, type OnCreateOTTErrorEventData, type OnErrorEventData$1 as OnErrorEventData, type OnUnavailableEventData$1 as OnUnavailableEventData, type OpenWalletEventType, PAYMENT_TYPE, PURPOSE, PayPalDataCollector, PayPalSavePaymentSourceWidget, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, PaypalWalletButtonExpress, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, TEXT, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, type VaultDisplayStyle, VaultDisplayWidget, WALLET_TYPES, WalletButtons, type WalletPaymentSource, type WalletType, ZipmoneyCheckoutButton };