@adyen/adyen-web 6.33.0 → 6.34.1

package/dist/es/index.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="applepayjs" />
 /// <reference types="googlepay" />
 import * as preact from 'preact';
-import { h, Ref, Component, FunctionComponent, ComponentChild, RefObject } from 'preact';
+import { h, TargetedMouseEvent, Ref, RefObject, Component, FunctionComponent, ComponentChild } from 'preact';
+import { OrderResponseBody, OnShippingAddressChangeData, OnShippingOptionsChangeData, OnInitActions } from '@paypal/paypal-js';
 
 /**
  * Holds the result of a validation
@@ -23,7 +24,9 @@ declare class ValidationRuleResult {
 type ValidatorMode = 'blur' | 'input';
 type ErrorMessageObject = {
     translationKey: string;
-    translationObject: any;
+    translationObject: {
+        values: Record<string, string | null>;
+    };
 };
 type ValidateFunction = (value: string, context: any) => boolean;
 interface ValidatorRule {
@@ -234,6 +237,10 @@ type SetupSessionOptions = {
     order?: Order;
 };
 
+interface ILanguageService {
+    fetchTranslationsFromCdn(locale: string): Promise<Readonly<Translations>>;
+}
+
 type CustomTranslations = {
     [locale: string]: Translations;
 };
@@ -241,20 +248,33 @@ type Translations = {
     [translationKey: string]: string;
 };
 interface LanguageOptions {
-    locale: string;
-    translations: Translations;
+    service: ILanguageService;
+    locale?: string;
     customTranslations?: CustomTranslations;
+    onError?: CoreConfiguration['onError'];
 }
 
 declare class Language {
     readonly locale: string;
     readonly languageCode: string;
-    private readonly translations;
+    private readonly service;
     private readonly customTranslations;
+    /**
+     * Supported locales list
+     * Includes all supported locales from the CDN and any custom locales defined in customTranslations
+     */
+    private readonly supportedLocales;
+    /**
+     * Translations object
+     * Contains all translations for the current locale, including English as fallback
+     */
+    private _translations;
     readonly timeFormatOptions: Intl.DateTimeFormatOptions;
     readonly timeAndDateFormatOptions: Intl.DateTimeFormatOptions;
     readonly timeAndDateFormatter: Intl.DateTimeFormat;
     constructor(props: LanguageOptions);
+    requestTranslations(): Promise<void>;
+    get translations(): Readonly<Translations>;
     /**
      * Returns a translated string from a key in the current {@link Language.locale}
      * @param key - Translation key
@@ -280,6 +300,13 @@ declare class Language {
      * @param date - Date to be localized
      */
     dateTime(date: string): string;
+    /**
+     * Creates a list of supported locales including the ones passed as custom translations
+     *
+     * @param customTranslations - Custom translations to include
+     * @returns Array of supported locales
+     */
+    private createSupportedLocalesList;
 }
 
 type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'action' | 'link' | 'iconOnly';
