@primer-io/primer-js 1.6.3 → 1.8.0

package/dist/primer-loader.d.ts

@@ -1,7 +1,6 @@
 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 { FUNDING_SOURCE, PayPalButtonStyle } from '@paypal/paypal-js';
 import { CSSResult, LitElement, PropertyValues, ReactiveController, ReactiveControllerHost, SVGTemplateResult, TemplateResult, nothing } from 'lit';
 
 declare global {
@@ -268,7 +267,9 @@ export interface GooglePayClientOptions {
 	 */
 	captureBillingAddress?: boolean;
 	/**
-	 * When true, requests shipping address from Google Pay and updates client session.
+	 * When true, requests shipping address from Google Pay and updates client
+	 * session. Register `onShippingAddressChange` to supply shipping options
+	 * for display in the sheet.
 	 */
 	captureShippingAddress?: boolean;
 	/**
@@ -281,10 +282,9 @@ export interface GooglePayClientOptions {
 	 */
 	emailRequired?: boolean;
 	/**
-	 * When true, enables shipping method selection in the Google Pay payment sheet.
-	 * Shipping methods are read from the SHIPPING checkout module in the client configuration.
-	 * When the user selects a shipping option, the SDK will call selectShippingMethod()
-	 * on the client session API to update the order on the backend.
+	 * When true, enables shipping method selection in the Google Pay payment
+	 * sheet. Register `onShippingAddressChange` to supply the option list and
+	 * `onShippingOptionChange` to commit the shopper's selection.
 	 */
 	requireShippingMethod?: boolean;
 	/**
@@ -371,29 +371,15 @@ 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[];
+	/** Available shipping methods (legacy `shippingMethodsUrl` path only) */
+	shippingMethods: ShippingOption[];
 	/** Currently selected shipping method ID */
 	selectedShippingMethod?: string;
+	callbackMode?: boolean;
 }
 /**
  * Shipping checkout module
@@ -407,6 +393,20 @@ export interface ShippingCheckoutModule {
  * Supports billing address and shipping modules
  */
 export type CheckoutModuleConfig = BillingAddressCheckoutModule | ShippingCheckoutModule;
+/**
+ * A shipping option offered to the shopper inside an Express Checkout
+ * (Apple Pay / Google Pay) payment sheet — either the legacy
+ * `shippingMethodsUrl`-resolved list (read from `ShippingCheckoutModule`),
+ * or merchant-supplied via the newer event-driven flow: returned via the
+ * `setShippingOptions` handler on `onShippingAddressChange`, and passed back
+ * via `onShippingOptionChange` once the shopper selects one.
+ */
+export interface ShippingOption {
+	amount: number;
+	id: string;
+	name: string;
+	description: string;
+}
 export type ApprovalMode = "AUTO" | "MANUAL";
 export interface ClientSession {
 	clientSessionId: string;
@@ -537,6 +537,17 @@ export interface PaymentRenderButtonOptions {
 		shadowRoot?: ShadowRoot | null;
 	};
 }
+/**
+ * Field validation state (mirrors @primer-io/sdk-utils/iframes/types)
+ */
+export interface FieldState {
+	valid: boolean;
+	dirty: boolean;
+	touched: boolean;
+	focused: boolean;
+	disabled: boolean;
+	error: string;
+}
 export interface BaseInputStyle {
 	background?: string;
 	borderColor?: number | string;
@@ -680,35 +691,16 @@ export interface TelemetryClient {
 	dispose(): void;
 }
 declare enum HeadlessManagerType {
+	BACKEND_DRIVEN = "BACKEND_DRIVEN",
 	BLIK = "BLIK",
 	CARD = "CARD",
 	NATIVE = "NATIVE",
 	REDIRECT = "REDIRECT",
 	KLARNA = "KLARNA",
 	ADYEN_KLARNA = "ADYEN_KLARNA",
-	ACH = "ACH",
 	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",
-	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"
-}
-type EventListener$1 = (event?: Event) => void;
 export interface PayPalOptionsWithPaypalJsTypes {
 	/**
 	 * Button style configuration with optional per-funding-source overrides.
@@ -730,6 +722,51 @@ export interface PayPalOptionsWithPaypalJsTypes {
 	enableFunding?: FUNDING_SOURCE[];
 	integrationDate?: string;
 	debug?: boolean;
+	/**
+	 * PayPal App Switch configuration.
+	 *
+	 * When enabled, tapping the PayPal button attempts to open the PayPal app
+	 * (falling back to the web flow when unavailable), and the buyer is
+	 * returned to complete checkout. The SDK uses your `returnUrl` as the PayPal
+	 * order/billing-agreement return and cancel URLs, and resumes the pending
+	 * session on return.
+	 */
+	appSwitch?: {
+		/**
+		 * Whether App Switch is enabled.
+		 * @default false
+		 */
+		enabled?: boolean;
+		/**
+		 * The full URL PayPal returns and cancels to after the app switch.
+		 * **Required when App Switch is enabled**, and PayPal requires it to be the
+		 * same URL the SDK was initialized on. The SDK appends `?clientToken=…` so
+		 * that page can resume the pending session.
+		 */
+		returnUrl?: string;
+		/**
+		 * Host-app bridge for checkout embedded in a native app's webview, where
+		 * PayPal's in-browser App Switch cannot return. The SDK hands the approval
+		 * deep link to the host app, which opens it and calls `resumeAppSwitch()`
+		 * on the native return.
+		 */
+		hostApp?: {
+			/** Return the host native app's return deep link, OS, and OS version. */
+			getContext: () => Promise<{
+				appUrl: string;
+				osType: "IOS" | "ANDROID" | "OTHER";
+				/** Host OS version, e.g. "14". */
+				osVersion?: string;
+			}>;
+			/**
+			 * Open the PayPal approval deep link. The native return appends
+			 * `/success` or `/cancel` to the return URL and carries the `token`
+			 * (order id) on both — route by path: `resumeAppSwitch(token)` on
+			 * success, `cancelAppSwitch()` on cancel.
+			 */
+			openApprovalUrl: (approvalUrl: string) => void | Promise<void>;
+		};
+	};
 }
 export interface LegacyApplePayOptions {
 	/**
@@ -777,6 +814,11 @@ export interface ApplePayClientOptions {
 		 * @see https://developer.apple.com/documentation/applepayontheweb/applepaypaymentrequest/requiredshippingcontactfields
 		 */
 		requiredShippingContactFields?: ("postalAddress" | "name" | "phoneticName" | "phone" | "email")[];
+		/**
+		 * When true, enables shipping method selection in the Apple Pay sheet.
+		 * Register `onShippingAddressChange` to supply the option list and
+		 * `onShippingOptionChange` to commit the shopper's selection.
+		 */
 		requireShippingMethod?: boolean;
 	};
 }
@@ -788,41 +830,32 @@ export interface Payment {
 		[key: string]: unknown;
 	};
 }
