@flopay/react 1.3.4 → 1.4.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/provider.tsx
-import { useEffect, useState, useMemo } from "react";
+import { useCallback, useEffect, useState, useMemo, useRef } from "react";
 import { resolveBillingApiUrl } from "@flopay/shared";
 
 // src/context.ts
@@ -16,6 +16,59 @@ var CheckoutContext = createContext({
   error: null
 });
 
+// src/telemetry-bridge.ts
+var FLOPAY_TELEMETRY_BRIDGE = /* @__PURE__ */ Symbol.for("@flopay/js.telemetry.bridge.v1");
+var TELEMETRY_REPORTER_FACTORY = /* @__PURE__ */ Symbol.for("@flopay/js.telemetry.reporter-factory.v1");
+function noopTelemetryBridge() {
+  return {
+    error: () => {
+    },
+    log: () => {
+    },
+    performance: () => {
+    },
+    terminal: () => {
+    },
+    now: () => globalThis.performance?.now() ?? 0,
+    elapsed: (startedAt) => Math.max(0, (globalThis.performance?.now() ?? startedAt) - startedAt),
+    setCheckoutContext: () => {
+    },
+    beginCheckout: () => globalThis.performance?.now() ?? 0,
+    disable: () => {
+    },
+    flush: async () => {
+    },
+    destroy: () => {
+    }
+  };
+}
+function normalizeTelemetryBridge(source) {
+  const fallback = noopTelemetryBridge();
+  const bind = (candidate, defaultValue) => candidate ? candidate.bind(source) : defaultValue;
+  const now = bind(source.now, fallback.now);
+  return {
+    error: bind(source.error, fallback.error),
+    log: bind(source.log, fallback.log),
+    performance: bind(source.performance, fallback.performance),
+    terminal: bind(source.terminal, fallback.terminal),
+    now,
+    elapsed: source.elapsed ? source.elapsed.bind(source) : (startedAt) => Math.max(0, now() - startedAt),
+    setCheckoutContext: bind(source.setCheckoutContext, fallback.setCheckoutContext),
+    beginCheckout: bind(source.beginCheckout, fallback.beginCheckout),
+    disable: bind(source.disable, fallback.disable),
+    flush: bind(source.flush, fallback.flush),
+    destroy: bind(source.destroy, fallback.destroy)
+  };
+}
+function createTelemetryBridge(options) {
+  const factory = globalThis[TELEMETRY_REPORTER_FACTORY];
+  return normalizeTelemetryBridge(factory?.(options) ?? {});
+}
+function getFloPayTelemetryBridge(floPay) {
+  if (!floPay) return void 0;
+  return floPay[FLOPAY_TELEMETRY_BRIDGE];
+}
+
 // src/provider.tsx
 import { jsx } from "react/jsx-runtime";
 function FloPayProvider({
@@ -31,6 +84,18 @@ function FloPayProvider({
     paypalFloPayProp instanceof Promise || !paypalFloPayProp ? null : paypalFloPayProp
   );
   const [elements, setElements] = useState(null);
+  const mountedAt = useRef(null);
+  const renderedElements = useRef(null);
+  const interactiveElements = useRef(null);
+  useEffect(() => {
+    if (!flopay) return;
+    const telemetry = getFloPayTelemetryBridge(flopay);
+    mountedAt.current = telemetry?.beginCheckout() ?? telemetry?.now() ?? 0;
+    telemetry?.log({ name: "checkout.mount", stage: "checkout_mount" });
+    return () => {
+      telemetry?.log({ name: "checkout.unmount", stage: "unmount" });
+    };
+  }, [flopay]);
   useEffect(() => {
     let cancelled = false;
     if (floPayProp instanceof Promise) {
@@ -91,18 +156,46 @@ function FloPayProvider({
     options?.paymentMethodCreation,
     options?.setupFutureUsage
   ]);
+  useEffect(() => {
+    if (!flopay || !elements || renderedElements.current === elements) return;
+    renderedElements.current = elements;
+    const telemetry = getFloPayTelemetryBridge(flopay);
+    telemetry?.log({ name: "checkout.rendered", stage: "checkout_render" });
+    telemetry?.performance({
+      stage: "checkout_render",
+      durationMs: telemetry.elapsed(mountedAt.current ?? 0),
+      durationMode: "machine"
+    });
+  }, [elements, flopay]);
+  const reportInteractive = useCallback(() => {
+    if (!flopay || !elements || interactiveElements.current === elements) return;
+    interactiveElements.current = elements;
+    const telemetry = getFloPayTelemetryBridge(flopay);
+    telemetry?.log({ name: "checkout.interactive", stage: "checkout_interactive" });
+    telemetry?.performance({
+      stage: "checkout_interactive",
+      durationMs: telemetry.elapsed(mountedAt.current ?? 0),
+      durationMode: "machine"
+    });
+  }, [elements, flopay]);
   const resolvedBillingApiUrl = resolveBillingApiUrl(options?.billingApiUrl);
   const value = useMemo(
-    () => ({ flopay, paypalFlopay, elements, billingApiUrl: resolvedBillingApiUrl }),
-    [flopay, paypalFlopay, elements, resolvedBillingApiUrl]
+    () => ({
+      flopay,
+      paypalFlopay,
+      elements,
+      billingApiUrl: resolvedBillingApiUrl,
+      reportInteractive
+    }),
+    [flopay, paypalFlopay, elements, resolvedBillingApiUrl, reportInteractive]
   );
   return /* @__PURE__ */ jsx(FloPayContext.Provider, { value, children });
 }
 
 // src/flopay-checkout.tsx
-import React8, { useCallback as useCallback3, useEffect as useEffect6, useMemo as useMemo4, useRef as useRef5, useState as useState4 } from "react";
+import React8, { useCallback as useCallback4, useEffect as useEffect6, useMemo as useMemo4, useRef as useRef6, useState as useState4 } from "react";
 import { PaymentAPI as PaymentAPI4 } from "@flopay/js";
-import { SDK_VERSION, FloPayError as FloPayError5, resolveBillingApiUrl as resolveBillingApiUrl3, buildCheckoutDisplayData, resolveButtonsLayoutTheme as resolveButtonsLayoutTheme2, resolveTheme as resolveTheme2 } from "@flopay/shared";
+import { SDK_VERSION as SDK_VERSION2, FloPayError as FloPayError5, resolveBillingApiUrl as resolveBillingApiUrl3, buildCheckoutDisplayData, resolveButtonsLayoutTheme as resolveButtonsLayoutTheme2, resolveTheme as resolveTheme2 } from "@flopay/shared";
 
 // src/card-button-content.tsx
 import "react";
@@ -172,7 +265,7 @@ function TitleContentSlot({
 }
 
 // src/elements.tsx
-import { useEffect as useEffect2, useRef, useContext } from "react";
+import { useEffect as useEffect2, useRef as useRef2, useContext } from "react";
 import { jsx as jsx3 } from "react/jsx-runtime";
 function createElementComponent(elementType, displayName) {
   function ElementComponent({
@@ -186,9 +279,9 @@ function createElementComponent(elementType, displayName) {
     onBlur,
     onEscape
   }) {
-    const containerRef = useRef(null);
-    const elementRef = useRef(null);
-    const { elements } = useContext(FloPayContext);
+    const containerRef = useRef2(null);
+    const elementRef = useRef2(null);
+    const { elements, reportInteractive } = useContext(FloPayContext);
     useEffect2(() => {
       if (!elements || !containerRef.current) return;
       let mounted = true;
@@ -203,7 +296,10 @@ function createElementComponent(elementType, displayName) {
         element.mount(containerRef.current);
         elementRef.current = element;
         if (onChange) element.on("change", onChange);
-        if (onReady) element.on("ready", onReady);
+        element.on("ready", () => {
+          reportInteractive?.();
+          onReady?.();
+        });
         if (onFocus) element.on("focus", onFocus);
         if (onBlur) element.on("blur", onBlur);
         if (onEscape) element.on("escape", onEscape);
@@ -218,7 +314,7 @@ function createElementComponent(elementType, displayName) {
           elementRef.current = null;
         }
       };
-    }, [elements]);
+    }, [elements, reportInteractive]);
     return /* @__PURE__ */ jsx3("div", { ref: containerRef, className, id, style });
   }
   ElementComponent.displayName = displayName;
@@ -262,7 +358,7 @@ import {
 import { PaymentAPI as PaymentAPI2 } from "@flopay/js";
 
 // src/vault-card-fields.tsx
-import { useEffect as useEffect3, useRef as useRef2 } from "react";
+import { useEffect as useEffect3, useRef as useRef3 } from "react";
 import { jsx as jsx4 } from "react/jsx-runtime";
 function VaultCardFields({
   capture,
@@ -275,14 +371,14 @@ function VaultCardFields({
   onError,
   onValidation
 }) {
-  const containerRef = useRef2(null);
-  const onReadyRef = useRef2(onReady);
-  const onErrorRef = useRef2(onError);
-  const onValidationRef = useRef2(onValidation);
+  const containerRef = useRef3(null);
+  const onReadyRef = useRef3(onReady);
+  const onErrorRef = useRef3(onError);
+  const onValidationRef = useRef3(onValidation);
   onReadyRef.current = onReady;
   onErrorRef.current = onError;
   onValidationRef.current = onValidation;
-  const themeRef = useRef2(theme);
+  const themeRef = useRef3(theme);
   themeRef.current = theme;
   useEffect3(() => {
     const el = containerRef.current;
@@ -333,7 +429,7 @@ function VaultCardFields({
 }
 
 // src/split-card-form.tsx
-import React7, { forwardRef, useCallback as useCallback2, useContext as useContext3, useEffect as useEffect5, useImperativeHandle, useMemo as useMemo3, useRef as useRef4, useState as useState3 } from "react";
+import React7, { forwardRef, useCallback as useCallback3, useContext as useContext3, useEffect as useEffect5, useImperativeHandle, useMemo as useMemo3, useRef as useRef5, useState as useState3 } from "react";
 
 // src/hooks.ts
 import { useContext as useContext2 } from "react";
@@ -770,10 +866,23 @@ function isInAppBrowser(userAgent) {
 }
 
 // src/direct-paypal-button.tsx
-import { useCallback, useEffect as useEffect4, useMemo as useMemo2, useRef as useRef3, useState as useState2 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect4, useMemo as useMemo2, useRef as useRef4, useState as useState2 } from "react";
 import { loadScript } from "@paypal/paypal-js";
 import { PaymentAPI } from "@flopay/js";
-import { FloPayError as FloPayError2, normalizeGatewayEnvironment } from "@flopay/shared";
+import { FloPayError as FloPayError2, SDK_VERSION, normalizeGatewayEnvironment } from "@flopay/shared";
+
+// src/merchant-callback.ts
+function invokeMerchantCallback(callback) {
+  if (!callback) return;
+  const reportFailure = (error) => {
+    console.error("[FloPay] Merchant callback failed; checkout continued.", error);
+  };
+  try {
+    void Promise.resolve(callback()).catch(reportFailure);
+  } catch (error) {
+    reportFailure(error);
+  }
+}
 
 // src/external-method-recovery.ts
 var EXTERNAL_METHOD_CALLBACK_GRACE_MS = 600;
@@ -831,7 +940,7 @@ var DIRECT_PAYPAL_RECOVERY_ACTION_STYLE = {
 function buildDirectPayPalRecoveryMessage(popupBlocked) {
   return popupBlocked ? `${DIRECT_PAYPAL_RECOVERY_MESSAGE} Allow pop-ups for this site, then try again.` : DIRECT_PAYPAL_RECOVERY_MESSAGE;
 }
-function DirectPayPalButton({
+function DirectPayPalButtonImplementation({
   sessionId,
   nonce,
   billingApiUrl,
@@ -851,14 +960,62 @@ function DirectPayPalButton({
   runBeforeButtonClick,
   session,
   existingOrderId,
+  telemetry,
+  telemetryContext,
   debug = false
 }) {
-  const containerRef = useRef3(null);
-  const focusTargetRef = useRef3(null);
-  const pendingProviderFocusRef = useRef3(false);
+  const flopay = useFloPay();
+  const standaloneTelemetry = useMemo2(() => {
+    if (flopay) return null;
+    const reporter = createTelemetryBridge({
+      billingApiUrl,
+      sdkPackage: "@flopay/react",
+      sdkVersion: SDK_VERSION,
+      enabled: telemetry !== false
+    });
+    reporter.setCheckoutContext(telemetryContext ?? {});
+    reporter.beginCheckout(telemetryContext ?? {});
+    return reporter;
+  }, [
+    billingApiUrl,
+    flopay,
+    telemetry,
+    telemetryContext?.checkoutMode,
+    telemetryContext?.layout
+  ]);
+  const floPayTelemetry = useMemo2(() => getFloPayTelemetryBridge(flopay), [flopay]);
+  useEffect4(() => () => {
+    if (!standaloneTelemetry) return;
+    void standaloneTelemetry.flush().catch(() => {
+    }).finally(() => standaloneTelemetry.destroy());
+  }, [standaloneTelemetry]);
+  const telemetrySource = useMemo2(() => ({
+    error: (input) => {
+      if (floPayTelemetry) floPayTelemetry.error(input);
+      else standaloneTelemetry?.error(input);
+    },
+    log: (input) => {
+      if (floPayTelemetry) floPayTelemetry.log(input);
+      else standaloneTelemetry?.log(input);
+    },
+    performance: (input) => {
+      if (floPayTelemetry) floPayTelemetry.performance(input);
+      else standaloneTelemetry?.performance(input);
+    },
+    terminal: (input) => {
+      if (floPayTelemetry) floPayTelemetry.terminal(input);
+      else standaloneTelemetry?.terminal(input);
+    },
+    startTiming: () => floPayTelemetry?.now() ?? standaloneTelemetry?.now() ?? 0,
+    elapsed: (startedAt) => floPayTelemetry?.elapsed(startedAt) ?? Math.max(0, (standaloneTelemetry?.now() ?? startedAt) - startedAt)
+  }), [floPayTelemetry, standaloneTelemetry]);
+  const containerRef = useRef4(null);
+  const providerStartedAt = useRef4(0);
+  const focusTargetRef = useRef4(null);
+  const pendingProviderFocusRef = useRef4(false);
   const [ready, setReady] = useState2(false);
   const [renderGeneration, setRenderGeneration] = useState2(0);
-  const activeRenderGenerationRef = useRef3(0);
+  const activeRenderGenerationRef = useRef4(0);
   const [showRetryFocusTarget, setShowRetryFocusTarget] = useState2(false);
   const [failed, setFailed] = useState2(false);
   const [submitting, setSubmitting] = useState2(false);
@@ -868,23 +1025,23 @@ function DirectPayPalButton({
     if (!debug) return;
     setDebugLines((prev) => [...prev, `${(/* @__PURE__ */ new Date()).toISOString().slice(11, 23)} ${line}`]);
   };
-  const onTokenizedBodyRef = useRef3(onTokenizedBody);
-  const onCompleteRef = useRef3(onComplete);
-  const onErrorChangeRef = useRef3(onErrorChange);
-  const onDeclineRef = useRef3(onDecline);
-  const onTechnicalFailureRef = useRef3(onTechnicalFailure);
-  const onButtonClickRef = useRef3(onButtonClick);
-  const onLoadStateChangeRef = useRef3(onLoadStateChange);
-  const runBeforeButtonClickRef = useRef3(runBeforeButtonClick);
-  const sessionRef = useRef3(session);
-  const emailRef = useRef3(email);
-  const nonceRef = useRef3(nonce);
-  const beforeClickRef = useRef3(null);
-  const attemptGenerationRef = useRef3(0);
-  const attemptRef = useRef3(null);
-  const invalidatedAttemptGenerationRef = useRef3(null);
-  const attemptContextBySurfaceRef = useRef3(/* @__PURE__ */ new Map());
-  const approvalContextByTokenRef = useRef3(/* @__PURE__ */ new Map());
+  const onTokenizedBodyRef = useRef4(onTokenizedBody);
+  const onCompleteRef = useRef4(onComplete);
+  const onErrorChangeRef = useRef4(onErrorChange);
+  const onDeclineRef = useRef4(onDecline);
+  const onTechnicalFailureRef = useRef4(onTechnicalFailure);
+  const onButtonClickRef = useRef4(onButtonClick);
+  const onLoadStateChangeRef = useRef4(onLoadStateChange);
+  const runBeforeButtonClickRef = useRef4(runBeforeButtonClick);
+  const sessionRef = useRef4(session);
+  const emailRef = useRef4(email);
+  const nonceRef = useRef4(nonce);
+  const beforeClickRef = useRef4(null);
+  const attemptGenerationRef = useRef4(0);
+  const attemptRef = useRef4(null);
+  const invalidatedAttemptGenerationRef = useRef4(null);
+  const attemptContextBySurfaceRef = useRef4(/* @__PURE__ */ new Map());
+  const approvalContextByTokenRef = useRef4(/* @__PURE__ */ new Map());
   useEffect4(() => {
     onTokenizedBodyRef.current = onTokenizedBody;
   }, [onTokenizedBody]);
@@ -924,16 +1081,16 @@ function DirectPayPalButton({
   useEffect4(() => {
     if (showRetryFocusTarget) focusTargetRef.current?.focus();
   }, [showRetryFocusTarget, renderGeneration]);
-  const focusRetryTarget = useCallback(() => {
+  const focusRetryTarget = useCallback2(() => {
     window.setTimeout(() => {
       focusTargetRef.current?.focus();
     }, 0);
   }, []);
-  const remountPayPalButtons = useCallback(() => {
+  const remountPayPalButtons = useCallback2(() => {
     setReady(false);
     setRenderGeneration((current) => current + 1);
   }, []);
-  const focusPayPalSurface = useCallback(() => {
+  const focusPayPalSurface = useCallback2(() => {
     setShowRetryFocusTarget(false);
     const target = containerRef.current?.querySelector(
       'iframe, button, [tabindex]:not([tabindex="-1"])'
@@ -945,7 +1102,7 @@ function DirectPayPalButton({
     pendingProviderFocusRef.current = false;
     focusPayPalSurface();
   }, [focusPayPalSurface, ready, renderGeneration]);
-  const notifyTechnicalFailure = useCallback((err, options) => {
+  const notifyTechnicalFailure = useCallback2((err, options) => {
     const handler = onTechnicalFailureRef.current;
     if (handler) {
       handler("paypal", err, options);
@@ -1042,7 +1199,7 @@ function DirectPayPalButton({
     };
   }, []);
   useEffect4(() => {
-    onLoadStateChangeRef.current?.(ready && !failed);
+    invokeMerchantCallback(() => onLoadStateChangeRef.current?.(ready && !failed));
   }, [ready, failed]);
   const normalizedEnv = normalizeGatewayEnvironment(environment);
   useEffect4(() => {
@@ -1053,6 +1210,13 @@ function DirectPayPalButton({
     if (!clientId) {
       appendDebug("FAIL: clientId empty \u2014 gateway misconfigured");
       setFailed(true);
+      telemetrySource.error({
+        errorCode: "CONFIGURATION_INVALID",
+        stage: "provider_load",
+        provider: "paypal",
+        paymentMethodCategory: "paypal",
+        requestCategory: "provider_sdk"
+      });
       console.error("[FloPay] DirectPayPal: clientId empty \u2014 gateway misconfigured");
       return;
     }
@@ -1060,8 +1224,33 @@ function DirectPayPalButton({
       appendDebug("FAIL: containerRef not attached");
       return;
     }
+    providerStartedAt.current = telemetrySource.startTiming();
+    telemetrySource.log({
+      name: "provider.load.started",
+      stage: "provider_load",
+      provider: "paypal",
+      paymentMethodCategory: "paypal"
+    });
     let cancelled = false;
     let activeButtons = null;
+    let overlayStartedAt = null;
+    const finishOverlay = () => {
+      if (overlayStartedAt === null) return;
+      telemetrySource.log({
+        name: "provider.overlay.returned",
+        stage: "overlay_return",
+        provider: "paypal",
+        paymentMethodCategory: "paypal"
+      });
+      telemetrySource.performance({
+        stage: "overlay_return",
+        durationMs: telemetrySource.elapsed(overlayStartedAt),
+        durationMode: "buyer",
+        provider: "paypal",
+        paymentMethodCategory: "paypal"
+      });
+      overlayStartedAt = null;
+    };
     let rendered = false;
     const container = containerRef.current;
     let containerObserver = null;
@@ -1165,7 +1354,7 @@ function DirectPayPalButton({
       if (cancelled) return;
       if (isZoidLifecycleMessage(message)) return;
       const friendly = applyFriendlyMessageOverride(message) ?? message;
-      onErrorChangeRef.current?.(friendly);
+      invokeMerchantCallback(() => onErrorChangeRef.current?.(friendly));
     };
     const markRenderFailed = (message) => {
       if (cancelled) return;
@@ -1174,24 +1363,55 @@ function DirectPayPalButton({
         return;
       }
       setFailed(true);
+      if (!message.includes("paypal_ineligible")) {
+        telemetrySource.error({
+          errorCode: "PROVIDER_LOAD_FAILED",
+          stage: "provider_load",
+          provider: "paypal",
+          paymentMethodCategory: "paypal",
+          requestCategory: "provider_sdk"
+        });
+      }
       console.error("[FloPay] DirectPayPal load/render failure:", message);
     };
     setFailed(false);
     const dispatchTokenizedBody = async (body, prepared = beforeClickRef.current) => {
       const effectiveSessionId = prepared?.sessionId ?? sessionId;
       if (onTokenizedBodyRef.current) {
-        onTokenizedBodyRef.current(body, {
+        await onTokenizedBodyRef.current(body, {
           sessionId: effectiveSessionId,
           accountPatch: prepared?.accountPatch,
           nonce: prepared?.nonce
         });
         return;
       }
+      const processingStartedAt = telemetrySource.startTiming();
+      telemetrySource.log({
+        name: "payment.processing.started",
+        stage: "processing",
+        provider: "paypal",
+        paymentMethodCategory: "paypal"
+      });
+      const finishProcessing = () => {
+        telemetrySource.log({
+          name: "payment.processing.completed",
+          stage: "processing",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
+        telemetrySource.performance({
+          stage: "processing",
+          durationMs: telemetrySource.elapsed(processingStartedAt),
+          durationMode: "machine",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
+      };
       try {
         const currentSession = sessionRef.current;
         const currentEmail = prepared?.accountPatch?.email ?? emailRef.current;
         const effectiveUserId = prepared?.accountPatch?.userId ?? currentSession?.customer?.id ?? currentSession?.accountData?.userId ?? "";
-        const api = new PaymentAPI(baseUrl);
+        const api = new PaymentAPI(baseUrl, { telemetry: false });
         const response = await api.processPayment(
           effectiveUserId,
           {
@@ -1209,23 +1429,57 @@ function DirectPayPalButton({
           }
         );
         if (response.ok) {
-          onCompleteRef.current?.({ status: "succeeded", checkoutMethod: "paypal" });
+          finishProcessing();
+          telemetrySource.terminal({
+            outcome: "payment_succeeded",
+            provider: "paypal",
+            paymentMethodCategory: "paypal"
+          });
+        } else {
+          const json = await response.json().catch(() => null);
+          const rawMessage = json?.["message"] ?? "PayPal payment failed.";
+          const message = applyFriendlyMessageOverride(rawMessage) ?? rawMessage;
+          finishProcessing();
+          if (typeof json?.["declineCode"] === "string") {
+            telemetrySource.terminal({
+              outcome: "payment_declined",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
+          } else {
+            telemetrySource.error({
+              errorCode: "PAYMENT_PROCESSING_FAILED",
+              stage: "processing",
+              provider: "paypal",
+              paymentMethodCategory: "paypal",
+              requestCategory: "process_payment",
+              statusClass: response.status >= 500 ? "5xx" : response.status >= 400 ? "4xx" : response.status >= 300 ? "3xx" : "unknown"
+            });
+          }
+          forwardError(message);
+          invokeMerchantCallback(() => onDeclineRef.current?.(buildDeclineEvent("paypal", message, {
+            code: json?.["code"],
+            declineCode: json?.["declineCode"]
+          })));
           return;
         }
-        const json = await response.json().catch(() => null);
-        const rawMessage = json?.["message"] ?? "PayPal payment failed.";
-        const message = applyFriendlyMessageOverride(rawMessage) ?? rawMessage;
-        forwardError(message);
-        onDeclineRef.current?.(buildDeclineEvent("paypal", message, {
-          code: json?.["code"],
-          declineCode: json?.["declineCode"]
-        }));
       } catch (err) {
+        finishProcessing();
+        telemetrySource.error({
+          errorCode: "NETWORK_REQUEST_FAILED",
+          stage: "processing",
+          provider: "paypal",
+          paymentMethodCategory: "paypal",
+          requestCategory: "process_payment",
+          statusClass: "network_error"
+        });
         const rawMessage = err instanceof Error ? err.message : "PayPal payment failed.";
         const message = applyFriendlyMessageOverride(rawMessage) ?? rawMessage;
         forwardError(message);
-        onDeclineRef.current?.(buildDeclineEvent("paypal", message));
+        invokeMerchantCallback(() => onDeclineRef.current?.(buildDeclineEvent("paypal", message)));
+        return;
       }
+      invokeMerchantCallback(() => onCompleteRef.current?.({ status: "succeeded", checkoutMethod: "paypal" }));
     };
     const createPaypalIntent = async (fallbackMessage) => {
       const prepared = beforeClickRef.current;
@@ -1234,6 +1488,13 @@ function DirectPayPalButton({
       const intentHeaders = { "Content-Type": "application/json" };
       const currentNonce = prepared?.nonce ?? nonceRef.current;
       if (currentNonce) intentHeaders["x-checkout-session-token"] = currentNonce;
+      telemetrySource.log({
+        name: "payment.intent.started",
+        stage: "processing",
+        provider: "paypal",
+        paymentMethodCategory: "paypal",
+        requestCategory: "intent_create"
+      });
       const response = await fetch(`${baseUrl}/v1/checkouts/payments/intents`, {
         method: "POST",
         headers: intentHeaders,
@@ -1252,6 +1513,14 @@ function DirectPayPalButton({
       if (!id) {
         throw new Error(fallbackMessage);
       }
+      telemetrySource.log({
+        name: "payment.intent.completed",
+        stage: "processing",
+        provider: "paypal",
+        paymentMethodCategory: "paypal",
+        requestCategory: "intent_create",
+        statusClass: "2xx"
+      });
       return id;
     };
     const effectRenderGeneration = renderGeneration;
@@ -1286,6 +1555,12 @@ function DirectPayPalButton({
           if (!cancelled && !paypal?.Buttons) appendDebug("FAIL: namespace missing Buttons factory");
           return;
         }
+        telemetrySource.log({
+          name: "provider.availability.checked",
+          stage: "provider_ready",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
         const handleApprove = async (data) => {
           if (cancelled || activeRenderGenerationRef.current !== effectRenderGeneration) return;
           const token = data.subscriptionID ?? data.orderID ?? "";
@@ -1294,9 +1569,10 @@ function DirectPayPalButton({
           if (!finishAttempt(context.generation)) return;
           approvalContextByTokenRef.current.delete(token);
           attemptContextBySurfaceRef.current.delete(context.surfaceKey);
+          finishOverlay();
           try {
             setSubmitting(true);
-            onErrorChangeRef.current?.(null);
+            invokeMerchantCallback(() => onErrorChangeRef.current?.(null));
             if (!token) {
               throw new FloPayError2(
                 "PayPal did not return an approval token.",
@@ -1346,7 +1622,7 @@ function DirectPayPalButton({
                 return;
               }
             }
-            onButtonClickRef.current?.("paypal");
+            invokeMerchantCallback(() => onButtonClickRef.current?.("paypal"));
             const generation = startAttempt();
             const context = {
               generation,
@@ -1356,6 +1632,25 @@ function DirectPayPalButton({
             beforeClickRef.current = context;
             attemptContextBySurfaceRef.current.set(effectRenderGeneration, context);
             await actions.resolve();
+            telemetrySource.log({
+              name: "payment.method.selected",
+              stage: "processing",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
+            telemetrySource.log({
+              name: "provider.popup.opened",
+              stage: "overlay_open",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
+            telemetrySource.log({
+              name: "provider.overlay.opened",
+              stage: "overlay_open",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
+            overlayStartedAt = telemetrySource.startTiming();
           },
           // When the SDK is already holding an order/subscription id from a
           // prior backend round-trip (the `paypal_direct_required` retry
@@ -1368,6 +1663,12 @@ function DirectPayPalButton({
             const context = attemptContextBySurfaceRef.current.get(effectRenderGeneration) ?? beforeClickRef.current;
             if (context) attemptContextBySurfaceRef.current.delete(context.surfaceKey);
             beforeClickRef.current = null;
+            finishOverlay();
+            telemetrySource.terminal({
+              outcome: "payment_cancelled",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
             pendingProviderFocusRef.current = true;
             invalidateAttempt({ generation: context?.generation, remount: true, focus: false });
           },
@@ -1383,6 +1684,15 @@ function DirectPayPalButton({
                 finishAttempt(context?.generation);
                 return;
               }
+              finishOverlay();
+              const lower = message.toLowerCase();
+              telemetrySource.error({
+                errorCode: lower.includes("popup") && lower.includes("block") ? "POPUP_BLOCKED" : "PROVIDER_RUNTIME_FAILED",
+                stage: "provider_ready",
+                provider: "paypal",
+                paymentMethodCategory: "paypal",
+                requestCategory: "provider_sdk"
+              });
               if (context) attemptContextBySurfaceRef.current.delete(context.surfaceKey);
               beforeClickRef.current = null;
               invalidateAttempt({ generation: context?.generation, remount: true, showRetry: true, focus: true });
@@ -1394,6 +1704,12 @@ function DirectPayPalButton({
         });
         const eligible = buttons.isEligible();
         appendDebug(`isEligible=${eligible}`);
+        telemetrySource.log({
+          name: "provider.eligibility.checked",
+          stage: "provider_ready",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
         if (!eligible) {
           setReady(false);
           markRenderFailed(
@@ -1465,6 +1781,19 @@ function DirectPayPalButton({
           activeButtons = typedButtons;
           rendered = true;
           setReady(true);
+          telemetrySource.log({
+            name: "provider.ready",
+            stage: "provider_ready",
+            provider: "paypal",
+            paymentMethodCategory: "paypal"
+          });
+          telemetrySource.performance({
+            stage: "provider_ready",
+            durationMs: telemetrySource.elapsed(providerStartedAt.current),
+            durationMode: "machine",
+            provider: "paypal",
+            paymentMethodCategory: "paypal"
+          });
         }).catch((err) => {
           const message = err instanceof Error ? err.message : "PayPal failed to render.";
           appendDebug(`render:rejected msg=${message.slice(0, 120)}`);
@@ -1486,7 +1815,7 @@ function DirectPayPalButton({
         });
       }
     };
-  }, [baseUrl, clientId, currency, environment, isSubscription, sessionId, existingOrderId, renderGeneration]);
+  }, [baseUrl, clientId, currency, environment, isSubscription, sessionId, existingOrderId, renderGeneration, telemetrySource]);
   const debugPanel = debug ? /* @__PURE__ */ jsxs3(
     "pre",
     {
@@ -1567,6 +1896,12 @@ ${debugLines.join("\n")}`
     ] })
   );
 }
+function DirectPayPalButton(props) {
+  return /* @__PURE__ */ jsx6(DirectPayPalButtonImplementation, { ...props });
+}
+function InstrumentedDirectPayPalButton(props) {
+  return /* @__PURE__ */ jsx6(DirectPayPalButtonImplementation, { ...props });
+}
 
 // src/split-card-form.tsx
 import { FloPayError as FloPayError3, isSetupIntentClientSecret as isSetupIntentClientSecret2, resolveTheme } from "@flopay/shared";
@@ -1685,17 +2020,17 @@ function buildExternalMethodRecoveryMessage(method, popupBlocked) {
   return popupBlocked ? `${base} Allow pop-ups for this site, then try again.` : base;
 }
 function useExternalAttemptReconciliation(onMissingTerminal) {
-  const generationRef = useRef4(0);
-  const invalidatedGenerationRef = useRef4(null);
-  const attemptRef = useRef4(null);
-  const clearAttemptTimer = useCallback2((targetAttempt = attemptRef.current) => {
+  const generationRef = useRef5(0);
+  const invalidatedGenerationRef = useRef5(null);
+  const attemptRef = useRef5(null);
+  const clearAttemptTimer = useCallback3((targetAttempt = attemptRef.current) => {
     const attempt = targetAttempt;
     if (attempt?.timer) {
       clearTimeout(attempt.timer);
       attempt.timer = null;
     }
   }, []);
-  const armAttemptTimer = useCallback2((attempt, delayMs) => {
+  const armAttemptTimer = useCallback3((attempt, delayMs) => {
     if (typeof document !== "undefined" && document.visibilityState !== "visible") return;
     clearAttemptTimer(attempt);
     attempt.timer = setTimeout(() => {
@@ -1710,11 +2045,11 @@ function useExternalAttemptReconciliation(onMissingTerminal) {
       );
     }, delayMs);
   }, [clearAttemptTimer, onMissingTerminal]);
-  const armRecoveryTimer = useCallback2((attempt) => {
+  const armRecoveryTimer = useCallback3((attempt) => {
     if (!attempt.yieldedControl) return;
     armAttemptTimer(attempt, EXTERNAL_METHOD_CALLBACK_GRACE_MS);
   }, [armAttemptTimer]);
-  const startAttempt = useCallback2((method) => {
+  const startAttempt = useCallback3((method) => {
     clearAttemptTimer();
     const generation = generationRef.current + 1;
     generationRef.current = generation;
@@ -1723,7 +2058,7 @@ function useExternalAttemptReconciliation(onMissingTerminal) {
     attemptRef.current = attempt;
     return generation;
   }, [clearAttemptTimer]);
-  const finishAttempt = useCallback2((generation) => {
+  const finishAttempt = useCallback3((generation) => {
     const attempt = attemptRef.current;
     if (typeof generation === "number" && attempt?.generation !== generation) return false;
     clearAttemptTimer(attempt);
@@ -1733,7 +2068,7 @@ function useExternalAttemptReconciliation(onMissingTerminal) {
     }
     return true;
   }, [clearAttemptTimer]);
-  const invalidateAttempt = useCallback2((generation) => {
+  const invalidateAttempt = useCallback3((generation) => {
     const attempt = attemptRef.current;
     const targetGeneration = generation ?? attempt?.generation ?? generationRef.current;
     if (!generation || attempt?.generation === generation) {
@@ -1742,20 +2077,20 @@ function useExternalAttemptReconciliation(onMissingTerminal) {
     }
     invalidatedGenerationRef.current = targetGeneration;
   }, [clearAttemptTimer]);
-  const isAttemptInvalidated = useCallback2(
+  const isAttemptInvalidated = useCallback3(
     (generation) => invalidatedGenerationRef.current === (generation ?? generationRef.current),
     []
   );
-  const isAttemptCurrent = useCallback2(
+  const isAttemptCurrent = useCallback3(
     (generation) => attemptRef.current?.generation === generation && invalidatedGenerationRef.current !== generation,
     []
   );
-  const scheduleRecoveryIfReturned = useCallback2(() => {
+  const scheduleRecoveryIfReturned = useCallback3(() => {
     const attempt = attemptRef.current;
     if (!attempt) return;
     armRecoveryTimer(attempt);
   }, [armRecoveryTimer]);
-  const markAttemptYieldedControl = useCallback2(() => {
+  const markAttemptYieldedControl = useCallback3(() => {
     const attempt = attemptRef.current;
     if (!attempt) return;
     attempt.yieldedControl = true;
@@ -1883,6 +2218,7 @@ function PayPalButtonInner({
   onLoadStateChange,
   placeholderBorderRadius
 }) {
+  const flopay = useFloPay();
   const stripe = useStripeRaw();
   const elements = useStripeElements();
   const [loadState, setLoadState] = useState3("loading");
@@ -1890,13 +2226,13 @@ function PayPalButtonInner({
     onLoadStateChange?.(loadState);
   }, [loadState, onLoadStateChange]);
   const [submitting, setSubmitting] = useState3(false);
-  const paypalResumeAttempted = useRef4(false);
-  const focusTargetRef = useRef4(null);
-  const recoveryActionRef = useRef4(null);
+  const paypalResumeAttempted = useRef5(false);
+  const focusTargetRef = useRef5(null);
+  const recoveryActionRef = useRef5(null);
   const [surfaceKey, setSurfaceKey] = useState3(0);
   const [showRecoveryAction, setShowRecoveryAction] = useState3(false);
-  const pendingProviderFocusRef = useRef4(false);
-  const attemptContextBySurfaceRef = useRef4(/* @__PURE__ */ new Map());
+  const pendingProviderFocusRef = useRef5(false);
+  const attemptContextBySurfaceRef = useRef5(/* @__PURE__ */ new Map());
   const baseUrl = billingApiUrl.replace(/\/+$/, "");
   const {
     startAttempt,
@@ -1915,16 +2251,16 @@ function PayPalButtonInner({
   useEffect5(() => {
     if (showRecoveryAction) recoveryActionRef.current?.focus();
   }, [showRecoveryAction, surfaceKey]);
-  const resetSurface = useCallback2(() => {
+  const resetSurface = useCallback3(() => {
     setSurfaceKey((key) => key + 1);
   }, []);
-  const recoverTechnicalFailure = useCallback2((err, code, generation) => {
+  const recoverTechnicalFailure = useCallback3((err, code, generation) => {
     invalidateAttempt(generation);
     onTechnicalFailure?.("paypal", err, { code, popupBlocked: isPopupBlockedError(err) });
     setShowRecoveryAction(true);
     resetSurface();
   }, [invalidateAttempt, onTechnicalFailure, resetSurface]);
-  const focusProviderSurface = useCallback2(() => {
+  const focusProviderSurface = useCallback3(() => {
     window.setTimeout(() => {
       const target = focusTargetRef.current?.querySelector("iframe");
       (target ?? focusTargetRef.current)?.focus();
@@ -1935,7 +2271,7 @@ function PayPalButtonInner({
     pendingProviderFocusRef.current = false;
     focusProviderSurface();
   }, [focusProviderSurface, surfaceKey]);
-  const handleRecoveryActionClick = useCallback2(() => {
+  const handleRecoveryActionClick = useCallback3(() => {
     setShowRecoveryAction(false);
     onErrorChange?.(null);
     focusProviderSurface();
@@ -2006,7 +2342,7 @@ function PayPalButtonInner({
       }
     })();
   }, [stripe, onTokenizedBody, onErrorChange, onDecline]);
-  const handlePayPalClick = useCallback2(async (event) => {
+  const handlePayPalClick = useCallback3(async (event) => {
     if (isProcessing || submitting) {
       event.reject();
       return;
@@ -2028,7 +2364,7 @@ function PayPalButtonInner({
     onButtonClick?.("paypal");
     event.resolve();
   }, [attemptContextBySurfaceRef, isProcessing, onButtonClick, runBeforeButtonClick, startAttempt, submitting, surfaceKey]);
-  const handlePayPalConfirm = useCallback2(async (event) => {
+  const handlePayPalConfirm = useCallback3(async (event) => {
     if (!stripe || !elements) return;
     const attemptContext = attemptContextBySurfaceRef.current.get(surfaceKey);
     if (attemptContext && !isAttemptCurrent(attemptContext.generation)) {
@@ -2197,6 +2533,11 @@ function PayPalButtonInner({
                   onCancel: () => {
                     const attemptContext = attemptContextBySurfaceRef.current.get(surfaceKey);
                     attemptContextBySurfaceRef.current.delete(surfaceKey);
+                    getFloPayTelemetryBridge(flopay)?.terminal({
+                      outcome: "payment_cancelled",
+                      provider: "paypal",
+                      paymentMethodCategory: "paypal"
+                    });
                     invalidateAttempt(attemptContext?.generation);
                     setShowRecoveryAction(false);
                     pendingProviderFocusRef.current = true;
@@ -2240,6 +2581,7 @@ function WalletButtonInner({
   onLoadStateChange,
   placeholderBorderRadius
 }) {
+  const flopay = useFloPay();
   const stripe = useStripeRaw();
   const elements = useStripeElements();
   const [loadState, setLoadState] = useState3("loading");
@@ -2248,15 +2590,15 @@ function WalletButtonInner({
   }, [loadState, onLoadStateChange]);
   const [submitting, setSubmitting] = useState3(false);
   const baseUrl = billingApiUrl.replace(/\/+$/, "");
-  const focusTargetRef = useRef4(null);
-  const recoveryActionRef = useRef4(null);
+  const focusTargetRef = useRef5(null);
+  const recoveryActionRef = useRef5(null);
   const [surfaceKey, setSurfaceKey] = useState3(0);
   const [showRecoveryAction, setShowRecoveryAction] = useState3(false);
   const [recoveryActionMethod, setRecoveryActionMethod] = useState3("google_pay");
-  const pendingProviderFocusRef = useRef4(false);
-  const lastWalletProviderMethodRef = useRef4("google_pay");
-  const lastWalletMethodRef = useRef4("google_pay");
-  const attemptContextBySurfaceRef = useRef4(/* @__PURE__ */ new Map());
+  const pendingProviderFocusRef = useRef5(false);
+  const lastWalletProviderMethodRef = useRef5("google_pay");
+  const lastWalletMethodRef = useRef5("google_pay");
+  const attemptContextBySurfaceRef = useRef5(/* @__PURE__ */ new Map());
   const {
     startAttempt,
     finishAttempt,
@@ -2275,17 +2617,17 @@ function WalletButtonInner({
   useEffect5(() => {
     if (showRecoveryAction) recoveryActionRef.current?.focus();
   }, [showRecoveryAction, surfaceKey]);
-  const resetSurface = useCallback2(() => {
+  const resetSurface = useCallback3(() => {
     setSurfaceKey((key) => key + 1);
   }, []);
-  const recoverTechnicalFailure = useCallback2((method, err, code, generation) => {
+  const recoverTechnicalFailure = useCallback3((method, err, code, generation) => {
     invalidateAttempt(generation);
     onTechnicalFailure?.(method, err, { code, popupBlocked: isPopupBlockedError(err) });
     setRecoveryActionMethod(method);
     setShowRecoveryAction(true);
     resetSurface();
   }, [invalidateAttempt, onTechnicalFailure, resetSurface]);
-  const focusProviderSurface = useCallback2(() => {
+  const focusProviderSurface = useCallback3(() => {
     window.setTimeout(() => {
       const target = focusTargetRef.current?.querySelector("iframe");
       (target ?? focusTargetRef.current)?.focus();
@@ -2296,12 +2638,12 @@ function WalletButtonInner({
     pendingProviderFocusRef.current = false;
     focusProviderSurface();
   }, [focusProviderSurface, surfaceKey]);
-  const handleRecoveryActionClick = useCallback2(() => {
+  const handleRecoveryActionClick = useCallback3(() => {
     setShowRecoveryAction(false);
     onErrorChange?.(null);
     focusProviderSurface();
   }, [focusProviderSurface, onErrorChange]);
-  const handleWalletConfirm = useCallback2(
+  const handleWalletConfirm = useCallback3(
     async (event) => {
       if (!stripe || !elements) return;
       const attemptContext = attemptContextBySurfaceRef.current.get(surfaceKey);
@@ -2461,6 +2803,13 @@ function WalletButtonInner({
                   },
                   onLoadError: (_event) => {
                     setLoadState("load_error");
+                    getFloPayTelemetryBridge(flopay)?.error({
+                      errorCode: "PROVIDER_LOAD_FAILED",
+                      stage: "provider_load",
+                      provider: "stripe",
+                      paymentMethodCategory: "wallet",
+                      requestCategory: "provider_sdk"
+                    });
                   },
                   onClick: async (event) => {
                     lastWalletProviderMethodRef.current = event.expressPaymentType;
@@ -2487,6 +2836,11 @@ function WalletButtonInner({
                   onCancel: () => {
                     const attemptContext = attemptContextBySurfaceRef.current.get(surfaceKey);
                     attemptContextBySurfaceRef.current.delete(surfaceKey);
+                    getFloPayTelemetryBridge(flopay)?.terminal({
+                      outcome: "payment_cancelled",
+                      provider: "stripe",
+                      paymentMethodCategory: "wallet"
+                    });
                     invalidateAttempt(attemptContext?.generation);
                     setShowRecoveryAction(false);
                     pendingProviderFocusRef.current = true;
@@ -2657,14 +3011,15 @@ function StripeMethodInlineForm({
   submitButtonStyle,
   errorText
 }) {
+  const flopay = useFloPay();
   const stripe = useStripeRaw();
   const elements = useStripeElements();
   const [submitting, setSubmitting] = useState3(false);
-  const submittingRef = useRef4(false);
+  const submittingRef = useRef5(false);
   const [isMethodComplete, setIsMethodComplete] = useState3(false);
   const [loadState, setLoadState] = useState3("loading");
   const baseUrl = billingApiUrl.replace(/\/+$/, "");
-  const handlePay = useCallback2(async () => {
+  const handlePay = useCallback3(async () => {
     if (!stripe || !elements || isProcessing || submittingRef.current || !isMethodComplete) return;
     submittingRef.current = true;
     setSubmitting(true);
@@ -2809,7 +3164,16 @@ function StripeMethodInlineForm({
       PaymentElement2,
       {
         onReady: () => setLoadState("ready"),
-        onLoadError: () => setLoadState("load_error"),
+        onLoadError: () => {
+          setLoadState("load_error");
+          getFloPayTelemetryBridge(flopay)?.error({
+            errorCode: "PROVIDER_LOAD_FAILED",
+            stage: "provider_load",
+            provider: "stripe",
+            paymentMethodCategory: "apm",
+            requestCategory: "provider_sdk"
+          });
+        },
         onChange: (event) => {
           const evRecord = event;
           setIsMethodComplete(!!evRecord.complete);
@@ -2897,7 +3261,7 @@ function StripePaymentElementInner({
   const baseUrl = billingApiUrl.replace(/\/+$/, "");
   const [expandedMethod, setExpandedMethod] = useState3(null);
   const [submittingMethod, setSubmittingMethod] = useState3(null);
-  const submittingRef = useRef4(false);
+  const submittingRef = useRef5(false);
   useEffect5(() => {
     if (paymentElementMethods.length > 0 && stripeInstance) {
       onLoadStateChange?.("ready");
@@ -2905,7 +3269,7 @@ function StripePaymentElementInner({
       onLoadStateChange?.("loading");
     }
   }, [paymentElementMethods.length, stripeInstance, onLoadStateChange]);
-  const handleAutoConfirm = useCallback2(async (method) => {
+  const handleAutoConfirm = useCallback3(async (method) => {
     if (!stripeInstance) return;
     if (submittingRef.current || isProcessing) return;
     submittingRef.current = true;
@@ -3046,7 +3410,7 @@ function StripePaymentElementInner({
   ]);
   const [localExpandedMethod, setLocalExpandedMethod] = useState3(null);
   const activeExpandedMethod = onExpandApm ? expandedApmMethod ?? null : localExpandedMethod;
-  const handleMethodClick = useCallback2((method) => {
+  const handleMethodClick = useCallback3((method) => {
     if (submittingRef.current || isProcessing) return;
     if (activeExpandedMethod && activeExpandedMethod !== method) return;
     if (needsStripeMethodExplicitConfirm(method)) {
@@ -3204,12 +3568,12 @@ function SplitCardFormInner({
   const [city, setCity] = useState3(cityProp ?? "");
   const [stateValue, setStateValue] = useState3(stateProp ?? "");
   const [accountPatch, setAccountPatch] = useState3({});
-  const zipCodeRef = useRef4(zipProp ?? "");
-  const selectedCountryRef = useRef4(countryProp ?? "US");
-  const addressLine1Ref = useRef4(addressLine1Prop ?? "");
-  const addressLine2Ref = useRef4(addressLine2Prop ?? "");
-  const cityRef = useRef4(cityProp ?? "");
-  const stateRef = useRef4(stateProp ?? "");
+  const zipCodeRef = useRef5(zipProp ?? "");
+  const selectedCountryRef = useRef5(countryProp ?? "US");
+  const addressLine1Ref = useRef5(addressLine1Prop ?? "");
+  const addressLine2Ref = useRef5(addressLine2Prop ?? "");
+  const cityRef = useRef5(cityProp ?? "");
+  const stateRef = useRef5(stateProp ?? "");
   const avsConfig = useMemo3(() => resolveAVSConfig(enableAVSProp), [enableAVSProp]);
   const enableAVS = avsConfig !== null;
   const vaultBlockReady = Boolean(session?.vault?.html);
@@ -3251,20 +3615,20 @@ function SplitCardFormInner({
   const [expandedApmMethod, setExpandedApmMethod] = useState3(null);
   const showCardForm = viewState === "expanding" || viewState === "card";
   const TRANSITION_MS = 280;
-  const expandToCard = useCallback2(() => {
+  const expandToCard = useCallback3(() => {
     setViewState("expanding");
     setTimeout(() => setViewState("card"), TRANSITION_MS);
   }, []);
-  const collapseToButtons = useCallback2(() => {
+  const collapseToButtons = useCallback3(() => {
     setViewState("collapsing");
     setTimeout(() => setViewState("buttons"), TRANSITION_MS);
   }, []);
-  const expandToApm = useCallback2((method) => {
+  const expandToApm = useCallback3((method) => {
     setExpandedApmMethod(method);
     setViewState("apm-expanding");
     setTimeout(() => setViewState("apm-form"), TRANSITION_MS);
   }, []);
-  const collapseFromApm = useCallback2(() => {
+  const collapseFromApm = useCallback3(() => {
     setViewState("apm-collapsing");
     setTimeout(() => {
       setViewState("buttons");
@@ -3279,9 +3643,9 @@ function SplitCardFormInner({
   const [fullName, setFullName] = useState3("");
   const [formReady, setFormReady] = useState3(false);
   const [overlayStatus, setOverlayStatus] = useState3(null);
-  const processingRef = useRef4(false);
+  const processingRef = useRef5(false);
   const [paypalDirectRetry, setPaypalDirectRetry] = useState3(null);
-  const paypalDirectRetryRef = useRef4(paypalDirectRetry);
+  const paypalDirectRetryRef = useRef5(paypalDirectRetry);
   useEffect5(() => {
     paypalDirectRetryRef.current = paypalDirectRetry;
   }, [paypalDirectRetry]);
@@ -3389,7 +3753,7 @@ function SplitCardFormInner({
     setupFutureUsage: "off_session",
     ...stripeAppearanceProp
   }), [amountInCents, currency, stripeAppearanceProp]);
-  const updateError = useCallback2(
+  const updateError = useCallback3(
     (err) => {
       setError(err);
       onErrorChange?.(err);
@@ -3405,13 +3769,13 @@ function SplitCardFormInner({
       updateError(null);
     }
   }, [viewState, updateError]);
-  const emitDecline = useCallback2(
+  const emitDecline = useCallback3(
     (method, input, overrides) => {
       onDecline?.(buildDeclineEvent(method, input, overrides));
     },
     [onDecline]
   );
-  const recoverExternalMethodTechnicalFailure = useCallback2(
+  const recoverExternalMethodTechnicalFailure = useCallback3(
     (method, err, options) => {
       const popupBlocked = options?.popupBlocked ?? isPopupBlockedError(err);
       const message = buildExternalMethodRecoveryMessage(method, popupBlocked);
@@ -3473,7 +3837,7 @@ function SplitCardFormInner({
     nonce,
     updateError
   ]);
-  const vaultOutcomeRef = useRef4({
+  const vaultOutcomeRef = useRef5({
     onComplete,
     onError,
     updateError,
@@ -3499,8 +3863,8 @@ function SplitCardFormInner({
     nonce,
     baseUrl
   };
-  const vaultCompletedRef = useRef4(false);
-  const buildVaultAccountSnapshot = useCallback2(() => {
+  const vaultCompletedRef = useRef5(false);
+  const buildVaultAccountSnapshot = useCallback3(() => {
     const { resolvedAccount: resolvedAccount2, avsConfig: avsConfig2, fullName: fullName2, avsCheckProp: avsCheckProp2 } = vaultOutcomeRef.current;
     const cc = selectedCountryRef.current || resolvedAccount2.country || "US";
     const stateVisible = avsConfig2 ? isAVSFieldVisible(avsConfig2.state, cc) : false;
@@ -3656,7 +4020,7 @@ function SplitCardFormInner({
   const shouldDisplayPayPalRow = shouldRenderDirectPayPal ? directPaypalReady : shouldRenderStripePayPal && isExpressCheckoutRowVisible(paypalLoadState);
   const shouldDisplayWalletRow = shouldRenderWallets && isExpressCheckoutRowVisible(walletLoadState);
   const shouldDisplayPaymentElementRow = shouldRenderPaymentElement && paymentElementLoadState !== "load_error";
-  const validationFiredRef = useRef4(false);
+  const validationFiredRef = useRef5(false);
   useEffect5(() => {
     if (validationFiredRef.current) return;
     if (!showStripe && !showPayPal) {
@@ -3677,7 +4041,7 @@ function SplitCardFormInner({
       updateError(err.message);
     }
   }, [showStripe, showPayPal, directPaypalConfigured, paypalStripeInstance, onError, updateError]);
-  const deprecationLoggedRef = useRef4(false);
+  const deprecationLoggedRef = useRef5(false);
   useEffect5(() => {
     if (deprecationLoggedRef.current) return;
     if (!hasEnabledMethods) return;
@@ -3690,14 +4054,14 @@ function SplitCardFormInner({
       `[FloPay] ${stale.join(" / ")} ${stale.length === 1 ? "is" : "are"} deprecated: the Apple Pay / Google Pay surface is now driven by \`gateways.stripe.enabledPaymentMethods\` on the session response. Remove the legacy prop(s) to silence this warning.`
     );
   }, [hasEnabledMethods, showApplePay, showGooglePay]);
-  const handleNameChange = useCallback2((value) => {
+  const handleNameChange = useCallback3((value) => {
     setFullName(value);
     onFullNameChange?.(value);
     const parts = value.trim().split(/\s+/);
     onFirstNameChange?.(parts[0] ?? "");
     onLastNameChange?.(parts.length > 1 ? parts.slice(1).join(" ") : "");
   }, [onFullNameChange, onFirstNameChange, onLastNameChange]);
-  const applyInlineSessionPatch = useCallback2(
+  const applyInlineSessionPatch = useCallback3(
     (patch, method) => {
       if (!checkout.applyInlineSessionPatch) {
         return Promise.resolve({ error: null, sessionId, nonce });
@@ -3719,7 +4083,7 @@ function SplitCardFormInner({
     },
     [checkout.applyInlineSessionPatch, nonce, onError, sessionId, updateError]
   );
-  const runBeforeButtonClick = useCallback2(async (method) => {
+  const runBeforeButtonClick = useCallback3(async (method) => {
     if (!onBeforeButtonClick) return { proceed: true };
     try {
       const result = await onBeforeButtonClick({
@@ -3756,7 +4120,7 @@ function SplitCardFormInner({
       return { proceed: false };
     }
   }, [applyInlineSessionPatch, checkout.inlineSessionDraft, onBeforeButtonClick, onError, sessionId, updateError]);
-  const processPaymentInternal = useCallback2(
+  const processPaymentInternal = useCallback3(
     async (tokenizedBody, overrides) => {
       if (processingRef.current) return;
       processingRef.current = true;
@@ -3967,7 +4331,7 @@ function SplitCardFormInner({
     },
     [baseUrl, sessionId, nonce, resolvedAccount, fullName, chv, flopay, paypalFlopay, onComplete, onError, updateError, emitDecline]
   );
-  const dispatchTokenizedBody = useCallback2(
+  const dispatchTokenizedBody = useCallback3(
     (tokenizedBody, overrides) => {
       if (onTokenizedBody) {
         onTokenizedBody(tokenizedBody);
@@ -4004,7 +4368,7 @@ function SplitCardFormInner({
       }
     }
   }), [flopay, dispatchTokenizedBody, onError, updateError, emitDecline]);
-  const stripeResumeAttemptedRef = useRef4(false);
+  const stripeResumeAttemptedRef = useRef5(false);
   useEffect5(() => {
     if (typeof window === "undefined" || stripeResumeAttemptedRef.current) return;
     const params = new URLSearchParams(window.location.search);
@@ -4083,7 +4447,7 @@ function SplitCardFormInner({
       }, persistedOverrides);
     })();
   }, [sessionId, dispatchTokenizedBody, flopay, updateError, emitDecline]);
-  const handleSubmit = useCallback2(
+  const handleSubmit = useCallback3(
     async (e) => {
       e.preventDefault();
       if (!flopay || !elements || isSubmitting || processingRef.current) return;
@@ -5725,7 +6089,7 @@ async function recover3DSRedirectResult({
     return null;
   }
   try {
-    const api = new PaymentAPI3(billingApiUrl);
+    const api = new PaymentAPI3(billingApiUrl, { telemetry: false });
     const unified = await api.getUnifiedCheckoutSession(sessionId, nonce);
     const refreshedToken = unified.data.stripe?.clientSecret;
     if (isStripePaymentIntentClientSecret(refreshedToken)) {
@@ -5744,7 +6108,8 @@ async function processSavedPaymentForMode({
   session,
   nonce,
   tokenizedData,
-  returnUrl
+  returnUrl,
+  telemetry
 }) {
   const baseUrl = billingApiUrl.replace(/\/+$/, "");
   const resolvedSessionId = sessionId ?? session.id;
@@ -5755,7 +6120,10 @@ async function processSavedPaymentForMode({
   const lastName = session.customer?.lastName ?? session.accountData?.lastName ?? "";
   const country = session.customer?.country ?? session.accountData?.country ?? void 0;
   const zip = session.customer?.zip ?? session.accountData?.zip ?? void 0;
-  const api = new PaymentAPI3(baseUrl);
+  const api = new PaymentAPI3(
+    baseUrl,
+    telemetry === false ? { telemetry: false } : void 0
+  );
   const response = await retryOnceOnFetchFailure(() => api.processPayment(customerId, {
     sessionId: resolvedSessionId,
     nonce: resolvedNonce,
@@ -5832,7 +6200,8 @@ async function handleSavedPaymentRedirectResult(redirectResult, {
   billingApiUrl,
   sessionId,
   session,
-  returnUrl
+  returnUrl,
+  telemetry
 }) {
   const stripe = flopay?.getRawProvider();
   if (!stripe) {
@@ -5915,6 +6284,7 @@ async function handleSavedPaymentRedirectResult(redirectResult, {
         billingApiUrl,
         sessionId,
         session,
+        telemetry,
         tokenizedData: {
           id: paymentIntent.id,
           type: "card",
@@ -5936,7 +6306,8 @@ async function handleSavedPaymentRedirectResult(redirectResult, {
         billingApiUrl,
         sessionId,
         session,
-        returnUrl
+        returnUrl,
+        telemetry
       });
     }
     throw Object.assign(
@@ -6042,7 +6413,8 @@ async function loadSavedPaymentProviders({
   publishableKey,
   paypalPublishableKey,
   billingApiUrl,
-  locale
+  locale,
+  telemetry
 }) {
   if (!publishableKey) {
     return { flopay: null, paypalFlopay: null };
@@ -6051,11 +6423,13 @@ async function loadSavedPaymentProviders({
   const [instance, paypalInstanceOrError] = await Promise.all([
     loadFloPay(publishableKey, {
       billingApiUrl,
-      locale
+      locale,
+      telemetry
     }),
     needsSeparatePaypal ? loadFloPay(paypalPublishableKey, {
       billingApiUrl,
-      locale
+      locale,
+      telemetry
     }).catch((err) => {
       console.warn("[FloPay] Failed to load PayPal Stripe instance:", err);
       return null;
@@ -6075,6 +6449,33 @@ var sessionInflightMap = /* @__PURE__ */ new Map();
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function createStandaloneTelemetryReporter(billingApiUrl, enabled, context) {
+  const reporter = createTelemetryBridge({
+    billingApiUrl,
+    sdkPackage: "@flopay/react",
+    sdkVersion: SDK_VERSION2,
+    enabled: enabled !== false
+  });
+  reporter.beginCheckout(context);
+  return reporter;
+}
+function finishStandaloneTelemetry(reporter) {
+  void reporter.flush().catch(() => {
+  }).finally(() => reporter.destroy());
+}
+function reportStandaloneTelemetryError(billingApiUrl, enabled, context, errorCode, stage) {
+  const reporter = createStandaloneTelemetryReporter(billingApiUrl, enabled, context);
+  reporter.error({
+    errorCode,
+    stage,
+    paymentMethodCategory: "unknown",
+    ...stage === "session_read" ? { requestCategory: "session_read" } : {}
+  });
+  finishStandaloneTelemetry(reporter);
+}
+function isExpectedExistingSessionError(error) {
+  return error.type === "validation_error" || error.code === "checkout_session_not_found" || error.code === "checkout_session_expired" || error.code === "checkout_session_completed" || error.code === "session_auto_completed";
+}
 function resolveDirectPaypalConfig(unified) {
   const clientId = unified?.data.paypal?.publishableKey;
   if (!clientId) return void 0;
@@ -6179,6 +6580,7 @@ function FloPayCheckout({
   nonce: nonceProp,
   createSession: createSessionParams,
   billingApiUrl,
+  telemetry,
   appearance: appearanceOverride,
   locale,
   loading: loadingNode,
@@ -6224,9 +6626,9 @@ function FloPayCheckout({
   const checkoutLayout = children ? "custom_layout" : layout === "buttons" ? "buttons_layout" : "default_layout";
   const [unified, setUnified] = useState4(null);
   const [flopay, setFloPay] = useState4(null);
-  const flopayRef = useRef5(null);
+  const flopayRef = useRef6(null);
   const [paypalFlopay, setPaypalFloPay] = useState4(null);
-  const paypalFlopayRef = useRef5(null);
+  const paypalFlopayRef = useRef6(null);
   const [session, setSession] = useState4(null);
   const [resolvedSessionId, setResolvedSessionId] = useState4(sessionIdProp ?? "");
   const activeSessionId = sessionIdProp ?? resolvedSessionId;
@@ -6241,20 +6643,30 @@ function FloPayCheckout({
   const [createSessionPatch, setCreateSessionPatch] = useState4(void 0);
   const [createSessionPatchBaseHash, setCreateSessionPatchBaseHash] = useState4("");
   const [cardBootstrapPending, setCardBootstrapPending] = useState4(false);
-  const autoCheckoutAttempted = useRef5(false);
-  const paypalResumeAttempted = useRef5(false);
-  const savedPaymentKeysRef = useRef5(null);
-  const onCompleteRef = useRef5(onComplete);
+  const autoCheckoutAttempted = useRef6(false);
+  const paypalResumeAttempted = useRef6(false);
+  const savedPaymentKeysRef = useRef6(null);
+  const telemetryCheckoutContext = useMemo4(() => ({
+    checkoutMode: checkoutModeProp ?? currentMode,
+    layout: children ? "unknown" : layout === "buttons" ? "buttons" : "embedded"
+  }), [checkoutModeProp, children, currentMode, layout]);
+  const onCompleteRef = useRef6(onComplete);
   onCompleteRef.current = onComplete;
-  const onErrorRef = useRef5(onError);
+  const onErrorRef = useRef6(onError);
   onErrorRef.current = onError;
-  const onDeclineRef = useRef5(onDecline);
+  const onDeclineRef = useRef6(onDecline);
   onDeclineRef.current = onDecline;
-  const onSessionCompletedRef = useRef5(onSessionCompleted);
+  useEffect6(() => {
+    getFloPayTelemetryBridge(flopay)?.setCheckoutContext(telemetryCheckoutContext);
+    if (paypalFlopay && paypalFlopay !== flopay) {
+      getFloPayTelemetryBridge(paypalFlopay)?.setCheckoutContext(telemetryCheckoutContext);
+    }
+  }, [flopay, paypalFlopay, telemetryCheckoutContext]);
+  const onSessionCompletedRef = useRef6(onSessionCompleted);
   onSessionCompletedRef.current = onSessionCompleted;
   useEffect6(() => {
     console.info("[FloPay] Checkout initialized", {
-      sdk_version: SDK_VERSION,
+      sdk_version: SDK_VERSION2,
       checkout_type: checkoutType,
       checkout_layout: checkoutLayout,
       billing_api_url: resolvedBillingUrl
@@ -6287,22 +6699,112 @@ function FloPayCheckout({
   useEffect6(() => {
     setModeError(initialErrorMessage);
   }, [initialErrorMessage]);
-  const emitDecline = useCallback3(
+  const emitDecline = useCallback4(
     (method, input, overrides) => {
-      onDeclineRef.current?.(buildDeclineEvent(method, input, overrides));
+      invokeMerchantCallback(() => {
+        onDeclineRef.current?.(buildDeclineEvent(method, input, overrides));
+      });
     },
-    []
+    [invokeMerchantCallback]
   );
-  const runSavedPaymentFlow = useCallback3(
+  const runSavedPaymentFlow = useCallback4(
     async (sess, options) => {
       setModeError(null);
       setModeOverlayError(null);
       setModeOverlayStatus("processing");
       const activeSessionId2 = options?.sessionId ?? sess.id;
+      const activeFloPay = flopayRef.current ?? paypalFlopayRef.current;
+      const activeTelemetry = getFloPayTelemetryBridge(activeFloPay);
+      const standaloneTelemetry = activeFloPay ? null : createStandaloneTelemetryReporter(
+        resolvedBillingUrl,
+        telemetry,
+        telemetryCheckoutContext
+      );
+      const telemetrySource = {
+        log: (input) => {
+          if (activeTelemetry) activeTelemetry.log(input);
+          else standaloneTelemetry?.log(input);
+        },
+        error: (input) => {
+          if (activeTelemetry) activeTelemetry.error(input);
+          else standaloneTelemetry?.error(input);
+        },
+        terminal: (input) => {
+          if (activeTelemetry) activeTelemetry.terminal(input);
+          else standaloneTelemetry?.terminal(input);
+        },
+        performance: (input) => {
+          if (activeTelemetry) activeTelemetry.performance(input);
+          else standaloneTelemetry?.performance(input);
+        },
+        now: () => activeTelemetry?.now() ?? standaloneTelemetry?.now() ?? 0,
+        elapsed: (startedAt) => activeTelemetry?.elapsed(startedAt) ?? Math.max(0, (standaloneTelemetry?.now() ?? startedAt) - startedAt)
+      };
+      const processingStartedAt = telemetrySource.now();
+      let recoveryFlow = Boolean(
+        options?.initialAutoProcessingError || options?.initialAutoProcessingPending
+      );
+      let recoveryStarted = false;
+      let recoveryStartedAt;
+      const startRecovery = () => {
+        if (recoveryStarted) return;
+        recoveryStarted = true;
+        recoveryFlow = true;
+        recoveryStartedAt = telemetrySource.now();
+        telemetrySource.log({
+          name: "checkout.recovery.started",
+          stage: "recovery",
+          paymentMethodCategory: "saved"
+        });
+        telemetrySource.log({
+          name: "operation.recovery.started",
+          stage: "recovery",
+          paymentMethodCategory: "saved"
+        });
+      };
+      let processingFinished = false;
+      const finishProcessing = () => {
+        if (processingFinished) return;
+        processingFinished = true;
+        telemetrySource.log({
+          name: "payment.processing.completed",
+          stage: "processing",
+          paymentMethodCategory: "saved"
+        });
+        telemetrySource.performance({
+          stage: "processing",
+          durationMs: telemetrySource.elapsed(processingStartedAt),
+          durationMode: "machine",
+          paymentMethodCategory: "saved"
+        });
+        if (recoveryStartedAt !== void 0) {
+          telemetrySource.performance({
+            stage: "recovery",
+            durationMs: telemetrySource.elapsed(recoveryStartedAt),
+            durationMode: "machine",
+            paymentMethodCategory: "saved"
+          });
+        }
+      };
+      telemetrySource.log({
+        name: "payment.method.selected",
+        stage: "processing",
+        paymentMethodCategory: "saved"
+      });
+      telemetrySource.log({
+        name: "payment.processing.started",
+        stage: "processing",
+        paymentMethodCategory: "saved"
+      });
+      if (recoveryFlow) {
+        startRecovery();
+      }
+      let completionCallback;
       try {
         const redirectResult = getRedirectResultFromCheckoutProcessError(options?.initialAutoProcessingError);
         let paymentResult;
         if (redirectResult) {
+          startRecovery();
           if (redirectResult.type === "paypal_redirect_required" && savedPaymentKeysRef.current?.publishableKey) {
             persistPayPalResumeState({
               sessionId: activeSessionId2,
@@ -6316,13 +6818,14 @@ function FloPayCheckout({
             attempt3DS: options?.attempt3DS,
             billingApiUrl: resolvedBillingUrl,
             sessionId: activeSessionId2,
-            session: sess
+            session: sess,
+            telemetry: false
           });
           if (redirectResult.type === "paypal_redirect_required") {
             clearPayPalResumeState();
           }
         } else if (options?.initialAutoProcessingPending) {
-          const api = new PaymentAPI4(resolvedBillingUrl);
+          const api = new PaymentAPI4(resolvedBillingUrl, { telemetry: false });
           const completed = await api.waitForCheckoutSessionCompletion(options.initialAutoProcessingPending.sessionId, {
             initialDelayMs: options.initialAutoProcessingPending.retryAfterMs
           });
@@ -6350,11 +6853,13 @@ function FloPayCheckout({
           const result = await processSavedPaymentForMode({
             billingApiUrl: resolvedBillingUrl,
             sessionId: activeSessionId2,
-            session: sess
+            session: sess,
+            telemetry: false
           });
           if (result.type === "success") {
             paymentResult = result.result;
           } else {
+            startRecovery();
             if (result.type === "paypal_redirect_required" && savedPaymentKeysRef.current?.publishableKey) {
               persistPayPalResumeState({
                 sessionId: activeSessionId2,
@@ -6368,7 +6873,8 @@ function FloPayCheckout({
               attempt3DS: options?.attempt3DS,
               billingApiUrl: resolvedBillingUrl,
               sessionId: activeSessionId2,
-              session: sess
+              session: sess,
+              telemetry: false
             });
             if (result.type === "paypal_redirect_required") {
               clearPayPalResumeState();
@@ -6376,20 +6882,57 @@ function FloPayCheckout({
           }
         }
         if (activeSessionId2) markSessionRecentlyCompleted(activeSessionId2);
+        finishProcessing();
+        if (recoveryFlow) {
+          telemetrySource.log({
+            name: "checkout.recovery.completed",
+            stage: "recovery",
+            paymentMethodCategory: "saved"
+          });
+          telemetrySource.log({
+            name: "operation.recovery.completed",
+            stage: "recovery",
+            paymentMethodCategory: "saved"
+          });
+        }
+        telemetrySource.terminal({
+          outcome: "payment_succeeded",
+          paymentMethodCategory: "saved"
+        });
         setModeOverlayStatus("success");
         await sleep(PROCESSING_OVERLAY_SUCCESS_DELAY_MS);
-        onCompleteRef.current?.(paymentResult);
-        return true;
+        completionCallback = () => onCompleteRef.current?.(paymentResult);
       } catch (err) {
         const floPayErr = normalizeSavedPaymentError(err);
         const method = floPayErr.checkoutMethod ?? DEFAULT_SAVED_PAYMENT_DECLINE_METHOD;
         setModeError(floPayErr.message);
         setModeOverlayError(floPayErr.message);
         if (options?.fallbackToFull) {
+          telemetrySource.log({
+            name: "operation.fallback",
+            stage: "recovery",
+            paymentMethodCategory: "saved"
+          });
           setCurrentMode("full");
           replaceCheckoutModeQueryParam("full");
         }
-        onErrorRef.current?.(floPayErr);
+        finishProcessing();
+        const expectedDecline = Boolean(
+          floPayErr.declineCode || floPayErr.code?.toLowerCase().includes("declin")
+        );
+        if (expectedDecline) {
+          telemetrySource.terminal({
+            outcome: "payment_declined",
+            paymentMethodCategory: "saved"
+          });
+        } else {
+          telemetrySource.error({
+            errorCode: recoveryFlow ? "RECOVERY_FAILED" : "PAYMENT_PROCESSING_FAILED",
+            stage: recoveryFlow ? "recovery" : "processing",
+            paymentMethodCategory: "saved"
+          });
+        }
+        invokeMerchantCallback(() => onErrorRef.current?.(floPayErr));
         emitDecline(method, floPayErr, {
           code: floPayErr.code,
           declineCode: floPayErr.declineCode
@@ -6399,16 +6942,35 @@ function FloPayCheckout({
           sleep(PROCESSING_OVERLAY_ERROR_DELAY_MS),
           options?.ensureProvidersReady ? options.ensureProvidersReady() : Promise.resolve()
         ]);
+        if (recoveryFlow) {
+          telemetrySource.log({
+            name: "checkout.recovery.completed",
+            stage: "recovery",
+            paymentMethodCategory: "saved"
+          });
+          telemetrySource.log({
+            name: "operation.recovery.completed",
+            stage: "recovery",
+            paymentMethodCategory: "saved"
+          });
+        }
         return false;
       } finally {
+        finishProcessing();
+        if (standaloneTelemetry) finishStandaloneTelemetry(standaloneTelemetry);
         setModeOverlayStatus(null);
         setModeOverlayError(null);
       }
+      invokeMerchantCallback(completionCallback);
+      return true;
     },
     [
       emitDecline,
+      invokeMerchantCallback,
       normalizeSavedPaymentError,
-      resolvedBillingUrl
+      resolvedBillingUrl,
+      telemetry,
+      telemetryCheckoutContext
     ]
   );
   useEffect6(() => {
@@ -6426,6 +6988,8 @@ function FloPayCheckout({
     }
     paypalResumeAttempted.current = true;
     void (async () => {
+      let resumeTelemetry;
+      let redirectResumeStartedAt = 0;
       setModeError(null);
       setModeOverlayError(null);
       setModeOverlayStatus("processing");
@@ -6433,7 +6997,11 @@ function FloPayCheckout({
       try {
         if (params.get("redirect_status") === "failed") {
           throw Object.assign(
-            new FloPayError5("PayPal payment was declined. Please try again.", "api_error"),
+            new FloPayError5(
+              "PayPal payment was declined. Please try again.",
+              "api_error",
+              { declineCode: "paypal_redirect_failed" }
+            ),
             { checkoutMethod: "paypal" }
           );
         }
@@ -6444,7 +7012,22 @@ function FloPayCheckout({
           publishableKey: resumeState.publishableKey,
           paypalPublishableKey: resumeState.paypalPublishableKey,
           billingApiUrl: resolvedBillingUrl,
-          locale
+          locale,
+          telemetry
+        });
+        resumeTelemetry = getFloPayTelemetryBridge(resumePaypalFlopay ?? resumeFlopay);
+        redirectResumeStartedAt = resumeTelemetry?.now() ?? 0;
+        resumeTelemetry?.log({
+          name: "provider.redirect.resumed",
+          stage: "redirect_resume",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
+        resumeTelemetry?.log({
+          name: "operation.recovery.started",
+          stage: "recovery",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
         });
         const paypalStripe = (resumePaypalFlopay ?? resumeFlopay)?.getRawProvider();
         if (!paypalStripe) {
@@ -6474,7 +7057,7 @@ function FloPayCheckout({
         const paymentMethodId = typeof paymentIntent.payment_method === "string" ? paymentIntent.payment_method : paymentIntent.payment_method?.id;
         let finalResultStatus = resultStatus;
         if (resumeState.sessionId) {
-          const resumeApi = new PaymentAPI4(resolvedBillingUrl);
+          const resumeApi = new PaymentAPI4(resolvedBillingUrl, { telemetry: false });
           const resumeSessionResult = await resumeApi.getUnifiedCheckoutSession(resumeState.sessionId);
           const resumeSession = resumeSessionResult.data.session;
           if (resumeSession && resumeSession.status !== "complete") {
@@ -6482,6 +7065,7 @@ function FloPayCheckout({
               billingApiUrl: resolvedBillingUrl,
               sessionId: resumeState.sessionId,
               session: resumeSession,
+              telemetry: false,
               tokenizedData: {
                 id: paymentMethodId ?? paymentIntent.id,
                 type: "card",
@@ -6499,20 +7083,84 @@ function FloPayCheckout({
           }
         }
         if (resumeState.sessionId) markSessionRecentlyCompleted(resumeState.sessionId);
+        resumeTelemetry?.log({
+          name: "operation.recovery.completed",
+          stage: "recovery",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
+        resumeTelemetry?.performance({
+          stage: "redirect_resume",
+          durationMs: resumeTelemetry.elapsed(redirectResumeStartedAt),
+          durationMode: "machine",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
+        resumeTelemetry?.terminal({
+          outcome: "payment_succeeded",
+          provider: "paypal",
+          paymentMethodCategory: "paypal"
+        });
         setModeOverlayStatus("success");
         await sleep(PROCESSING_OVERLAY_SUCCESS_DELAY_MS);
-        onCompleteRef.current?.({
+        invokeMerchantCallback(() => onCompleteRef.current?.({
           status: finalResultStatus,
           paymentIntentId: paymentIntent.id,
           paymentMethodId,
           checkoutMethod: "paypal"
-        });
+        }));
       } catch (err) {
         const floPayErr = normalizeSavedPaymentError(err);
         const method = floPayErr.checkoutMethod ?? "paypal";
+        const expectedDecline = Boolean(
+          floPayErr.declineCode || floPayErr.code?.toLowerCase().includes("declin")
+        );
+        if (resumeTelemetry) {
+          resumeTelemetry.performance({
+            stage: "redirect_resume",
+            durationMs: resumeTelemetry.elapsed(redirectResumeStartedAt),
+            durationMode: "machine",
+            provider: "paypal",
+            paymentMethodCategory: "paypal"
+          });
+          if (expectedDecline) {
+            resumeTelemetry.terminal({
+              outcome: "payment_declined",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
+          } else {
+            resumeTelemetry.error({
+              errorCode: "REDIRECT_RESUME_FAILED",
+              stage: "redirect_resume",
+              provider: "paypal",
+              paymentMethodCategory: "paypal"
+            });
+          }
+        } else if (expectedDecline) {
+          const reporter = createStandaloneTelemetryReporter(
+            resolvedBillingUrl,
+            telemetry,
+            telemetryCheckoutContext
+          );
+          reporter.terminal({
+            outcome: "payment_declined",
+            provider: "paypal",
+            paymentMethodCategory: "paypal"
+          });
+          finishStandaloneTelemetry(reporter);
+        } else {
+          reportStandaloneTelemetryError(
+            resolvedBillingUrl,
+            telemetry,
+            telemetryCheckoutContext,
+            "REDIRECT_RESUME_FAILED",
+            "redirect_resume"
+          );
+        }
         setModeError(floPayErr.message);
         setModeOverlayError(floPayErr.message);
-        onErrorRef.current?.(floPayErr);
+        invokeMerchantCallback(() => onErrorRef.current?.(floPayErr));
         emitDecline(method, floPayErr, {
           code: floPayErr.code,
           declineCode: floPayErr.declineCode
@@ -6527,8 +7175,8 @@ function FloPayCheckout({
         setConfirmProcessing(false);
       }
     })();
-  }, [emitDecline, locale, normalizeSavedPaymentError, resolvedBillingUrl]);
-  const initializedHashRef = useRef5(null);
+  }, [emitDecline, invokeMerchantCallback, locale, normalizeSavedPaymentError, resolvedBillingUrl, telemetry]);
+  const initializedHashRef = useRef6(null);
   function hashCreateParams(params) {
     const key = JSON.stringify({
       c: params?.clientId,
@@ -6565,7 +7213,7 @@ function FloPayCheckout({
     () => effectiveCreateSession ? hashCreateParams(effectiveCreateSession) : "",
     [effectiveCreateSession]
   );
-  const createSessionParamsRef = useRef5(effectiveCreateSession);
+  const createSessionParamsRef = useRef6(effectiveCreateSession);
   createSessionParamsRef.current = effectiveCreateSession;
   useEffect6(() => {
     setResolvedSessionId(sessionIdProp ?? "");
@@ -6577,44 +7225,107 @@ function FloPayCheckout({
     setModeOverlayStatus(null);
   }, [createSessionHash, initialErrorMessage, sessionIdProp]);
   async function resolveInlineSession(params, cacheKey) {
-    const api = new PaymentAPI4(resolvedBillingUrl);
-    const cached = readCachedInlineSession(cacheKey);
-    let sid = cached?.sid ?? null;
-    let realResult = null;
-    if (sid) {
-      try {
-        realResult = await api.getUnifiedCheckoutSession(sid, cached?.nonce);
-        const status = realResult.data.session?.status;
-        if (status === "complete") {
-          if (wasSessionRecentlyCompleted(sid)) {
-            return { sid, result: realResult };
+    const reporter = createStandaloneTelemetryReporter(
+      resolvedBillingUrl,
+      telemetry,
+      telemetryCheckoutContext
+    );
+    const api = new PaymentAPI4(resolvedBillingUrl, { telemetry: false });
+    try {
+      const cached = readCachedInlineSession(cacheKey);
+      reporter.log({
+        name: cached ? "operation.cache.hit" : "operation.cache.miss",
+        stage: "session_create",
+        requestCategory: "session_create"
+      });
+      let sid = cached?.sid ?? null;
+      let realResult = null;
+      if (sid) {
+        try {
+          realResult = await api.getUnifiedCheckoutSession(sid, cached?.nonce);
+          const status = realResult.data.session?.status;
+          if (status === "complete") {
+            if (wasSessionRecentlyCompleted(sid)) {
+              return { sid, result: realResult };
+            }
+            clearCachedInlineSession(cacheKey);
+            sid = null;
+            realResult = null;
           }
+        } catch {
+          reporter.log({
+            name: "operation.fallback",
+            stage: "session_read",
+            requestCategory: "session_read"
+          });
           clearCachedInlineSession(cacheKey);
           sid = null;
-          realResult = null;
         }
-      } catch {
-        clearCachedInlineSession(cacheKey);
-        sid = null;
       }
-    }
-    if (!sid) {
-      const paramsWithAnalytics = {
-        ...params,
-        avsCheck: !!enableAVS,
-        avsConfig: typeof enableAVS === "object" ? enableAVS : void 0,
-        checkoutType: "embedded_checkout",
-        checkoutLayout: children ? "custom_layout" : layout === "buttons" ? "buttons_layout" : "default_layout"
-      };
-      realResult = await api.createAndFetchSession(paramsWithAnalytics);
-      sid = realResult.data.session?.id ?? "";
-      if (sid) {
-        persistCachedInlineSession(cacheKey, sid, realResult.data.session?.clientSecret);
+      if (!sid) {
+        const sessionCreateStartedAt = reporter.now();
+        reporter.log({
+          name: "session.create.started",
+          stage: "session_create",
+          requestCategory: "session_create"
+        });
+        const paramsWithAnalytics = {
+          ...params,
+          avsCheck: !!enableAVS,
+          avsConfig: typeof enableAVS === "object" ? enableAVS : void 0,
+          checkoutType: "embedded_checkout",
+          checkoutLayout: children ? "custom_layout" : layout === "buttons" ? "buttons_layout" : "default_layout"
+        };
+        try {
+          realResult = await api.createAndFetchSession(paramsWithAnalytics);
+          reporter.log({
+            name: "session.request.completed",
+            stage: "session_complete",
+            requestCategory: "session_create",
+            statusClass: "2xx"
+          });
+          reporter.performance({
+            stage: "session_create",
+            durationMs: reporter.now() - sessionCreateStartedAt,
+            durationMode: "machine",
+            requestCategory: "session_create",
+            statusClass: "2xx"
+          });
+        } catch (error) {
+          reporter.performance({
+            stage: "session_create",
+            durationMs: reporter.now() - sessionCreateStartedAt,
+            durationMode: "machine",
+            requestCategory: "session_create",
+            statusClass: "network_error"
+          });
+          if (error instanceof FloPayError5 && error.type === "validation_error") {
+            reporter.terminal({
+              outcome: "validation_rejected",
+              stage: "session_create",
+              paymentMethodCategory: "unknown"
+            });
+          } else {
+            reporter.error({
+              errorCode: "CHECKOUT_SESSION_CREATE_FAILED",
+              stage: "session_create",
+              paymentMethodCategory: "unknown",
+              requestCategory: "session_create"
+            });
+          }
+          throw error;
+        }
+        sid = realResult.data.session?.id ?? "";
+        if (sid) {
+          persistCachedInlineSession(cacheKey, sid, realResult.data.session?.clientSecret);
+        }
       }
+      return { sid: sid ?? "", result: realResult };
+    } finally {
+      finishStandaloneTelemetry(reporter);
     }
-    return { sid: sid ?? "", result: realResult };
   }
-  const bootstrapInlineSession = useCallback3(
+  const bootstrapInlineSession = useCallback4(
     async (patch) => {
       const baseParams = createSessionParamsRef.current;
       if (!baseParams) {
@@ -6658,7 +7369,8 @@ function FloPayCheckout({
           publishableKey,
           paypalPublishableKey,
           billingApiUrl: resolvedBillingUrl,
-          locale
+          locale,
+          telemetry
         });
         flopayRef.current = instance;
         setFloPay(instance);
@@ -6673,9 +7385,9 @@ function FloPayCheckout({
       }
       return resolved;
     },
-    [locale, resolvedBillingUrl]
+    [locale, resolvedBillingUrl, telemetry, telemetryCheckoutContext]
   );
-  const handleInlineSessionPatch = useCallback3(async (patch) => {
+  const handleInlineSessionPatch = useCallback4(async (patch) => {
     if (!hasInlineSessionPatchData(patch) || cardBootstrapPending) {
       return {
         sessionId: resolvedSessionId,
@@ -6752,7 +7464,9 @@ function FloPayCheckout({
             setModeOverlayStatus("success");
             await sleep(PROCESSING_OVERLAY_SUCCESS_DELAY_MS);
             if (!cancelled) {
-              onCompleteRef.current?.({ status: "succeeded" });
+              invokeMerchantCallback(() => {
+                onCompleteRef.current?.({ status: "succeeded" });
+              });
               setModeOverlayStatus(null);
               setModeOverlayError(null);
             }
@@ -6772,8 +7486,9 @@ function FloPayCheckout({
     }
     setIsLoading(true);
     async function init() {
+      let sessionReadCompleted = false;
       try {
-        const api = new PaymentAPI4(resolvedBillingUrl);
+        const api = new PaymentAPI4(resolvedBillingUrl, { telemetry: false });
         const result = await api.getUnifiedCheckoutSession(activeSessionId, nonceProp);
         if (cancelled) return;
         setUnified(result);
@@ -6784,7 +7499,9 @@ function FloPayCheckout({
         }
         if (sess.status === "complete") {
           setIsLoading(false);
-          onSessionCompletedRef.current?.(sess.successUrl ?? "");
+          invokeMerchantCallback(() => {
+            onSessionCompletedRef.current?.(sess.successUrl ?? "");
+          });
           return;
         }
         if (sess.status === "expired") {
@@ -6792,6 +7509,7 @@ function FloPayCheckout({
             code: "checkout_session_expired"
           });
         }
+        sessionReadCompleted = true;
         const effectiveMode = checkoutModeProp ?? sess.checkoutMode ?? "full";
         setCurrentMode(effectiveMode);
         const hasPayPalRedirectParams = typeof window !== "undefined" && new URLSearchParams(window.location.search).has("payment_intent");
@@ -6823,6 +7541,23 @@ function FloPayCheckout({
         if (!cancelled) setIsLoading(false);
       } catch (err) {
         if (cancelled) return;
+        if (!(err instanceof FloPayError5)) {
+          reportStandaloneTelemetryError(
+            resolvedBillingUrl,
+            telemetry,
+            telemetryCheckoutContext,
+            "INTERNAL_SDK_ERROR",
+            "checkout_mount"
+          );
+        } else if (!sessionReadCompleted && !isExpectedExistingSessionError(err)) {
+          reportStandaloneTelemetryError(
+            resolvedBillingUrl,
+            telemetry,
+            telemetryCheckoutContext,
+            "NETWORK_REQUEST_FAILED",
+            "session_read"
+          );
+        }
         const floPayErr = err instanceof FloPayError5 ? err : new FloPayError5(err instanceof Error ? err.message : "Failed to initialize checkout", "api_error");
         setLoadError(floPayErr);
         setIsLoading(false);
@@ -6844,7 +7579,8 @@ function FloPayCheckout({
         publishableKey,
         paypalPublishableKey,
         billingApiUrl: resolvedBillingUrl,
-        locale
+        locale,
+        telemetry
       });
       flopayRef.current = instance;
       setFloPay(instance);
@@ -6861,10 +7597,11 @@ function FloPayCheckout({
     createSessionHash,
     effectiveCreateSessionMode,
     initSessionDependency,
+    invokeMerchantCallback,
     nonceProp,
     runSavedPaymentFlow
   ]);
-  const handleConfirmCheckout = useCallback3(async () => {
+  const handleConfirmCheckout = useCallback4(async () => {
     if (confirmProcessing || !session) return;
     setConfirmProcessing(true);
     setModeError(null);
@@ -7028,7 +7765,7 @@ function FloPayCheckout({
           }
         ),
         /* @__PURE__ */ jsx8(
-          DirectPayPalButton,
+          InstrumentedDirectPayPalButton,
           {
             sessionId: activeSessionId,
             nonce: session.clientSecret || void 0,
@@ -7043,6 +7780,8 @@ function FloPayCheckout({
             onDecline,
             onButtonClick,
             session,
+            telemetry,
+            telemetryContext: telemetryCheckoutContext,
             debug
           }
         )
@@ -7431,7 +8170,7 @@ function InterimButtonsView({
 // src/checkout-form.tsx
 import { PaymentAPI as PaymentAPI5 } from "@flopay/js";
 import { FloPayError as FloPayError6 } from "@flopay/shared";
-import { forwardRef as forwardRef2, useCallback as useCallback4, useEffect as useEffect7, useImperativeHandle as useImperativeHandle2, useState as useState5 } from "react";
+import { forwardRef as forwardRef2, useCallback as useCallback5, useEffect as useEffect7, useImperativeHandle as useImperativeHandle2, useState as useState5 } from "react";
 import { Fragment as Fragment4, jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
 var WALLET_RESUME_KEY = "flopay_wallet_resume";
 var CheckoutForm = forwardRef2(
@@ -7473,20 +8212,20 @@ function CheckoutFormInner({
   const isSubmitting = externalProcessing ?? processing;
   const isSelfContained = !onTokenizedBody;
   const baseUrl = (billingApiUrl || contextBillingUrl).replace(/\/+$/, "");
-  const updateError = useCallback4(
+  const updateError = useCallback5(
     (err) => {
       setError(err);
       onErrorChange?.(err);
     },
     [onErrorChange]
   );
-  const emitDecline = useCallback4(
+  const emitDecline = useCallback5(
     (input, overrides) => {
       onDecline?.(buildDeclineEvent("card", input, overrides));
     },
     [onDecline]
   );
-  const processPaymentInternal = useCallback4(
+  const processPaymentInternal = useCallback5(
     async (tokenizedBody, completionPaymentMethodId) => {
       setProcessing(true);
       updateError(null);
@@ -7598,7 +8337,7 @@ function CheckoutFormInner({
     },
     [baseUrl, sessionId, nonce, userId, email, firstName, lastName, chv, flopay, paypalFlopay, onComplete, onError, onDecline, updateError, emitDecline]
   );
-  const dispatchTokenizedBody = useCallback4(
+  const dispatchTokenizedBody = useCallback5(
     (tokenizedBody) => {
       if (onTokenizedBody) {
         onTokenizedBody(tokenizedBody);
@@ -7653,7 +8392,7 @@ function CheckoutFormInner({
       localStorage.removeItem(WALLET_RESUME_KEY);
     }
   }, [sessionId, dispatchTokenizedBody]);
-  const handleSubmit = useCallback4(
+  const handleSubmit = useCallback5(
     async (e) => {
       e.preventDefault();
       if (!flopay || !elements || isSubmitting) return;
@@ -7776,7 +8515,7 @@ function CheckoutFormInner({
 // src/paypal-button.tsx
 import { PaymentAPI as PaymentAPI6 } from "@flopay/js";
 import { FloPayError as FloPayError7 } from "@flopay/shared";
-import { useCallback as useCallback5, useEffect as useEffect8, useRef as useRef6, useState as useState6 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect8, useRef as useRef7, useState as useState6 } from "react";
 import { Fragment as Fragment5, jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
 function PayPalButton({
   sessionId,
@@ -7797,9 +8536,9 @@ function PayPalButton({
   const contextBillingUrl = useBillingApiUrl();
   const [ready, setReady] = useState6(false);
   const [submitting, setSubmitting] = useState6(false);
-  const paypalResumeAttempted = useRef6(false);
+  const paypalResumeAttempted = useRef7(false);
   const baseUrl = (billingApiUrl || contextBillingUrl).replace(/\/+$/, "");
-  const processPaymentInternal = useCallback5(
+  const processPaymentInternal = useCallback6(
     async (tokenizedBody) => {
       try {
         const api = new PaymentAPI6(baseUrl);
@@ -7827,7 +8566,7 @@ function PayPalButton({
     },
     [baseUrl, sessionId, nonce, userId, email, firstName, lastName, chv, onComplete, onErrorChange]
   );
-  const dispatchTokenizedBody = useCallback5(
+  const dispatchTokenizedBody = useCallback6(
     (body) => {
       if (onTokenizedBody) {
         onTokenizedBody(body);
@@ -7885,7 +8624,7 @@ function PayPalButton({
       }
     })();
   }, [flopay, dispatchTokenizedBody, onErrorChange]);
-  const handlePayPalConfirm = useCallback5(async () => {
+  const handlePayPalConfirm = useCallback6(async () => {
     if (!flopay || !elements) return;
     try {
       setSubmitting(true);
@@ -7965,7 +8704,7 @@ function PayPalButton({
 }
 
 // src/automatic-payment-button.tsx
-import { useCallback as useCallback6, useEffect as useEffect9, useMemo as useMemo5, useRef as useRef7, useState as useState7 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect9, useMemo as useMemo5, useRef as useRef8, useState as useState7 } from "react";
 import { PaymentAPI as PaymentAPI7 } from "@flopay/js";
 import { FloPayError as FloPayError8, resolveBillingApiUrl as resolveBillingApiUrl4, resolveButtonsLayoutTheme as resolveButtonsLayoutTheme3, resolveTheme as resolveTheme3 } from "@flopay/shared";
 import { Fragment as Fragment6, jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
@@ -8084,12 +8823,12 @@ function FloPayAutomaticPaymentButton({
   const [overlayStatus, setOverlayStatus] = useState7(null);
   const [overlayError, setOverlayError] = useState7(null);
   const [fallbackSession, setFallbackSession] = useState7(null);
-  const isMountedRef = useRef7(true);
-  const threeDsAbortRef = useRef7(null);
-  const fallbackSessionRef = useRef7(fallbackSession);
-  const onSuccessRef = useRef7(onSuccess);
-  const onErrorRef = useRef7(onError);
-  const onDeclineRef = useRef7(onDecline);
+  const isMountedRef = useRef8(true);
+  const threeDsAbortRef = useRef8(null);
+  const fallbackSessionRef = useRef8(fallbackSession);
+  const onSuccessRef = useRef8(onSuccess);
+  const onErrorRef = useRef8(onError);
+  const onDeclineRef = useRef8(onDecline);
   useEffect9(() => {
     fallbackSessionRef.current = fallbackSession;
   }, [fallbackSession]);
@@ -8110,7 +8849,7 @@ function FloPayAutomaticPaymentButton({
     };
   }, []);
   useEffect9(() => {
-    if (!fallbackSession || typeof window === "undefined") {
+    if (typeof window === "undefined") {
       return;
     }
     const handleKeyDown = (event) => {
@@ -8122,14 +8861,14 @@ function FloPayAutomaticPaymentButton({
     return () => {
       window.removeEventListener("keydown", handleKeyDown);
     };
-  }, [fallbackSession]);
-  const emitDecline = useCallback6((error, method = DEFAULT_SAVED_PAYMENT_DECLINE_METHOD) => {
+  }, []);
+  const emitDecline = useCallback7((error, method = DEFAULT_SAVED_PAYMENT_DECLINE_METHOD) => {
     onDeclineRef.current?.(buildDeclineEvent(method, error, {
       code: error.code,
       declineCode: error.declineCode
     }));
   }, []);
-  const showSuccess = useCallback6(async (event) => {
+  const showSuccess = useCallback7(async (event) => {
     if (!isMountedRef.current) return;
     setOverlayError(null);
     setOverlayStatus("success");
@@ -8137,7 +8876,7 @@ function FloPayAutomaticPaymentButton({
     if (!isMountedRef.current) return;
     onSuccessRef.current?.(event);
   }, []);
-  const showError = useCallback6(async (error, options) => {
+  const showError = useCallback7(async (error, options) => {
     if (!isMountedRef.current) return;
     onErrorRef.current?.(error);
     if (options?.emitDecline) {
@@ -8147,7 +8886,7 @@ function FloPayAutomaticPaymentButton({
     setOverlayStatus("error");
     await sleep2(PROCESSING_OVERLAY_ERROR_DELAY_MS);
   }, [emitDecline]);
-  const processResolvedSession = useCallback6(async (apiResult, resolvedSessionId, options) => {
+  const processResolvedSession = useCallback7(async (apiResult, resolvedSessionId, options) => {
     const session = apiResult.data.session ?? null;
     if (!session) {
       throw new FloPayError8("No session data returned", "api_error");
@@ -8303,7 +9042,7 @@ function FloPayAutomaticPaymentButton({
     showError,
     showSuccess
   ]);
-  const handleButtonClick = useCallback6(async (event) => {
+  const handleButtonClick = useCallback7(async (event) => {
     buttonProps.onClick?.(event);
     if (event.defaultPrevented || disabled || isProcessing) {
       return;
@@ -8385,7 +9124,7 @@ function FloPayAutomaticPaymentButton({
     showError,
     showSuccess
   ]);
-  const handleFallbackComplete = useCallback6((result) => {
+  const handleFallbackComplete = useCallback7((result) => {
     const activeFallback = fallbackSessionRef.current;
     setFallbackSession(null);
     onSuccessRef.current?.({
@@ -8395,10 +9134,10 @@ function FloPayAutomaticPaymentButton({
       autoCompleted: false
     });
   }, []);
-  const handleFallbackError = useCallback6((error) => {
+  const handleFallbackError = useCallback7((error) => {
     onErrorRef.current?.(error);
   }, []);
-  const handleFallbackDecline = useCallback6((decline) => {
+  const handleFallbackDecline = useCallback7((decline) => {
     onDeclineRef.current?.(decline);
   }, []);
   const themeBundle = useMemo5(() => resolveTheme3(theme), [theme]);