@@ -295,6 +322,8 @@ interface ButtonProps {
     onClickCompletedLabel?: string | h.JSX.Element;
     ariaLabel?: string;
     ariaDescribedBy?: string;
+    ariaExpanded?: boolean;
+    ariaControls?: string;
     secondaryLabel?: string;
     icon?: string;
     onClickCompletedIcon?: string;
@@ -302,7 +331,7 @@ interface ButtonProps {
     href?: string;
     target?: string;
     rel?: string;
-    onClick?: (e: h.JSX.TargetedMouseEvent<HTMLButtonElement | HTMLAnchorElement>, callbacks?: {
+    onClick?: (e: TargetedMouseEvent<HTMLButtonElement | HTMLAnchorElement>, callbacks?: {
         complete?: () => void;
     }) => void;
     onKeyDown?: (event: KeyboardEvent) => void;
@@ -564,7 +593,9 @@ declare class AmazonPayElement extends UIElement<AmazonPayConfiguration> {
      */
     formatData(): AmazonPayElementData;
     protected beforeRender(configSetByMerchant?: AmazonPayConfiguration): void;
-    getShopperDetails(): void | Promise<any>;
+    getShopperDetails(): void | Promise<{
+        declineFlowUrl?: string;
+    } & Record<string, unknown>>;
     handleDeclineFlow(): void;
     get isValid(): boolean;
     get browserInfo(): BrowserInfo;
@@ -572,11 +603,6 @@ declare class AmazonPayElement extends UIElement<AmazonPayConfiguration> {
     protected componentToRender(): h.JSX.Element;
 }
 
-declare global {
-    interface Window {
-        amazon: object;
-    }
-}
 type ButtonColor = 'Gold' | 'LightGray' | 'DarkGray';
 type Placement = 'Home' | 'Product' | 'Cart' | 'Checkout' | 'Other';
 type ProductType = 'PayOnly' | 'PayAndShip';
@@ -585,6 +611,19 @@ type FrequencyUnit = 'Year' | 'Month' | 'Week' | 'Day' | 'Variable';
 type Currency = 'EUR' | 'GBP' | 'USD';
 type Region = 'EU' | 'UK' | 'US';
 type SupportedLocale = (typeof SUPPORTED_LOCALES_EU)[number] | (typeof SUPPORTED_LOCALES_US)[number];
+interface AmazonPayButtonInstance {
+    onClick(handler: () => void): void;
+}
+interface AmazonWindowObject {
+    Pay: {
+        renderButton(selector: string, settings: AmazonPayButtonSettings): AmazonPayButtonInstance;
+        initCheckout(options: AmazonPayButtonSettings & {
+            createCheckoutSessionConfig: CheckoutSessionConfig;
+        }): void;
+        signout(): void;
+        bindChangeAction(selector: string, options: ChangeActionOptions): void;
+    };
+}
 interface RecurringMetadata {
     frequency: {
         unit: string;
@@ -613,11 +652,12 @@ interface AmazonPayConfiguration extends UIElementProps {
     configuration?: AmazonPayBackendConfiguration;
     currency?: Currency;
     deliverySpecifications?: DeliverySpecifications;
+    design?: string;
     environment?: string;
     loadingContext?: string;
     locale?: string;
     merchantMetadata?: MerchantMetadata;
-    onSubmit?(state: any, element: AmazonPayElement, actions: {
+    onSubmit?(state: SubmitData, element: AmazonPayElement, actions: {
         resolve: (response: CheckoutAdvancedFlowResponse) => void;
         reject: () => void;
     }): void;
@@ -630,9 +670,9 @@ interface AmazonPayConfiguration extends UIElementProps {
     showOrderButton?: boolean;
     showSignOutButton?: boolean;
     signature?: string;
-    onClick?: (resolve: any, reject: any) => Promise<void>;
-    onError?: (error: any, component: any) => void;
-    onSignOut?: (resolve: any, reject: any) => Promise<void>;
+    onClick?: (resolve: (value?: unknown) => void, reject: () => void) => Promise<void>;
+    onError?: (error: AdyenCheckoutError, component: UIElement) => void;
+    onSignOut?: (resolve: (value?: unknown) => void, reject: () => void) => Promise<void>;
     /**
      * Used for analytics
      */
@@ -648,13 +688,12 @@ interface AmazonPayComponentProps extends AmazonPayConfiguration {
     amazonCheckoutSessionId?: string;
     showOrderButton?: boolean;
     showChangePaymentDetailsButton?: boolean;
-    onClick: (resolve: any, reject: any) => Promise<void>;
-    onError: (error: any, component: any) => void;
-    onSignOut: (resolve: any, reject: any) => Promise<void>;
-    ref: any;
+    setComponentRef: (ref: ComponentMethodsRef & {
+        getSubmitFunction?: () => () => void;
+    }) => void;
 }
 interface AmazonPayButtonProps {
-    amazonRef: any;
+    amazonRef: AmazonWindowObject;
     buttonColor?: ButtonColor;
     cancelUrl?: string;
     chargePermissionType?: ChargePermissionType;
@@ -665,22 +704,24 @@ interface AmazonPayButtonProps {
     design?: string;
     environment?: string;
     locale?: string;
-    onClick: (resolve: any, reject: any) => Promise<void>;
-    onError: (error: any, component: any) => void;
+    onClick: (resolve: (value?: unknown) => void, reject: () => void) => Promise<void>;
+    onError?: (error: AdyenCheckoutError, component: UIElement) => void;
     placement?: Placement;
     productType?: ProductType;
     recurringMetadata?: RecurringMetadata;
-    ref: any;
+    ref: RefObject<{
+        initCheckout(): void;
+    }>;
     returnUrl?: string;
     showPayButton: boolean;
 }
 interface SignOutButtonProps {
-    amazonRef: any;
-    onSignOut: (resolve: any, reject: any) => Promise<void>;
+    amazonRef: AmazonWindowObject;
+    onSignOut: (resolve: (value?: unknown) => void, reject: () => void) => Promise<void>;
 }
 interface ChangePaymentDetailsButtonProps {
     amazonCheckoutSessionId: string;
-    amazonRef: any;
+    amazonRef: AmazonWindowObject;
 }
 interface ChangeActionOptions {
     amazonCheckoutSessionId: string;
@@ -690,9 +731,11 @@ interface OrderButtonProps {
     amazonCheckoutSessionId: string;
     clientKey: string;
     chargePermissionType?: ChargePermissionType;
-    onError: (error: any, component: any) => void;
+    onError: (error: AdyenCheckoutError, component: UIElement) => void;
     recurringMetadata: RecurringMetadata;
-    ref: any;
+    ref: RefObject<{
+        createOrder(): void;
+    }>;
     region: Region;
     returnUrl: string;
     publicKeyId: string;
@@ -986,7 +1029,7 @@ interface ApplePayConfiguration extends UIElementProps {
      * @param reject - Must be called if something failed during the merchant validation
      * @param validationURL - The URL your server must use to validate itself and obtain a merchant session object.
      */
-    onValidateMerchant?: (resolve: (merchantSession: any) => void, reject: (error?: string) => void, validationURL: string) => Promise<void>;
+    onValidateMerchant?: (resolve: (merchantSession: unknown) => void, reject: (error?: string) => void, validationURL: string) => Promise<void>;
     /**
      * An event handler to call when the user selects a new payment method.
      *
@@ -1143,7 +1186,7 @@ interface VoucherProps {
     /**
      * Any additional surcharge to the amount.
      */
-    surcharge?: any;
+    surcharge?: string;
     /**
      * List of details that will be rendered on the voucher.
      */
@@ -1519,7 +1562,7 @@ declare class SecuredFieldsProvider extends Component<SFPProps, SFPState> {
     private checkForKCPFields;
     getChildContext(): object;
     handleUnsupportedCard(errObj: CardErrorData): boolean;
-    setFocusOn(frame: string): void;
+    setFocusOn(frame: SFFieldType): void;
     updateStyles(stylesObj: StylesObject): void;
     sfIsOptionalOrHidden(fieldType: string): boolean;
     destroy(): void;
@@ -2108,8 +2151,6 @@ interface DokuVoucherResultProps {
     instructionsUrl?: string;
     shopperName?: string;
     merchantName?: string;
-    outputDetails?: any;
-    ref?: any;
     onActionHandled?: (rtnObj: ActionHandledReturnObject) => void;
 }
 
@@ -2192,7 +2233,10 @@ interface DragonpayConfiguraton extends UIElementProps {
     type?: string;
     issuers?: DragonpayInputIssuerItem[];
     /** @deprecated use issuers */
-    details?: any;
+    details?: {
+        key: string;
+        items: DragonpayInputIssuerItem[];
+    }[];
     loadingContext?: string;
     reference?: string;
     i18n?: Language;
@@ -2210,7 +2254,7 @@ interface DragonpayInputProps {
     onSubmit?: (state: any, component: any) => void;
     showPayButton: boolean;
     payButton: (props: PayButtonProps) => h.JSX.Element;
-    ref?: any;
+    setComponentRef: (ref: ComponentMethodsRef) => void;
 }
 interface DragonpayVoucherResultProps {
     reference?: string;
@@ -2222,7 +2266,6 @@ interface DragonpayVoucherResultProps {
     alternativeReference?: string;
     icon?: string;
     issuer?: string;
-    ref?: any;
     onActionHandled?: (rtnObj: ActionHandledReturnObject) => void;
 }
 
@@ -2555,12 +2598,6 @@ declare enum IrisMode {
     BANK_LIST = "bankList"
 }
 
-declare global {
-    interface Window {
-        Klarna: any;
-        klarnaAsyncCallback: any;
-    }
-}
 /** sdkData present in Klarna `action`objects. */
 type KlarnaSdkData = {
     /**
@@ -2596,7 +2633,7 @@ interface KlarnaWidgetAuthorizeResponse {
     approved: boolean;
     show_form: boolean;
     authorization_token: string;
-    error?: any;
+    error?: unknown;
 }
 interface KlarnaComponentRef extends ComponentMethodsRef {
     setAction(action: KlarnaAction): void;
@@ -2618,35 +2655,10 @@ interface KlarnaAdditionalDetailsData extends AdditionalDetailsData {
     };
 }
 
-interface MultibancoVoucherResultProps {
-    entity?: string;
-    reference?: string;
-    expiresAt?: string;
-    merchantReference?: string;
-    totalAmount?: PaymentAmount;
-    paymentMethodType?: string;
-    downloadUrl?: string;
-    ref?: any;
-    onActionHandled?: (rtnObj: ActionHandledReturnObject) => void;
-}
-
-interface OxxoVoucherResultProps {
-    alternativeReference?: string;
-    reference?: string;
-    expiresAt?: string;
-    merchantReference?: string;
-    totalAmount?: PaymentAmount;
-    paymentMethodType?: string;
-    downloadUrl?: string;
-    ref?: any;
-    onActionHandled?: (rtnObj: ActionHandledReturnObject) => void;
-    clientKey?: string;
-}
-
 declare class PaypalElement extends UIElement<PayPalConfiguration> {
     static readonly type = TxVariants.paypal;
     static readonly subtype = "sdk";
-    paymentData: string;
+    paymentData: string | null;
     private resolve;
     private reject;
     protected static readonly defaultProps: Partial<PayPalConfiguration>;
@@ -2678,7 +2690,7 @@ declare class PaypalElement extends UIElement<PayPalConfiguration> {
      * Paypal does not require any specific Dropin validation
      */
     get isValid(): boolean;
-    private handleOnApprove;
+    private readonly handleOnApprove;
     handleResolve(token: string): void;
     handleReject(errorMessage: string): void;
     private handleSubmit;
@@ -2700,9 +2712,18 @@ declare class PaypalElement extends UIElement<PayPalConfiguration> {
      * @param actions - PayPal actions.
      */
     private handleOnShippingOptionsChange;
-    protected componentToRender(): h.JSX.Element;
+    protected componentToRender(): h.JSX.Element | null;
 }
 
+type PayPalOrderResponseBody = OrderResponseBody;
+type PayPalOnShippingAddressChangeData = OnShippingAddressChangeData & {
+    errors: Record<string, string>;
+};
+type PayPalOnShippingOptionsChangeData = OnShippingOptionsChangeData & {
+    errors: Record<string, string>;
+};
+type PayPalOnInitActions = OnInitActions;
+
 interface PayPalConfiguration extends UIElementProps {
     /**
      * Configuration returned by the backend
@@ -2712,7 +2733,7 @@ interface PayPalConfiguration extends UIElementProps {
         /**
          * @see {@link https://developer.paypal.com/sdk/js/configuration/#merchant-id}
          */
-        merchantId: string;
+        merchantId?: string;
         /**
          * @see {@link https://developer.paypal.com/sdk/js/configuration/#intent}
          */
@@ -2755,7 +2776,7 @@ interface PayPalConfiguration extends UIElementProps {
      * @param actions - Used to indicate that payment flow must continue or must stop
      */
     onAuthorized?: (data: {
-        authorizedEvent: any;
+        authorizedEvent: PayPalOrderResponseBody;
         billingAddress?: Partial<AddressData>;
         deliveryAddress?: Partial<AddressData>;
     }, actions: {
@@ -2770,7 +2791,7 @@ interface PayPalConfiguration extends UIElementProps {
      * @param actions - Used to reject the address change in case the address is invalid
      * @param component - Adyen instance of its PayPal implementation. It must be used to manipulate the 'paymentData' in order to apply the amount patch correctly
      */
-    onShippingAddressChange?: (data: any, actions: {
+    onShippingAddressChange?: (data: PayPalOnShippingAddressChangeData, actions: {
         reject: (reason?: string) => Promise<void>;
     }, component: PaypalElement) => Promise<void>;
     /**
@@ -2781,7 +2802,7 @@ interface PayPalConfiguration extends UIElementProps {
      * @param actions - Used to indicates to PayPal that you will not support the shipping method selected by the buyer
      * @param component - Adyen instance of its PayPal implementation. It must be used to manipulate the 'paymentData' in order to apply the amount patch correctly
      */
-    onShippingOptionsChange?: (data: any, actions: {
+    onShippingOptionsChange?: (data: PayPalOnShippingOptionsChangeData, actions: {
         reject: (reason?: string) => Promise<void>;
     }, component: PaypalElement) => Promise<void>;
     /**
@@ -2808,7 +2829,7 @@ interface PayPalConfiguration extends UIElementProps {
      * Called when the button first renders. You can use it for validations on your page if you are unable to do so prior to rendering.
      * @see {@link https://developer.paypal.com/sdk/js/reference/#oninitonclick}
      */
-    onInit?: (data?: any, actions?: any) => void;
+    onInit?: (data?: Record<string, unknown>, actions?: PayPalOnInitActions) => void;
     /**
      * @see {@link https://developer.paypal.com/sdk/js/reference/#oninitonclick}
      */
@@ -2870,7 +2891,11 @@ interface PayPalConfiguration extends UIElementProps {
  * @see {@link https://developer.paypal.com/docs/checkout/reference/customize-sdk/#intent}
  */
 type Intent = 'sale' | 'capture' | 'authorize' | 'order' | 'tokenize';
-type FundingSource = 'paypal' | 'credit' | 'paylater' | 'venmo';
+type SupportedPayPalFundingSources = 'paypal' | 'credit' | 'paylater' | 'venmo';
+/**
+ * @deprecated Use {@link SupportedPayPalFundingSources} instead
+ */
+type FundingSource = SupportedPayPalFundingSources;
 
 /**
  * PayPal Fastlane Reference:
@@ -2998,6 +3023,13 @@ type FastlaneSignupConfiguration = FastlaneConsentRenderState & {
     fastlaneSessionId?: string;
     telephoneNumber?: string;
 };
+interface FastlaneData {
+    consentShown: boolean;
+    fastlaneSessionId: string;
+    consentGiven: boolean;
+    consentVersion?: string;
+    telephoneNumber?: string;
+}
 type FastlanePaymentMethodConfiguration = FastlaneComponentConfiguration | FastlaneCardComponentConfiguration;
 interface FastlaneSDKConfiguration {
     clientKey: string;
@@ -3133,12 +3165,26 @@ interface PreAuthorizedDebitCanadaPlaceholders {
 
 interface RedirectConfiguration extends UIElementProps {
     type?: string;
+    beforeRedirect?: (resolve: any, reject: any, url: any) => Promise<void>;
+    /**
+     * Specifies the URL to redirect to. Returned in the action object.
+     * @internal
+     */
     url?: string;
+    /**
+     * When the redirect URL must be accessed via POST, use this data to post to the redirect URL.
+     * Returned in the action object
+     * @internal
+     */
     data?: {
-        [key: string]: any;
+        [key: string]: unknown;
     };
+    /**
+     * Specifies the HTTP method for the redirect.
+     * Returned in the action object
+     * @internal
+     */
     method?: 'GET' | 'POST';
-    beforeRedirect?: (resolve: any, reject: any, url: any) => Promise<void>;
 }
 
 interface SepaElementData {
@@ -3151,18 +3197,41 @@ interface SepaElementData {
 interface SepaConfiguration extends UIElementProps {
 }
 
-type Mandate = {
+interface Mandate {
+    /**
+     * Mandate amount in the smallest unit of the currency. Maximum amount the shopper authorizes
+     * for future recurring charges.
+     */
     amount: string;
+    /**
+     * Charge cadence for the mandate.
+     */
     frequency: 'monthly' | 'weekly' | 'adhoc';
+    /**
+     * - `max`: merchant can charge any amount up to `amount` during future billing cycles.
+     * - `exact`: merchant must charge exactly `amount` on each recurring charge.
+     */
     amountRule: 'max' | 'exact';
-};
+    /**
+     * End date of the mandate in `YYYY-MM-DD` format. Required by the Checkout API.
+     * Recommended to set between 7 and 10 years in the future.
+     */
+    endsAt: string;
+    /**
+     * Start date of the mandate in `YYYY-MM-DD` format. Defaults to the mandate creation date.
+     */
+    startsAt?: string;
+    /**
+     * Free-form description of the mandate shown on the shopper's UPI app.
+     */
+    remarks?: string;
+}
 
 type UpiType = TxVariants.upi_qr | TxVariants.upi_intent;
 type UpiMode = 'qrCode' | 'intent';
 type App = {
     id: string;
     name: string;
-    type?: UpiType;
 };
 type UpiPaymentData = {
     paymentMethod: {
@@ -3171,7 +3240,10 @@ type UpiPaymentData = {
     };
 };
 interface UPIConfiguration extends UIElementProps {
-    /** @deprecated UPI configuration property "defaultMode" is deprecated and will be removed in a future version. */
+    /**
+     * @deprecated
+     * UPI configuration property "defaultMode" is deprecated and will be removed in a future version.
+     */
     defaultMode?: UpiMode;
     mandate?: Mandate;
     apps?: Array<App>;
@@ -3190,7 +3262,23 @@ interface UPIConfiguration extends UIElementProps {
      * The duration in minutes before the await/QR code expires.
      */
     countdownTime?: number;
+    /**
+     * Show the available UPI apps images on the Drop-in payment method item
+     */
+    showPaymentMethodItemImages?: boolean;
+    /**
+     * Show `+ other` after the UPI apps images on the Drop-in payment method item
+     */
+    showOtherInsteadOfNumber?: boolean;
 }
+/**
+ * @internal
+ */
+type UPIAppList = Array<{
+    id: string;
+    name: string;
+    icon: string;
+}>;
 
 declare enum PayToIdentifierEnum {
     phone = "phone",
@@ -3237,7 +3325,11 @@ type PayToPlaceholdersType = {
     [K in keyof PayToData]: string;
 };
 interface PayToConfiguration extends UIElementProps {
-    paymentData?: any;
+    /**
+     * Data received from the server to handle the action
+     * @internal
+     */
+    paymentData?: string;
     data?: PayToData;
     placeholders?: PayToPlaceholdersType;
     mandate?: MandateType;
@@ -3731,10 +3823,7 @@ declare class IssuerListContainer<TProps extends IssuerListConfiguration = Issue
      * This is used to show the brands in the PaymentMethodItem
      * Requires brands icons to be loaded in the payment method
      */
-    get brands(): {
-        icon: any;
-        name: string;
-    }[];
+    get brands(): PaymentMethodBrand[];
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -3836,8 +3925,8 @@ declare class CashAppPay extends UIElement<CashAppPayConfiguration> {
     get additionalInfo(): "" | "Cash App Pay";
     submit: () => void;
     get isValid(): boolean;
-    private handleOnChangeStoreDetails;
-    private handleAuthorize;
+    private readonly handleOnChangeStoreDetails;
+    private readonly handleAuthorize;
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -4552,9 +4641,12 @@ declare class DragonpayElement extends UIElement<DragonpayConfiguraton> {
         shopperEmail: any;
     };
     protected formatProps(props: DragonpayConfiguraton): {
-        issuers: any;
+        issuers: DragonpayInputIssuerItem[];
         type?: string;
-        details?: any;
+        details?: {
+            key: string;
+            items: DragonpayInputIssuerItem[];
+        }[];
         loadingContext?: string;
         reference?: string;
         i18n?: Language;
@@ -4657,7 +4749,6 @@ declare class OxxoElement extends UIElement<VoucherConfiguration> {
             type: string;
         };
     };
-    private handleRef;
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -4673,7 +4764,6 @@ declare class MultibancoElement extends UIElement<VoucherConfiguration> {
             type: string;
         };
     };
-    private handleRef;
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -5143,11 +5233,17 @@ declare class RatePayDirectDebit extends OpenInvoiceContainer {
 declare class UPI extends UIElement<UPIConfiguration> {
     static readonly type = TxVariants.upi;
     static readonly txVariants: TxVariants[];
-    private mode;
+    private readonly mode;
+    private readonly appsList;
+    protected static readonly defaultProps: {
+        showPaymentMethodItemImages: boolean;
+        countdownTime: number;
+    };
     constructor(checkout: ICore, props: UPIConfiguration);
-    formatProps(props: UPIConfiguration): UPIConfiguration;
+    protected formatProps(props: UPIConfiguration): UPIConfiguration;
     get isValid(): boolean;
     formatData(): UpiPaymentData;
+    get brands(): PaymentMethodBrand[];
     get paymentType(): UpiType;
     protected componentToRender(): h.JSX.Element;
 }
@@ -5365,10 +5461,7 @@ declare class PayByBankUS extends RedirectElement {
     };
     get displayName(): string;
     get additionalInfo(): string;
-    get brands(): {
-        icon: string;
-        name: string;
-    }[];
+    get brands(): PaymentMethodBrand[];
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -5402,10 +5495,7 @@ declare class Fastlane extends UIElement<FastlaneConfiguration> {
     /**
      * Used to display the payment method supported brands within Drop-in
      */
-    get brands(): {
-        icon: string;
-        name: string;
-    }[];
+    get brands(): PaymentMethodBrand[];
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -5462,7 +5552,7 @@ declare class PayToElement extends UIElement<PayToConfiguration> {
             bankAccountNumber: string;
             selectedInput: PayToInputOption;
         };
-        paymentData?: any;
+        paymentData?: string;
         placeholders?: PayToPlaceholdersType;
         mandate?: MandateType;
         payee?: string;
@@ -6422,7 +6512,7 @@ declare abstract class UIElement<P extends UIElementProps = UIElementProps> exte
     protected componentRef: any;
     protected resources: Resources;
     elementRef: UIElement;
-    static readonly type: any;
+    static readonly type: string | undefined;
     /**
      * Reference to the methods exposed by the AmountProvider context
      */
@@ -6557,7 +6647,7 @@ declare abstract class UIElement<P extends UIElementProps = UIElementProps> exte
      * @private
      */
     protected handleAdvanceFlowPaymentMethodsUpdate(order: Order | null, amount?: PaymentAmount): Promise<ICore>;
-    protected abstract componentToRender(): h.JSX.Element;
+    protected abstract componentToRender(): h.JSX.Element | null;
     render(): h.JSX.Element;
 }
 
@@ -6885,6 +6975,10 @@ type DecodeObject = {
     error?: string;
     data?: string;
 };
+type PaymentMethodBrand = {
+    icon: string;
+    name: string;
+};
 
 type PlaceholderKeys = 'holderName' | 'cardNumber' | 'expiryDate' | 'expiryMonth' | 'expiryYear' | 'securityCodeThreeDigits' | 'securityCodeFourDigits' | 'password';
 type FundingSourceKeys = 'credit' | 'debit' | 'prepaid';
@@ -7313,6 +7407,13 @@ interface DualBrandSelectElement {
     id: string;
     brandObject: BrandObject;
 }
+interface DualBrandButtons {
+    id: string;
+    name: string;
+    imageURL: string;
+    altName: string;
+}
+type DualBrandingChangeHandler = (brandValue: string) => void;
 
 declare class CardElement extends UIElement<CardConfiguration> {
     static readonly type: TxVariants;
@@ -7350,10 +7451,7 @@ declare class CardElement extends UIElement<CardConfiguration> {
     };
     get isValid(): boolean;
     get icon(): string;
-    get brands(): {
-        icon: any;
-        name: string;
-    }[];
+    get brands(): PaymentMethodBrand[];
     get displayName(): string;
     get accessibleName(): string;
     get browserInfo(): BrowserInfo;
@@ -7839,7 +7937,6 @@ declare class Core implements ICore {
     constructor(props: CoreConfiguration);
     initialize(): Promise<this>;
     private initializeCore;
-    private fetchLocaleTranslations;
     private validateCoreConfiguration;
     /**
      * Method used when handling redirects. It submits details using 'onAdditionalDetails' or the Sessions flow if available.
@@ -7900,6 +7997,14 @@ declare class Core implements ICore {
     private handleCreateError;
     private createPaymentMethodsList;
     private createCoreModules;
+    /**
+     * Retrieve the parsed locale from the i18n module and assigns it to the core options.
+     */
+    private assignLocaleToCore;
+    /**
+     * Request translations to the CDN. If an error occurs, it will be logged to the console in development mode.
+     */
+    private requestTranslations;
     private requestAnalyticsAttemptId;
 }
 
@@ -7910,4 +8015,4 @@ declare namespace AdyenCheckout {
 }
 
 export { ANCVElement as ANCV, AchElement as Ach, AddressElement as Address, AdyenCheckout, AdyenCheckoutError, Affirm, AfterPay, AfterPayB2B, AmazonPayElement as AmazonPay, ApplePayElement as ApplePay, Atome, BacsElement as BacsDirectDebit, BancontactElement as Bancontact, BankTransferElement as BankTransfer, BCMCMobileElement as BcmcMobile, BillDeskOnlineElement as BillDeskOnline, BillDeskWalletElement as BillDeskWallet, BlikElement as Blik, BoletoElement as Boleto, CardElement as Card, CashAppPay, ClickToPayElement as ClickToPay, Core, CustomCard, DokuElement as Doku, DonationElement as Donation, DotpayElement as Dotpay, DragonpayElement as Dragonpay, DropinElement as Dropin, DuitNowElement as DuitNow, EPSElement as EPS, EcontextElement as Econtext, FacilyPay10x as FacilPay10x, FacilyPay12x as FacilPay12x, FacilyPay3x as FacilPay3x, FacilyPay4x as FacilPay4x, FacilyPay6x as FacilPay6x, Fastlane, FastlaneSDK, GiftcardElement as Giftcard, GiropayElement as Giropay, GooglePay, Iris, IrisMode, KlarnaPayments as Klarna, MBWayElement as MBWay, MealVoucherFRElement as MealVoucherFR, MolPayEBankingMYElement as MolPayEBankingMY, MolPayEBankingTHElement as MolPayEBankingTH, MolPayEbankingVNElement as MolPayEBankingVN, MultibancoElement as Multibanco, OnlineBankingCZElement as OnlineBankingCZ, OnlineBankingFI, OnlineBankingINElement as OnlineBankingIN, OnlineBankingPL, OnlineBankingSKElement as OnlineBankingSK, OxxoElement as Oxxo, PayByBank, PayByBankPixElement as PayByBankPix, PayByBankUS, PayMeElement as PayMe, PayNowElement as PayNow, PaypalElement as PayPal, PayToElement as PayTo, PayuNetCashcardElement as PayuCashcard, PayuNetBankingElement as PayuNetBanking, PersonalDetailsElement as PersonalDetails, PixElement as Pix, PreAuthorizedDebitCanada, PromptPayElement as PromptPay, RatePay, RatePayDirectDebit, RedirectElement as Redirect, Riverty, SepaElement as SepaDirectDebit, SwishElement as Swish, ThreeDS2Challenge, ThreeDS2DeviceFingerprint, TrustlyElement as Trustly, TwintElement as Twint, UIElement, UPI, VippsElement as Vipps, WalletINElement as WalletIN, WeChatPayElement as WeChat, index_d as components, initializeFastlane };
-export type { ANCVConfiguration, ANCVDataState, AchConfiguration, AchPlaceholders, ActionDescriptionType, ActionHandledReturnObject, AdditionalDetailsActions, AdditionalDetailsData, AddressData, AddressField, AmazonPayBackendConfiguration, AmazonPayButtonProps, AmazonPayButtonSettings, AmazonPayComponentProps, AmazonPayConfiguration, AmazonPayElementData, App, ApplePayButtonStyle, ApplePayButtonType, ApplePayConfiguration, ApplePayElementData, ApplePayPaymentAuthorizationResult, ApplePayPaymentOrderDetails, ApplePaySessionRequest, ApplePayWebConfiguration, AwaitComponentProps, AwaitConfiguration, BankDetailsSchema, BankTransferConfiguration, BankTransferSchema, BankTransferState, BeforeSubmitActions, BinLookupResponse, BinLookupResponseRaw, BoletoConfiguration, BoletoElementProps, BoletoInputDataState, BoletoInputErrorState, BoletoInputValidState, BrandConfiguration, BrandObject, BrowserInfo, CReqData, CardAllValidData, CardAutoCompleteData, CardBackendConfiguration, CardBinLookupData, CardBinValueData, CardBrandData, CardBrandsConfiguration, CardConfigSuccessData, CardConfiguration, CardElementData, CardErrorData, CardFieldValidData, CardFocusData, CardLoadData, CardPlaceholders, CashAppPayConfiguration, CashAppPayElementData, CashAppPayEventData, ChallengeData, ChallengeResolveData, ChallengeWindowSize, ChangeActionOptions, ChangePaymentDetailsButtonProps, ChargeAmount, CheckoutAdvancedFlowResponse, CheckoutDetailsRequest, CheckoutSession, CheckoutSessionConfig, ClickToPayConfiguration, ClickToPayPaymentData, ClickToPayProps, ClickToPayScheme, CommonVoucherProps, ComponentFocusObject, ComponentMethodsRef, CoreConfiguration, CoreModules, Currency, CustomCardConfiguration, CustomTranslations, DecodeObject, DeliverySpecifications, DokuVoucherResultProps, DonationConfiguration, DragonpayConfiguraton, DragonpayInputData, DragonpayInputIssuerItem, DragonpayInputProps, DragonpayVoucherResultProps, DropinComponentProps, DropinComponentState, DropinConfiguration, DropinStatus, DropinStatusProps, DualBrandSelectElement, EcontextConfiguration, EcontextInputSchema, EcontextVoucherResultProps, ErrorCodeObject, ExtendedMerchantInfo, FastlaneAddress, FastlaneAuthenticatedCustomerResult, FastlaneConfiguration, FastlaneConsentRenderState, FastlaneOptions, FastlanePaymentMethodConfiguration, FastlaneProfile, FastlaneSDKConfiguration, FastlaneShipping, FastlaneShippingAddressSelectorResult, FastlaneSignupConfiguration, FastlaneWindowInstance, FieldsetVisibility, FingerPrintData, FingerprintResolveData, FundingSource, FundingSourceKeys, GiftCardBalanceCheckErrorType, GiftCardConfiguration, GiftCardElementData, GiftCardValidationError, GooglePayConfiguration, GooglePaymentDataRequest, ICore, IDropin, InstantPaymentTypes, Intent, IrisConfiguration, IrisData, IssuerListConfiguration, IssuerListData, KlarnaAction, KlarnaAdditionalDetailsData, KlarnaComponentRef, KlarnaConfiguration, KlarnaSdkData, KlarnaWidgetAuthorizeResponse, KlarnaWidgetProps, LedgerCurrencies, LegacyChallengeResolveData, LegacyFingerprintResolveData, MandateFrequencyType, MandateType, MultibancoVoucherResultProps, OnChangeData, OpenInvoiceActiveFieldsets, OpenInvoiceConfiguration, OpenInvoiceFieldsetsRefs, OpenInvoiceProps, OpenInvoiceStateData, OpenInvoiceStateError, OpenInvoiceStateValid, OpenInvoiceVisibility, Order, OrderButtonProps, OrderStatus, OxxoVoucherResultProps, PayPalConfiguration, PayToConfiguration, PayToData, PayToPlaceholdersType, PayloadJSON, PaymentAction, PaymentActionsType, PaymentAmount, PaymentCompletedData, PaymentData, PaymentFailedData, PaymentMethodData, PaymentMethodGroup, PaymentMethodOptions, PaymentMethods, PaymentMethodsConfiguration, PaymentMethodsRequestData, PaymentMethodsResponse, PaymentResponseData, PersonalDetailsSchema, PixConfiguration, PixElementData, PostMsgParseErrorObject, PreAuthorizedDebitCanadaConfiguration, PreAuthorizedDebitCanadaPlaceholders, ProcessedPaymentStatusResponse, QRLoaderConfiguration, RawPaymentMethod, RawPaymentResponse, RawPaymentStatusResponse, RawStoredPaymentMethod, RecurringMetadata, RedirectConfiguration, Region, ResultCode, ResultObject, ResultValue, SepaConfiguration, SepaElementData, SessionsResponse, SignOutButtonProps, SocialSecurityMode, StatusFromAction, SubmitActions, SubmitData, SupportedLocale, ThreeDS2ActionProps, ThreeDS2ChallengeConfiguration, ThreeDS2ConfigProps, ThreeDS2DeviceFingerprintConfiguration, ThreeDS2FingerprintResponse, ThreeDS2FlowObject, ThreeDS2FlowProps, ThreeDS2Token, UIElementProps, UIElementStatus, UPIConfiguration, UpdateAmazonCheckoutSessionRequest, UpiMode, UpiPaymentData, UpiType, ValidationError, VoucherConfiguration, VoucherDetail, VoucherProps, balanceCheckResponseType, onBalanceCheckCallbackType, onOrderCancelData, onOrderCancelType, onOrderRequestCallbackType, onRequiringConfirmationCallbackType };
+export type { ANCVConfiguration, ANCVDataState, AchConfiguration, AchPlaceholders, ActionDescriptionType, ActionHandledReturnObject, AdditionalDetailsActions, AdditionalDetailsData, AddressData, AddressField, AmazonPayBackendConfiguration, AmazonPayButtonProps, AmazonPayButtonSettings, AmazonPayComponentProps, AmazonPayConfiguration, AmazonPayElementData, AmazonWindowObject, App, ApplePayButtonStyle, ApplePayButtonType, ApplePayConfiguration, ApplePayElementData, ApplePayPaymentAuthorizationResult, ApplePayPaymentOrderDetails, ApplePaySessionRequest, ApplePayWebConfiguration, AwaitComponentProps, AwaitConfiguration, BankDetailsSchema, BankTransferConfiguration, BankTransferSchema, BankTransferState, BeforeSubmitActions, BinLookupResponse, BinLookupResponseRaw, BoletoConfiguration, BoletoElementProps, BoletoInputDataState, BoletoInputErrorState, BoletoInputValidState, BrandConfiguration, BrandObject, BrowserInfo, CReqData, CardAllValidData, CardAutoCompleteData, CardBackendConfiguration, CardBinLookupData, CardBinValueData, CardBrandData, CardBrandsConfiguration, CardConfigSuccessData, CardConfiguration, CardElementData, CardErrorData, CardFieldValidData, CardFocusData, CardLoadData, CardPlaceholders, CashAppPayConfiguration, CashAppPayElementData, CashAppPayEventData, ChallengeData, ChallengeResolveData, ChallengeWindowSize, ChangeActionOptions, ChangePaymentDetailsButtonProps, ChargeAmount, CheckoutAdvancedFlowResponse, CheckoutDetailsRequest, CheckoutSession, CheckoutSessionConfig, ClickToPayConfiguration, ClickToPayPaymentData, ClickToPayProps, ClickToPayScheme, CommonVoucherProps, ComponentFocusObject, ComponentMethodsRef, CoreConfiguration, CoreModules, Currency, CustomCardConfiguration, CustomTranslations, DecodeObject, DeliverySpecifications, DokuVoucherResultProps, DonationConfiguration, DragonpayConfiguraton, DragonpayInputData, DragonpayInputIssuerItem, DragonpayInputProps, DragonpayVoucherResultProps, DropinComponentProps, DropinComponentState, DropinConfiguration, DropinStatus, DropinStatusProps, DualBrandButtons, DualBrandSelectElement, DualBrandingChangeHandler, EcontextConfiguration, EcontextInputSchema, EcontextVoucherResultProps, ErrorCodeObject, ExtendedMerchantInfo, FastlaneAddress, FastlaneAuthenticatedCustomerResult, FastlaneConfiguration, FastlaneConsentRenderState, FastlaneData, FastlaneOptions, FastlanePaymentMethodConfiguration, FastlaneProfile, FastlaneSDKConfiguration, FastlaneShipping, FastlaneShippingAddressSelectorResult, FastlaneSignupConfiguration, FastlaneWindowInstance, FieldsetVisibility, FingerPrintData, FingerprintResolveData, FundingSource, FundingSourceKeys, GiftCardBalanceCheckErrorType, GiftCardConfiguration, GiftCardElementData, GiftCardValidationError, GooglePayConfiguration, GooglePaymentDataRequest, ICore, IDropin, InstantPaymentTypes, Intent, IrisConfiguration, IrisData, IssuerListConfiguration, IssuerListData, KlarnaAction, KlarnaAdditionalDetailsData, KlarnaComponentRef, KlarnaConfiguration, KlarnaSdkData, KlarnaWidgetAuthorizeResponse, KlarnaWidgetProps, LedgerCurrencies, LegacyChallengeResolveData, LegacyFingerprintResolveData, MandateFrequencyType, MandateType, OnChangeData, OpenInvoiceActiveFieldsets, OpenInvoiceConfiguration, OpenInvoiceFieldsetsRefs, OpenInvoiceProps, OpenInvoiceStateData, OpenInvoiceStateError, OpenInvoiceStateValid, OpenInvoiceVisibility, Order, OrderButtonProps, OrderStatus, PayPalConfiguration, PayToConfiguration, PayToData, PayToPlaceholdersType, PayloadJSON, PaymentAction, PaymentActionsType, PaymentAmount, PaymentCompletedData, PaymentData, PaymentFailedData, PaymentMethodBrand, PaymentMethodData, PaymentMethodGroup, PaymentMethodOptions, PaymentMethods, PaymentMethodsConfiguration, PaymentMethodsRequestData, PaymentMethodsResponse, PaymentResponseData, PersonalDetailsSchema, PixConfiguration, PixElementData, PostMsgParseErrorObject, PreAuthorizedDebitCanadaConfiguration, PreAuthorizedDebitCanadaPlaceholders, ProcessedPaymentStatusResponse, QRLoaderConfiguration, RawPaymentMethod, RawPaymentResponse, RawPaymentStatusResponse, RawStoredPaymentMethod, RecurringMetadata, RedirectConfiguration, Region, ResultCode, ResultObject, ResultValue, SepaConfiguration, SepaElementData, SessionsResponse, SignOutButtonProps, SocialSecurityMode, StatusFromAction, SubmitActions, SubmitData, SupportedLocale, SupportedPayPalFundingSources, ThreeDS2ActionProps, ThreeDS2ChallengeConfiguration, ThreeDS2ConfigProps, ThreeDS2DeviceFingerprintConfiguration, ThreeDS2FingerprintResponse, ThreeDS2FlowObject, ThreeDS2FlowProps, ThreeDS2Token, UIElementProps, UIElementStatus, UPIAppList, UPIConfiguration, UpdateAmazonCheckoutSessionRequest, UpiMode, UpiPaymentData, UpiType, ValidationError, VoucherConfiguration, VoucherDetail, VoucherProps, balanceCheckResponseType, onBalanceCheckCallbackType, onOrderCancelData, onOrderCancelType, onOrderRequestCallbackType, onRequiringConfirmationCallbackType };