@flopay/shared 1.4.19 → 1.4.21

package/dist/index.d.cts

@@ -193,6 +193,60 @@ interface LineItem {
 }
 /** Checkout mode controlling the payment UI behavior. */
 type CheckoutMode = 'full' | 'auto' | 'confirm';
+/**
+ * Checkout mode reported by a session read. `setup` is read-only in the
+ * browser SDK: merchant-authenticated setup-session creation stays on the
+ * merchant's server, while the existing create parameter types intentionally
+ * continue to accept only {@link CheckoutMode}.
+ */
+type CheckoutSessionMode = CheckoutMode | 'setup';
+/** Whether checkout captures immediately or only authorises funds for later capture. */
+type CaptureMethod = 'automatic' | 'manual';
+/** Stable, provider-neutral authorization lifecycle failures exposed by the SDK. */
+type CheckoutFailureOutcome = 'authorization_declined' | 'authentication_required' | 'authorization_expired' | 'capture_failed';
+/** Lifecycle states returned by the merchant-scoped saved-method list. */
+type SavedPaymentMethodStatus = 'pending' | 'active' | 'deleted';
+/**
+ * Display-only card fields safe to show to a customer. This deliberately has
+ * no provider payment-method id, vault token, capture reference, or reusable
+ * credential.
+ */
+interface SavedCardDisplay {
+    /** FloPay payment-method UUID. */
+    id: string;
+    brand: string;
+    lastFour: string;
+    expiryMonth: number;
+    expiryYear: number;
+    status: SavedPaymentMethodStatus;
+}
+/** Stable conflicts returned by `DELETE /v1/payment-methods/:id`. */
+type PaymentMethodRemovalConflictCode = 'payment_method_has_active_payment' | 'payment_method_in_use' | 'payment_method_reassignment_requires_payer_action';
+/** Indistinguishable missing-or-inaccessible saved-method response. */
+interface PaymentMethodRemovalNotFoundError {
+    statusCode: 404;
+    code: 'payment_method_not_found';
+    message?: string;
+}
+/** A blocked removal that requires merchant/customer guidance. */
+interface PaymentMethodRemovalConflictError {
+    statusCode: 409;
+    code: PaymentMethodRemovalConflictCode;
+    message?: string;
+}
+/** Provider-neutral reason accompanying a retry-safe removal failure. */
+type PaymentMethodRemovalFailureReason = 'payment_method_data_incomplete' | 'provider_cleanup_failed' | 'provider_unavailable' | 'provider_verification_failed';
+/** Retry-safe incomplete provider/vault cleanup response. */
+interface PaymentMethodRemovalRetryableError {
+    statusCode: 502;
+    code: 'payment_method_deletion_failed';
+    reason: PaymentMethodRemovalFailureReason;
+    retrySafe: true;
+    resolution: string;
+    message?: string;
+}
+/** Stable error union for merchant-server saved-method removal calls. */
+type PaymentMethodRemovalError = PaymentMethodRemovalNotFoundError | PaymentMethodRemovalConflictError | PaymentMethodRemovalRetryableError;
 /**
  * Discriminator describing whether a checkout product is a one-time item or a
  * recurring subscription. Mirrors the backend's `ProductTypeEnum`.
@@ -306,13 +360,21 @@ interface CheckoutSession {
     id: string;
     clientSecret: string;
     mode: 'payment' | 'subscription' | 'setup';
-    status: 'open' | 'complete' | 'expired';
+    status: 'open' | 'authorized' | 'complete' | 'expired';
     amount: number;
     currency: string;
+    /** Capture behavior persisted by the billing API. Omitted on legacy sessions. */
+    captureMethod?: CaptureMethod;
+    /** FloPay payment transaction UUID used by the merchant capture REST route. */
+    paymentId?: string;
+    /** Provider authorisation deadline. Present while an authorisation is capturable. */
+    authorizationExpiresAt?: string;
+    /** Stable failure outcome when the authorization lifecycle did not settle. */
+    failureOutcome?: CheckoutFailureOutcome;
     lineItems?: LineItem[];
     customer?: Customer;
     metadata?: Record<string, string>;
