@primer-io/primer-js 1.5.1 → 1.6.0

package/dist/primer-loader.d.ts

@@ -1,172 +1,16 @@
 import { ContextProvider } from '@lit/context';
 import { Task, initialState } from '@lit/task';
+import { PayPalButtonStyle } from '@paypal/paypal-js';
+import { FUNDING_SOURCE } from '@paypal/paypal-js/types/components/funding-eligibility';
 import { CSSResult, LitElement, PropertyValues, ReactiveController, ReactiveControllerHost, SVGTemplateResult, TemplateResult, nothing } from 'lit';
 
-declare const PaymentInstrumentType: {
-	readonly WORLDPAY_IDEAL: "WORLDPAY_IDEAL";
-	readonly AUTOMATED_CLEARING_HOUSE: "AUTOMATED_CLEARING_HOUSE";
-	readonly ADYEN_KLARNA: "ADYEN_KLARNA";
-	readonly ADYEN_BANCONTACT_CARD: "ADYEN_BANCONTACT_CARD";
-	readonly PAY_NL_KAARTDIRECT: "PAY_NL_KAARTDIRECT";
-	readonly ADYEN_EPS: "ADYEN_EPS";
-	readonly ADYEN_BANCONTACT_PAYCONIQ: "ADYEN_BANCONTACT_PAYCONIQ";
-	readonly OMISE_PROMPTPAY: "OMISE_PROMPTPAY";
-	readonly OMISE_TRUEMONEY: "OMISE_TRUEMONEY";
-	readonly ADYEN_MULTIBANCO: "ADYEN_MULTIBANCO";
-	readonly PACYPAY_WECHAT: "PACYPAY_WECHAT";
-	readonly PACYPAY_ALIPAY: "PACYPAY_ALIPAY";
-	readonly ADYEN_MBWAY: "ADYEN_MBWAY";
-	readonly XENDIT_DANA: "XENDIT_DANA";
-	readonly XENDIT_SHOPEEPAY: "XENDIT_SHOPEEPAY";
-	readonly ADYEN_PAYSHOP: "ADYEN_PAYSHOP";
-	readonly ADYEN_PAYTRAIL: "ADYEN_PAYTRAIL";
-	readonly CLEARPAY: "CLEARPAY";
-	readonly RAPYD_FAST: "RAPYD_FAST";
-	readonly RAPYD_PROMPTPAY: "RAPYD_PROMPTPAY";
-	readonly RAPYD_GCASH: "RAPYD_GCASH";
-	readonly RAPYD_POLI: "RAPYD_POLI";
-	readonly RAPYD_GRABPAY: "RAPYD_GRABPAY";
-	readonly PRIMER_PAYPAL: "PRIMER_PAYPAL";
-	readonly TWOC2P: "TWOC2P";
-	readonly NETS: "NETS";
-	readonly STRIPE_ACH: "STRIPE_ACH";
-	readonly STRIPE_GIROPAY: "STRIPE_GIROPAY";
-	readonly MOLLIE_GIROPAY: "MOLLIE_GIROPAY";
-	readonly MOLLIE_EPS: "MOLLIE_EPS";
-	readonly PAY_NL_EPS: "PAY_NL_EPS";
-	readonly PAY_NL_P24: "PAY_NL_P24";
-	readonly MOLLIE_P24: "MOLLIE_P24";
-	readonly MOLLIE_SOFORT: "MOLLIE_SOFORT";
-	readonly COINBASE: "COINBASE";
-	readonly OPENNODE: "OPENNODE";
-	readonly MOLLIE_GIFT_CARD: "MOLLIE_GIFTCARD";
-	readonly XFERS_PAYNOW: "XFERS_PAYNOW";
-	readonly CARD: "PAYMENT_CARD";
-	readonly APPLE_PAY: "APPLE_PAY";
-	readonly GOOGLE_PAY: "GOOGLE_PAY";
-	readonly PAYPAL: "PAYPAL_ORDER";
-	readonly PAYPAL_VAULTED: "PAYPAL_BILLING_AGREEMENT";
-	readonly GO_CARDLESS: "GOCARDLESS";
-	readonly PAY_NL_IDEAL: "PAY_NL_IDEAL";
-	readonly PAY_NL_SOFORT_BANKING: "PAY_NL_SOFORT_BANKING";
-	readonly PAY_NL_BANCONTACT: "PAY_NL_BANCONTACT";
-	readonly PAY_NL_PAYPAL: "PAY_NL_PAYPAL";
-	readonly PAY_NL_CREDIT_TRANSFER: "PAY_NL_CREDIT_TRANSFER";
-	readonly PAY_NL_DIRECT_DEBIT: "PAY_NL_DIRECT_DEBIT";
-	readonly PAY_NL_GIROPAY: "PAY_NL_GIROPAY";
-	readonly PAY_NL_PAYCONIQ: "PAY_NL_PAYCONIQ";
-	readonly PAY_NL_RIVERTY: "PAY_NL_RIVERTY";
-	readonly HOOLAH: "HOOLAH";
-	readonly ADYEN_BLIK: "ADYEN_BLIK";
-	readonly ADYEN_VIPPS: "ADYEN_VIPPS";
-	readonly ADYEN_GIROPAY: "ADYEN_GIROPAY";
-	readonly ADYEN_SOFORT: "ADYEN_SOFORT";
-	readonly ADYEN_IDEAL: "ADYEN_IDEAL";
-	readonly ADYEN_TRUSTLY: "ADYEN_TRUSTLY";
-	readonly ADYEN_ALIPAY: "ADYEN_ALIPAY";
-	readonly ADYEN_TWINT: "ADYEN_TWINT";
-	readonly ADYEN_MOBILEPAY: "ADYEN_MOBILEPAY";
-	readonly MOLLIE_BANCONTACT: "MOLLIE_BANCONTACT";
-	readonly MOLLIE_IDEAL: "MOLLIE_IDEAL";
-	readonly BUCKAROO_GIROPAY: "BUCKAROO_GIROPAY";
-	readonly BUCKAROO_EPS: "BUCKAROO_EPS";
-	readonly BUCKAROO_SOFORT: "BUCKAROO_SOFORT";
-	readonly BUCKAROO_BANCONTACT: "BUCKAROO_BANCONTACT";
-	readonly BUCKAROO_IDEAL: "BUCKAROO_IDEAL";
-	readonly ATOME: "ATOME";
-	readonly KLARNA_CUSTOMER_TOKEN: "KLARNA_CUSTOMER_TOKEN";
-	readonly DLOCAL_PIX: "DLOCAL_PIX";
-	readonly ALMA: "ALMA";
-	readonly ADYEN_CASHAPP: "ADYEN_CASHAPP";
-	readonly ADYEN_AFFIRM: "ADYEN_AFFIRM";
-};
-export type PaymentInstrumentType = (typeof PaymentInstrumentType)[keyof typeof PaymentInstrumentType];
-declare const PaymentMethodType: {
-	readonly WORLDPAY_IDEAL: "WORLDPAY_IDEAL";
-	readonly STRIPE_ACH: "STRIPE_ACH";
-	readonly STRIPE_IDEAL: "STRIPE_IDEAL";
-	readonly ADYEN_KLARNA: "ADYEN_KLARNA";
-	readonly ADYEN_BANCONTACT_CARD: "ADYEN_BANCONTACT_CARD";
-	readonly PAY_NL_KAARTDIRECT: "PAY_NL_KAARTDIRECT";
-	readonly ADYEN_EPS: "ADYEN_EPS";
-	readonly ADYEN_BANCONTACT_PAYCONIQ: "ADYEN_BANCONTACT_PAYCONIQ";
-	readonly OMISE_PROMPTPAY: "OMISE_PROMPTPAY";
-	readonly OMISE_TRUEMONEY: "OMISE_TRUEMONEY";
-	readonly ADYEN_MULTIBANCO: "ADYEN_MULTIBANCO";
-	readonly PACYPAY_WECHAT: "PACYPAY_WECHAT";
-	readonly PACYPAY_ALIPAY: "PACYPAY_ALIPAY";
-	readonly ADYEN_MBWAY: "ADYEN_MBWAY";
-	readonly XENDIT_DANA: "XENDIT_DANA";
-	readonly XENDIT_SHOPEEPAY: "XENDIT_SHOPEEPAY";
-	readonly ADYEN_PAYSHOP: "ADYEN_PAYSHOP";
-	readonly ADYEN_PAYTRAIL: "ADYEN_PAYTRAIL";
-	readonly CLEARPAY: "CLEARPAY";
-	readonly RAPYD_FAST: "RAPYD_FAST";
-	readonly RAPYD_PROMPTPAY: "RAPYD_PROMPTPAY";
-	readonly RAPYD_GCASH: "RAPYD_GCASH";
-	readonly RAPYD_POLI: "RAPYD_POLI";
-	readonly RAPYD_GRABPAY: "RAPYD_GRABPAY";
-	readonly PRIMER_PAYPAL: "PRIMER_PAYPAL";
-	readonly TWOC2P: "TWOC2P";
-	readonly NETS: "NETS";
-	readonly STRIPE_GIROPAY: "STRIPE_GIROPAY";
-	readonly MOLLIE_GIROPAY: "MOLLIE_GIROPAY";
-	readonly MOLLIE_EPS: "MOLLIE_EPS";
-	readonly PAY_NL_EPS: "PAY_NL_EPS";
-	readonly PAY_NL_P24: "PAY_NL_P24";
-	readonly MOLLIE_P24: "MOLLIE_P24";
-	readonly MOLLIE_SOFORT: "MOLLIE_SOFORT";
-	readonly COINBASE: "COINBASE";
-	readonly OPENNODE: "OPENNODE";
-	readonly MOLLIE_GIFT_CARD: "MOLLIE_GIFTCARD";
-	readonly XFERS_PAYNOW: "XFERS_PAYNOW";
-	readonly PAYMENT_CARD: "PAYMENT_CARD";
-	readonly APPLE_PAY: "APPLE_PAY";
-	readonly GOOGLE_PAY: "GOOGLE_PAY";
-	readonly PAYPAL: "PAYPAL";
-	readonly GO_CARDLESS: "GOCARDLESS";
-	readonly KLARNA: "KLARNA";
-	readonly PAY_NL_IDEAL: "PAY_NL_IDEAL";
-	readonly PAY_NL_SOFORT_BANKING: "PAY_NL_SOFORT_BANKING";
-	readonly PAY_NL_BANCONTACT: "PAY_NL_BANCONTACT";
-	readonly PAY_NL_PAYPAL: "PAY_NL_PAYPAL";
-	readonly PAY_NL_CREDIT_TRANSFER: "PAY_NL_CREDIT_TRANSFER";
-	readonly PAY_NL_DIRECT_DEBIT: "PAY_NL_DIRECT_DEBIT";
-	readonly PAY_NL_GIROPAY: "PAY_NL_GIROPAY";
-	readonly PAY_NL_PAYCONIQ: "PAY_NL_PAYCONIQ";
-	readonly PAY_NL_RIVERTY: "PAY_NL_RIVERTY";
-	readonly HOOLAH: "HOOLAH";
-	readonly ADYEN_BLIK: "ADYEN_BLIK";
-	readonly ADYEN_MOBILEPAY: "ADYEN_MOBILEPAY";
-	readonly ADYEN_VIPPS: "ADYEN_VIPPS";
-	readonly ADYEN_GIROPAY: "ADYEN_GIROPAY";
-	readonly ADYEN_SOFORT: "ADYEN_SOFORT";
-	readonly ADYEN_IDEAL: "ADYEN_IDEAL";
-	readonly ADYEN_TRUSTLY: "ADYEN_TRUSTLY";
-	readonly ADYEN_ALIPAY: "ADYEN_ALIPAY";
-	readonly ADYEN_TWINT: "ADYEN_TWINT";
-	readonly ADYEN_BANK_TRANSFER: "ADYEN_BANK_TRANSFER";
-	readonly MOLLIE_BANCONTACT: "MOLLIE_BANCONTACT";
-	readonly MOLLIE_IDEAL: "MOLLIE_IDEAL";
-	readonly BUCKAROO_GIROPAY: "BUCKAROO_GIROPAY";
-	readonly BUCKAROO_EPS: "BUCKAROO_EPS";
-	readonly BUCKAROO_SOFORT: "BUCKAROO_SOFORT";
-	readonly BUCKAROO_BANCONTACT: "BUCKAROO_BANCONTACT";
-	readonly BUCKAROO_IDEAL: "BUCKAROO_IDEAL";
-	readonly ATOME: "ATOME";
-	readonly DLOCAL_PIX: "DLOCAL_PIX";
-	readonly ALMA: "ALMA";
-	readonly ADYEN_CASHAPP: "ADYEN_CASHAPP";
-	readonly ADYEN_AFFIRM: "ADYEN_AFFIRM";
-};
-export type PaymentMethodType = (typeof PaymentMethodType)[keyof typeof PaymentMethodType];
 declare global {
 	interface Window {
 		MSStream?: string;
 		opera?: string;
 	}
 }