-export interface HeadlessHostedInputOptions {
-	placeholder?: string;
-	ariaLabel?: string;
-	style?: Record<string, unknown>;
-}
 export interface CardPaymentMethodSubmitValues {
 	cardNetwork?: string;
 }
-export interface CardPaymentMethodManagerOptions {
-	onBinDataAvailable?: (event: BinDataAvailableEvent) => void;
-	onBinDataLoadingChange?: (loading: boolean) => void;
-	onCardNetworksChange?: (event: CardNetworkChangeEvent) => void;
-	onCardNetworksLoading?: () => void;
-}
-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 KlarnaPaymentCategory {
+	name: string;
+	identifier: string;
+	standardAssetUrl: string;
+	descriptiveAssetUrl: string;
 }
-export interface KlarnaPaymentMethodManager {
+export interface KlarnaPaymentMethod {
+	type: typeof PaymentMethodType.KLARNA;
+	managerType: HeadlessManagerType.KLARNA;
+	getCategories: () => KlarnaPaymentCategory[];
 	renderCategory: (params: {
 		containerId: string | HTMLElement;
 		paymentMethodCategoryId: string;
 		onHeightChange?: (height: number) => void;
 	}) => Promise<void>;
-	start: (params: {
-		paymentMethodCategoryId: string;
-	}) => Promise<void>;
+	/**
+	 * Set the selected payment category for the payment flow
+	 */
+	setSelectedCategory: (categoryId: string) => void;
+	/**
+	 * Start the payment flow with the selected category
+	 */
+	start: () => Promise<void>;
 }
 /**
  * Adyen Klarna payment type option
@@ -832,25 +865,18 @@ export interface AdyenKlarnaPaymentOption {
 	label: 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;
-}
-/**
- * Adyen Klarna Payment Method Manager
+ * Adyen Klarna Payment Method
  *
  * Unlike direct Klarna integration, Adyen Klarna uses a redirect flow
  * with payment type selection (Pay Now, Pay Later, etc.)
  */
-export interface AdyenKlarnaPaymentMethodManager {
+export interface AdyenKlarnaPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_KLARNA;
+	managerType: HeadlessManagerType.ADYEN_KLARNA;
 	/**
 	 * Get available payment options
 	 */
-	getPaymentOptions: () => AdyenKlarnaPaymentOption[];
+	getOptions: () => AdyenKlarnaPaymentOption[];
 	/**
 	 * Select a payment option
 	 */
@@ -860,10 +886,6 @@ export interface AdyenKlarnaPaymentMethodManager {
 	 */
 	start: () => Promise<void>;
 }
-export interface AchPaymentMethodManagerOptions {
-	onCollectBankAccountDetailsComplete?: () => void;
-}
-export type PaymentMethodManagerOptions = CardPaymentMethodManagerOptions | KlarnaPaymentMethodManagerOptions | AdyenKlarnaPaymentMethodManagerOptions | AchPaymentMethodManagerOptions | Record<string, unknown>;
 export interface VaultListItem {
 	id: string;
 	analyticsId: string;
@@ -1033,29 +1055,13 @@ export interface KlarnaVaultedPaymentMethodSummary extends BaseVaultedPaymentMet
 		};
 	};
 }
-/**
- * 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;
-	};
-}
 /**
  * Generic vaulted payment method summary for payment instruments
  * not explicitly modeled with their own interface.
  */
 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">;
+	paymentInstrumentType: Exclude<PaymentInstrumentType, "PAYMENT_CARD" | "PAYPAL_BILLING_AGREEMENT" | "KLARNA_CUSTOMER_TOKEN">;
 	/** Generic payment instrument data for unknown/other payment methods */
 	paymentInstrumentData?: Record<string, unknown>;
 }
@@ -1063,7 +1069,7 @@ export interface GenericVaultedPaymentMethodSummary extends BaseVaultedPaymentMe
  * Discriminated union of all vaulted payment method summaries.
  * Use the paymentInstrumentType field to narrow to specific types.
  */
