@adyen/adyen-web 6.32.1 → 6.34.0

package/dist/cjs/index.d.cts

@@ -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
@@ -234,6 +235,10 @@ type SetupSessionOptions = {
     order?: Order;
 };
 
+interface ILanguageService {
+    fetchTranslationsFromCdn(locale: string): Promise<Readonly<Translations>>;
+}
+
 type CustomTranslations = {
     [locale: string]: Translations;
 };
@@ -241,20 +246,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 +298,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 +320,8 @@ interface ButtonProps {
     onClickCompletedLabel?: string | h.JSX.Element;
     ariaLabel?: string;
     ariaDescribedBy?: string;
+    ariaExpanded?: boolean;
+    ariaControls?: string;
     secondaryLabel?: string;
     icon?: string;
     onClickCompletedIcon?: string;
@@ -302,7 +329,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 +591,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 +601,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 +609,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 +650,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 +668,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 +686,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 +702,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 +729,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;
@@ -849,12 +890,12 @@ interface ApplePayConfiguration extends UIElementProps {
     /**
      * The Apple Pay version number your website supports.
      * @default highest supported version by the shopper device
-     * @see {@link https://developer.apple.com/documentation/apple_pay_on_the_web/apple_pay_on_the_web_version_history Apple Pay on the Web Version History}
+     * @see {@link https://developer.apple.com/documentation/applepayontheweb/apple-pay-on-the-web-version-history Apple Pay on the Web Version History}
      */
     version?: number;
     /**
      * Part of the 'ApplePayLineItem' object, which sets the label of the payment request
-     * @see {@link https://developer.apple.com/documentation/apple_pay_on_the_web/applepaylineitem ApplePayLineItem docs}
+     * @see {@link https://developer.apple.com/documentation/applepayontheweb/applepaylineitem ApplePayLineItem docs}
      */
     totalPriceLabel?: string;
     /**
@@ -908,7 +949,7 @@ interface ApplePayConfiguration extends UIElementProps {
     supportedNetworks?: string[];
     /**
      * ApplePayRecurringPaymentRequest - Represents a request to set up a recurring payment, typically a subscription.
-     * {@link https://developer.apple.com/documentation/apple_pay_on_the_web/applepayrecurringpaymentrequest}
+     * {@link https://developer.apple.com/documentation/applepayontheweb/applepayrecurringpaymentrequest}
      */
     recurringPaymentRequest?: ApplePayJS.ApplePayRecurringPaymentRequest;
     /**
@@ -973,7 +1014,7 @@ interface ApplePayConfiguration extends UIElementProps {
      * Collect the order tracking details if available.
      * This callback is invoked when a successfull payment is resolved
      *
-     * {@link https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentorderdetails}
+     * {@link https://developer.apple.com/documentation/applepayontheweb/applepaypaymentorderdetails}
      * @param resolve - Must be called with the orderDetails fields
      * @param reject - Must be called if something failed during the order creation. Calling 'reject' won't cancel the payment flow
      */
@@ -1014,6 +1055,25 @@ interface ApplePayConfiguration extends UIElementProps {
      * @param event - The event parameter contains the shippingMethod attribute.
      */
     onShippingMethodSelected?: (resolve: (shippingMethodUpdate: ApplePayJS.ApplePayShippingMethodUpdate) => void, reject: (shippingMethodUpdate: ApplePayJS.ApplePayShippingMethodUpdate) => void, event: ApplePayJS.ApplePayShippingMethodSelectedEvent) => void;
+    /**
+     * The initial coupon code for the payment request.
+     * @see {@link https://developer.apple.com/documentation/applepayontheweb/applepaypaymentrequest/couponcode couponCode docs}
+     */
+    couponCode?: ApplePayJS.ApplePayPaymentRequest['couponCode'];
+    /**
+     * A Boolean value that determines whether the payment sheet displays the coupon code field.
+     * @see {@link https://developer.apple.com/documentation/applepayontheweb/applepaypaymentrequest/supportscouponcode supportsCouponCode docs}
+     */
+    supportsCouponCode?: ApplePayJS.ApplePayPaymentRequest['supportsCouponCode'];
+    /**
+     * An event handler called by the system when the user enters or updates a coupon code.
+     *
+     * {@link https://developer.apple.com/documentation/applepayontheweb/applepaysession/oncouponcodechanged}
+     * @param resolve - Completes the change of a coupon code with an update.
+     * @param reject - Completes the change of a coupon code with no update.
+     * @param event - The event parameter contains the couponCode attribute.
+     */
+    onCouponCodeChanged?: (resolve: (update: ApplePayJS.ApplePayCouponCodeUpdate) => void, reject: (update: ApplePayJS.ApplePayCouponCodeUpdate) => void, event: ApplePayJS.ApplePayCouponCodeChangedEvent) => void;
     buttonColor?: ApplePayButtonStyle;
     buttonType?: ApplePayButtonType;
     /**
@@ -1124,7 +1184,7 @@ interface VoucherProps {
     /**
      * Any additional surcharge to the amount.
      */
-    surcharge?: any;
+    surcharge?: string;
     /**
      * List of details that will be rendered on the voucher.
      */
@@ -1500,7 +1560,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;
@@ -2089,8 +2149,6 @@ interface DokuVoucherResultProps {
     instructionsUrl?: string;
     shopperName?: string;
     merchantName?: string;
-    outputDetails?: any;
-    ref?: any;
     onActionHandled?: (rtnObj: ActionHandledReturnObject) => void;
 }
 
@@ -2599,35 +2657,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>;
@@ -2659,7 +2692,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;
@@ -2681,9 +2714,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
@@ -2693,7 +2735,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}
          */
@@ -2736,7 +2778,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: {
@@ -2751,7 +2793,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>;
     /**
@@ -2762,7 +2804,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>;
     /**
@@ -2789,7 +2831,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}
      */
@@ -2851,7 +2893,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:
@@ -2979,6 +3025,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;
@@ -3114,12 +3167,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 {
@@ -3143,7 +3210,6 @@ type UpiMode = 'qrCode' | 'intent';
 type App = {
     id: string;
     name: string;
-    type?: UpiType;
 };
 type UpiPaymentData = {
     paymentMethod: {
@@ -3152,7 +3218,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>;
@@ -3171,7 +3240,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",
@@ -3646,7 +3731,7 @@ declare class ApplePayElement extends UIElement<ApplePayConfiguration> {
      * not mean there are no cards available, it means the status cannot be determined and as such defaulting
      * and upstreaming should still be considered.
      *
-     * {@link https://developer.apple.com/documentation/apple_pay_on_the_web/applepaysession/4440085-applepaycapabilities}
+     * {@link https://developer.apple.com/documentation/applepayontheweb/applepaysession/4440085-applepaycapabilities}
      * @param merchantIdentifier
      */
     applePayCapabilities(merchantIdentifier?: string): Promise<ApplePayJS.PaymentCredentialStatusResponse>;
@@ -3712,10 +3797,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;
 }
 
@@ -3817,8 +3899,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;
 }
 
@@ -4638,7 +4720,6 @@ declare class OxxoElement extends UIElement<VoucherConfiguration> {
             type: string;
         };
     };
-    private handleRef;
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -4654,7 +4735,6 @@ declare class MultibancoElement extends UIElement<VoucherConfiguration> {
             type: string;
         };
     };
-    private handleRef;
     protected componentToRender(): h.JSX.Element;
 }
 
@@ -5124,11 +5204,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;
 }
@@ -5346,10 +5432,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;
 }
 
@@ -5383,10 +5466,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;
 }
 
@@ -6139,7 +6219,7 @@ interface CoreConfiguration {
     /**
      * Use 'test'. When you're ready to accept live payments, change the value to one of our {@link https://docs.adyen.com/checkout/drop-in-web#testing-your-integration | live environments}.
      */
-    environment?: 'test' | 'live' | 'live-us' | 'live-au' | 'live-apse' | 'live-in';
+    environment?: 'test' | 'live' | 'live-us' | 'live-au' | 'live-apse' | 'live-in' | 'live-nea';
     /**
      * Show or hides a Pay Button for each payment method
      * @default true
@@ -6403,7 +6483,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
      */
@@ -6538,7 +6618,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;
 }
 
@@ -6866,6 +6946,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';
@@ -7294,6 +7378,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;
@@ -7331,10 +7422,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;
@@ -7820,7 +7908,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.
@@ -7881,6 +7968,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;
 }
 
@@ -7891,4 +7986,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 };