-declare const PaymentMethodType$1 = {
+declare const PaymentMethodType = {
 	WORLDPAY_IDEAL: "WORLDPAY_IDEAL",
 	STRIPE_ACH: "STRIPE_ACH",
 	STRIPE_IDEAL: "STRIPE_IDEAL",
@@ -244,8 +88,8 @@ declare const PaymentMethodType$1 = {
 	DLOCAL_PIX: "DLOCAL_PIX",
 	ALMA: "ALMA",
 } as const;
-type PaymentMethodType$1 = (typeof PaymentMethodType$1)[keyof typeof PaymentMethodType$1];
-declare const PaymentInstrumentType$1 = {
+export type PaymentMethodType = (typeof PaymentMethodType)[keyof typeof PaymentMethodType];
+declare const PaymentInstrumentType = {
 	WORLDPAY_IDEAL: "WORLDPAY_IDEAL",
 	AUTOMATED_CLEARING_HOUSE: "AUTOMATED_CLEARING_HOUSE",
 	ADYEN_KLARNA: "ADYEN_KLARNA",
@@ -323,7 +167,63 @@ declare const PaymentInstrumentType$1 = {
 	ADYEN_CASHAPP: "ADYEN_CASHAPP",
 	ADYEN_AFFIRM: "ADYEN_AFFIRM",
 } as const;
-type PaymentInstrumentType$1 = (typeof PaymentInstrumentType$1)[keyof typeof PaymentInstrumentType$1];
+export type PaymentInstrumentType = (typeof PaymentInstrumentType)[keyof typeof PaymentInstrumentType];
+export interface IconUrl {
+	colored: string;
+	dark: string;
+	light: string;
+}
+export interface ColorConfig {
+	colored: string;
+	dark: string;
+	light: string;
+}
+export interface PaymentMethodDisplayMetadata {
+	button: {
+		backgroundColor: ColorConfig;
+		borderColor: {
+			dark: string;
+			light: string;
+		};
+		borderWidth: ColorConfig;
+		cornerRadius: number;
+		iconPositionRelativeToText?: "START" | "END";
+		iconUrl: IconUrl;
+		text?: string;
+		textColor?: {
+			dark: string;
+			light: string;
+		};
+	};
+	overlay: {
+		logo: ColorConfig;
+		backgroundColor: ColorConfig;
+	};
+	popup: {
+		width: number;
+		height: number;
+	};
+}
+export interface CardFormConfig {
+	visible?: boolean;
+	required?: boolean;
+}
+/**
+ * Capability flags returned by the server on a payment method config.
+ * - `BACKEND_DRIVEN` — flow is driven by server-sent instructions (step tree schema);
+ *   the SDK must use the BDC orchestrator instead of the standard tokenise path.
+ */
+export type PaymentMethodCapability = "BACKEND_DRIVEN" | (string & {});
+export interface PaymentMethodOptions {
+	captureVaultedCardCvv?: boolean;
+	clientId?: string;
+	merchantAccountId?: string;
+	threeDSecureToken?: string;
+	threeDSecureInitUrl?: string;
+	threeDSecureProvider?: string;
+	threeDSecureEnabled?: boolean;
+	cardholderName?: CardFormConfig;
+}
 /**
  * Google Pay shipping address parameters.
  * @see https://developers.google.com/pay/api/web/reference/request-objects#ShippingAddressParameters
@@ -440,6 +340,149 @@ export interface GooglePayClientOptions {
 	 */
 	buttonBorderType?: GooglePayButtonBorderType;
 }
+export interface PaymentMethodConfig<T extends PaymentMethodOptions = PaymentMethodOptions> {
+	id: string;
+	type: PaymentMethodType;
+	name: string;
+	implementationType: "WEB_REDIRECT" | "NATIVE_SDK" | "BACKEND_DRIVEN";
+	displayMetadata: PaymentMethodDisplayMetadata;
+	options: T;
+	forceRedirect?: boolean;
+	capabilities?: PaymentMethodCapability[];
+}
+/**
+ * Billing address module configuration options
+ * Controls which fields are visible and required in the billing address form
+ */
+export interface BillingAddressModuleOptions {
+	firstName?: boolean;
+	lastName?: boolean;
+	addressLine1?: boolean;
+	addressLine2?: boolean;
+	city?: boolean;
+	postalCode?: boolean;
+	state?: boolean;
+	countryCode?: boolean;
+}
+/**
+ * Billing address checkout module
+ */
+export interface BillingAddressCheckoutModule {
+	type: "BILLING_ADDRESS";
+	options: BillingAddressModuleOptions;
+}
+/**
+ * Shipping method for express checkout flows (Google Pay, Apple Pay).
+ */
+export interface ShippingMethod {
+	/** Unique identifier for the shipping method */
+	id: string;
+	/** Display name for the shipping method */
+	name: string;
+	/** Description (e.g., "5-7 business days") */
+	description: string;
+	/** Shipping cost in minor units */
+	amount: number;
+	/** Type of shipping method */
+	type?: "shipping" | "pickup";
+}
+/**
+ * Shipping checkout module options
+ */
+export interface ShippingModuleOptions {
+	/** Available shipping methods */
+	shippingMethods: ShippingMethod[];
+	/** Currently selected shipping method ID */
+	selectedShippingMethod?: string;
+}
+/**
+ * Shipping checkout module
+ */
+export interface ShippingCheckoutModule {
+	type: "SHIPPING";
+	options: ShippingModuleOptions;
+}
+/**
+ * Checkout module configuration
+ * Supports billing address and shipping modules
+ */
+export type CheckoutModuleConfig = BillingAddressCheckoutModule | ShippingCheckoutModule;
+export type ApprovalMode = "AUTO" | "MANUAL";
+export interface ClientSession {
+	clientSessionId: string;
+	/**
+	 * Whether the session approves payments automatically (AUTO, default) or
+	 * requires explicit merchant approval per attempt (MANUAL). Set at creation.
+	 */
+	approvalMode?: ApprovalMode;
+	/**
+	 * The active payment attempt for a MANUAL session, if any. Used to resolve
+	 * manual-flow recovery without a separate `GET /client-session` call on startup.
+	 */
+	currentAttempt?: CurrentAttempt;
+	customer?: {
+		customerId?: string;
+		emailAddress?: string;
+		mobileNumber?: string;
+		firstName?: string;
+		lastName?: string;
+		billingAddress?: ClientSessionAddress;
+		shippingAddress?: ClientSessionAddress;
+		taxId?: string;
+	};
+	paymentMethod: {
+		options?: Array<{
+			type: string;
+			surcharge?: number;
+			networks?: Array<{
+				type: string;
+				surcharge?: number;
+			}>;
+		}>;
+		orderedAllowedCardNetworks: string[];
+		vaultOnSuccess: boolean;
+	};
+	order: {
+		countryCode?: string;
+		currencyCode?: string;
+		fees?: Array<{
+			type?: string;
+			description?: string;
+			amount: number;
+		}>;
+		lineItems?: Array<{
+			amount: number;
+			description: string;
+			discountAmount?: number;
+			itemId: string;
+			name?: string;
+			productType?: "DIGITAL" | "PHYSICAL" | "SHIPPING_FEE";
+			quantity: number;
+			taxAmount?: number;
+			taxCode?: string;
+		}>;
+		merchantAmount?: number;
+		orderId?: string;
+		shipping?: {
+			amount: number;
+			methodId?: string;
+			methodName?: string;
+			methodDescription?: string;
+		};
+		totalOrderAmount: number;
+	};
+}
+export interface ClientConfiguration {
+	binDataUrl: string;
+	checkoutModules?: CheckoutModuleConfig[];
+	clientSession: ClientSession;
+	coreUrl: string;
+	env: string;
+	paymentMethods: PaymentMethodConfig<any>[];
+	pciUrl: string;
+	primerAccountId: string;
+	settleOnAuth?: boolean;
+}
 export interface ThreeDSAuthenticationData {
 	responseCode: "AUTH_SUCCESS" | "AUTH_FAILED" | "SKIPPED" | "CHALLENGE";
 	reasonCode?: string;
@@ -447,7 +490,7 @@ export interface ThreeDSAuthenticationData {
 	protocolVersion: string;
 	challengeIssued: boolean;
 }
-export interface IPaymentMethodToken<T, U extends PaymentInstrumentType$1 = PaymentInstrumentType$1> {
+export interface IPaymentMethodToken<T, U extends PaymentInstrumentType = PaymentInstrumentType> {
 	token: string;
 	analyticsId: string;
 	tokenType: "SINGLE_USE" | "MULTI_USE";
@@ -462,7 +505,7 @@ export type PaymentCardToken = IPaymentMethodToken<{
 	last4Digits: string;
 	cardholderName: string;
 	network: string;
-}, typeof PaymentInstrumentType$1.CARD>;
+}, typeof PaymentInstrumentType.CARD>;
 export interface UnmanagedPaymentToken {
 	token: string;
 	analyticsId: string;
@@ -475,467 +518,314 @@ export interface UnmanagedPaymentToken {
 	threeDSecureAuthentication: null;
 }
 export type PaymentMethodToken = PaymentCardToken | UnmanagedPaymentToken;
-/**
- * Minimal payment summary with reduced PII exposure.
- * Used in events for public data delivery.
- */
-export interface PaymentSummary {
-	/** Payment ID from Primer API */
-	id: string;
-	/** Order ID/reference from merchant */
-	orderId: string;
-	/** Payment method data with whitelisted fields */
-	paymentMethodData?: {
-		/** Payment method type (e.g., "PAYMENT_CARD", "PAYPAL") */
-		paymentMethodType?: string;
-		/** Last 4 digits of card (cards only) */
-		last4Digits?: string;
-		/** Card network (e.g., "VISA", "MASTERCARD") - cards only */
-		network?: string;
-		/** Last 4 digits of account number (ACH only) */
-		accountNumberLastFourDigits?: string;
-		/** Bank name (ACH only) */
-		bankName?: string;
-	};
+export interface ClientSessionAddress {
+	firstName?: string;
+	lastName?: string;
+	addressLine1?: string;
+	addressLine2?: string;
+	city?: string;
+	state?: string;
+	postalCode?: string;
+	countryCode?: string;
 }
-/**
- * Base interface for common vaulted payment method fields.
- * All payment-method-specific interfaces extend this base.
- */
-export interface BaseVaultedPaymentMethodSummary {
-	/** Payment instrument ID */
-	id: string;
-	/** Analytics tracking ID */
-	analyticsId: string;
-	/** Payment method type (e.g., "PAYMENT_CARD", "PAYPAL") */
-	paymentMethodType: PaymentMethodType$1;
-	/** Optional user-provided description for the payment method */
-	userDescription?: string;
+export type NullableAddress = {
+	[K in keyof ClientSessionAddress]?: ClientSessionAddress[K] | null;
+};
+export interface PaymentRenderButtonOptions {
+	style?: {
+		buttonHeight?: number;
+		shadowRoot?: ShadowRoot | null;
+	};
 }
-/**
- * Vaulted payment card summary with card-specific fields.
- */
-export interface CardVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
-	/** Discriminant for card payment instruments */
-	paymentInstrumentType: "PAYMENT_CARD";
-	/** Card-specific payment instrument data */
-	paymentInstrumentData?: {
-		/** Last 4 digits of card */
-		last4Digits?: string;
-		/** Card network (e.g., "VISA", "MASTERCARD") */
-		network?: string;
-		/** Cardholder name */
-		cardholderName?: string;
-		/** Expiration month (1-12) */
-		expirationMonth?: string;
-		/** Expiration year (e.g., "2025") */
-		expirationYear?: string;
+export interface BaseInputStyle {
+	background?: string;
+	borderColor?: number | string;
+	borderRadius?: number | string;
+	borderStyle?: string;
+	borderWidth?: number | string;
+	boxShadow?: string;
+	color?: string;
+	fontFamily?: string;
+	fontSize?: string;
+	fontSmoothing?: string;
+	fontWeight?: string;
+	height?: number | string;
+	letterSpacing?: string;
+	lineHeight?: string;
+	paddingHorizontal?: number;
+	textTransform?: string;
+}
+export interface InputStyle extends BaseInputStyle {
+	focus?: BaseInputStyle;
+	hover?: BaseInputStyle;
+	placeholder?: BaseInputStyle;
+	selection?: BaseInputStyle;
+	webkitAutofill?: BaseInputStyle;
+}
+export interface HostedInputOptions {
+	placeholder?: string;
+	ariaLabel?: string;
+	style?: {
+		input?: {
+			base?: InputStyle;
+			error?: InputStyle;
+		};
+	};
+	orderedAllowedCardNetworks?: string[];
+	cardholderName?: {
+		visible?: boolean;
+		required?: boolean;
 	};
 }
 /**
- * Vaulted PayPal billing agreement summary with PayPal-specific fields.
+ * Per-funding-source style overrides for PayPal buttons.
+ * Keys are funding source names (e.g., 'card', 'paylater'), values are style overrides.
  */
-export interface PayPalVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
-	/** Discriminant for PayPal billing agreement instruments */
-	paymentInstrumentType: "PAYPAL_BILLING_AGREEMENT";
-	/** PayPal-specific payment instrument data */
-	paymentInstrumentData?: {
-		/** External PayPal payer ID */
-		externalPayerId?: string;
-		/** PayPal account email */
-		email?: string;
-		/** First name */
-		firstName?: string;
-		/** Last name */
-		lastName?: string;
-	};
-}
+export type PayPalStyleOverrides = Partial<Record<FUNDING_SOURCE, PayPalButtonStyle>>;
 /**
- * Vaulted Klarna customer token summary with Klarna-specific fields.
+ * Unified PayPal button style configuration.
+ * Base style properties (color, shape, etc.) apply to all buttons.
+ * Funding source keys (paypal, paylater, card, etc.) contain per-button overrides.
+ *
+ * @example
+ * {
+ *   color: 'blue',        // Base style for all buttons
+ *   shape: 'rect',
+ *   paylater: {           // Override for Pay Later button
+ *     color: 'white'
+ *   },
+ *   card: {               // Override for Card button
+ *     color: 'black'
+ *   }
+ * }
  */
-export interface KlarnaVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
-	/** Discriminant for Klarna customer token instruments */
-	paymentInstrumentType: "KLARNA_CUSTOMER_TOKEN";
-	/** Klarna-specific payment instrument data */
-	paymentInstrumentData?: {
-		/** Klarna account email */
-		email?: string;
-		/** First name */
-		firstName?: string;
-		/** Last name */
-		lastName?: string;
-		/** Phone number */
-		phoneNumber?: string;
-	};
-}
+export type PayPalStyleWithOverrides = PayPalButtonStyle & PayPalStyleOverrides;
 /**
- * Vaulted ACH (Automated Clearing House) summary with ACH-specific fields.
+ * Local type definitions to prevent sdk-utils from leaking through public API.
+ * These types mirror sdk-utils but are defined locally to avoid dts-bundle-generator
+ * traversing into sdk-utils source files during TypeScript definition bundling.
  */
-export interface ACHVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
-	/** Discriminant for ACH instruments */
-	paymentInstrumentType: "AUTOMATED_CLEARING_HOUSE";
-	/** ACH-specific payment instrument data */
-	paymentInstrumentData?: {
-		/** Last 4 digits of account number */
-		accountNumberLastFourDigits?: string;
-		/** Bank name */
-		bankName?: string;
-		/** Account type (e.g., "CHECKING", "SAVINGS") */
-		accountType?: string;
-	};
-}
 /**
- * Generic vaulted payment method summary for payment instruments
- * not explicitly modeled with their own interface.
+ * Function type for translating keys to localized strings.
+ * Defined locally to avoid dts-bundle-generator traversing into checkoutContext.
  */
-export interface GenericVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
-	/** Discriminant for all other payment instrument types */
-	paymentInstrumentType: Exclude<PaymentInstrumentType$1, "PAYMENT_CARD" | "PAYPAL_BILLING_AGREEMENT" | "KLARNA_CUSTOMER_TOKEN" | "AUTOMATED_CLEARING_HOUSE">;
-	/** Generic payment instrument data for unknown/other payment methods */
-	paymentInstrumentData?: Record<string, unknown>;
-}
+export type TranslateFunction = (key: string, fallback: string) => string;
 /**
- * Discriminated union of all vaulted payment method summaries.
- * Use the paymentInstrumentType field to narrow to specific types.
+ * Analytics environment type (mirrors @primer-io/sdk-utils/analytics)
  */
-export type VaultedPaymentMethodSummary = CardVaultedPaymentMethodSummary | PayPalVaultedPaymentMethodSummary | KlarnaVaultedPaymentMethodSummary | ACHVaultedPaymentMethodSummary | GenericVaultedPaymentMethodSummary;
+export type AnalyticsEnvironment = "LOCAL" | "DEV" | "STAGING" | "SANDBOX" | "PRODUCTION";
 /**
- * Data surfaced to the merchant when a MANUAL-approval `:pay` creates an
- * attempt awaiting approval. The merchant sends clientSessionId +
- * paymentAttemptId to its backend (which calls /approve or /abort), then calls
- * continueFlow() to resume the SDK.
+ * SDK Error class interface (mirrors @primer-io/sdk-utils/errors/errors)
+ * Base class for all SDK errors with error code and nested error.
  */
-export interface PaymentApprovalRequiredData {
-	clientSessionId: string;
-	paymentAttemptId: string;
-	paymentMethodToken: PaymentMethodToken;
-	continueFlow: () => Promise<void>;
+export interface SdkError extends Error {
+	readonly code: string;
+	readonly error?: unknown;
 }
-export type APIVersionOption = "legacy" | "2.4";
 declare enum HeadlessManagerType {
+	BLIK = "BLIK",
 	CARD = "CARD",
 	NATIVE = "NATIVE",
 	REDIRECT = "REDIRECT",
 	KLARNA = "KLARNA",
 	ADYEN_KLARNA = "ADYEN_KLARNA",
 	ACH = "ACH",
-	BLIK = "BLIK",
-	MBWAY = "MBWAY"
+	MBWAY = "MBWAY",
+	QRCODE = "QRCODE"
 }
+export type PaymentMethodInfo = {
+	type: PaymentMethodType;
+	managerType: HeadlessManagerType;
+};
 declare enum EventTypes {
 	CHANGE = "change",
+	ENTER = "ENTER",
 	ERROR = "error",
 	FOCUS = "focus",
 	BLUR = "blur",
 	CLICK = "click",
 	CLOSE = "close",
-	ENTER = "enter",
+	INPUT = "input",
 	CONFIRMED_KLARNA_CATEGORY = "CONFIRMED_KLARNA_CATEGORY",
 	CONFIRMED_KLARNA_CATEGORY_ERROR = "CONFIRMED_KLARNA_CATEGORY_ERROR",
 	KLARNA_SESSION_UPDATE = "KLARNA_SESSION_UPDATE",
 	KLARNA_SESSION_REFRESH_ERROR = "KLARNA_SESSION_REFRESH_ERROR"
 }
-export interface BasePaymentInstrumentData {
-	[key: string]: unknown;
-}
-export interface ClientSessionLineItem {
-	amount: number;
-	description: string;
-	discountAmount?: number;
-	itemId: string;
-	name?: string;
-	productType?: "DIGITAL" | "PHYSICAL" | "SHIPPING_FEE";
-	quantity: number;
-	taxAmount?: number;
-	taxCode?: string;
-}
-export interface ClientSessionShipping {
-	amount: number;
-	methodId?: string;
-	methodName?: string;
-	methodDescription?: string;
-}
-export interface ClientSessionFeeItem {
-	type?: string;
-	description?: string;
-	amount: number;
+type EventListener$1 = (event?: Event) => void;
+export interface PayPalOptionsWithPaypalJsTypes {
+	/**
+	 * Button style configuration with optional per-funding-source overrides.
+	 * Root-level properties (color, shape, etc.) are base styles for all buttons.
+	 * Funding source keys (paypal, paylater, card) contain per-button overrides.
+	 *
+	 * @example
+	 * {
+	 *   color: 'blue',           // Base style for all buttons
+	 *   shape: 'rect',
+	 *   card: { color: 'black' } // Card button requires black or white
+	 * }
+	 */
+	style?: PayPalStyleWithOverrides;
+	vault?: boolean;
+	paymentFlow?: string;
+	buyerCountry?: string;
+	disableFunding?: FUNDING_SOURCE[];
+	enableFunding?: FUNDING_SOURCE[];
+	integrationDate?: string;
+	debug?: boolean;
 }
-export interface ClientSessionAddress {
-	firstName?: string;
-	lastName?: string;
-	addressLine1?: string;
-	addressLine2?: string;
-	city?: string;
-	state?: string;
-	countryCode?: string;
-	postalCode?: string;
+export interface LegacyApplePayOptions {
+	/**
+	 * @deprecated Use buttonOptions.type instead
+	 */
+	buttonType?: "add-money" | "book" | "buy" | "check-out" | "continue" | "contribute" | "donate" | "order" | "pay" | "plain" | "reload" | "rent" | "set-up" | "subscribe" | "support" | "tip" | "top-up";
+	/**
+	 * @deprecated Use buttonOptions.buttonstyle instead
+	 */
+	buttonStyle?: "black" | "white" | "white-outline";
 }
-export type NullableAddress = {
-	[K in keyof ClientSessionAddress]?: ClientSessionAddress[K] | null;
-};
-export interface ClientSession {
-	orderId?: string;
-	currencyCode?: string;
-	lineItems?: ClientSessionLineItem[];
-	totalAmount?: number;
-	customerId?: string;
-	orderDetails?: {
-		countryCode?: string;
-		shipping?: ClientSessionShipping;
-		fees?: ClientSessionFeeItem[];
-	};
-	customer?: {
-		emailAddress?: string;
-		mobileNumber?: string;
-		firstName?: string;
-		lastName?: string;
-		billingAddress?: ClientSessionAddress;
-		shippingAddress?: ClientSessionAddress;
-		taxId?: string;
-		nationalDocumentId?: string;
+export interface ApplePayClientOptions {
+	/**
+	 * Button configuration options
+	 */
+	buttonOptions?: {
+		/**
+		 * The kind of Apple Pay button, such as a button for purchasing a subscription.
+		 * @default "plain"
+		 * @see https://developer.apple.com/documentation/applepayontheweb/applepaybuttontype
+		 */
+		type?: "add-money" | "book" | "buy" | "check-out" | "continue" | "contribute" | "donate" | "order" | "pay" | "plain" | "reload" | "rent" | "set-up" | "subscribe" | "support" | "tip" | "top-up";
+		/**
+		 * The appearance of the Apple Pay button, such as a black button with white lettering.
+		 * @see https://developer.apple.com/documentation/applepayontheweb/applepaybuttonstyle
+		 */
+		buttonStyle?: "black" | "white" | "white-outline";
 	};
-	paymentMethod?: {
-		options?: Record<string, unknown>;
-		orderedAllowedCardNetworks?: string[];
-		vaultOnSuccess?: boolean;
+	/**
+	 * Billing contact configuration options
+	 */
+	billingOptions?: {
+		/**
+		 * The fields of billing information the user must provide to process the transaction.
+		 * @see https://developer.apple.com/documentation/applepayontheweb/applepaypaymentrequest/requiredbillingcontactfields
+		 */
+		requiredBillingContactFields?: "postalAddress"[];
 	};
-}
-export interface BackgroundColor {
-	colored: string;
-	dark: string;
-	light: string;
-}
-export interface IconUrl {
-	colored: string;
-	dark: string;
-	light: string;
-}
-export interface InputStyles {
-	base?: {
-		color?: string;
-		fontFamily?: string;
-		fontSize?: string;
-		fontWeight?: string;
-		lineHeight?: string;
-		letterSpacing?: string;
-		textTransform?: string;
-		background?: string;
-		borderRadius?: number | string;
-		borderColor?: string | number;
-		borderWidth?: string | number;
-		borderStyle?: string;
-		boxShadow?: string;
-		height?: number | string;
-		paddingHorizontal?: number;
-		hover?: Record<string, unknown>;
-		focus?: Record<string, unknown>;
-		placeholder?: Record<string, unknown>;
-		webkitAutofill?: Record<string, unknown>;
-		selection?: Record<string, unknown>;
+	/**
+	 * Shipping contact configuration options
+	 */
+	shippingOptions?: {
+		/**
+		 * The fields of shipping information the user must provide to process the transaction.
+		 * @see https://developer.apple.com/documentation/applepayontheweb/applepaypaymentrequest/requiredshippingcontactfields
+		 */
+		requiredShippingContactFields?: ("postalAddress" | "name" | "phoneticName" | "phone" | "email")[];
+		requireShippingMethod?: boolean;
 	};
-	error?: Record<string, unknown>;
 }
-export interface InputValidationError {
-	field?: string;
-	name: string;
-	error: string;
-	message: string;
-}
-export interface Validation {
-	valid: boolean;
-	validationErrors: InputValidationError[];
-	error?: string;
-}
-export interface InputMetadata {
-	errorCode: string | null;
-	error: string | null;
-	valid: boolean;
-	active: boolean;
-	dirty: boolean;
-	touched: boolean;
-	submitted: boolean;
-}
-export interface PaymentMethodConfig<T = Record<string, unknown>> {
+export interface Payment {
 	id: string;
-	type: PaymentMethodType;
-	name: string;
-	implementationType: "WEB_REDIRECT" | "NATIVE_SDK" | "BACKEND_DRIVEN";
-	displayMetadata: {
-		button: {
-			backgroundColor: BackgroundColor;
-			borderColor: {
-				dark: string;
-				light: string;
-			};
-			borderWidth: {
-				colored: number | string;
-				dark: number | string;
-				light: number | string;
-			};
-			cornerRadius: number;
-			iconPositionRelativeToText?: "START" | "END";
-			iconUrl: IconUrl;
-			text?: string;
-			textColor?: {
-				dark: string;
-				light: string;
-			};
-		};
-		overlay: {
-			logo: IconUrl;
-			backgroundColor: BackgroundColor;
-		};
-		popup: {
-			width: number;
-			height: number;
-		};
-	};
-	options: T extends Record<string, unknown> ? T : {
-		captureVaultedCardCvv?: boolean;
-		clientId?: string;
-		threeDSecureToken?: string;
-		threeDSecureInitUrl?: string;
-		threeDSecureProvider?: string;
-		threeDSecureEnabled?: boolean;
-		cardholderName?: {
-			visible?: boolean;
-			required?: boolean;
-		};
+	orderId: string;
+	paymentMethodData?: {
+		paymentMethodType: PaymentMethodType;
+		[key: string]: unknown;
 	};
-	forceRedirect?: boolean;
-}
-export interface PaymentMethodInfo {
-	type: PaymentMethodType;
-	managerType: HeadlessManagerType;
 }
-export type CardNetworkType = "american-express" | "diners-club" | "discover" | "elo" | "hiper" | "hipercard" | "interac" | "jcb" | "maestro" | "mastercard" | "mir" | "unionpay" | "private-label" | "visa";
-export interface CardNetworkDetails {
-	displayName: string;
-	network: string;
-	allowed: boolean;
+export interface HeadlessHostedInputOptions {
+	placeholder?: string;
+	ariaLabel?: string;
+	style?: Record<string, unknown>;
 }
-export interface CardNetworkChangeEvent {
-	detectedCardNetworks: {
-		items: CardNetworkDetails[];
-		preferred?: CardNetworkDetails;
-	};
-	selectableCardNetworks?: {
-		items: CardNetworkDetails[];
-		preferred?: CardNetworkDetails;
-	};
-	source: "REMOTE" | "LOCAL" | "LOCAL_FALLBACK";
+export interface CardPaymentMethodSubmitValues {
+	cardNetwork?: string;
 }
-export interface BinDataDetails extends CardNetworkDetails {
-	issuerCountryCode?: string;
-	issuerName?: string;
-	accountFundingType?: string;
-	prepaidReloadableIndicator?: string;
-	productUsageType?: string;
-	productCode?: string;
-	productName?: string;
-	issuerCurrencyCode?: string;
-	regionalRestriction?: string;
-	accountNumberType?: string;
+export interface CardPaymentMethodManagerOptions {
+	onBinDataAvailable?: (event: BinDataAvailableEvent) => void;
+	onBinDataLoadingChange?: (loading: boolean) => void;
+	onCardNetworksChange?: (event: CardNetworkChangeEvent) => void;
+	onCardNetworksLoading?: () => void;
 }
-export interface BinDataAvailableEvent {
-	preferred?: BinDataDetails;
-	alternatives: BinDataDetails[];
-	status: "complete" | "partial";
-	firstDigits?: string;
+export interface KlarnaPaymentMethodManagerOptions {
+	onPaymentMethodCategoriesChange?: (categories: {
+		id: string;
+		name: string;
+		descriptiveAssetUrl: string;
+		standardAssetUrl: string;
+	}[]) => void;
+	onPaymentMethodAction?: (action: string, data: {
+		paymentMethodType: string;
+		category: string;
+	}) => void;
 }
-export interface CardPaymentMethodSubmitValues {
-	cardNetwork?: string;
+export interface KlarnaPaymentMethodManager {
+	renderCategory: (params: {
+		containerId: string | HTMLElement;
+		paymentMethodCategoryId: string;
+		onHeightChange?: (height: number) => void;
+	}) => Promise<void>;
+	start: (params: {
+		paymentMethodCategoryId: string;
+	}) => Promise<void>;
 }
-export type CardPreferredFlow = "DEDICATED_SCENE" | "EMBEDDED_IN_HOME";
-export interface PaymentCardInstrumentData extends BasePaymentInstrumentData {
-	last4Digits: string;
-	first6Digits: string;
-	expirationMonth: string;
-	expirationYear: string;
-	cardholderName: string;
-	network: string;
-	isNetworkTokenized: boolean;
-	binData?: {
-		network: string;
-		issuerCountryCode: string;
-		issuerName: string;
-		issuerCurrencyCode: string;
-		regionalRestriction: string;
-		accountNumberType: string;
-		accountFundingType: string;
-		prepaidReloadableIndicator: string;
-		productUsageType: string;
-		productCode: string;
-		productName: string;
-	};
+/**
+ * Adyen Klarna payment type option
+ */
+export interface AdyenKlarnaPaymentOption {
+	id: string;
+	label: string;
 }
-export interface PayPalInstrumentData extends BasePaymentInstrumentData {
-	externalPayerInfo?: {
-		externalPayerId?: string;
-		firstName?: string;
-		lastName?: string;
-		email?: string;
-	};
-	shippingAddress?: {
-		firstName?: string;
-		lastName?: string;
-		addressLine1?: string;
-		addressLine2?: string;
-		city?: string;
-		state?: string;
-		countryCode?: string;
-		postalCode?: string;
-	};
+/**
+ * Options for creating an Adyen Klarna payment method manager
+ */
+export interface AdyenKlarnaPaymentMethodManagerOptions {
+	/**
+	 * Callback when payment options change (e.g., Pay Now, Pay Later)
+	 */
+	onPaymentOptionsChange?: (options: AdyenKlarnaPaymentOption[]) => void;
 }
-export interface KlarnaInstrumentData extends BasePaymentInstrumentData {
-	sessionData?: {
-		billingAddress?: {
-			firstName?: string;
-			lastName?: string;
-			email?: string;
-			phoneNumber?: string;
-			addressLine1?: string;
-			addressLine2?: string;
-			city?: string;
-			state?: string;
-			countryCode?: string;
-			postalCode?: string;
-		};
-	};
+/**
+ * Adyen Klarna Payment Method Manager
+ *
+ * Unlike direct Klarna integration, Adyen Klarna uses a redirect flow
+ * with payment type selection (Pay Now, Pay Later, etc.)
+ */
+export interface AdyenKlarnaPaymentMethodManager {
+	/**
+	 * Get available payment options
+	 */
+	getPaymentOptions: () => AdyenKlarnaPaymentOption[];
+	/**
+	 * Select a payment option
+	 */
+	selectOption: (optionId: string) => void;
+	/**
+	 * Start the payment flow with the selected option
+	 */
+	start: () => Promise<void>;
 }
-export interface ACHInstrumentData extends BasePaymentInstrumentData {
-	accountNumberLastFourDigits: string;
-	bankName: string;
-	accountType?: string;
-	routingNumber?: string;
+export interface AchPaymentMethodManagerOptions {
+	onCollectBankAccountDetailsComplete?: () => void;
 }
-export interface IVaultedPaymentMethod<B extends BasePaymentInstrumentData = BasePaymentInstrumentData, I extends PaymentInstrumentType = PaymentInstrumentType, T extends PaymentMethodType = PaymentMethodType> {
+export type PaymentMethodManagerOptions = CardPaymentMethodManagerOptions | KlarnaPaymentMethodManagerOptions | AdyenKlarnaPaymentMethodManagerOptions | AchPaymentMethodManagerOptions | Record<string, unknown>;
+export interface VaultListItem {
 	id: string;
 	analyticsId: string;
-	paymentInstrumentData: B;
-	paymentInstrumentType: I;
-	paymentMethodType: T;
-	threeDSecureAuthentication?: ThreeDSAuthenticationData$1 | null;
-	vaultData?: VaultData | null;
+	paymentInstrumentData: Record<string, unknown>;
+	paymentInstrumentType: PaymentInstrumentType;
+	paymentMethodType: PaymentMethodType;
+	threeDSecureAuthentication?: unknown;
+	vaultData?: unknown;
 	userDescription?: string;
 	isVaulted?: boolean;
 }
-export type PaymentCardVaultedMethod = IVaultedPaymentMethod<PaymentCardInstrumentData, typeof PaymentInstrumentType.CARD, typeof PaymentMethodType.PAYMENT_CARD>;
-export type PayPalVaultedMethod = IVaultedPaymentMethod<PayPalInstrumentData, typeof PaymentInstrumentType.PAYPAL_VAULTED, typeof PaymentMethodType.PAYPAL>;
-export type KlarnaVaultedMethod = IVaultedPaymentMethod<KlarnaInstrumentData, typeof PaymentInstrumentType.KLARNA_CUSTOMER_TOKEN, typeof PaymentMethodType.KLARNA>;
-export type ACHVaultedMethod = IVaultedPaymentMethod<ACHInstrumentData, typeof PaymentInstrumentType.AUTOMATED_CLEARING_HOUSE, typeof PaymentMethodType.STRIPE_ACH>;
-export type VaultedPaymentMethod = PaymentCardVaultedMethod | PayPalVaultedMethod | KlarnaVaultedMethod | ACHVaultedMethod | IVaultedPaymentMethod;
-export interface CardSecurityCodeInputOptions {
-	ariaLabel?: string;
+export interface CvvInputOptions {
 	container: string | Element | HTMLElement;
-	id?: string;
-	name?: string;
-	placeholder?: string;
-	placement?: "append" | "prepend";
-	properties?: unknown;
-	style?: CheckoutStyle;
 	cardNetwork?: string;
+	ariaLabel?: string;
+	placeholder?: string;
+	style?: HostedInputOptions["style"];
 }
+export type SecureInputListener = (...args: unknown[]) => void;
 export interface CvvInput {
 	frame: HTMLIFrameElement | null;
 	readonly metadata: {
@@ -949,236 +839,331 @@ export interface CvvInput {
 	};
 	focus(): void;
 	blur(): void;
-	addListener(event: "change" | "blur" | "focus", listener: (...args: unknown[]) => void): (() => void) | undefined;
-	addEventListener(event: "change" | "blur" | "focus", listener: (...args: unknown[]) => void): (() => void) | undefined;
-	removeListener(event: "change" | "blur" | "focus", listener: (...args: unknown[]) => void): void;
-	name: string;
-	valueToken: string;
+	addListener(event: "metadata" | "change" | "blur" | "focus", listener: SecureInputListener): void;
+	addEventListener(event: "metadata" | "change" | "blur" | "focus", listener: SecureInputListener): void;
+	removeListener(event: "metadata" | "change" | "blur" | "focus", listener: SecureInputListener): void;
 	remove: () => void;
+	validate: () => void;
 }
-export interface Payment {
+export interface HeadlessVaultManager {
+	deleteVaultedPaymentMethod(paymentMethodId: string): Promise<void>;
+	fetchVaultedPaymentMethods(): Promise<VaultListItem[]>;
+	startPaymentFlow(id: string, data?: {
+		cvv?: string;
+	}): Promise<void>;
+	createCvvInput(options: CvvInputOptions): Promise<CvvInput>;
+}
+/**
+ * Minimal payment summary with reduced PII exposure.
+ * Used in events for public data delivery.
+ */
+export interface PaymentSummary {
+	/** Payment ID from Primer API */
 	id: string;
+	/** Order ID/reference from merchant */
 	orderId: string;
+	/** Payment method data with whitelisted fields */
 	paymentMethodData?: {
-		paymentMethodType: PaymentMethodType;
-		reference?: string;
-		expiresAt?: string;
-		entity?: string;
+		/** Payment method type (e.g., "PAYMENT_CARD", "PAYPAL") */
+		paymentMethodType?: string;
+		/** Last 4 digits of card (cards only) */
+		last4Digits?: string;
+		/** Card network (e.g., "VISA", "MASTERCARD") - cards only */
+		network?: string;
+		/** Last 4 digits of account number (ACH only) */
+		accountNumberLastFourDigits?: string;
+		/** Bank name (ACH only) */
+		bankName?: string;
 	};
 }
-export interface KlarnaPaymentMethodCategory {
+/**
+ * Base interface for common vaulted payment method fields.
+ * All payment-method-specific interfaces extend this base.
+ */
+export interface BaseVaultedPaymentMethodSummary {
+	/** Payment instrument ID */
 	id: string;
-	name: string;
-	descriptiveAssetUrl: string;
-	standardAssetUrl: string;
-}
-export interface StripeAchCustomerDetails {
-	emailAddress: string;
-	firstName: string;
-	lastName: string;
+	/** Analytics tracking ID */
+	analyticsId: string;
+	/** Payment method type (e.g., "PAYMENT_CARD", "PAYPAL") */
+	paymentMethodType: PaymentMethodType;
+	/** Optional user-provided description for the payment method */
+	userDescription?: string;
 }
-export interface PrimerClientErrorOptions<T = unknown> {
-	message: string;
-	diagnosticsId?: string;
-	severity?: "ERROR" | "DEBUG" | "WARN" | "INFO";
-	errorId?: string;
-	data?: T;
-	isFromDeveloper?: boolean;
-}
-declare enum ErrorCode {
-	INITIALIZATION_ERROR = "INITIALIZATION_ERROR",
-	NO_PAYMENT_METHODS = "NO_PAYMENT_METHODS",
-	PRIMER_TEARDOWN = "PRIMER_TEARDOWN",
-	PRIMER_SERVER_ERROR = "PRIMER_SERVER_ERROR",
-	THREE_DS_AUTH_FAILED = "THREE_DS_AUTH_FAILED",
-	TOKENIZATION_ERROR = "TOKENIZATION_ERROR",
-	DUPLICATE_PAYMENT_METHOD_ERROR = "DUPLICATE_PAYMENT_METHOD_ERROR",
-	CARD_NUMBER_ERROR = "CARD_NUMBER_ERROR",
-	PAYMENT_METHOD_NOT_SETUP = "PAYMENT_METHOD_NOT_SETUP",
-	PAYMENT_METHOD_NOT_PROVIDED = "PAYMENT_METHOD_NOT_PROVIDED",
-	PAYMENT_METHOD_NOT_COMPATIBLE = "PAYMENT_METHOD_NOT_COMPATIBLE",
-	RESUME_ERROR = "RESUME_ERROR",
-	VALIDATION_ERROR = "VALIDATION_ERROR",
-	PAYMENT_FAILED = "PAYMENT_FAILED",
-	PAYMENT_CREATION_ABORTED = "PAYMENT_CREATION_ABORTED",
-	PAYMENT_CREATION_DISABLED = "PAYMENT_CREATION_DISABLED",
-	CLIENT_SESSION_UPDATE_ERROR = "CLIENT_SESSION_UPDATE_ERROR",
-	INVALID_ARGUMENT = "INVALID_ARGUMENT",
-	VAULT_FETCH = "VAULT_FETCH",
-	VAULT_DELETE = "VAULT_DELETE",
-	HEADLESS_VAULT_MANAGER_VALIDATION = "HEADLESS_VAULT_MANAGER_VALIDATION",
-	CARD_FORM_VALIDATION_UNEXPECTED_FIELD = "CARD_FORM_VALIDATION_UNEXPECTED_FIELD",
-	MISSING_FIRST_NAME_OR_LAST_NAME = "MISSING_FIRST_NAME_OR_LAST_NAME",
-	MISSING_EMAIL_ADDRESS = "MISSING_EMAIL_ADDRESS",
-	INVALID_FLOW = "INVALID_FLOW"
-}
-declare class PrimerClientError<T = unknown> extends Error {
-	readonly code: ErrorCode;
-	readonly diagnosticsId: string | null;
-	readonly data?: T;
-	readonly isFromDeveloper: boolean;
-	constructor(code: ErrorCode, options: PrimerClientErrorOptions<T>);
-	static fromErrorCode(code: ErrorCode, options: PrimerClientErrorOptions): PrimerClientError;
-}
-export interface IHeadlessHostedInput {
-	getOptions(): {
-		placeholder?: string;
-		ariaLabel?: string;
-		style?: CheckoutStyle;
+/**
+ * Vaulted payment card summary with card-specific fields.
+ */
+export interface CardVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
+	/** Discriminant for card payment instruments */
+	paymentInstrumentType: "PAYMENT_CARD";
+	/** Card-specific payment instrument data */
+	paymentInstrumentData?: {
+		/** Last 4 digits of card */
+		last4Digits?: string;
+		/** Card network (e.g., "VISA", "MASTERCARD") */
+		network?: string;
+		/** Cardholder name */
+		cardholderName?: string;
+		/** Expiration month (1-12) */
+		expirationMonth?: string;
+		/** Expiration year (e.g., "2025") */
+		expirationYear?: string;
 	};
-	setOptions(options: {
-		placeholder?: string;
-		ariaLabel?: string;
-		style?: CheckoutStyle;
-	}): void;
-	render(container: string | Element | null, options: {
-		placeholder?: string;
-		ariaLabel?: string;
-		style?: CheckoutStyle;
-	}): Promise<void>;
-	addEventListener(event: EventTypes, callback: EventListener$1): void;
-	focus(): void;
-	blur(): void;
-	setDisabled(status: boolean): void;
 }
-export interface ICardPaymentMethodManager {
-	createHostedInputs(): {
-		cardNumberInput: IHeadlessHostedInput;
-		expiryInput: IHeadlessHostedInput;
-		cvvInput: IHeadlessHostedInput;
+/**
+ * Vaulted PayPal billing agreement summary with PayPal-specific fields.
+ */
+export interface PayPalVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
+	/** Discriminant for PayPal billing agreement instruments */
+	paymentInstrumentType: "PAYPAL_BILLING_AGREEMENT";
+	/** PayPal-specific payment instrument data */
+	paymentInstrumentData?: {
+		/** External PayPal payer ID */
+		externalPayerId?: string;
+		/** PayPal account email */
+		email?: string;
+		/** First name */
+		firstName?: string;
+		/** Last name */
+		lastName?: string;
+		externalPayerInfo?: {
+			externalPayerId?: string;
+			firstName?: string;
+			lastName?: string;
+			email?: string;
+		};
+		shippingAddress?: {
+			firstName?: string;
+			lastName?: string;
+			addressLine1?: string;
+			addressLine2?: string;
+			city?: string;
+			state?: string;
+			countryCode?: string;
+			postalCode?: string;
+		};
 	};
-	setCardholderName(cardholderName: string): void;
-	removeHostedInputs(): void;
-	submit(values?: CardPaymentMethodSubmitValues): Promise<void>;
-	validate(): Promise<Validation>;
-	reset(): void;
-}
-export interface IHeadlessPaymentMethodButton {
-	render(containerId: string | Element, options: {
-		style?: Record<string, unknown>;
-	}): Promise<void>;
-	setDisabled(disabled: boolean): Promise<void>;
-	clean(): void;
-	focus(): void;
-	blur(): void;
-	addEventListener(event: EventTypes, callback: EventListener$1): void;
 }
-export interface INativePaymentMethodManager {
-	createButton(): IHeadlessPaymentMethodButton;
-}
-export interface IRedirectPaymentMethodManager {
-	start(): Promise<void>;
-	addEventListener(event: EventTypes, callback: EventListener$1): void;
-}
-export interface IKlarnaPaymentMethodManager {
-	start(paymentPayload: {
-		paymentMethodCategoryId: string;
-	}): Promise<{
-		outcome: "APPROVED" | "DENIED";
-	}>;
-	renderCategory(renderCategoryDetails: {
-		containerId: string | Element;
-		paymentMethodCategoryId: string;
-		onHeightChange: (height: number) => void;
-	}): Promise<void>;
-	addEventListener(event: EventTypes, callback: EventListener$1): void;
-	getPaymentMethod(): void;
-}
-export interface IAchPaymentMethodManager {
-	start(paymentDetails: StripeAchCustomerDetails): Promise<Validation | void>;
-	setAndValidate(paymentDetails: StripeAchCustomerDetails): Promise<Validation>;
-	collectBankAccountDetails(): Promise<void>;
-	confirmMandate(): Promise<void>;
-	declineMandate(): Promise<void>;
-	getPaymentMethod(): void;
+/**
+ * Vaulted Klarna customer token summary with Klarna-specific fields.
+ */
+export interface KlarnaVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
+	/** Discriminant for Klarna customer token instruments */
+	paymentInstrumentType: "KLARNA_CUSTOMER_TOKEN";
+	/** Klarna-specific payment instrument data */
+	paymentInstrumentData?: {
+		/** Klarna account email */
+		email?: string;
+		/** First name */
+		firstName?: string;
+		/** Last name */
+		lastName?: string;
+		/** Phone number */
+		phoneNumber?: string;
+		sessionData?: {
+			billingAddress?: {
+				firstName?: string;
+				lastName?: string;
+				email?: string;
+				phoneNumber?: string;
+				addressLine1?: string;
+				addressLine2?: string;
+				city?: string;
+				state?: string;
+				countryCode?: string;
+				postalCode?: string;
+			};
+		};
+	};
 }
-export interface IBlikPaymentMethodManager {
-	start(params: {
-		blikCode: string;
-	}): Promise<void>;
+/**
+ * Vaulted ACH (Automated Clearing House) summary with ACH-specific fields.
+ */
+export interface ACHVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
+	/** Discriminant for ACH instruments */
+	paymentInstrumentType: "AUTOMATED_CLEARING_HOUSE";
+	/** ACH-specific payment instrument data */
+	paymentInstrumentData?: {
+		/** Last 4 digits of account number */
+		accountNumberLastFourDigits?: string;
+		/** Bank name */
+		bankName?: string;
+		/** Account type (e.g., "CHECKING", "SAVINGS") */
+		accountType?: string;
+	};
 }
 /**
- * Adyen MB WAY Payment Method Manager
- *
- * Collects the user's phone number (with country prefix) inline, tokenizes
- * it, and polls the returned status URL until the user confirms the payment
- * in the MB WAY mobile app.
+ * Generic vaulted payment method summary for payment instruments
+ * not explicitly modeled with their own interface.
  */
-export interface IMbwayPaymentMethodManager {
-	start(params: {
-		phoneNumber: string;
-	}): Promise<void>;
+export interface GenericVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
+	/** Discriminant for all other payment instrument types */
+	paymentInstrumentType: Exclude<PaymentInstrumentType, "PAYMENT_CARD" | "PAYPAL_BILLING_AGREEMENT" | "KLARNA_CUSTOMER_TOKEN" | "AUTOMATED_CLEARING_HOUSE">;
+	/** Generic payment instrument data for unknown/other payment methods */
+	paymentInstrumentData?: Record<string, unknown>;
 }
 /**
- * Adyen Klarna payment option
+ * Discriminated union of all vaulted payment method summaries.
+ * Use the paymentInstrumentType field to narrow to specific types.
  */
-export interface AdyenKlarnaPaymentOption {
+export type VaultedPaymentMethodSummary = CardVaultedPaymentMethodSummary | PayPalVaultedPaymentMethodSummary | KlarnaVaultedPaymentMethodSummary | ACHVaultedPaymentMethodSummary | GenericVaultedPaymentMethodSummary;
+/**
+ * Approval state of a MANUAL attempt. `REQUIRES_APPROVAL` is pending; `APPROVED`,
+ * `ABORTED` and `EXPIRED` are terminal.
+ */
+export type AttemptApprovalStatus = "REQUIRES_APPROVAL" | "APPROVED" | "ABORTED" | "EXPIRED";
+/**
+ * The active payment attempt for a MANUAL session. Returned on the client-session
+ * response (`:pay` / session fetch) and embedded on the configuration response,
+ * letting the SDK resolve MANUAL-flow recovery without a separate session read
+ * on startup. Absent when no attempt is in flight.
+ */
+export interface CurrentAttempt {
+	/** Payment attempt identifier - required for /approve and /abort */
 	id: string;
-	label: string;
+	/** Token attached to this attempt; optional on the wire, but always set for a MANUAL attempt. */
+	paymentInstrumentTokenId?: string;
+	/** Id of the payment created once approved; absent while awaiting approval. */
+	paymentId?: string;
+	/** The attempt's approval state. */
+	approvalStatus?: AttemptApprovalStatus;
 }
 /**
- * Adyen Klarna Payment Method Manager
- *
- * Unlike direct Klarna integration, Adyen Klarna uses a redirect flow
- * with payment type selection (Pay Now, Pay Later, etc.)
+ * Data surfaced to the merchant when a MANUAL-approval `:pay` creates an
+ * attempt awaiting approval. The merchant sends clientSessionId +
+ * paymentAttemptId to its backend (which calls /approve or /abort), then calls
+ * continueFlow() to resume the SDK.
  */
-export interface IAdyenKlarnaPaymentMethodManager {
-	/**
-	 * Get available payment options
-	 */
-	getPaymentOptions(): AdyenKlarnaPaymentOption[];
-	/**
-	 * Select a payment option
-	 */
-	selectOption(optionId: string): void;
-	/**
-	 * Start the payment flow with the selected option
-	 */
-	start(): Promise<void>;
+export interface PaymentApprovalRequiredData {
+	clientSessionId: string;
+	paymentAttemptId: string;
+	/** The token tied to the attempt. */
+	paymentMethodToken: PaymentMethodToken;
+	continueFlow: () => Promise<void>;
 }
-export interface HeadlessVaultManager {
-	fetchVaultedPaymentMethods(): Promise<VaultedPaymentMethod[]>;
-	deleteVaultedPaymentMethod(id: string): Promise<void>;
-	startPaymentFlow(id: string, data?: {
-		cvv?: string;
+export interface CardNetworkDetails {
+	displayName: string;
+	network: string;
+	allowed: boolean;
+}
+export interface CardNetworks {
+	items: CardNetworkDetails[];
+	preferred?: CardNetworkDetails;
+}
+export interface CardNetworkChangeEvent {
+	detectedCardNetworks: CardNetworks;
+	selectableCardNetworks?: CardNetworks;
+	source: "REMOTE" | "LOCAL" | "LOCAL_FALLBACK";
+}
+export interface BinDataDetails extends CardNetworkDetails {
+	issuerCountryCode?: string;
+	issuerName?: string;
+	accountFundingType?: string;
+	prepaidReloadableIndicator?: string;
+	productUsageType?: string;
+	productCode?: string;
+	productName?: string;
+	issuerCurrencyCode?: string;
+	regionalRestriction?: string;
+	accountNumberType?: string;
+}
+export interface BinDataAvailableEvent {
+	preferred?: BinDataDetails;
+	alternatives: BinDataDetails[];
+	status: "complete" | "partial";
+	firstDigits?: string;
+}
+export interface HostedInput {
+	cleanup: () => void;
+	getOptions: () => HeadlessHostedInputOptions;
+	setOptions: (options: HeadlessHostedInputOptions) => void;
+	render: (container: string | Element, options: HeadlessHostedInputOptions) => Promise<void>;
+	addEventListener: (event: EventTypes, callback: EventListener$1) => void;
+	focus: () => void;
+	blur: () => void;
+	setDisabled: (status: boolean) => void;
+}
+export interface HostedInputs {
+	cardNumberInput: HostedInput;
+	cardholderNameInput: HostedInput;
+	expiryInput: HostedInput;
+	cvvInput: HostedInput;
+}
+export interface InputValidationError {
+	field?: string;
+	name: string;
+	error: string;
+	message: string;
+}
+export interface Validation {
+	valid: boolean;
+	validationErrors: InputValidationError[];
+	error?: string;
+}
+export interface CardPaymentMethodManager {
+	createHostedInputs: () => HostedInputs;
+	removeHostedInputs: () => void;
+	submit: (values?: CardPaymentMethodSubmitValues) => Promise<void>;
+	validate: () => Promise<Validation>;
+	reset: () => void;
+	setCardholderName: (cardholderName: string) => void;
+}
+export interface MbwayPaymentMethodManager {
+	start(params: {
+		phoneNumber: string;
 	}): Promise<void>;
-	createCvvInput(options: CardSecurityCodeInputOptions): Promise<CvvInput | null>;
 }
-export interface IAssetsManager {
-	getCardNetworkAsset(cardNetwork: string): Promise<{
-		cardUrl: string;
-		displayName: string;
-	}>;
-	getPaymentMethodAsset(type: PaymentMethodType): Promise<{
-		backgroundColor: BackgroundColor;
-		iconUrl: IconUrl;
-		paymentMethodName?: string;
-		buttonText?: string;
-		displayName?: string;
-	} | null>;
+export interface BlikPaymentMethodManager {
+	start(params: {
+		blikCode: string;
+	}): Promise<void>;
+}
+export interface StripeAchCustomerDetails {
+	emailAddress: string;
+	firstName: string;
+	lastName: string;
+}
+export interface AchPaymentMethodManager {
+	start(paymentDetails: StripeAchCustomerDetails): Promise<Validation | void>;
+	setAndValidate(paymentDetails: StripeAchCustomerDetails): Promise<Validation>;
+	collectBankAccountDetails(): Promise<void>;
+	confirmMandate(): Promise<void>;
+	declineMandate(): Promise<void>;
+	getPaymentMethod(): void;
 }
-export interface CheckoutModuleConfig {
-	type: string;
-	options?: Record<string, unknown>;
+export interface NativePaymentMethodManager {
+	createButton: () => {
+		render: (container: HTMLElement, buttonOptions?: PaymentRenderButtonOptions) => Promise<void>;
+		setDisabled(disabled: boolean): Promise<void>;
+	};
 }
-export interface ClientConfiguration {
-	binDataUrl: string;
-	checkoutModules?: CheckoutModuleConfig[];
-	clientSession: ClientSession;
-	coreUrl: string;
-	env: string;
-	paymentMethods: PaymentMethodConfig[];
-	pciUrl: string;
-	primerAccountId: string;
-	settleOnAuth?: boolean;
+export interface RedirectPaymentMethodManager {
+	start: () => Promise<void>;
+}
+/**
+ * QRCode Payment Method Manager
+ */
+export interface QRCodePaymentMethodManager {
+	/**
+	 * Start the payment flow, optionally providing a callback for when the QR code is received
+	 * @param params Optional parameters, including onQRCodeReceived callback
+	 */
+	start(params?: {
+		onQRCodeReceived?: (qrCode: string) => void;
+	}): Promise<void>;
+	/**
+	 * Stop the payment flow
+	 */
+	stop(): void;
 }
-export interface HeadlessSDKUtilities {
-	getCardNetworkAsset(network: string): {
+export type PaymentMethodManager = CardPaymentMethodManager | NativePaymentMethodManager | RedirectPaymentMethodManager | KlarnaPaymentMethodManager | QRCodePaymentMethodManager;
+export interface SDKUtilities {
+	getCardNetworkAsset: (network: string) => {
 		cardUrl: string;
 		displayName: string;
 	};
-	getUIOrderAmount(): string | null;
-	getCDNAssets(paymentMethodType: PaymentMethodType): Promise<{
+	getUIOrderAmount: () => string | null;
+	getCDNAssets: (paymentType: PaymentMethodType) => Promise<{
 		assets: {
 			icon: string;
 		};
@@ -1192,88 +1177,11 @@ export interface HeadlessSDKUtilities {
 		website: string | null;
 		goatCdnUrl: string;
 	} | undefined>;
-	getPaymentMethodConfiguration(paymentMethodType: PaymentMethodType): PaymentMethodConfig | undefined;
-	setBillingAddress(address: NullableAddress): Promise<void>;
-}
-export interface CardPaymentMethodManagerOptions {
-	onBinDataAvailable?: (event: BinDataAvailableEvent) => void;
-	onBinDataLoadingChange?: (loading: boolean) => void;
-	onCardMetadataChange?: (metadata: {
-		type: CardNetworkType | null;
-		possibleTypes: string[];
-		cvvLength: number;
-		cardNumberLength: number;
-	}) => void;
-	onCardNetworksChange?: (event: CardNetworkChangeEvent) => void;
-	onCardNetworksLoading?: () => void;
-}
-export interface KlarnaPaymentMethodManagerOptions {
-	onPaymentMethodCategoriesChange?: (paymentMethodCategories: KlarnaPaymentMethodCategory[]) => void;
-	onPaymentMethodAction?: (action: string, data: {
-		paymentMethodType: string;
-		category: string;
-	}) => void;
-}
-export interface AchPaymentMethodManagerOptions {
-	onCollectBankAccountDetailsComplete?: () => void;
-}
-export interface AdyenKlarnaPaymentMethodManagerOptions {
-	onPaymentOptionsChange?: (options: AdyenKlarnaPaymentOption[]) => void;
-}
-export type PaymentMethodManagerOptions = CardPaymentMethodManagerOptions | KlarnaPaymentMethodManagerOptions | AdyenKlarnaPaymentMethodManagerOptions | AchPaymentMethodManagerOptions;
-export interface CheckoutStyle {
-	fontFaces?: Array<{
-		fontFamily?: string;
-		src?: string;
-		unicodeRange?: string;
-		fontVariant?: string;
-		fontFeatureSettings?: string;
-		fontVariationSettings?: string;
-		fontStretch?: string;
-		fontWeight?: string;
-		fontStyle?: string;
-	}>;
-	stylesheets?: Array<{
-		href: string;
-	}>;
-	loadingScreen?: {
-		color?: string;
-	};
-	input?: InputStyles;
-	inputLabel?: Record<string, unknown>;
-	inputErrorText?: Record<string, unknown>;
-	formSpacings?: {
-		betweenLabelAndInput?: string;
-		betweenInputs?: string;
-	};
-	showMorePaymentMethodsButton?: Record<string, unknown>;
-	networkError?: Record<string, unknown>;
-	submitButton?: Record<string, unknown>;
-	vaultTitle?: Record<string, unknown>;
-	savedPaymentMethodButton?: Record<string, unknown>;
-	paymentMethodButton?: Record<string, unknown>;
-	errorMessage?: Record<string, unknown>;
-	smallPrint?: Record<string, unknown>;
-	directDebit?: Record<string, unknown>;
-	vaultMenu?: Record<string, unknown>;
-	backButton?: Record<string, unknown>;
-	separator?: Record<string, unknown>;
-	processingIndicator?: Record<string, unknown>;
-	focusCheckoutOnInit?: boolean;
-}
-interface ThreeDSAuthenticationData$1 {
-	responseCode: "AUTH_SUCCESS" | "AUTH_FAILED" | "SKIPPED" | "CHALLENGE";
-	reasonCode?: string;
-	reasonText?: string;
-	protocolVersion: string;
-	challengeIssued: boolean;
-}
-export interface VaultData {
-	customerId: string;
+	getPaymentMethodConfiguration: (paymentType: PaymentMethodType) => PaymentMethodConfig | undefined;
+	setBillingAddress: (address: NullableAddress) => Promise<void>;
 }
-type EventListener$1 = (event?: Event) => void;
 export interface AnalyticsUtils {
-	environment: string;
+	environment: AnalyticsEnvironment;
 	primerAccountId?: string;
 	checkoutSessionId: string;
 	clientSessionId?: string;
@@ -1283,254 +1191,170 @@ export interface AnalyticsUtils {
 	configurationFetchStartTime?: number;
 }
 export interface PrimerHeadlessCheckout {
-	createPaymentMethodManager(type: "PAYMENT_CARD", options?: PaymentMethodManagerOptions): Promise<ICardPaymentMethodManager | null>;
-	createPaymentMethodManager(type: "PAYPAL" | "GOOGLE_PAY" | "APPLE_PAY", options?: PaymentMethodManagerOptions): Promise<INativePaymentMethodManager | null>;
-	createPaymentMethodManager(type: "STRIPE_ACH", options?: AchPaymentMethodManagerOptions): Promise<IAchPaymentMethodManager | null>;
-	createPaymentMethodManager(type: "KLARNA", options?: PaymentMethodManagerOptions): Promise<IKlarnaPaymentMethodManager | null>;
-	createPaymentMethodManager(type: "ADYEN_KLARNA", options?: AdyenKlarnaPaymentMethodManagerOptions): Promise<IAdyenKlarnaPaymentMethodManager | null>;
-	createPaymentMethodManager(type: PaymentMethodType, options?: PaymentMethodManagerOptions): Promise<IRedirectPaymentMethodManager | null>;
-	createVaultManager(): HeadlessVaultManager;
-	getSDKUtilities(): HeadlessSDKUtilities;
-	getAnalyticsUtils?: () => AnalyticsUtils;
-	configure?: (options: Omit<HeadlessUniversalCheckoutOptions, "clientSessionCachingEnabled">) => void;
-	getAssetsManager(): IAssetsManager;
 	start: () => Promise<void>;
-	refreshClientSession(): Promise<boolean>;
-	getConfiguration(): ClientConfiguration;
-	teardown?: () => void;
+	createPaymentMethodManager: (type: string, managerOptions?: PaymentMethodManagerOptions) => Promise<PaymentMethodManager | null>;
+	getSDKUtilities: () => SDKUtilities;
+	getAnalyticsUtils?: () => AnalyticsUtils;
+	createVaultManager: () => HeadlessVaultManager;
+	getAssetsManager: () => unknown;
+	refreshClientSession: () => Promise<boolean>;
+	teardown: () => void;
+	getConfiguration: () => ClientConfiguration;
 }
-export interface HeadlessUniversalCheckoutOptions {
-	style?: CheckoutStyle;
-	paymentHandling?: "AUTO" | "MANUAL";
-	locale?: string;
+/**
+ * Dialog display request containing content and coordination callbacks
+ */
+export interface DialogRequest {
+	/**
+	 * HTML content to display (3DS forms, iframes, etc.)
+	 */
+	htmlContent: Element;
+	/**
+	 * Called when DOM content is fully rendered and ready
+	 * SDK Core uses this for form submission, iframe setup, etc.
+	 */
+	onContentReady?: () => void;
+	/**
+	 * Wether the dialog should show a close button
+	 * @default false
+	 */
+	showCloseButton?: boolean;
+	/**
+	 * Size of the dialog
+	 * @default 'large'
+	 */
+	size?: "flex" | "large";
+	/**
+	 * Optional call-to-action (CTA) button configuration
+	 */
+	cta?: {
+		label: string;
+		onClick: (event: MouseEvent) => void;
+		icon?: string;
+	};
+}
+/**
+ * Result of dialog interaction
+ */
+export interface DialogResult {
+	/**
+	 * Whether the dialog completed successfully
+	 * false indicates user cancellation/dismissal
+	 */
+	success: boolean;
+}
+/**
+ * 3DS challenge display request. The dialog provider dispatches an event with
+ * `url`/`width`/`height` so merchants can render the challenge themselves
+ * (e.g. by pointing an iframe at `url`). If no merchant intercepts, the
+ * provider falls back to rendering `htmlContent` in its default dialog.
+ */
+export interface ThreeDsChallengeRequest {
+	url: string;
+	width: number;
+	height: number;
+	/** Pre-built DOM the provider renders when no merchant intercepts the event. */
+	htmlContent: Element;
+	/** Called by the provider once `htmlContent` is mounted. */
+	onContentReady?: () => void;
+}
+/**
+ * DialogProvider interface for SDK Core dialog abstraction
+ * Enables merchants to integrate any dialog implementation
+ */
+export interface DialogProvider {
+	/**
+	 * Display dialog content and coordinate with SDK Core
+	 * @param request Dialog display request
+	 * @returns Promise resolving when user completes or cancels flow
+	 */
+	show(request: DialogRequest): Promise<DialogResult>;
+	/**
+	 * Programmatically close the dialog
+	 * Called by SDK Core when background processes complete
+	 */
+	close(): void;
+	/**
+	 * Display a 3DS challenge by URL. Implementations are expected to give the
+	 * merchant a chance to render their own dialog/tab (e.g. by dispatching a
+	 * `primer:3ds-challenge` DOM event) and fall back to a built-in dialog when
+	 * the merchant does not handle it.
+	 */
+	show3dsChallenge(request: ThreeDsChallengeRequest): Promise<DialogResult>;
+	/**
+	 * Close the 3DS challenge dialog and signal completion to merchant
+	 * listeners (e.g. by dispatching `primer:3ds-challenge-completed`).
+	 */
+	close3dsChallenge(): void;
+}
+export interface CreateHeadlessOptions {
+	enabledPaymentMethods?: PaymentMethodType[];
+	cardholderName?: {
+		required?: boolean;
+		visible?: boolean;
+		/**
+		 * Pre-fills the cardholder name field with the specified value.
+		 * Value is applied synchronously during iframe initialization (no race conditions).
+		 * User can edit or clear the pre-filled value.
+		 *
+		 * @example "John Doe"
+		 */
+		defaultValue?: string;
+	};
+	/**
+	 * Google Pay client-side options.
+	 */
+	googlePay?: GooglePayClientOptions;
 	card?: {
 		cardholderName?: {
 			required?: boolean;
 			visible?: boolean;
 			placeholder?: string;
+			/**
+			 * Pre-fills the cardholder name field with the specified value.
+			 * Value is applied synchronously during iframe initialization (no race conditions).
+			 * User can edit or clear the pre-filled value.
+			 *
+			 * @example "John Doe"
+			 */
+			defaultValue?: string;
 		};
-		cardNumber?: {
-			placeholder?: string;
-		};
-		expiryDate?: {
-			placeholder?: string;
-		};
-		cvv?: {
-			placeholder?: string;
-		};
-		preferredFlow?: CardPreferredFlow;
-	};
-	redirect?: {
-		returnUrl?: string;
-		forceRedirect?: boolean;
 	};
-	paypal?: PayPalOptions;
-	googlePay?: GooglePayOptions;
-	applePay?: ApplePayOptions;
-	adyenKlarna?: {
+	paypal?: PayPalOptionsWithPaypalJsTypes;
+	applePay?: LegacyApplePayOptions & ApplePayClientOptions;
+	klarna?: {
+		paymentFlow?: "DEFAULT" | "PREFER_VAULT";
+		recurringPaymentDescription?: string;
+		allowedPaymentCategories?: Array<"pay_now" | "pay_later" | "pay_over_time">;
 		buttonOptions?: {
 			text?: string;
 		};
 	};
-	klarna?: KlarnaOptions;
-	directDebit?: {
-		customerCountryCode: string;
-		companyName: string;
-		companyAddress: string;
-		customerName?: string;
-		customerEmail?: string;
-		customerAddressLine1?: string;
-		customerAddressLine2?: string;
-		customerCity?: string;
-		customerPostalCode?: string;
-		iban?: string;
-		submitButtonLabels?: {
-			form?: string;
-			mandate: string;
+	adyenKlarna?: {
+		buttonOptions?: {
+			text?: string;
 		};
 	};
-	giftCard?: {
-		logoSrc: string;
-		background: string;
-		logoAlt?: string;
-		text?: string;
-	};
-	stripe?: {
-		publishableKey?: string;
-		mandateData?: {
-			fullMandateText?: string;
-			merchantName?: string;
-		};
-	} & Record<string, unknown>;
-	onAvailablePaymentMethodsLoad: (paymentMethods: PaymentMethodInfo[]) => void;
+	locale?: string;
 	/**
-	 * Fires after each successful `refreshClientSession` when the available
-	 * payment methods changed as a result of the backend re-evaluating
-	 * visibility rules against the updated client session metadata.
+	 * Optional translation function for localizing strings.
+	 * When provided, sdk-core will use this to translate labels (e.g., Google Pay display items).
 	 */
-	onAvailablePaymentMethodsRefresh?: (paymentMethods: PaymentMethodInfo[]) => void;
-	clientSessionCachingEnabled?: boolean;
-	apiVersion?: APIVersionOption;
-	onCheckoutComplete?: (data: {
-		payment: Payment | null;
-	}) => void;
-	onCheckoutFail?: (error: PrimerClientError, data: {
-		payment?: Payment;
-	}, handler?: {
-		showErrorMessage: (errorMessage?: string) => void;
-	}) => void;
-	onBeforePaymentCreate?: (data: {
-		paymentMethodType?: PaymentMethodType;
-	}, handler: {
-		continuePaymentCreation: (data?: {
-			idempotencyKey?: string;
-		}) => void;
-		abortPaymentCreation: () => void;
-	}) => void;
-	onPaymentCreationStart?: () => void;
-	onPaymentApprovalRequired?: (data: PaymentApprovalRequiredData) => void;
-	onPaymentMethodAction?: (data: "PAYMENT_METHOD_SELECTED" | "PAYMENT_METHOD_UNSELECTED", handler: {
-		payment?: Payment;
-		paymentMethodType: PaymentMethodType | null;
-	}) => void;
-	onClientSessionUpdate?: (clientSession: ClientSession) => void;
-	onBeforeClientSessionUpdate?: () => void;
-	onTokenizeShouldStart?: (data: {
-		paymentMethodType?: PaymentMethodType;
-	}) => boolean | Promise<boolean>;
-	onTokenizeDidNotStart?: (reason: string) => void;
-	onTokenizeStart?: () => void;
-	onTokenizeSuccess?: (data: PaymentMethodToken$1, handler: {
-		handleSuccess(): unknown;
-		handleFailure(errorMessage?: string): unknown;
-		continueWithNewClientToken(clientToken: string): unknown;
-	}) => void | Promise<void>;
-	onTokenizeError?: (error: PrimerClientError) => void;
-	onResumeSuccess?: (data: {
-		resumeToken: string;
-		paymentId?: string;
-	}, handler: {
-		handleSuccess(): unknown;
-		handleFailure(errorMessage?: string): unknown;
-		continueWithNewClientToken(clientToken: string): unknown;
-	}) => void;
-	onResumePending?: (paymentMethodData: {
-		paymentMethodType: PaymentMethodType;
-		reference?: string;
-		expiresAt?: string;
-		entity?: string;
-	}) => void;
-	onResumeError?: (error: PrimerClientError) => void;
-}
-interface PaymentMethodToken$1 {
-	token: string;
-	analyticsId: string;
-	tokenType: "SINGLE_USE" | "MULTI_USE";
-	paymentInstrumentData: BasePaymentInstrumentData;
-	paymentInstrumentType: PaymentInstrumentType;
-	threeDSecureAuthentication: ThreeDSAuthenticationData$1 | null;
-	vaultData: VaultData | null;
-}
-export interface ApplePayOptions {
-	container?: string | Element;
-	buttonType?: "plain" | "buy" | "set-up" | "donate" | "check-out" | "book" | "subscribe";
-	buttonStyle?: "white" | "white-outline" | "black";
-	captureBillingAddress?: boolean;
-	billingOptions?: {
-		requiredBillingContactFields?: Array<"emailAddress" | "name" | "phoneNumber" | "postalAddress" | "phoneticName">;
-	};
-	shippingOptions?: {
-		requiredShippingContactFields?: Array<"emailAddress" | "name" | "phoneNumber" | "postalAddress" | "phoneticName">;
-		requireShippingMethod?: boolean;
-	};
-}
-export interface GooglePayOptions {
-	container?: string | Element;
-	buttonType?: "long" | "short" | "book" | "buy" | "checkout" | "donate" | "order" | "pay" | "plain" | "subscribe";
-	buttonColor?: "default" | "black" | "white";
-	buttonSizeMode?: "fill" | "static";
-	onClick?: () => void;
-	captureBillingAddress?: boolean;
-	shippingAddressParameters?: {
-		phoneNumberRequired?: boolean;
-	};
-	emailRequired?: boolean;
-	requireShippingMethod?: boolean;
-	shadowRoot?: boolean;
-}
-export interface PayPalOptions {
-	container?: string | Element;
-	buttonColor?: "gold" | "blue" | "silver" | "white" | "black";
-	buttonShape?: "pill" | "rect";
-	buttonSize?: "small" | "medium" | "large" | "responsive";
-	buttonHeight?: number;
-	buttonLabel?: "checkout" | "credit" | "pay" | "buynow" | "paypal" | "installment";
-	buttonTagline?: boolean;
-	paymentFlow?: "DEFAULT" | "PREFER_VAULT";
-	onClick?: () => void;
-}
-export interface KlarnaOptions {
-	paymentFlow?: "DEFAULT" | "PREFER_VAULT";
-	recurringPaymentDescription?: string;
-	allowedPaymentCategories?: Array<"pay_now" | "pay_later" | "pay_over_time">;
-	buttonOptions?: {
-		text?: string;
-	};
-}
-/**
- * PrimerCheckoutOptions defines the configuration options for the Primer checkout.
- * This is an explicit definition of the options rather than a mapped type to make
- * the type more predictable and easier to maintain.
- */
-export interface PrimerCheckoutOptions {
-	clientToken?: string;
+	translate?: TranslateFunction;
 	/**
-	 * Sets the localization language for SDK UI text, validation messages, and country names.
-	 *
-	 * Supports standard locale codes in the format `language-COUNTRY` (e.g., `'en-US'`, `'fr-FR'`).
-	 * If an unsupported locale is provided, falls back to `'en-GB'` with a console warning.
-	 *
-	 * Supported locales: `ar`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `en-GB`, `es`, `es-AR`, `es-MX`,
-	 * `et-EE`, `fi-FI`, `fr`, `he`, `hr`, `hu`, `id`, `it`, `ja`, `ko`, `lt`, `lt-LT`, `lv`, `lv-LV`,
-	 * `ms`, `nb`, `nl`, `nl_NL`, `pl`, `pt`, `pt-BR`, `ro`, `ru`, `sk`, `sl`, `sr-RS`, `sv`, `th`,
-	 * `tr`, `uk-UA`, `vi`, `zh`, `zh-TW`
-	 *
-	 * @default 'en-GB'
-	 * @example
-	 * ```typescript
-	 * // French localization
-	 * { locale: 'fr-FR' }
-	 *
-	 * // Spanish (Mexico)
-	 * { locale: 'es-MX' }
-	 * ```
+	 * Dialog implementation for 3DS and redirect flows
+	 * Required for SDK Core operation
 	 */
-	locale?: string;
-	apiVersion?: APIVersionOption;
+	dialogProvider: DialogProvider;
+	sdkVersion?: string;
+	integrationType?: string;
 	/**
-	 * Specifies the merchant's domain for Apple Pay domain validation.
-	 * If not provided, defaults to window.location.hostname.
-	 * This is particularly useful when the checkout is hosted on a different domain
-	 * than the merchant's registered Apple Pay domain.
-	 *
-	 * @default window.location.hostname
+	 * Merchant domain for Apple Pay integration
+	 * Required if the SDK is rendered inside an iframe
 	 */
 	merchantDomain?: string;
 	/**
-	 * Configuration for redirect-based payment methods.
-	 *
-	 * Controls the return URL behavior for payment methods that require a redirect
-	 * to an external page (e.g. PayPal, Klarna, and most APMs), whether to force
-	 * a full-page redirect instead of opening the flow in a popup where supported,
-	 * and how to handle users closing the redirect popup.
-	 *
-	 * @example
-	 * ```typescript
-	 * redirect: {
-	 *   returnUrl: 'https://merchant.example.com/checkout/return',
-	 *   forceRedirect: true,
-	 * }
-	 * ```
+	 * Redirect options
 	 */
 	redirect?: {
 		/**
@@ -1541,233 +1365,136 @@ export interface PrimerCheckoutOptions {
 		 * redirect the customer to an external page. The SDK throws at initialization
 		 * if a redirect-capable payment method is enabled and this is
 		 * missing.
-		 *
-		 * **Setting up the return page**
-		 *
-		 * The URL you provide must host a page that mounts the
-		 * `<primer-checkout>` component again so the payment can be
-		 * resumed. Primer redirects the customer back with a new client
-		 * token appended as a `clientToken` query parameter — read it
-		 * from the URL and pass it to the component:
-		 *
-		 * ```html
-		 * <primer-checkout client-token=""></primer-checkout>
-		 * <script>
-		 *   const clientToken = new URLSearchParams(window.location.search)
-		 *     .get('clientToken');
-		 *   document
-		 *     .querySelector('primer-checkout')
-		 *     .setAttribute('client-token', clientToken);
-		 * </script>
-		 * ```
-		 *
-		 * The SDK reads the intent embedded in the token, detects that
-		 * this is a return-from-redirect, and resumes the payment
-		 * automatically — no separate method call is required.
-		 *
 		 */
 		returnUrl: string;
 		/**
-		 * Whether to force a full-page redirect for payment methods that would
-		 * otherwise open in a popup.
-		 *
+		 * Force redirect flow for all supported payment methods
 		 * @default false
 		 */
 		forceRedirect?: boolean;
-	};
-	/**
-	 * Configuration for card payment method options.
-	 * Controls the display and validation of card form fields.
-	 */
-	card?: {
 		/**
-		 * Configuration for the cardholder name input field.
+		 * Whether to try resuming the payment when the redirect popup is closed by the user.
+		 * If false, the payment method will be deselected, allowing the user to select a different payment method.
+		 * @default false
 		 */
-		cardholderName?: {
-			/**
-			 * Whether the cardholder name field is required for form validation.
-			 * When true, form submission is blocked until a valid name is entered.
-			 *
-			 * Note: When using legacy SDK (`sdkCore: false`) with `visible: false`,
-			 * this is automatically set to `false` for compatibility.
-			 *
-			 * @default false
-			 */
-			required?: boolean;
-			defaultValue?: string;
-			/**
-			 * Whether the cardholder name field is visible in the card form.
-			 * When false, the field is hidden and not included in validation.
-			 *
-			 * @default true
-			 */
-			visible?: boolean;
-		};
+		resumePaymentOnPopupClosure?: boolean;
 	};
 	/**
-	 * Configuration options for Apple Pay button and payment flow.
-	 *
-	 * Controls button appearance, billing/shipping contact field collection,
-	 * and shipping method requirements. The SDK manages button rendering automatically,
-	 * so the `container` property is omitted from this configuration.
-	 *
-	 * @see ApplePayOptions - Full type definition in compatibility-types.ts
-	 * @example
-	 * ```typescript
-	 * applePay: {
-	 *   buttonStyle: 'black',
-	 *   buttonType: 'buy',
-	 *   billingOptions: {
-	 *     requiredBillingContactFields: ['postalAddress', 'emailAddress']
-	 *   },
-	 *   shippingOptions: {
-	 *     requiredShippingContactFields: ['postalAddress', 'name'],
-	 *     requireShippingMethod: true
-	 *   }
-	 * }
-	 * ```
+	 * Fires once at SDK init with the initial set of available payment methods.
 	 */
-	applePay?: Omit<ApplePayOptions, "container"> & {
-		/**
-		 * @deprecated Use `billingOptions.requiredBillingContactFields: ['postalAddress']` instead.
-		 *
-		 * Legacy option to capture billing address for Apple Pay.
-		 * This property is maintained for backward compatibility.
-		 */
-		captureBillingAddress?: boolean;
-		/**
-		 * Billing contact field configuration for Apple Pay.
-		 */
-		billingOptions?: {
-			/**
-			 * Array of billing contact fields required for checkout.
-			 *
-			 * Valid values: `'emailAddress'`, `'name'`, `'phoneNumber'`, `'postalAddress'`, `'phoneticName'`
-			 *
-			 * @example ['postalAddress', 'emailAddress']
-			 */
-			requiredBillingContactFields?: Array<"emailAddress" | "name" | "phoneNumber" | "postalAddress" | "phoneticName">;
-		};
-		/**
-		 * Shipping contact field and method configuration for Apple Pay.
-		 */
-		shippingOptions?: {
-			/**
-			 * Array of shipping contact fields required for checkout.
-			 *
-			 * Valid values: `'emailAddress'`, `'name'`, `'phoneNumber'`, `'postalAddress'`, `'phoneticName'`
-			 *
-			 * @example ['postalAddress', 'name', 'phoneNumber']
-			 */
-			requiredShippingContactFields?: Array<"emailAddress" | "name" | "phoneNumber" | "postalAddress" | "phoneticName">;
-			/**
-			 * Whether to require shipping method selection during Apple Pay checkout.
-			 *
-			 * When true, customer must select a shipping method before completing payment.
-			 *
-			 * @default false
-			 */
-			requireShippingMethod?: boolean;
-		};
-	};
+	onAvailablePaymentMethodsLoad?: (info: PaymentMethodInfo[]) => void;
+	/**
+	 * Fires after each successful `refreshClientSession` when the available
+	 * payment methods have changed (added or removed) as a result of the backend
+	 * re-evaluating visibility rules against the updated client session metadata.
+	 * The `info` array reflects the current set in backend order.
+	 */
+	onAvailablePaymentMethodsRefresh?: (info: PaymentMethodInfo[]) => void;
+	onCheckoutComplete?: (data: {
+		payment: Payment | null;
+	}) => void;
+	onCheckoutFail?: (error: SdkError, data: {
+		payment?: Payment;
+	}, handler?: {
+		showErrorMessage: (errorMessage?: string) => void;
+	}) => void;
+	onBeforePaymentCreate?: (data: {
+		paymentMethodType?: PaymentMethodType;
+	}, handler: {
+		continuePaymentCreation: (data?: {
+			idempotencyKey?: string;
+		}) => void;
+		abortPaymentCreation: () => void;
+	}) => void;
+	onPaymentMethodAction?: (data: "PAYMENT_METHOD_SELECTED" | "PAYMENT_METHOD_UNSELECTED", handler: {
+		paymentMethodType: PaymentMethodType | null;
+		payment?: Payment;
+	}) => void;
+	onPaymentCreationStart?: () => void;
+	onClientSessionUpdate?: (data: ClientConfiguration["clientSession"]) => void;
+	/**
+	 * MANUAL approval flow: invoked when `:pay` returns 202 and the attempt is
+	 * awaiting merchant approval. The merchant sends clientSessionId +
+	 * paymentAttemptId to its backend (which calls /approve or /abort), then
+	 * calls continueFlow() to resume the SDK.
+	 */
+	onPaymentApprovalRequired?: (data: PaymentApprovalRequiredData) => void;
 	/**
-	 * Options for using gift cards as a payment method
+	 * MANUAL approval recovery: invoked on init when an in-flight attempt is found
+	 * on the configuration response (i.e. the checkout is resuming after a refresh
+	 * / tab reload), before the recovery does any async work. The host uses this
+	 * to enter its processing state so the loading UI persists while the outcome
+	 * is resolved. Not fired for a fresh checkout (no attempt in flight).
 	 */
+	onCheckoutResume?: () => void;
+}
+export interface KlarnaPaymentMethodCategory {
+	id: string;
+	name: string;
+	descriptiveAssetUrl: string;
+	standardAssetUrl: string;
+}
+export interface CardSecurityCodeInputOptions {
+	ariaLabel?: string;
+	container: string | Element | HTMLElement;
+	id?: string;
+	name?: string;
+	placeholder?: string;
+	placement?: "append" | "prepend";
+	properties?: unknown;
+	style?: any;
+	cardNetwork?: string;
+}
+export interface InputMetadata {
+	errorCode: string | null;
+	error: string | null;
+	valid: boolean;
+	active: boolean;
+	dirty: boolean;
+	touched: boolean;
+	submitted: boolean;
+}
+export interface PrimerCheckoutOptions extends Omit<CreateHeadlessOptions, "dialogProvider"> {
 	giftCard?: {
-		/**
-		 * The source URL of the button logo.
-		 */
 		logoSrc: string;
-		/**
-		 * The background color of the button.
-		 */
 		background: string;
-		/**
-		 * An alternative text for the button logo.
-		 */
 		logoAlt?: string;
-		/**
-		 * The text to display on the button.
-		 */
 		text?: string;
 	};
 	/**
-	 * Configuration options for Google Pay button and payment flow.
-	 *
-	 * When `sdkCore: true` (default), uses `GooglePayClientOptions` from SDK Core with
-	 * full express checkout support including:
-	 * - Button customization (`buttonType`, `buttonColor`, `buttonSizeMode`, `buttonRadius`, `buttonLocale`)
-	 * - Billing/shipping address capture
-	 * - Email collection
-	 * - Shipping method selection
-	 *
-	 * When `sdkCore: false`, uses legacy `GooglePayOptions` with basic button styling.
-	 *
-	 * @example
-	 * ```typescript
-	 * // SDK Core mode (recommended)
-	 * googlePay: {
-	 *   buttonType: 'checkout',
-	 *   buttonColor: 'white',
-	 *   buttonSizeMode: 'fill',
-	 *   buttonRadius: 8,
-	 *   captureBillingAddress: true,
-	 *   captureShippingAddress: true,
-	 *   emailRequired: true,
-	 *   requireShippingMethod: true,
-	 * }
-	 *
-	 * // Legacy mode (sdkCore: false)
-	 * googlePay: {
-	 *   buttonType: 'buy',
-	 *   buttonColor: 'black',
-	 *   captureBillingAddress: true,
-	 * }
-	 * ```
-	 */
-	googlePay?: GooglePayClientOptions | Omit<GooglePayOptions, "container">;
-	/**
-	 * Configuration options for PayPal button and payment flow.
-	 *
-	 * Controls button styling, size, and payment flow behavior.
-	 * The SDK manages button rendering automatically, so the `container`
-	 * property is omitted from this configuration.
-	 *
-	 * @see PayPalOptions - Full type definition in compatibility-types.ts
-	 * @example
-	 * ```typescript
-	 * paypal: {
-	 *   buttonColor: 'gold',
-	 *   buttonShape: 'pill',
-	 *   buttonLabel: 'pay',
-	 *   paymentFlow: 'PREFER_VAULT'
-	 * }
-	 * ```
-	 */
-	paypal?: Omit<PayPalOptions, "container">;
-	/**
-	 * Configuration options for Klarna payment method.
-	 *
-	 * Controls payment flow, allowed payment categories (pay now/later/over time),
-	 * and button customization for Klarna installment payments.
-	 *
-	 * @see KlarnaOptions - Full type definition in compatibility-types.ts
-	 * @example
-	 * ```typescript
-	 * klarna: {
-	 *   paymentFlow: 'DEFAULT',
-	 *   allowedPaymentCategories: ['pay_now', 'pay_later'],
-	 *   buttonOptions: {
-	 *     text: 'Pay with Klarna'
-	 *   }
-	 * }
-	 * ```
+	 * Configuration for the submit button behavior in Primer.js components.
 	 */
-	klarna?: KlarnaOptions;
-	adyenKlarna?: {
-		buttonOptions?: {
-			text?: string;
-		};
+	submitButton?: {
+		/**
+		 * Whether to show the order amount on the submit button.
+		 * When true, displays formatted amount next to button text (e.g., "Pay $12.34").
+		 * @default false
+		 */
+		amountVisible?: boolean;
+		/**
+		 * Whether to render the built-in submit button component.
+		 *
+		 * When `true` (default): The component renders the standard Primer submit button.
+		 * When `false`: No DOM elements are created, allowing external buttons to handle
+		 * form submission by dispatching the 'primer:card-submit' event.
+		 *
+		 * @example
+		 * // Hide built-in button and use external button
+		 * const options = {
+		 *   submitButton: {
+		 *     useBuiltInButton: false
+		 *   }
+		 * };
+		 *
+		 * // External button should dispatch this event to submit
+		 * const submitEvent = new CustomEvent('primer:card-submit', {
+		 *   bubbles: true,
+		 *   composed: true
+		 * });
+		 *
+		 * @default true
+		 */
+		useBuiltInButton?: boolean;
 	};
 	/**
 	 * Configuration for payment method vaulting (save for later use).
@@ -1839,105 +1566,6 @@ export interface PrimerCheckoutOptions {
 		 */
 		headless?: boolean;
 	};
-	/**
-	 * Configuration options for Stripe ACH payment method.
-	 *
-	 * Provides Stripe-specific settings for ACH bank account payments,
-	 * including mandate text and authorization requirements.
-	 *
-	 * Note: Only applicable when Stripe ACH is enabled as a payment method.
-	 */
-	stripe?: {
-		/**
-		 * Mandate data for ACH authorization and compliance.
-		 *
-		 * ACH payments require customer authorization (mandate) for bank account debits.
-		 * This configuration controls the mandate text displayed to customers.
-		 */
-		mandateData: {
-			/**
-			 * Custom mandate text for ACH authorization.
-			 *
-			 * When provided, overrides default mandate language.
-			 * Must comply with ACH authorization requirements.
-			 *
-			 * @example "I authorize [Merchant Name] to debit my bank account for the amount shown."
-			 */
-			fullMandateText?: string;
-			/**
-			 * Merchant name displayed in the mandate authorization text.
-			 *
-			 * Used in default mandate language when `fullMandateText` is not provided.
-			 * Should match the legal business name for compliance.
-			 *
-			 * @example "Acme Corporation Inc."
-			 */
-			merchantName?: string;
-		};
-		/**
-		 * Stripe publishable API key for client-side operations.
-		 *
-		 * Required for Stripe ACH functionality. Obtain from Stripe Dashboard.
-		 * Use the publishable key (starts with `pk_`), not the secret key.
-		 *
-		 * @example "pk_test_51H..."
-		 */
-		publishableKey?: string;
-	} & Record<string, unknown>;
-	/**
-	 * Configuration for the submit button behavior in Primer.js components.
-	 */
-	submitButton?: {
-		/**
-		 * Whether to show the order amount on the submit button.
-		 * When true, displays formatted amount next to button text (e.g., "Pay $12.34").
-		 * @default false
-		 */
-		amountVisible?: boolean;
-		/**
-		 * Whether to render the built-in submit button component.
-		 *
-		 * When `true` (default): The component renders the standard Primer submit button.
-		 * When `false`: No DOM elements are created, allowing external buttons to handle
-		 * form submission by dispatching the 'primer:card-submit' event.
-		 *
-		 * @example
-		 * // Hide built-in button and use external button
-		 * const options = {
-		 *   submitButton: {
-		 *     useBuiltInButton: false
-		 *   }
-		 * };
-		 *
-		 * // External button should dispatch this event to submit
-		 * const submitEvent = new CustomEvent('primer:card-submit', {
-		 *   bubbles: true,
-		 *   composed: true
-		 * });
-		 *
-		 * @default true
-		 */
-		useBuiltInButton?: boolean;
-	};
-	/**
-	 * Controls which SDK engine is used for payment processing.
-	 *
-	 * - `true` or `undefined`: Uses SDK Core engine (recommended) - modern architecture with better performance
-	 * - `false`: Uses legacy SDK engine (primer-sdk-web) - maintained for backward compatibility only
-	 *
-	 * SDK Core provides:
-	 * - Improved performance and reliability
-	 * - Better error handling and validation
-	 * - Newer payment method features
-	 * - Active development and feature updates
-	 *
-	 * Legacy SDK is maintained for backward compatibility but receives only critical bug fixes.
-	 * New integrations should use SDK Core (leave this option undefined or set to true).
-	 *
-	 * @default true
-	 * @remarks Setting to false may result in different cardholder name handling for compatibility
-	 */
-	sdkCore?: boolean;
 	/**
 	 * Globally disables all payment method interactions in drop-in mode.
 	 *
@@ -1960,100 +1588,58 @@ export interface PrimerCheckoutOptions {
 	 * ```
 	 */
 	disabledPayments?: boolean;
-	/**
-	 * Specifies which payment methods are enabled and displayed in the checkout.
-	 *
-	 * By default, only `PaymentMethodType.PAYMENT_CARD` is enabled.
-	 * Configure this to enable specific payment methods for your checkout flow.
-	 *
-	 * Available payment methods include: `PAYMENT_CARD`, `APPLE_PAY`, `GOOGLE_PAY`,
-	 * `PAYPAL`, `KLARNA`, `ADYEN_BLIK`, and many regional payment options.
-	 *
-	 * @default [PaymentMethodType.PAYMENT_CARD]
-	 * @see PaymentMethodType - Full enum of available payment method types
-	 * @example
-	 * ```typescript
-	 * // Enable card and digital wallets
-	 * enabledPaymentMethods: [
-	 *   PaymentMethodType.PAYMENT_CARD,
-	 *   PaymentMethodType.APPLE_PAY,
-	 *   PaymentMethodType.GOOGLE_PAY,
-	 *   PaymentMethodType.PAYPAL
-	 * ]
-	 *
-	 * // Enable card and BLIK (Poland)
-	 * enabledPaymentMethods: [
-	 *   PaymentMethodType.PAYMENT_CARD,
-	 *   PaymentMethodType.ADYEN_BLIK
-	 * ]
-	 * ```
-	 */
-	enabledPaymentMethods?: typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.PAYPAL | (typeof PaymentMethodType.ADYEN_BLIK)[];
 }
 /**
- * Native payment method types (sent with managerType: 'NATIVE' from server)
- */
-export type NativePaymentMethodTypes = typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK;
-/**
- * Payment methods that use the REDIRECT manager type.
- *
- * This type excludes payment methods with specialized manager types:
- * - STRIPE_ACH: Uses ACH manager
- * - PAYMENT_CARD: Uses CARD manager
- * - KLARNA: Uses KLARNA manager
- * - ADYEN_KLARNA: Uses ADYEN_KLARNA manager
- * - PAYPAL, GOOGLE_PAY, APPLE_PAY: Use NATIVE manager
- * - ADYEN_BLIK: Uses BLIK manager
- * - ADYEN_MBWAY: Uses MBWAY manager
- *
- * All other payment methods use the REDIRECT manager by default.
+ * Payment methods that use the REDIRECT manager type — i.e. every
+ * PaymentMethodType not handled by a specialized manager (CARD, ACH, KLARNA,
+ * ADYEN_KLARNA, NATIVE, BLIK, MBWAY, QRCODE).
  */
-export type RedirectPaymentMethodTypes = Exclude<PaymentMethodType, typeof PaymentMethodType.STRIPE_ACH | typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.KLARNA | typeof PaymentMethodType.ADYEN_KLARNA | typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK | typeof PaymentMethodType.ADYEN_MBWAY>;
+export type RedirectPaymentMethodTypes = Exclude<PaymentMethodType, typeof PaymentMethodType.STRIPE_ACH | typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.KLARNA | typeof PaymentMethodType.ADYEN_KLARNA | typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK | typeof PaymentMethodType.ADYEN_MBWAY | typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.XFERS_PAYNOW | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY>;
 /**
- * Represents a payment method that uses the REDIRECT manager.
- *
- * REDIRECT payment methods typically involve redirecting the user to an external
- * page for authorization. However, some REDIRECT payment methods (like BLIK)
- * use custom inline UI components while still being classified as REDIRECT type
- * due to their flow characteristics (status polling, external authorization).
+ * A payment method that authorizes by redirecting the user to an external page.
  */
 export interface RedirectPaymentMethod {
 	type: RedirectPaymentMethodTypes;
 	managerType: HeadlessManagerType.REDIRECT;
-	manager: IRedirectPaymentMethodManager;
+	manager: RedirectPaymentMethodManager;
 }
 export interface NativePaymentMethod {
 	type: typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY;
 	managerType: HeadlessManagerType.NATIVE;
-	manager: INativePaymentMethodManager;
+	manager: NativePaymentMethodManager;
 }
 export interface BlikPaymentMethod {
 	type: typeof PaymentMethodType.ADYEN_BLIK;
 	managerType: HeadlessManagerType.BLIK;
-	manager: IBlikPaymentMethodManager;
+	manager: BlikPaymentMethodManager;
 }
 export interface MbwayPaymentMethod {
 	type: typeof PaymentMethodType.ADYEN_MBWAY;
 	managerType: HeadlessManagerType.MBWAY;
-	manager: IMbwayPaymentMethodManager;
+	manager: MbwayPaymentMethodManager;
+}
+export interface QRCodePaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY | typeof PaymentMethodType.XFERS_PAYNOW;
+	managerType: HeadlessManagerType.QRCODE;
+	manager: QRCodePaymentMethodManager;
 }
 export type InitializedPaymentMethod = {
 	type: typeof PaymentMethodType.STRIPE_ACH;
 	managerType: HeadlessManagerType.ACH;
-	manager: IAchPaymentMethodManager;
+	manager: AchPaymentMethodManager;
 } | {
 	type: typeof PaymentMethodType.PAYMENT_CARD;
 	managerType: HeadlessManagerType.CARD;
-	manager: ICardPaymentMethodManager;
+	manager: CardPaymentMethodManager;
 } | {
 	type: typeof PaymentMethodType.KLARNA;
 	managerType: HeadlessManagerType.KLARNA;
-	manager: IKlarnaPaymentMethodManager;
+	manager: KlarnaPaymentMethodManager;
 } | {
 	type: typeof PaymentMethodType.ADYEN_KLARNA;
 	managerType: HeadlessManagerType.ADYEN_KLARNA;
-	manager: IAdyenKlarnaPaymentMethodManager;
-} | BlikPaymentMethod | MbwayPaymentMethod | RedirectPaymentMethod | NativePaymentMethod;
+	manager: AdyenKlarnaPaymentMethodManager;
+} | QRCodePaymentMethod | BlikPaymentMethod | MbwayPaymentMethod | RedirectPaymentMethod | NativePaymentMethod;
 export interface AssetsConfig {
 	backgroundColor: string;
 	name: string;
@@ -2076,7 +1662,7 @@ export interface VaultManagerState {
 	enabled: boolean;
 	isLoading: boolean;
 	isUpdating: boolean;
-	vaultedPaymentMethods: VaultedPaymentMethod[];
+	vaultedPaymentMethods: VaultListItem[];
 	cvvRecapture: boolean;
 	showEmptyState: boolean;
 	headless: boolean;
@@ -2094,8 +1680,8 @@ export interface VaultManagerItemState {
 	formIsDirty: boolean;
 	cvvInput: CvvInput | null;
 	setCvvInput: (metadata: CvvInput | null) => void;
-	selectedVaultedPaymentMethod: VaultedPaymentMethod | null;
-	setSelectedVaultedPaymentMethod: (paymentMethod: VaultedPaymentMethod | null) => void;
+	selectedVaultedPaymentMethod: VaultListItem | null;
+	setSelectedVaultedPaymentMethod: (paymentMethod: VaultListItem | null) => void;
 }
 export type KlarnaCategoriesContextType = {
 	categories: KlarnaPaymentMethodCategory[];
@@ -2119,17 +1705,13 @@ export type CardNetworksContextType = {
  */
 export type SdkState = {
 	isSuccessful: boolean;
-	isProcessing: boolean;
 	/**
-	 * MANUAL approval-mode flag: a `:pay` attempt has been created and is
-	 * awaiting merchant approval (202 response). Drives the loading UI while
-	 * the merchant approves/aborts. Distinct from `isProcessing` ("a payment is
-	 * being created/processed") because the downstream locking and continueFlow
-	 * functionalities need to tell the two phases apart.
-	 * Exactly one of `isProcessing` / `isAwaitingApproval` is true at a time.
-	 * Exited by continueFlow()/safety polling.
+	 * A payment is being created/processed, or a MANUAL `:pay` attempt is
+	 * awaiting merchant approval (202 response). Stays true across both phases
+	 * so the loading UI shows and the session stays locked from payment-method
+	 * change/resubmission until continueFlow()/safety polling resolves it.
 	 */
-	isAwaitingApproval: boolean;
+	isProcessing: boolean;
 	/**
 	 * SDK/component initialization errors.
 	 * This represents errors from the Primer JS layer itself (e.g., configuration errors,
@@ -2159,7 +1741,7 @@ export type ContextType = {
 	events?: PrimerEventsController;
 	clientOptions?: PrimerCheckoutOptions;
 	paymentMethods: InitializedPaymentMethod[];
-	headlessUtils?: HeadlessSDKUtilities;
+	headlessUtils?: SDKUtilities;
 	sdkState: SdkState;
 	vaultManager?: VaultManagerState;
 	vaultItem?: VaultManagerItemState;
@@ -2258,7 +1840,7 @@ declare class VaultManagerController implements ReactiveController {
 	/**
 	 * Fetch vaulted payment methods from the server
 	 */
-	fetchVaultedPaymentMethods(initialLoad?: boolean): Promise<VaultedPaymentMethod[]>;
+	fetchVaultedPaymentMethods(initialLoad?: boolean): Promise<VaultListItem[]>;
 	createCvvInput: (options: CardSecurityCodeInputOptions) => Promise<CvvInput | null>;
 	/**
 	 * Delete a vaulted payment method by ID
@@ -2277,7 +1859,7 @@ declare class VaultManagerController implements ReactiveController {
 	/**
 	 * Set the selected vaulted payment method - updates form state only
 	 */
-	setSelectedVaultedPaymentMethod: (paymentMethod: VaultedPaymentMethod | null) => void;
+	setSelectedVaultedPaymentMethod: (paymentMethod: VaultListItem | null) => void;
 	/**
 	 * Start vaulted payment flow by payment method ID
 	 * @param paymentMethodId - The ID of the vaulted payment method
@@ -2916,22 +2498,15 @@ declare class HeadlessSdkController implements ReactiveController {
 	get primerJSInstance(): PrimerJS | null;
 	hostConnected(): void;
 	hostDisconnected(): void;
-	/**
-	 * Normalizes options for legacy SDK compatibility.
-	 * When cardholder name is visible in Primer.js, it should be required in the legacy SDK
-	 * regardless of user's required setting, to ensure proper validation behavior.
-	 */
-	private normalizeOptionsForLegacySdk;
 	private setupLoadingTimeout;
 	private clearLoadingTimeout;
 	private cleanupResources;
-	private _loadV2Sdk;
 	/**
-	 * MANUAL approval flow: on a `:pay` 202, sdk-core invokes this. Enter the
-	 * awaiting-approval state (so the checkout shows its loading UI while the
-	 * merchant approves/aborts), then surface the approval request to the
-	 * merchant. State is set BEFORE dispatching so listeners that synchronously
-	 * read state see `isAwaitingApproval: true`.
+	 * MANUAL approval flow: on a `:pay` 202, sdk-core invokes this. Keep the SDK
+	 * in the processing state (so the checkout shows its loading UI and stays
+	 * locked while the merchant approves/aborts), then surface the approval
+	 * request to the merchant. State is set BEFORE dispatching so listeners that
+	 * synchronously read state see `isProcessing: true`.
 	 */
 	private handlePaymentApprovalRequired;
 	initializeHeadless(): ([clientToken, options]: readonly [
@@ -3640,68 +3215,9 @@ declare global {
 		"primer-klarna": PrimerKlarnaComponent;
 	}
 }
-/**
- * Google Pay component with shadow root rendering for full-width button support.
- *
- * Google Pay requires special rendering logic:
- * - Renders directly to shadow root (not button container)
- * - Does NOT render .native-button-container div
- * - Passes shadowRoot: true in render options
- * - Requires retry logic for async button rendering
- */
-declare class GooglePayComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	paymentMethod: NativePaymentMethod | undefined;
-	primerContext?: ContextType;
-	disabled: boolean;
-	private renderButtonTask;
-	constructor();
-	attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
-	protected updated(changedProperties: PropertyValues): void;
-	render(): symbol;
-}
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-google-pay": GooglePayComponent;
-	}
-}
-/**
- * Apple Pay component with standard button container rendering.
- *
- * Apple Pay uses the standard button container approach:
- * - Renders to a button container div (not shadow root)
- * - Passes buttonHeight in render options
- * - Uses updateOverlayForContainer for disabled state
- * - Simpler than Google Pay's shadow root approach
- */
-declare class ApplePayComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	paymentMethod: NativePaymentMethod | undefined;
-	primerContext?: ContextType;
-	disabled: boolean;
-	private buttonContainerRef;
-	private renderButtonTask;
-	constructor();
-	attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
-	protected updated(changedProperties: PropertyValues): void;
-	render(): import("lit-html").TemplateResult<1>;
-}
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-apple-pay": ApplePayComponent;
-	}
-}
-/**
- * PayPal component with standard button container rendering.
- *
- * PayPal uses the standard button container approach:
- * - Renders to a button container div (not shadow root)
- * - Passes buttonHeight in render options (sdk-core constrains to 25-55px)
- * - Uses updateOverlayForContainer for disabled state
- * - Height is calculated from CSS (PAYMENT_METHOD_LINE_HEIGHT + padding)
- */
-declare class PayPalComponent extends LitElement {
+declare class NativePaymentComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
+	type: PaymentMethodType | undefined;
 	paymentMethod: NativePaymentMethod | undefined;
 	primerContext?: ContextType;
 	disabled: boolean;
@@ -3709,14 +3225,9 @@ declare class PayPalComponent extends LitElement {
 	private renderButtonTask;
 	constructor();
 	attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
-	protected updated(changedProperties: PropertyValues): void;
+	protected willUpdate(changedProperties: PropertyValues): void;
 	render(): import("lit-html").TemplateResult<1>;
 }
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-paypal": PayPalComponent;
-	}
-}
 /**
  * BLIK Payment Component
  *
@@ -3871,21 +3382,41 @@ declare global {
 		"primer-adyen-mbway": AdyenMbwayComponent;
 	}
 }
-declare class PaymentMethodComponent extends LitElement {
+declare class QRCodeComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	type: PaymentMethodType | undefined;
+	paymentMethod: QRCodePaymentMethod | undefined;
 	disabled: boolean;
 	primerContext?: ContextType;
+	private isExpanded;
+	private isLoading;
+	private qrCodeUrl;
+	disconnectedCallback(): void;
+	private handleExpandedChange;
+	private loadQRCode;
 	/**
-	 * Sends PAYMENT_METHOD_SELECTION analytics event when user clicks on payment method
-	 * @private
+	 * Reset state on failures.
 	 */
-	private sendPaymentMethodSelectionEvent;
+	willUpdate(changed: PropertyValues): void;
+	private renderQRCode;
+	render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-qrcode": QRCodeComponent;
+	}
+}
+declare class PaymentMethodComponent extends LitElement {
+	static styles: import("lit").CSSResult[];
+	type: PaymentMethodType | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
+	private isActive;
 	/**
 	 * Handle interaction events on payment method component
 	 * @private
 	 */
 	private handleClick;
+	updated(): void;
 	render(): import("lit-html").TemplateResult<1> | typeof nothing;
 }
 declare global {
@@ -4308,7 +3839,7 @@ declare class VaultPaymentMethodItemComponent extends LitElement {
 	/**
 	 * The payment method to display
 	 */
-	paymentMethod: VaultedPaymentMethod | undefined;
+	paymentMethod: VaultListItem | undefined;
 	/**
 	 * Whether the component is in edit mode
 	 */
@@ -4504,7 +4035,7 @@ declare global {
 declare class VaultCvvInputComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	primerContext?: ContextType;
-	paymentMethod: PaymentCardVaultedMethod | null;
+	paymentMethod: CardVaultedPaymentMethodSummary | null;
 	private cvvError;
 	private cvvInputIsDirty;
 	private cvvInputIsBlurred;
@@ -4762,7 +4293,7 @@ export interface HostedInputConfig {
 /**
  * Possible input source types that can be returned by getHostedInput
  */
-export type InputSource = IHeadlessHostedInput | "cardholderName" | undefined;
+export type InputSource = HostedInput | "cardholderName" | undefined;
 declare class HostedInputController<T extends HostedInputHost> implements ReactiveController {
 	private _meta;
 	private _hostedInput;
@@ -4860,10 +4391,10 @@ export interface IHostedInputController {
 	focusInput(): void;
 }
 export interface CardFormContext {
-	cardNumberInput: IHeadlessHostedInput;
-	cardholderNameInput?: IHeadlessHostedInput;
-	expiryInput: IHeadlessHostedInput;
-	cvvInput: IHeadlessHostedInput;
+	cardNumberInput: HostedInput;
+	cardholderNameInput?: HostedInput;
+	expiryInput: HostedInput;
+	cvvInput: HostedInput;
 	setCardholderName: (val: string) => void;
 	setCardNetwork: (val: string) => void;
 	validate: () => Promise<Validation>;
@@ -5282,6 +4813,11 @@ declare global {
 		"primer-show-other-payments": ShowOtherPaymentsComponent;
 	}
 }
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-native-payment": NativePaymentComponent;
+	}
+}
 declare class PaymentMethodAccordionComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	type: PaymentMethodType | undefined;
@@ -5292,6 +4828,11 @@ declare class PaymentMethodAccordionComponent extends LitElement {
 	 * Used when payment flows open external popups (e.g. Klarna).
 	 */
 	suppressBlurCollapse: boolean;
+	/**
+	 * When true, the accordion ignores every collapse trigger (button toggle,
+	 * outside click, window blur).
+	 */
+	loading: boolean;
 	connectedCallback(): void;
 	disconnectedCallback(): void;
 	private _handleDocumentClick;
@@ -5386,7 +4927,6 @@ export declare function loadPrimer(): void;
 
 export {
 	AdyenMbwayComponent as AdyenMbway,
-	ApplePayComponent as ApplePay,
 	BillingAddressComponent as BillingAddress,
 	BlikComponent as Blik,
 	ButtonComponent as Button,
@@ -5397,7 +4937,6 @@ export {
 	DialogComponent as Dialog,
 	ErrorMessageComponent as ErrorMessage,
 	ErrorMessageContainerComponent as ErrorMessageContainer,
-	GooglePayComponent as GooglePay,
 	InputCardExpiryComponent as CardFormExpiry,
 	InputCardHolderNameComponent as CardFormName,
 	InputCardNumberComponent as CardFormCardNumber,
@@ -5406,7 +4945,7 @@ export {
 	InputErrorComponent as CardFormError,
 	InputLabelComponent as InputLabel,
 	InputWrapperComponent as InputWrapper,
-	PayPalComponent as PayPal,
+	NativePaymentComponent as NativePayment,
 	PaymentMethodAccordionComponent as PaymentMethodAccordion,
 	PaymentMethodAccordionConfirmButtonComponent as PaymentMethodAccordionConfirmButton,
 	PaymentMethodButtonComponent as PaymentMethodButton,
@@ -5420,6 +4959,7 @@ export {
 	PrimerKlarnaComponent as PrimerKlarna,
 	PrimerMainComponent as PrimerMain,
 	PtPhoneNumberInputComponent as PtPhoneNumberInput,
+	QRCodeComponent as QRCode,
 	RedirectPaymentComponent as RedirectPayment,
 	SelectComponent as Select,
 	ShowOtherPaymentsComponent as ShowOtherPayments,