-export type VaultedPaymentMethodSummary = CardVaultedPaymentMethodSummary | PayPalVaultedPaymentMethodSummary | KlarnaVaultedPaymentMethodSummary | ACHVaultedPaymentMethodSummary | GenericVaultedPaymentMethodSummary;
+export type VaultedPaymentMethodSummary = CardVaultedPaymentMethodSummary | PayPalVaultedPaymentMethodSummary | KlarnaVaultedPaymentMethodSummary | GenericVaultedPaymentMethodSummary;
 /**
  * Approval state of a MANUAL attempt. `REQUIRES_APPROVAL` is pending; `APPROVED`,
  * `ABORTED` and `EXPIRED` are terminal.
@@ -1130,22 +1136,6 @@ export interface BinDataAvailableEvent {
 	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;
@@ -1157,63 +1147,129 @@ export interface Validation {
 	validationErrors: InputValidationError[];
 	error?: string;
 }
-export interface CardPaymentMethodManager {
-	createHostedInputs: () => HostedInputs;
-	removeHostedInputs: () => void;
+export type HostedInputEvent = "input" | "focus" | "blur" | "enter";
+export interface HostedInput {
+	render(containerOrId: string | Element, options?: HostedInputOptions): Promise<void>;
+	remove(): void;
+	focus(): void;
+	getFieldState(): Promise<FieldState> | undefined;
+	addEventListener(event: HostedInputEvent, callback: (data?: unknown) => void): void;
+	setOptions(options: HostedInputOptions): void;
+	setCardholderName(cardholderName: string): void;
+}
+export interface CardFormIframes {
+	cardNumber: HostedInput;
+	cardSecurityCode: HostedInput;
+	cardExpiryDate: HostedInput;
+	cardholderName: HostedInput;
+}
+export interface CardPaymentMethod {
+	type: typeof PaymentMethodType.PAYMENT_CARD;
+	managerType: HeadlessManagerType.CARD;
+	iframes: CardFormIframes;
 	submit: (values?: CardPaymentMethodSubmitValues) => Promise<void>;
 	validate: () => Promise<Validation>;
-	reset: () => void;
 	setCardholderName: (cardholderName: string) => void;
 }
-export interface MbwayPaymentMethodManager {
-	start(params: {
-		phoneNumber: string;
-	}): Promise<void>;
+export interface MbwayPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_MBWAY;
+	managerType: HeadlessManagerType.MBWAY;
+	/**
+	 * Set the phone number used to confirm the payment in the MB WAY app
+	 */
+	setPhoneNumber(phoneNumber: string): void;
+	/**
+	 * Start the payment flow
+	 */
+	start(): Promise<void>;
 }