-    checkoutMode?: CheckoutMode;
+    checkoutMode?: CheckoutSessionMode;
     /**
      * Optional embedded hosted vault capture credentials
      * (TeamFloPay/backend#823). This remains the preferred fast path during the
@@ -375,7 +437,13 @@ interface CheckoutSession {
 }
 /** The result of a payment confirmation attempt. */
 interface PaymentResult {
-    status: 'succeeded' | 'processing' | 'requires_action' | 'failed';
+    status: 'authorized' | 'succeeded' | 'processing' | 'requires_action' | 'failed';
+    /** FloPay payment transaction UUID, present for an authorised outcome. */
+    paymentId?: string;
+    /** Owning checkout session UUID, present for an authorised outcome. */
+    sessionId?: string;
+    /** Provider authorisation deadline, present while the hold is capturable. */
+    authorizationExpiresAt?: string;
     paymentIntentId?: string;
     paymentMethodId?: string;
     checkoutMethod?: CheckoutButtonMethod;
@@ -690,6 +758,14 @@ type CardCaptureEventType = 'ready' | 'submitting' | 'complete' | 'decline' | 'e
 interface CardCaptureOutcomeEvent {
     /** Owning checkout session id, for correlation. */
     sessionId?: string;
+    /** Provider-neutral terminal result. Absent on legacy widget messages. */
+    outcome?: 'authorized' | 'succeeded';
+    /** FloPay payment transaction UUID used by the merchant capture REST route. */
+    paymentId?: string;
+    /** Provider authorisation deadline while the hold is capturable. */
+    authorizationExpiresAt?: string;
+    /** Stable provider-neutral failure for decline/error outcomes. */
+    failureOutcome?: CheckoutFailureOutcome;
     /** Provider intent / transaction id on a terminal outcome, when available. */
     intentId?: string;
     /** Mapped decline reason on `decline` (backend `PaymentDeclineReason` enum). */
@@ -702,6 +778,8 @@ interface CardCaptureOutcomeEvent {
      * other event type.
      */
     nextActionRedirectUrl?: string;
+    /** Display-only saved card produced by a successful setup, when supplied. */
+    paymentMethod?: SavedCardDisplay;
 }
 /**
  * `window.postMessage` payload the hosted vault widget sends its embedding SDK
@@ -735,6 +813,14 @@ interface VaultCaptureResultMessage {
      * the SDK was given a token it rejects messages that omit or mismatch it.
      */
     messageToken?: string;
+    /** Provider-neutral terminal result. Absent on legacy widget messages. */
+    outcome?: 'authorized' | 'succeeded';
+    /** FloPay payment transaction UUID used by the merchant capture REST route. */
+    paymentId?: string;
+    /** Provider authorisation deadline while the hold is capturable. */
+    authorizationExpiresAt?: string;
+    /** Stable provider-neutral failure for decline/error outcomes. */
+    failureOutcome?: CheckoutFailureOutcome;
     intentId?: string;
     declineReason?: string;
     message?: string;
@@ -745,6 +831,8 @@ interface VaultCaptureResultMessage {
      * blocked by the SDK's processing backdrop.
      */
     nextActionRedirectUrl?: string;
+    /** Display-only saved card produced by a successful setup, when supplied. */
+    paymentMethod?: SavedCardDisplay;
 }
 /** Options for mounting the hosted vault widget into a container element. */
 interface CardCaptureMountOptions {
@@ -892,6 +980,8 @@ interface TokenizedBody {
 /** Structured checkout-processing error returned by the billing API. */
 interface CheckoutProcessError {
     type: string;
+    /** Stable provider-neutral failure outcome when supplied by the backend. */
+    outcome?: CheckoutFailureOutcome;
     message?: string;
     transactionId?: string;
     threeDSecureToken?: string;
@@ -1167,6 +1257,12 @@ interface CreateSessionParams {
      * - 'full' – full checkout flow
      */
     checkoutMode?: 'confirm' | 'auto' | 'full';
+    /**
+     * Payment capture behavior. Omit (or use `'automatic'`) to preserve
+     * immediate capture; use `'manual'` to authorise funds for later capture.
+     * Manual capture is not supported for subscription products.
+     */
+    captureMethod?: CaptureMethod;
     /** Coupon codes to apply. */
     couponCodes?: string[];
     /** Pixel / analytics tags forwarded to the checkout page. */
@@ -1226,6 +1322,12 @@ interface InlineSessionParams {
     cancelUrl: string;
     /** Checkout mode: 'full' (default), 'auto', or 'confirm'. */
     checkoutMode?: 'full' | 'auto' | 'confirm';
+    /**
+     * Payment capture behavior. Omit (or use `'automatic'`) to preserve
+     * immediate capture; use `'manual'` to authorise funds for later capture.
+     * Manual capture is not supported for subscription products.
+     */
+    captureMethod?: CaptureMethod;
     /** Optional saved/tokenized payment method for inline auto or confirm checkout. */
     tokenizedData?: TokenizedBody;
     /** Coupon codes to apply. */
@@ -1407,6 +1509,13 @@ interface CountryOption {
     flag: string;
 }
 
+/**
+ * Whether a read session is safe to mount in a no-charge card-setup surface.
+ * Both the explicit setup mode and the empty, zero-amount cart are required so
+ * a purchase session can never be mistaken for a bare card form.
+ */
+declare function isCardSetupCheckoutSession(session: CheckoutSession): boolean;
+
 interface SentryStackFrameLike {
     in_app?: boolean;
     filename?: string;
@@ -1454,13 +1563,13 @@ declare const TELEMETRY_REQUEST_CATEGORIES: readonly ["session_create", "session
 type TelemetryRequestCategory = (typeof TELEMETRY_REQUEST_CATEGORIES)[number];
 declare const TELEMETRY_STATUS_CLASSES: readonly ["2xx", "3xx", "4xx", "5xx", "network_error", "timeout", "unknown"];
 type TelemetryStatusClass = (typeof TELEMETRY_STATUS_CLASSES)[number];
-declare const TELEMETRY_CHECKOUT_MODES: readonly ["full", "auto", "confirm", "unknown"];
+declare const TELEMETRY_CHECKOUT_MODES: readonly ["full", "auto", "confirm", "setup", "unknown"];
 type TelemetryCheckoutMode = (typeof TELEMETRY_CHECKOUT_MODES)[number];
 declare const TELEMETRY_LAYOUTS: readonly ["embedded", "buttons", "automatic", "unknown"];
 type TelemetryLayout = (typeof TELEMETRY_LAYOUTS)[number];
 declare const TELEMETRY_DURATION_MODES: readonly ["machine", "buyer", "total"];
 type TelemetryDurationMode = (typeof TELEMETRY_DURATION_MODES)[number];
-declare const TELEMETRY_EXPECTED_OUTCOMES: readonly ["action_required", "customer_abandoned", "payment_cancelled", "payment_declined", "payment_succeeded", "validation_rejected"];
+declare const TELEMETRY_EXPECTED_OUTCOMES: readonly ["action_required", "card_setup_declined", "card_setup_succeeded", "customer_abandoned", "payment_cancelled", "payment_declined", "payment_authorized", "payment_succeeded", "validation_rejected"];
 type TelemetryExpectedOutcome = (typeof TELEMETRY_EXPECTED_OUTCOMES)[number];
 interface TelemetryCommonFields {
     eventId: string;
@@ -1596,7 +1705,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.4.19";
+declare const SDK_VERSION = "1.4.21";
 /**
  * HTTP header the SDK sends on checkout-session create/read requests so the
  * backend can observe compatibility. Version 1.4.9 is the first release that
@@ -2123,6 +2232,24 @@ interface BuildCheckoutDisplayDataOptions {
  */
 declare function buildCheckoutDisplayData(session: CheckoutSession, options?: BuildCheckoutDisplayDataOptions): CheckoutDisplayData;
 
+interface CaptureMethodEligibilityParams {
+    captureMethod?: CaptureMethod;
+    products?: readonly CheckoutProduct[];
+    items?: readonly CheckoutItem[];
+    subscriptions?: readonly CheckoutSubscription[];
+}
+/**
+ * Reject authorisation-only checkout carts that contain a subscription.
+ *
+ * The backend remains authoritative; this shared preflight keeps every SDK
+ * creation style from mounting or redirecting to a checkout that cannot
+ * support manual capture.
+ *
+ * Subscription detection in the unified `products` shape is best-effort:
+ * `CheckoutProduct.type` is optional, so catalog-backed subscriptions that
+ * omit it are resolved and rejected by the authoritative backend validation.
+ */
+declare function assertCaptureMethodEligible(params: CaptureMethodEligibilityParams): void;
 /**
  * Whether a session may be created through the **detached** shell + claim flow
  * (TeamFloPay/backend#1099).
@@ -2186,6 +2313,20 @@ declare function buildItemPayload(item: CheckoutItem, sessionCurrency: string):
  */
 declare function buildSubscriptionPayload(subscription: CheckoutSubscription, sessionCurrency: string): Record<string, unknown>;
 
+/** Returns whether a checkout deliberately stops after placing an authorization hold. */
+declare function isAuthorizationOnlySession(session?: {
+    captureMethod?: CaptureMethod;
+} | null): boolean;
+/**
+ * Returns whether an outcome represents money settled for the active checkout.
+ *
+ * `requires_capture` remains successful for legacy automatic/PayPal flows, but
+ * can never be treated as settled for a manual-capture session.
+ */
+declare function isMoneySettledOutcome(outcome?: string | null, captureMethod?: CaptureMethod): boolean;
+/** Collapses provider/backend reason strings into the SDK's closed failure vocabulary. */
+declare function normalizeCheckoutFailureOutcome(value: unknown): CheckoutFailureOutcome | undefined;
+
 /**
  * Look up currency information by ISO 3166-1 alpha-2 country code.
  * Falls back to USD when the country is not in the map.
@@ -2279,4 +2420,4 @@ declare function isUuidV4(value: unknown): value is string;
  */
 declare function randomUuidV4(): string;
 
-export { type AVSFieldConfig, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, COUNTRY_OPTIONS, CURRENCY_MAP, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessError, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type ConfirmPaymentParams, type CountryOption, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DisplayLineItem, ELEMENT_TYPES, type ElementChangeEvent, type ElementOptions, type ElementType, FLAT_APPEARANCE, FLO_SDK_VERSION_HEADER, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, type MountedElement, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, type PayPalPaymentResult, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentProviderAdapter, type PaymentResult, type PriceData, type ProcessPaymentParams, type RecurringInterval, SDK_VERSION, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, SUPPORTED_CARD_BRANDS, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type StateOption, type StripeMethodEntry, type StripeMethodThemeVariant, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, type TagsData, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type WebhookEvent, apiError, authenticationError, buildCheckoutDisplayData, buildItemPayload, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, classifyPaymentRejection, classifyTelemetryFailure, configureFlopay, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCurrency, foldIntoProducts, generateIdempotencyKey, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasVendoredStripeMethodLogo, isAVSEnabled, isAVSFieldVisible, isDetachedSessionEligible, isPostalCodeSupported, isSetupIntentClientSecret, isUuidV4, isValidPostalCode, isValidPublishableKey, isValidSecretKey, needsStripeMethodExplicitConfirm, networkError, normalizeGatewayEnvironment, partitionStripeMethods, randomUuidV4, rateLimitError, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveIdempotencyKey, resolveSessionCurrency, resolveStripeMethodBrandVariant, resolveTheme, serializeTelemetryBatch, stripeExpressMethodToOptionKey, telemetryStatusClass, validationError };
+export { type AVSFieldConfig, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessError, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type ConfirmPaymentParams, type CountryOption, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DisplayLineItem, ELEMENT_TYPES, type ElementChangeEvent, type ElementOptions, type ElementType, FLAT_APPEARANCE, FLO_SDK_VERSION_HEADER, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, type MountedElement, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, type PayPalPaymentResult, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentProviderAdapter, type PaymentResult, type PriceData, type ProcessPaymentParams, type RecurringInterval, SDK_VERSION, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedPaymentMethodStatus, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type StateOption, type StripeMethodEntry, type StripeMethodThemeVariant, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, type TagsData, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type WebhookEvent, apiError, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildItemPayload, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, classifyPaymentRejection, classifyTelemetryFailure, configureFlopay, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCurrency, foldIntoProducts, generateIdempotencyKey, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasVendoredStripeMethodLogo, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isPostalCodeSupported, isSetupIntentClientSecret, isUuidV4, isValidPostalCode, isValidPublishableKey, isValidSecretKey, needsStripeMethodExplicitConfirm, networkError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, randomUuidV4, rateLimitError, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveIdempotencyKey, resolveSessionCurrency, resolveStripeMethodBrandVariant, resolveTheme, serializeTelemetryBatch, stripeExpressMethodToOptionKey, telemetryStatusClass, validationError };

package/dist/index.d.ts

@@ -193,6 +193,60 @@ interface LineItem {
 }
 /** Checkout mode controlling the payment UI behavior. */
 type CheckoutMode = 'full' | 'auto' | 'confirm';
+/**
+ * Checkout mode reported by a session read. `setup` is read-only in the
+ * browser SDK: merchant-authenticated setup-session creation stays on the
+ * merchant's server, while the existing create parameter types intentionally
+ * continue to accept only {@link CheckoutMode}.
+ */
+type CheckoutSessionMode = CheckoutMode | 'setup';
+/** Whether checkout captures immediately or only authorises funds for later capture. */
+type CaptureMethod = 'automatic' | 'manual';
+/** Stable, provider-neutral authorization lifecycle failures exposed by the SDK. */
+type CheckoutFailureOutcome = 'authorization_declined' | 'authentication_required' | 'authorization_expired' | 'capture_failed';
+/** Lifecycle states returned by the merchant-scoped saved-method list. */
+type SavedPaymentMethodStatus = 'pending' | 'active' | 'deleted';
+/**
+ * Display-only card fields safe to show to a customer. This deliberately has
+ * no provider payment-method id, vault token, capture reference, or reusable
+ * credential.
+ */
+interface SavedCardDisplay {
+    /** FloPay payment-method UUID. */
+    id: string;
+    brand: string;
+    lastFour: string;
+    expiryMonth: number;
+    expiryYear: number;
+    status: SavedPaymentMethodStatus;
+}
+/** Stable conflicts returned by `DELETE /v1/payment-methods/:id`. */
+type PaymentMethodRemovalConflictCode = 'payment_method_has_active_payment' | 'payment_method_in_use' | 'payment_method_reassignment_requires_payer_action';
+/** Indistinguishable missing-or-inaccessible saved-method response. */
+interface PaymentMethodRemovalNotFoundError {
+    statusCode: 404;
+    code: 'payment_method_not_found';
+    message?: string;
+}
+/** A blocked removal that requires merchant/customer guidance. */
+interface PaymentMethodRemovalConflictError {
+    statusCode: 409;
+    code: PaymentMethodRemovalConflictCode;
+    message?: string;
+}
+/** Provider-neutral reason accompanying a retry-safe removal failure. */
+type PaymentMethodRemovalFailureReason = 'payment_method_data_incomplete' | 'provider_cleanup_failed' | 'provider_unavailable' | 'provider_verification_failed';
+/** Retry-safe incomplete provider/vault cleanup response. */
+interface PaymentMethodRemovalRetryableError {
+    statusCode: 502;
+    code: 'payment_method_deletion_failed';
+    reason: PaymentMethodRemovalFailureReason;
+    retrySafe: true;
+    resolution: string;
+    message?: string;
+}
+/** Stable error union for merchant-server saved-method removal calls. */
+type PaymentMethodRemovalError = PaymentMethodRemovalNotFoundError | PaymentMethodRemovalConflictError | PaymentMethodRemovalRetryableError;
 /**
  * Discriminator describing whether a checkout product is a one-time item or a
  * recurring subscription. Mirrors the backend's `ProductTypeEnum`.
@@ -306,13 +360,21 @@ interface CheckoutSession {
     id: string;
     clientSecret: string;
     mode: 'payment' | 'subscription' | 'setup';
-    status: 'open' | 'complete' | 'expired';
+    status: 'open' | 'authorized' | 'complete' | 'expired';
     amount: number;
     currency: string;
+    /** Capture behavior persisted by the billing API. Omitted on legacy sessions. */
+    captureMethod?: CaptureMethod;
+    /** FloPay payment transaction UUID used by the merchant capture REST route. */
+    paymentId?: string;
+    /** Provider authorisation deadline. Present while an authorisation is capturable. */
+    authorizationExpiresAt?: string;
+    /** Stable failure outcome when the authorization lifecycle did not settle. */
+    failureOutcome?: CheckoutFailureOutcome;
     lineItems?: LineItem[];
     customer?: Customer;
     metadata?: Record<string, string>;
-    checkoutMode?: CheckoutMode;
+    checkoutMode?: CheckoutSessionMode;
     /**
      * Optional embedded hosted vault capture credentials
      * (TeamFloPay/backend#823). This remains the preferred fast path during the
@@ -375,7 +437,13 @@ interface CheckoutSession {
 }
 /** The result of a payment confirmation attempt. */
 interface PaymentResult {
-    status: 'succeeded' | 'processing' | 'requires_action' | 'failed';
+    status: 'authorized' | 'succeeded' | 'processing' | 'requires_action' | 'failed';
+    /** FloPay payment transaction UUID, present for an authorised outcome. */
+    paymentId?: string;
+    /** Owning checkout session UUID, present for an authorised outcome. */
+    sessionId?: string;
+    /** Provider authorisation deadline, present while the hold is capturable. */
+    authorizationExpiresAt?: string;
     paymentIntentId?: string;
     paymentMethodId?: string;
     checkoutMethod?: CheckoutButtonMethod;
@@ -690,6 +758,14 @@ type CardCaptureEventType = 'ready' | 'submitting' | 'complete' | 'decline' | 'e
 interface CardCaptureOutcomeEvent {
     /** Owning checkout session id, for correlation. */
     sessionId?: string;
+    /** Provider-neutral terminal result. Absent on legacy widget messages. */
+    outcome?: 'authorized' | 'succeeded';
+    /** FloPay payment transaction UUID used by the merchant capture REST route. */
+    paymentId?: string;
+    /** Provider authorisation deadline while the hold is capturable. */
+    authorizationExpiresAt?: string;
+    /** Stable provider-neutral failure for decline/error outcomes. */
+    failureOutcome?: CheckoutFailureOutcome;
     /** Provider intent / transaction id on a terminal outcome, when available. */
     intentId?: string;
     /** Mapped decline reason on `decline` (backend `PaymentDeclineReason` enum). */
@@ -702,6 +778,8 @@ interface CardCaptureOutcomeEvent {
      * other event type.
      */
     nextActionRedirectUrl?: string;
+    /** Display-only saved card produced by a successful setup, when supplied. */
+    paymentMethod?: SavedCardDisplay;
 }
 /**
  * `window.postMessage` payload the hosted vault widget sends its embedding SDK
@@ -735,6 +813,14 @@ interface VaultCaptureResultMessage {
      * the SDK was given a token it rejects messages that omit or mismatch it.
      */
     messageToken?: string;
+    /** Provider-neutral terminal result. Absent on legacy widget messages. */
+    outcome?: 'authorized' | 'succeeded';
+    /** FloPay payment transaction UUID used by the merchant capture REST route. */
+    paymentId?: string;
+    /** Provider authorisation deadline while the hold is capturable. */
+    authorizationExpiresAt?: string;
+    /** Stable provider-neutral failure for decline/error outcomes. */
+    failureOutcome?: CheckoutFailureOutcome;
     intentId?: string;
     declineReason?: string;
     message?: string;
@@ -745,6 +831,8 @@ interface VaultCaptureResultMessage {
      * blocked by the SDK's processing backdrop.
      */
     nextActionRedirectUrl?: string;
+    /** Display-only saved card produced by a successful setup, when supplied. */
+    paymentMethod?: SavedCardDisplay;
 }
 /** Options for mounting the hosted vault widget into a container element. */
 interface CardCaptureMountOptions {
@@ -892,6 +980,8 @@ interface TokenizedBody {
 /** Structured checkout-processing error returned by the billing API. */
 interface CheckoutProcessError {
     type: string;
+    /** Stable provider-neutral failure outcome when supplied by the backend. */
+    outcome?: CheckoutFailureOutcome;
     message?: string;
     transactionId?: string;
     threeDSecureToken?: string;
@@ -1167,6 +1257,12 @@ interface CreateSessionParams {
      * - 'full' – full checkout flow
      */
     checkoutMode?: 'confirm' | 'auto' | 'full';
+    /**
+     * Payment capture behavior. Omit (or use `'automatic'`) to preserve
+     * immediate capture; use `'manual'` to authorise funds for later capture.
+     * Manual capture is not supported for subscription products.
+     */
+    captureMethod?: CaptureMethod;
     /** Coupon codes to apply. */
     couponCodes?: string[];
     /** Pixel / analytics tags forwarded to the checkout page. */
@@ -1226,6 +1322,12 @@ interface InlineSessionParams {
     cancelUrl: string;
     /** Checkout mode: 'full' (default), 'auto', or 'confirm'. */
     checkoutMode?: 'full' | 'auto' | 'confirm';
+    /**
+     * Payment capture behavior. Omit (or use `'automatic'`) to preserve
+     * immediate capture; use `'manual'` to authorise funds for later capture.
+     * Manual capture is not supported for subscription products.
+     */
+    captureMethod?: CaptureMethod;
     /** Optional saved/tokenized payment method for inline auto or confirm checkout. */
     tokenizedData?: TokenizedBody;
     /** Coupon codes to apply. */
@@ -1407,6 +1509,13 @@ interface CountryOption {
     flag: string;
 }
 
+/**
+ * Whether a read session is safe to mount in a no-charge card-setup surface.
+ * Both the explicit setup mode and the empty, zero-amount cart are required so
+ * a purchase session can never be mistaken for a bare card form.
+ */
+declare function isCardSetupCheckoutSession(session: CheckoutSession): boolean;
+
 interface SentryStackFrameLike {
     in_app?: boolean;
     filename?: string;
@@ -1454,13 +1563,13 @@ declare const TELEMETRY_REQUEST_CATEGORIES: readonly ["session_create", "session
 type TelemetryRequestCategory = (typeof TELEMETRY_REQUEST_CATEGORIES)[number];
 declare const TELEMETRY_STATUS_CLASSES: readonly ["2xx", "3xx", "4xx", "5xx", "network_error", "timeout", "unknown"];
 type TelemetryStatusClass = (typeof TELEMETRY_STATUS_CLASSES)[number];
-declare const TELEMETRY_CHECKOUT_MODES: readonly ["full", "auto", "confirm", "unknown"];
+declare const TELEMETRY_CHECKOUT_MODES: readonly ["full", "auto", "confirm", "setup", "unknown"];
 type TelemetryCheckoutMode = (typeof TELEMETRY_CHECKOUT_MODES)[number];
 declare const TELEMETRY_LAYOUTS: readonly ["embedded", "buttons", "automatic", "unknown"];
 type TelemetryLayout = (typeof TELEMETRY_LAYOUTS)[number];
 declare const TELEMETRY_DURATION_MODES: readonly ["machine", "buyer", "total"];
 type TelemetryDurationMode = (typeof TELEMETRY_DURATION_MODES)[number];
-declare const TELEMETRY_EXPECTED_OUTCOMES: readonly ["action_required", "customer_abandoned", "payment_cancelled", "payment_declined", "payment_succeeded", "validation_rejected"];
+declare const TELEMETRY_EXPECTED_OUTCOMES: readonly ["action_required", "card_setup_declined", "card_setup_succeeded", "customer_abandoned", "payment_cancelled", "payment_declined", "payment_authorized", "payment_succeeded", "validation_rejected"];
 type TelemetryExpectedOutcome = (typeof TELEMETRY_EXPECTED_OUTCOMES)[number];
 interface TelemetryCommonFields {
     eventId: string;
@@ -1596,7 +1705,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.4.19";
+declare const SDK_VERSION = "1.4.21";
 /**
  * HTTP header the SDK sends on checkout-session create/read requests so the
  * backend can observe compatibility. Version 1.4.9 is the first release that
@@ -2123,6 +2232,24 @@ interface BuildCheckoutDisplayDataOptions {
  */
 declare function buildCheckoutDisplayData(session: CheckoutSession, options?: BuildCheckoutDisplayDataOptions): CheckoutDisplayData;
 
+interface CaptureMethodEligibilityParams {
+    captureMethod?: CaptureMethod;
+    products?: readonly CheckoutProduct[];
+    items?: readonly CheckoutItem[];
+    subscriptions?: readonly CheckoutSubscription[];
+}
+/**
+ * Reject authorisation-only checkout carts that contain a subscription.
+ *
+ * The backend remains authoritative; this shared preflight keeps every SDK
+ * creation style from mounting or redirecting to a checkout that cannot
+ * support manual capture.
+ *
+ * Subscription detection in the unified `products` shape is best-effort:
+ * `CheckoutProduct.type` is optional, so catalog-backed subscriptions that
+ * omit it are resolved and rejected by the authoritative backend validation.
+ */
+declare function assertCaptureMethodEligible(params: CaptureMethodEligibilityParams): void;
 /**
  * Whether a session may be created through the **detached** shell + claim flow
  * (TeamFloPay/backend#1099).
@@ -2186,6 +2313,20 @@ declare function buildItemPayload(item: CheckoutItem, sessionCurrency: string):
  */
 declare function buildSubscriptionPayload(subscription: CheckoutSubscription, sessionCurrency: string): Record<string, unknown>;
 
+/** Returns whether a checkout deliberately stops after placing an authorization hold. */
+declare function isAuthorizationOnlySession(session?: {
+    captureMethod?: CaptureMethod;
+} | null): boolean;
+/**
+ * Returns whether an outcome represents money settled for the active checkout.
+ *
+ * `requires_capture` remains successful for legacy automatic/PayPal flows, but
+ * can never be treated as settled for a manual-capture session.
+ */
+declare function isMoneySettledOutcome(outcome?: string | null, captureMethod?: CaptureMethod): boolean;
+/** Collapses provider/backend reason strings into the SDK's closed failure vocabulary. */
+declare function normalizeCheckoutFailureOutcome(value: unknown): CheckoutFailureOutcome | undefined;
+
 /**
  * Look up currency information by ISO 3166-1 alpha-2 country code.
  * Falls back to USD when the country is not in the map.
@@ -2279,4 +2420,4 @@ declare function isUuidV4(value: unknown): value is string;
  */
 declare function randomUuidV4(): string;
 
-export { type AVSFieldConfig, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, COUNTRY_OPTIONS, CURRENCY_MAP, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessError, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type ConfirmPaymentParams, type CountryOption, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DisplayLineItem, ELEMENT_TYPES, type ElementChangeEvent, type ElementOptions, type ElementType, FLAT_APPEARANCE, FLO_SDK_VERSION_HEADER, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, type MountedElement, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, type PayPalPaymentResult, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentProviderAdapter, type PaymentResult, type PriceData, type ProcessPaymentParams, type RecurringInterval, SDK_VERSION, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, SUPPORTED_CARD_BRANDS, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type StateOption, type StripeMethodEntry, type StripeMethodThemeVariant, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, type TagsData, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type WebhookEvent, apiError, authenticationError, buildCheckoutDisplayData, buildItemPayload, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, classifyPaymentRejection, classifyTelemetryFailure, configureFlopay, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCurrency, foldIntoProducts, generateIdempotencyKey, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasVendoredStripeMethodLogo, isAVSEnabled, isAVSFieldVisible, isDetachedSessionEligible, isPostalCodeSupported, isSetupIntentClientSecret, isUuidV4, isValidPostalCode, isValidPublishableKey, isValidSecretKey, needsStripeMethodExplicitConfirm, networkError, normalizeGatewayEnvironment, partitionStripeMethods, randomUuidV4, rateLimitError, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveIdempotencyKey, resolveSessionCurrency, resolveStripeMethodBrandVariant, resolveTheme, serializeTelemetryBatch, stripeExpressMethodToOptionKey, telemetryStatusClass, validationError };
+export { type AVSFieldConfig, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessError, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type ConfirmPaymentParams, type CountryOption, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DisplayLineItem, ELEMENT_TYPES, type ElementChangeEvent, type ElementOptions, type ElementType, FLAT_APPEARANCE, FLO_SDK_VERSION_HEADER, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, type MountedElement, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, type PayPalPaymentResult, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentProviderAdapter, type PaymentResult, type PriceData, type ProcessPaymentParams, type RecurringInterval, SDK_VERSION, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedPaymentMethodStatus, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type StateOption, type StripeMethodEntry, type StripeMethodThemeVariant, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, type TagsData, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type WebhookEvent, apiError, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildItemPayload, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, classifyPaymentRejection, classifyTelemetryFailure, configureFlopay, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCurrency, foldIntoProducts, generateIdempotencyKey, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasVendoredStripeMethodLogo, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isPostalCodeSupported, isSetupIntentClientSecret, isUuidV4, isValidPostalCode, isValidPublishableKey, isValidSecretKey, needsStripeMethodExplicitConfirm, networkError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, randomUuidV4, rateLimitError, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveIdempotencyKey, resolveSessionCurrency, resolveStripeMethodBrandVariant, resolveTheme, serializeTelemetryBatch, stripeExpressMethodToOptionKey, telemetryStatusClass, validationError };