-export interface BlikPaymentMethodManager {
-	start(params: {
-		blikCode: string;
-	}): Promise<void>;
+export interface BlikPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_BLIK;
+	managerType: HeadlessManagerType.BLIK;
+	/**
+	 * Set the 6-digit OTP code from the user's banking app
+	 */
+	setBlikCode(code: string): void;
+	/**
+	 * Start the payment flow
+	 */
+	start(): 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 NativePaymentMethodManager {
-	createButton: () => {
-		render: (container: HTMLElement, buttonOptions?: PaymentRenderButtonOptions) => Promise<void>;
-		setDisabled(disabled: boolean): Promise<void>;
-	};
+/**
+ * A payment method rendered as a branded button by an external SDK.
+ */
+export interface NativePaymentMethod {
+	type: typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.GOOGLE_PAY;
+	managerType: HeadlessManagerType.NATIVE;
+	/**
+	 * Initialize the payment method (e.g. load the external SDK)
+	 */
+	start(): Promise<void>;
+	/**
+	 * Render the payment button into the given container
+	 */
+	render(container: HTMLElement, buttonOptions?: PaymentRenderButtonOptions): Promise<void>;
+	setDisabled(disabled: boolean): Promise<void>;
+}
+/**
+ * PayPal renders like the other native methods, plus the host-app App Switch
+ * entry points. Both warn and do nothing unless `paypal.appSwitch.hostApp` is
+ * configured.
+ */
+export interface PayPalPaymentMethod {
+	type: typeof PaymentMethodType.PAYPAL;
+	managerType: HeadlessManagerType.NATIVE;
+	start(): Promise<void>;
+	render(container: HTMLElement, buttonOptions?: PaymentRenderButtonOptions): Promise<void>;
+	setDisabled(disabled: boolean): Promise<void>;
+	/** Finishes the payment after the buyer returns, with the `orderId` the host app captured. */
+	resumeAppSwitch(orderId: string): Promise<void>;
+	/** Propagates a user cancellation when the buyer returns without approving. */
+	cancelAppSwitch(): Promise<void>;
 }
-export interface RedirectPaymentMethodManager {
+/**
+ * Payment method types that have a surface of their own. Everything else is
+ * driven generically — by a redirect, or by the backend.
+ */
+export type SpecializedPaymentMethodType = 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;
+export interface RedirectPaymentMethod {
+	type: Exclude<PaymentMethodType, SpecializedPaymentMethodType>;
+	managerType: HeadlessManagerType.REDIRECT;
 	start: () => Promise<void>;
 }
 /**
- * QRCode Payment Method Manager
+ * A payment method whose flow is driven by the backend: the SDK executes the
+ * steps the backend sends rather than following a flow hardcoded per method.
+ *
+ * Which surface it renders is up to those steps — today they redirect, so this
+ * looks like {@link RedirectPaymentMethod}, but a step tree can drive other
+ * surfaces, which is why it is a member of its own rather than a redirect.
+ */
+export interface BackendDrivenPaymentMethod {
+	type: Exclude<PaymentMethodType, SpecializedPaymentMethodType>;
+	managerType: HeadlessManagerType.BACKEND_DRIVEN;
+	start: () => Promise<void>;
+}
+/**
+ * QRCode Payment Method
  */
-export interface QRCodePaymentMethodManager {
+export interface QRCodePaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY | typeof PaymentMethodType.XFERS_PAYNOW;
+	managerType: HeadlessManagerType.QRCODE;
 	/**
-	 * Start the payment flow, optionally providing a callback for when the QR code is received
+	 * Provide a callback for when the QR code is received
 	 * @param params Optional parameters, including onQRCodeReceived callback
 	 */
-	start(params?: {
-		onQRCodeReceived?: (qrCode: string) => void;
-	}): Promise<void>;
+	setOnQRCodeReceived(callback: (qrCode: string) => void): void;
+	/**
+	 * Start the payment flow
+	 */
+	start(): Promise<void>;
 	/**
 	 * Stop the payment flow
 	 */
 	stop(): void;
 }
-export type PaymentMethodManager = CardPaymentMethodManager | NativePaymentMethodManager | RedirectPaymentMethodManager | KlarnaPaymentMethodManager | QRCodePaymentMethodManager;
 export interface SDKUtilities {
 	getCardNetworkAsset: (network: string) => {
 		cardUrl: string;
@@ -1239,7 +1295,6 @@ export interface SDKUtilities {
 }
 export interface PrimerHeadlessCheckout {
 	start: () => Promise<void>;
-	createPaymentMethodManager: (type: string, managerOptions?: PaymentMethodManagerOptions) => Promise<PaymentMethodManager | null>;
 	getSDKUtilities: () => SDKUtilities;
 	/** Session-bound telemetry, shared with all sdk-core internals via the checkout context */
 	getTelemetry: () => TelemetryClient;
@@ -1421,23 +1476,21 @@ export interface CreateHeadlessOptions {
 		 */
 		forceRedirect?: boolean;
 		/**
-		 * 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
+		 * @deprecated this flag is no longer used and won't have any effect, will be removed in a future version
 		 */
 		resumePaymentOnPopupClosure?: boolean;
 	};
 	/**
 	 * Fires once at SDK init with the initial set of available payment methods.
 	 */
-	onAvailablePaymentMethodsLoad?: (info: PaymentMethodInfo[]) => void;
+	onAvailablePaymentMethodsLoad?: (info: InitializedPaymentMethod[]) => 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;
+	onAvailablePaymentMethodsRefresh?: (info: InitializedPaymentMethod[]) => void;
 	onCheckoutComplete?: (data: {
 		payment: Payment | null;
 	}) => void;
@@ -1475,13 +1528,67 @@ export interface CreateHeadlessOptions {
 	 * is resolved. Not fired for a fresh checkout (no attempt in flight).
 	 */
 	onCheckoutResume?: () => void;
+	/**
+	 * Express Checkout (Apple Pay / Google Pay): invoked when the shopper
+	 * changes/enters their shipping address inside the native payment sheet.
+	 * The merchant computes shipping options for that address and calls
+	 * `setShippingOptions` with the result; the SDK displays them in the
+	 * sheet. Display-only — the SDK does not persist the list.
+	 *
+	 * Required for `captureShippingAddress`/`requireShippingMethod` (Google
+	 * Pay) or `shippingOptions.requireShippingMethod` (Apple Pay) to show any
+	 * shipping options. If not registered, no options are shown and a warning
+	 * is logged.
+	 *
+	 * Must call `setShippingOptions` within 20 seconds or the payment attempt
+	 * fails with a `REQUEST_TIMEOUT` error. If integrating via
+	 * `addEventListener('primer:shipping-address-change', ...)` instead of
+	 * this callback, call `event.preventDefault()` synchronously to signal you
+	 * will respond asynchronously — otherwise the SDK assumes nothing is
+	 * listening, logs a warning, and your later response is ignored.
+	 *
+	 * Not invoked at all if a legacy `shippingMethodsUrl`-configured `SHIPPING`
+	 * checkout module is present on the client session — that legacy,
+	 * server-resolved flow takes priority silently (a warning is logged, but
+	 * this callback is simply never called). The two are mutually exclusive;
+	 * remove the `shippingMethodsUrl` configuration to use this callback.
+	 */
+	onShippingAddressChange?: (data: {
+		paymentMethodType: PaymentMethodType;
+		shippingAddress: NullableAddress;
+	}, handler: {
+		setShippingOptions: (options: ShippingOption[]) => void;
+	}) => void;
+	/**
+	 * Express Checkout (Apple Pay / Google Pay): invoked when the shopper
+	 * selects one of the shipping options supplied via
+	 * `onShippingAddressChange`. The merchant's backend should PATCH the
+	 * client session with the authoritative shipping amount (+ tax) before
+	 * calling `continue()` to acknowledge. Payment authorization is gated on
+	 * this ack.
+	 *
+	 * Must call `continue()` within 20 seconds or the payment attempt fails
+	 * with a `REQUEST_TIMEOUT` error. If integrating via
+	 * `addEventListener('primer:shipping-option-change', ...)` instead of
+	 * this callback, call `event.preventDefault()` synchronously to signal you
+	 * will respond asynchronously — otherwise the SDK assumes nothing is
+	 * listening, logs a warning, and your later response is ignored.
+	 *
+	 * Not invoked at all if a legacy `shippingMethodsUrl`-configured `SHIPPING`
+	 * checkout module is present — see `onShippingAddressChange`.
+	 */
+	onShippingOptionChange?: (data: {
+		paymentMethodType: PaymentMethodType;
+		selectedShippingOption: ShippingOption;
+	}, handler: {
+		continue: () => void;
+	}) => void;
+	onBinDataAvailable?: (event: BinDataAvailableEvent) => void;
+	onBinDataLoadingChange?: (loading: boolean) => void;
+	onCardNetworksChange?: (event: CardNetworkChangeEvent) => void;
+	onCardNetworksLoading?: () => void;
 }
-export interface KlarnaPaymentMethodCategory {
-	id: string;
-	name: string;
-	descriptiveAssetUrl: string;
-	standardAssetUrl: string;
-}
+export type InitializedPaymentMethod = CardPaymentMethod | KlarnaPaymentMethod | AdyenKlarnaPaymentMethod | QRCodePaymentMethod | BlikPaymentMethod | MbwayPaymentMethod | RedirectPaymentMethod | BackendDrivenPaymentMethod | NativePaymentMethod | PayPalPaymentMethod;
 export interface CardSecurityCodeInputOptions {
 	ariaLabel?: string;
 	container: string | Element | HTMLElement;
@@ -1502,7 +1609,7 @@ export interface InputMetadata {
 	touched: boolean;
 	submitted: boolean;
 }
-export interface PrimerCheckoutOptions extends Omit<CreateHeadlessOptions, "dialogProvider"> {
+export interface PrimerCheckoutOptions extends Omit<CreateHeadlessOptions, "dialogProvider" | "onShippingAddressChange" | "onShippingOptionChange"> {
 	giftCard?: {
 		logoSrc: string;
 		background: string;
@@ -1637,62 +1744,6 @@ export interface PrimerCheckoutOptions extends Omit<CreateHeadlessOptions, "dial
 	 */
 	disabledPayments?: boolean;
 }
-/**
- * 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 | typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.XFERS_PAYNOW | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY>;
-/**
- * A payment method that authorizes by redirecting the user to an external page.
- */
-export interface RedirectPaymentMethod {
-	type: RedirectPaymentMethodTypes;
-	managerType: HeadlessManagerType.REDIRECT;
-	manager: RedirectPaymentMethodManager;
-}
-export interface NativePaymentMethod {
-	type: typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY;
-	managerType: HeadlessManagerType.NATIVE;
-	manager: NativePaymentMethodManager;
-}
-export interface BlikPaymentMethod {
-	type: typeof PaymentMethodType.ADYEN_BLIK;
-	managerType: HeadlessManagerType.BLIK;
-	manager: BlikPaymentMethodManager;
-}
-export interface MbwayPaymentMethod {
-	type: typeof PaymentMethodType.ADYEN_MBWAY;
-	managerType: HeadlessManagerType.MBWAY;
-	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: AchPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.PAYMENT_CARD;
-	managerType: HeadlessManagerType.CARD;
-	manager: CardPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.KLARNA;
-	managerType: HeadlessManagerType.KLARNA;
-	manager: KlarnaPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.ADYEN_KLARNA;
-	managerType: HeadlessManagerType.ADYEN_KLARNA;
-	manager: AdyenKlarnaPaymentMethodManager;
-} | QRCodePaymentMethod | BlikPaymentMethod | MbwayPaymentMethod | RedirectPaymentMethod | NativePaymentMethod;
-export interface AssetsConfig {
-	backgroundColor: string;
-	name: string;
-	iconUrl: string;
-}
 /**
  * Options for initializing the Vault Manager
  */
@@ -1731,14 +1782,6 @@ export interface VaultManagerItemState {
 	selectedVaultedPaymentMethod: VaultListItem | null;
 	setSelectedVaultedPaymentMethod: (paymentMethod: VaultListItem | null) => void;
 }
-export type KlarnaCategoriesContextType = {
-	categories: KlarnaPaymentMethodCategory[];
-	isLoading: boolean;
-};
-export type AdyenKlarnaOptionsContextType = {
-	options: AdyenKlarnaPaymentOption[];
-	isLoading: boolean;
-};
 export type CardNetwork = {
 	displayName: string;
 	network: string;
@@ -1761,11 +1804,17 @@ export type SdkState = {
 	 */
 	isProcessing: boolean;
 	/**
-	 * SDK/component initialization errors.
-	 * This represents errors from the Primer JS layer itself (e.g., configuration errors,
-	 * component initialization failures), not payment processing errors.
-	 */
-	primerJsError: Error | null;
+	 * SDK initialization errors — never payment-processing failures (those go
+	 * to `paymentFailure`). The error thrown during initialization is kept
+	 * as-is; common codes:
+	 * - `INVALID_CLIENT_TOKEN`: the client token is malformed, expired, or was
+	 *   rejected — generate a new one
+	 * - `INITIALIZATION_ERROR`: any other initialization failure (e.g. the
+	 *   configuration failed to load)
+	 * `origin` says who should act on it ('network' marks retryable failures);
+	 * the underlying cause is nested in `error`.
+	 */
+	primerJsError: SdkError | null;
 	isLoading: boolean;
 	/**
 	 * Payment processing failure information.
@@ -1787,8 +1836,6 @@ export type ContextType = {
 	telemetry?: TelemetryClient;
 	configuration?: ClientConfiguration;
 	computedStyles?: CSSStyleDeclaration | null;
-	klarnaCategories: KlarnaCategoriesContextType;
-	adyenKlarnaOptions?: AdyenKlarnaOptionsContextType;
 	cardNetworks?: CardNetworksContextType;
 	events?: PrimerEventsController;
 	clientOptions?: PrimerCheckoutOptions;
@@ -1815,8 +1862,6 @@ declare class SDKContextController implements ReactiveController {
 	setCardNetworks(value: CardNetworksContextType): void;
 	setCardNetworksLoadingFalse(): void;
 	setVaultManager(vaultManager: VaultManagerState): void;
-	setKlarnaCategories(value: KlarnaCategoriesContextType): void;
-	setAdyenKlarnaOptions(value: AdyenKlarnaOptionsContextType): void;
 	setComputedStyles(value: CSSStyleDeclaration): void;
 	setVaultManagerCvv(vaultItem: VaultManagerItemState): void;
 	/**
@@ -2199,14 +2244,7 @@ export declare class PrimerJS {
 	/**
 	 * Returns the cached list of payment methods.
 	 */
-	getPaymentMethods(): PaymentMethodInfo[];
-	/**
-	 * Internal accessor that returns the initialized payment methods (with their
-	 * managers), used by the refresh path to preserve manager identity across
-	 * client-session refreshes.
-	 * @internal
-	 */
-	getInitializedPaymentMethods(): InitializedPaymentMethod[];
+	getPaymentMethods(): InitializedPaymentMethod[];
 	/**
 	 * Internal method to handle the onPaymentStart callback
 	 * @internal - This is only used internally by the SDK
@@ -2235,6 +2273,29 @@ export declare class PrimerJS {
 	 * ```
 	 */
 	setCardholderName(cardholderName: string): void;
+	/**
+	 * PayPal host-app App Switch: finishes the payment after the buyer returns
+	 * from the PayPal app, with the `orderId` the host app read from the return
+	 * deep link's `token` param. The outcome arrives through the usual
+	 * onCheckoutComplete/onCheckoutFail callbacks.
+	 *
+	 * Does not need the PayPal button to have rendered.
+	 *
+	 * @example
+	 * ```typescript
+	 * const checkout = document.querySelector('primer-checkout');
+	 * await checkout.primerJS?.resumeAppSwitch(orderIdFromDeepLink);
+	 * ```
+	 */
+	resumeAppSwitch(orderId: string): Promise<void>;
+	/** PayPal host-app App Switch: cancels when the buyer returns without approving. */
+	cancelAppSwitch(): Promise<void>;
+	/**
+	 * Warns rather than throwing when PayPal is absent: the host app calls these
+	 * on a deep-link return, where whether PayPal is in the session is not its
+	 * business.
+	 */
+	private findPayPalMethod;
 }
 export interface CardSubmitResult {
 	success?: boolean;
@@ -2308,6 +2369,18 @@ export interface PrimerEvents {
 	"primer:payment-approval-required": CustomEvent<PaymentApprovalRequiredData & {
 		timestamp: number;
 	}>;
+	"primer:shipping-address-change": CustomEvent<{
+		paymentMethodType: PaymentMethodType;
+		shippingAddress: NullableAddress;
+		setShippingOptions: (options: ShippingOption[]) => void;
+		timestamp: number;
+	}>;
+	"primer:shipping-option-change": CustomEvent<{
+		paymentMethodType: PaymentMethodType;
+		selectedShippingOption: ShippingOption;
+		continue: () => void;
+		timestamp: number;
+	}>;
 	"primer:vault-methods-update": CustomEvent<{
 		vaultedPayments: VaultedPaymentMethodSummary[];
 		cvvRecapture: boolean;
@@ -2387,6 +2460,26 @@ declare class PrimerEventsController {
 	 * backend to call /approve or /abort, and continueFlow() to resume the SDK.
 	 */
 	dispatchPaymentApprovalRequired(detail: PaymentApprovalRequiredData): void;
+	/**
+	 * @returns true if a listener called `preventDefault()` or
+	 * `setShippingOptions` synchronously; false if nothing is listening, so
+	 * the caller can resolve on its own rather than waiting out its timeout.
+	 */
+	dispatchShippingAddressChange(detail: {
+		paymentMethodType: PaymentMethodType;
+		shippingAddress: NullableAddress;
+		setShippingOptions: (options: ShippingOption[]) => void;
+	}): boolean;
+	/**
+	 * @returns true if a listener called `preventDefault()` or `continue()`
+	 * synchronously; false if nothing is listening, so the caller can resolve
+	 * on its own rather than waiting out its timeout.
+	 */
+	dispatchShippingOptionChange(detail: {
+		paymentMethodType: PaymentMethodType;
+		selectedShippingOption: ShippingOption;
+		continue: () => void;
+	}): boolean;
 	/**
 	 * Dispatch vault methods update event.
 	 * Called when vaulted payment methods are loaded or updated.
@@ -2545,8 +2638,6 @@ declare class HeadlessSdkController implements ReactiveController {
 	host: PrimerCheckoutType;
 	private currentSdkInstance;
 	private primerJS;
-	private loadingTimeout;
-	private isDisconnected;
 	/**
 	 * Session-bound telemetry of the current SDK instance. Held here (in
 	 * addition to the Lit context) so teardown paths can still emit
@@ -2557,8 +2648,6 @@ declare class HeadlessSdkController implements ReactiveController {
 	get primerJSInstance(): PrimerJS | null;
 	hostConnected(): void;
 	hostDisconnected(): void;
-	private setupLoadingTimeout;
-	private clearLoadingTimeout;
 	private cleanupResources;
 	/**
 	 * Datadog error reporting that works across the whole lifecycle: uses the
@@ -2574,11 +2663,23 @@ declare class HeadlessSdkController implements ReactiveController {
 	 * synchronously read state see `isProcessing: true`.
 	 */
 	private handlePaymentApprovalRequired;
+	/**
+	 * Bridges sdk-core's shipping-address-change callback to the
+	 * primer:shipping-address-change DOM event, auto-resolving with no
+	 * options so sdk-core's promise doesn't time out if nothing responds.
+	 */
+	private handleShippingAddressChange;
+	/**
+	 * Express Checkout (Apple Pay / Google Pay): sdk-core invokes this when the
+	 * shopper selects one of the shipping options previously supplied via
+	 * onShippingAddressChange. Same bridge/auto-resolve shape as
+	 * handleShippingAddressChange above.
+	 */
+	private handleShippingOptionChange;
 	initializeHeadless(): ([clientToken, options]: readonly [
 		string | null,
 		PrimerCheckoutOptions | null
 	]) => Promise<PrimerHeadlessCheckout | typeof initialState>;
-	private createManager;
 	/**
 	 * Updates card networks state and dispatches events
 	 *
@@ -2598,8 +2699,6 @@ declare class HeadlessSdkController implements ReactiveController {
  * 2. Setting the CSS custom property --primer-loader-disabled: 1
  */
 export declare class PrimerCheckoutComponent extends LitElement implements PrimerCheckoutType {
-	set jsInitialized(value: boolean);
-	get jsInitialized(): boolean;
 	get primerJS(): PrimerJS | undefined;
 	static styles: CSSResult[];
 	customStyles: string;
@@ -2611,11 +2710,9 @@ export declare class PrimerCheckoutComponent extends LitElement implements Prime
 	 * This is used to control the CSS-only loader visibility
 	 * @private
 	 */
-	private _jsInitialized;
+	private jsInitialized;
 	defaultSlot: HTMLSlotElement;
-	private previousLoadingState;
 	private hasAssignedContent;
-	private _loadingTimeoutId;
 	private _eventListenerController;
 	private _classObserver;
 	locale: LocaleCode;
@@ -2627,7 +2724,7 @@ export declare class PrimerCheckoutComponent extends LitElement implements Prime
 	headlessSdkController: HeadlessSdkController;
 	constructor();
 	connectedCallback(): void;
-	attributeChangedCallback(attrName: string, oldVal: string, newVal: string): void;
+	attributeChangedCallback(attrName: "custom-styles" | (string & {}), oldVal: string, newVal: string): void;
 	disconnectedCallback(): void;
 	willUpdate(changedProperties: PropertyValues): void;
 	updated(): void;
@@ -2646,11 +2743,6 @@ export declare class PrimerCheckoutComponent extends LitElement implements Prime
 	 * Uses AbortController signal to prevent circular event loops more safely
 	 */
 	private handleExternalShowOtherPaymentsToggle;
-	/**
-	 * Check if the loading state has changed and update the CSS loader visibility accordingly.
-	 * This method is called after each update cycle to detect when loading is complete.
-	 */
-	private checkLoadingStateChange;
 	render(): TemplateResult;
 	addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: PrimerCheckoutComponent, ev: HTMLElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
 	addEventListener<K extends keyof ShadowRootEventMap>(type: K, listener: (this: PrimerCheckoutComponent, ev: ShadowRootEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
@@ -2688,6 +2780,11 @@ export declare function injectLightTheme(): void;
  * @returns {void}
  */
 export declare function injectDarkTheme(): void;
+export interface AssetsConfig {
+	backgroundColor: string;
+	name: string;
+	iconUrl: string;
+}
 /**
  * Size options for the spinner component
  */
@@ -3280,10 +3377,13 @@ declare global {
 		"primer-klarna": PrimerKlarnaComponent;
 	}
 }
+type NativePaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.NATIVE;
+}>;
 declare class NativePaymentComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	type: PaymentMethodType | undefined;
-	paymentMethod: NativePaymentMethod | undefined;
+	paymentMethod: NativePaymentMethod$1 | undefined;
 	primerContext?: ContextType;
 	disabled: boolean;
 	private buttonContainerRef;
@@ -3293,6 +3393,9 @@ declare class NativePaymentComponent extends LitElement {
 	protected willUpdate(changedProperties: PropertyValues): void;
 	render(): import("lit-html").TemplateResult<1>;
 }
+type BlikPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.BLIK;
+}>;
 /**
  * BLIK Payment Component
  *
@@ -3315,7 +3418,7 @@ declare class NativePaymentComponent extends LitElement {
  */
 declare class BlikComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: BlikPaymentMethod | undefined;
+	paymentMethod: BlikPaymentMethod$1 | undefined;
 	disabled: boolean;
 	private currentState;
 	private blikCode;
@@ -3376,13 +3479,16 @@ declare global {
 		"primer-blik": BlikComponent;
 	}
 }
+type AdyenKlarnaPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.ADYEN_KLARNA;
+}>;
 declare class AdyenKlarnaComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	primerContext?: ContextType;
 	/**
 	 * The payment method from context
 	 */
-	paymentMethod?: InitializedPaymentMethod;
+	paymentMethod?: AdyenKlarnaPaymentMethod$1;
 	/**
 	 * Whether the component is disabled
 	 */
@@ -3400,7 +3506,6 @@ declare class AdyenKlarnaComponent extends LitElement {
 	 */
 	private loading;
 	private paymentInProgress;
-	private get manager();
 	/**
 	 * Get the Klarna logo URL from the payment method configuration
 	 */
@@ -3415,6 +3520,9 @@ declare global {
 		"primer-adyen-klarna": AdyenKlarnaComponent;
 	}
 }
+type MbwayPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.MBWAY;
+}>;
 /**
  * Adyen MB WAY Payment Component
  *
@@ -3424,7 +3532,7 @@ declare global {
  */
 declare class AdyenMbwayComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: MbwayPaymentMethod | undefined;
+	paymentMethod: MbwayPaymentMethod$1 | undefined;
 	disabled: boolean;
 	private currentState;
 	private phoneNumber;
@@ -3447,9 +3555,12 @@ declare global {
 		"primer-adyen-mbway": AdyenMbwayComponent;
 	}
 }
+type QRCodePaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.QRCODE;
+}>;
 declare class QRCodeComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: QRCodePaymentMethod | undefined;
+	paymentMethod: QRCodePaymentMethod$1 | undefined;
 	disabled: boolean;
 	primerContext?: ContextType;
 	private isExpanded;
@@ -3470,6 +3581,48 @@ declare global {
 		"primer-qrcode": QRCodeComponent;
 	}
 }
+declare class PaymentMethodButtonComponent extends LitElement {
+	static styles: import("lit").CSSResult[];
+	type: PaymentMethodType | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
+	/**
+	 * Based on packages/primer-sdk-web/src/payment-methods/Button.tsx
+	 * Should be replaced once we align on a better solution across all platforms.
+	 */
+	private _legacyGetButtonLabel;
+	private _getBackgroundColor;
+	private _getIconUrl;
+	private _getIconPosition;
+	private _getTextColor;
+	private _getDisplayName;
+	private _setupTask;
+	private _handleClick;
+	render(): symbol | import("lit-html").TemplateResult<1> | undefined;
+}
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-payment-method-button": PaymentMethodButtonComponent;
+	}
+}
+type BackendDrivenPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.BACKEND_DRIVEN;
+}>;
+/**
+ * Surface for a payment method whose flow the backend drives through a step
+ * tree. Today every step tree starts by handing off to a third party, so this
+ * renders a button — but unlike a redirect method, what the flow needs of this
+ * component is open-ended: steps can ask for input, render UI, or wait, and
+ * this is where that grows.
+ */
+declare class BackendDrivenComponent extends LitElement {
+	static styles: import("lit").CSSResult;
+	paymentMethod: BackendDrivenPaymentMethod$1 | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
+	private _handleClick;
+	render(): import("lit-html").TemplateResult<1>;
+}
 declare class PaymentMethodComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	type: PaymentMethodType | undefined;
@@ -3503,33 +3656,12 @@ declare global {
 		"primer-payment-method-container": PaymentMethodContainerComponent;
 	}
 }
-declare class PaymentMethodButtonComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	type: PaymentMethodType | undefined;
-	disabled: boolean;
-	primerContext?: ContextType;
-	/**
-	 * Based on packages/primer-sdk-web/src/payment-methods/Button.tsx
-	 * Should be replaced once we align on a better solution across all platforms.
-	 */
-	private _legacyGetButtonLabel;
-	private _getBackgroundColor;
-	private _getIconUrl;
-	private _getIconPosition;
-	private _getTextColor;
-	private _getDisplayName;
-	private _setupTask;
-	private _handleClick;
-	render(): symbol | import("lit-html").TemplateResult<1> | undefined;
-}
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-payment-method-button": PaymentMethodButtonComponent;
-	}
-}
+type RedirectPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.REDIRECT;
+}>;
 declare class RedirectPaymentComponent extends LitElement {
 	static styles: import("lit").CSSResult;
-	paymentMethod: RedirectPaymentMethod | undefined;
+	paymentMethod: RedirectPaymentMethod$1 | undefined;
 	disabled: boolean;
 	primerContext?: ContextType;
 	private _handleClick;
@@ -3540,6 +3672,11 @@ declare global {
 		"primer-redirect-payment": RedirectPaymentComponent;
 	}
 }
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-backend-driven": BackendDrivenComponent;
+	}
+}
 /**
  * BillingAddressComponent provides a form for collecting billing address information.
  *
@@ -4993,6 +5130,7 @@ export declare function loadPrimer(): void;
 
 export {
 	AdyenMbwayComponent as AdyenMbway,
+	BackendDrivenComponent as BackendDriven,
 	BillingAddressComponent as BillingAddress,
 	BlikComponent as Blik,
 	ButtonComponent as Button,