@easypayment/medusa-paypal-ui 1.2.7 → 1.3.0

package/dist/index.cjs

@@ -31,8 +31,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  HttpError: () => HttpError,
   MedusaNextPayPalAdapter: () => MedusaNextPayPalAdapter,
   PAYPAL_CARD_PROVIDER_ID: () => PAYPAL_CARD_PROVIDER_ID,
+  PAYPAL_PROVIDER_IDS: () => PAYPAL_PROVIDER_IDS,
   PAYPAL_WALLET_PROVIDER_ID: () => PAYPAL_WALLET_PROVIDER_ID,
   PayPalAdvancedCard: () => PayPalAdvancedCard,
   PayPalCurrencyNotice: () => PayPalCurrencyNotice,
@@ -40,9 +42,11 @@ __export(index_exports, {
   PayPalProvider: () => PayPalProvider,
   PayPalSmartButtons: () => PayPalSmartButtons,
   clearCartCaptured: () => clearCartCaptured,
+  createHttpClient: () => createHttpClient,
   createPayPalStoreApi: () => createPayPalStoreApi,
   generateIdempotencyKey: () => generateIdempotencyKey,
   hideProcessingOverlay: () => hideProcessingOverlay,
+  invalidatePayPalConfigCache: () => invalidatePayPalConfigCache,
   isPayPalProviderId: () => isPayPalProviderId,
   markCartCaptured: () => markCartCaptured,
   markPaymentComplete: () => markPaymentComplete,
@@ -104,7 +108,7 @@ function createHttpClient(opts) {
     if (opts.publishableApiKey) {
       headers["x-publishable-api-key"] = opts.publishableApiKey;
     }
-    const timeoutMs = 3e4;
+    const timeoutMs = opts.timeoutMs ?? 3e4;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
     const callerSignal = init?.signal ?? null;
@@ -161,14 +165,18 @@ function createHttpClient(opts) {
     }
     const contentType = res.headers.get("content-type") || "";
     if (!contentType.includes("application/json")) {
-      throw new Error(
-        `[PayPal] Unexpected non-JSON response (${contentType}) from ${path}`
+      throw new HttpError(
+        `[PayPal] Unexpected non-JSON response (${contentType}) from ${path}`,
+        res.status
       );
     }
     try {
       return JSON.parse(text);
     } catch {
-      throw new Error(`[PayPal] Failed to parse JSON response from ${path}`);
+      throw new HttpError(
+        `[PayPal] Failed to parse JSON response from ${path}`,
+        res.status
+      );
     }
   }
   async function request(path, init, reqOpts) {
@@ -203,14 +211,21 @@ function generateIdempotencyKey() {
   }
   return `pp-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
 }
-async function markPaymentComplete(baseUrl, cartId, publishableApiKey) {
-  const http = createHttpClient({ baseUrl, publishableApiKey });
+async function markPaymentComplete(baseUrl, cartId, options) {
+  const opts = typeof options === "string" ? { publishableApiKey: options } : options ?? {};
+  const http = createHttpClient({
+    baseUrl,
+    publishableApiKey: opts.publishableApiKey,
+    credentials: opts.credentials,
+    timeoutMs: opts.timeoutMs
+  });
   return http.request(
     `/store/paypal-complete`,
     {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ cart_id: cartId })
+      body: JSON.stringify({ cart_id: cartId }),
+      signal: opts.signal
     },
     { retries: 3 }
   );
@@ -222,10 +237,12 @@ function createPayPalStoreApi(opts) {
       const q = cartId ? `?cart_id=${encodeURIComponent(cartId)}` : "";
       return http.request(`/store/paypal/config${q}`, { signal });
     },
-    getSettings() {
-      return http.request(`/store/paypal/settings`);
+    getSettings(signal) {
+      return http.request(`/store/paypal/settings`, {
+        signal
+      });
     },
-    createOrder(cartId, isCardPayment = false) {
+    createOrder(cartId, isCardPayment = false, signal) {
       return http.request(`/store/paypal/create-order`, {
         method: "POST",
         headers: {
@@ -238,16 +255,18 @@ function createPayPalStoreApi(opts) {
         body: JSON.stringify({
           cart_id: cartId,
           is_card_payment: isCardPayment
-        })
+        }),
+        signal
       });
     },
-    captureOrder(cartId, orderId) {
+    captureOrder(cartId, orderId, signal) {
       return http.request(
         `/store/paypal/capture-order`,
         {
           method: "POST",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ cart_id: cartId, order_id: orderId })
+          body: JSON.stringify({ cart_id: cartId, order_id: orderId }),
+          signal
         },
         { retries: 2 }
       );
@@ -255,39 +274,97 @@ function createPayPalStoreApi(opts) {
   };
 }
 
-// src/hooks/usePayPalConfig.ts
-var import_react = require("react");
+// src/client/config-cache.ts
 var MAX_CACHE_ENTRIES = 50;
-var _cache = /* @__PURE__ */ new Map();
-var CACHE_TTL = 5 * 60 * 1e3;
-function cacheSet(key, value) {
-  if (_cache.size >= MAX_CACHE_ENTRIES) {
-    const oldest = _cache.keys().next().value;
-    if (oldest !== void 0) _cache.delete(oldest);
+var CACHE_TTL_MS = 5 * 60 * 1e3;
+var SEP = "
";
+var cache = /* @__PURE__ */ new Map();
+var inflight = /* @__PURE__ */ new Map();
+function configCacheKey(args) {
+  return [
+    args.baseUrl,
+    args.publishableApiKey ?? "",
+    args.cartId ?? "",
+    (args.currencyCode ?? "").toLowerCase()
+  ].join(SEP);
+}
+function getCachedPayPalConfig(key) {
+  const hit = cache.get(key);
+  if (!hit) return null;
+  if (Date.now() - hit.at >= CACHE_TTL_MS) {
+    cache.delete(key);
+    return null;
+  }
+  return hit.config;
+}
+function invalidatePayPalConfigCache(cartId) {
+  if (cartId === void 0) {
+    cache.clear();
+    return;
+  }
+  for (const key of [...cache.keys()]) {
+    if (key.split(SEP)[2] === cartId) cache.delete(key);
   }
-  _cache.set(key, value);
 }
-function cacheKey(baseUrl, cartId) {
-  return `${baseUrl}::${cartId ?? ""}`;
+function fetchPayPalConfigShared(key, fetcher) {
+  const existing = inflight.get(key);
+  if (existing) return existing;
+  const p = (async () => {
+    try {
+      const config = await fetcher();
+      if (cache.size >= MAX_CACHE_ENTRIES && !cache.has(key)) {
+        const oldest = cache.keys().next().value;
+        if (oldest !== void 0) cache.delete(oldest);
+      }
+      cache.set(key, { config, at: Date.now() });
+      return config;
+    } finally {
+      inflight.delete(key);
+    }
+  })();
+  inflight.set(key, p);
+  return p;
+}
+
+// src/constants.ts
+var PAYPAL_WALLET_PROVIDER_ID = "pp_paypal_paypal";
+var PAYPAL_CARD_PROVIDER_ID = "pp_paypal_card_paypal_card";
+var PAYPAL_PROVIDER_IDS = [
+  PAYPAL_WALLET_PROVIDER_ID,
+  PAYPAL_CARD_PROVIDER_ID
+];
+function isPayPalProviderId(providerId) {
+  if (!providerId) return false;
+  return PAYPAL_PROVIDER_IDS.includes(providerId);
 }
+
+// src/hooks/usePayPalConfig.ts
+var import_react = require("react");
 function usePayPalConfig({
   baseUrl,
   publishableApiKey,
   cartId,
+  currencyCode,
+  credentials,
   enabled = true
 }) {
   const api = (0, import_react.useMemo)(
-    () => createPayPalStoreApi({ baseUrl, publishableApiKey }),
-    [baseUrl, publishableApiKey]
+    () => createPayPalStoreApi({ baseUrl, publishableApiKey, credentials }),
+    [baseUrl, publishableApiKey, credentials]
   );
-  const key = cacheKey(baseUrl, cartId);
-  const hit = _cache.get(key);
-  const seedConfig = hit && Date.now() - hit.at < CACHE_TTL ? hit.config : null;
+  const key = configCacheKey({
+    baseUrl,
+    publishableApiKey,
+    cartId,
+    currencyCode
+  });
+  const seedConfig = getCachedPayPalConfig(key);
   const [config, setConfig] = (0, import_react.useState)(seedConfig);
   const [loading, setLoading] = (0, import_react.useState)(
     seedConfig === null && enabled
   );
   const [error, setError] = (0, import_react.useState)(null);
+  const [retryToken, setRetryToken] = (0, import_react.useState)(0);
   const fetchIdRef = (0, import_react.useRef)(0);
   (0, import_react.useEffect)(() => {
     if (!enabled) {
@@ -295,27 +372,26 @@ function usePayPalConfig({
       setError(null);
       return;
     }
-    const k = cacheKey(baseUrl, cartId);
-    const cached = _cache.get(k);
-    if (cached && Date.now() - cached.at < CACHE_TTL) {
-      setConfig(cached.config);
+    const cached = getCachedPayPalConfig(key);
+    if (cached) {
+      setConfig(cached);
       setLoading(false);
       setError(null);
       return;
     }
     const id = ++fetchIdRef.current;
     let mounted = true;
-    const controller = new AbortController();
     setLoading(true);
     setError(null);
     (async () => {
       try {
-        const cfg = await api.getConfig(cartId, controller.signal);
+        const cfg = await fetchPayPalConfigShared(
+          key,
+          () => api.getConfig(cartId)
+        );
         if (!mounted || id !== fetchIdRef.current) return;
-        cacheSet(k, { config: cfg, at: Date.now() });
         setConfig(cfg);
       } catch (e) {
-        if (e instanceof Error && e.name === "AbortError") return;
         if (!mounted || id !== fetchIdRef.current) return;
         setError(
           e instanceof Error ? e.message : "Failed to load PayPal config"
@@ -326,17 +402,17 @@ function usePayPalConfig({
     })();
     return () => {
       mounted = false;
-      controller.abort();
     };
-  }, [api, baseUrl, cartId, enabled]);
-  return { config, loading, error };
+  }, [api, key, cartId, enabled, retryToken]);
+  const retry = (0, import_react.useMemo)(() => () => setRetryToken((t) => t + 1), []);
+  return { config, loading, error, retry };
 }
 
 // src/components/PayPalProvider.tsx
 var import_react2 = require("react");
 var import_react_paypal_js = require("@paypal/react-paypal-js");
 var import_jsx_runtime = require("react/jsx-runtime");
-var BN_CODE = "MBJTechnolabs_SI_SPB";
+var BN_CODE = "MBJ_Medusa_SI";
 function PayPalProvider(props) {
   const { config, intent = "capture", disableFunding, children } = props;
   const options = (0, import_react2.useMemo)(() => {
@@ -430,15 +506,19 @@ function showProcessingOverlay() {
   const overlay = document.createElement("div");
   overlay.id = OVERLAY_ID;
   overlay.setAttribute("role", "status");
-  overlay.setAttribute("aria-label", "Processing payment");
   overlay.innerHTML = `
     <style>
-      @keyframes _pp_spin { to { transform: rotate(360deg) } }
-      @keyframes _pp_progress { 0% { transform: translateX(-100%) } 100% { transform: translateX(350%) } }
+      @keyframes _pp_ov_spin { to { transform: rotate(360deg) } }
+      @keyframes _pp_ov_progress { 0% { transform: translateX(-100%) } 100% { transform: translateX(350%) } }
+      ._pp-ov-spin { animation: _pp_ov_spin .8s linear infinite }
+      ._pp-ov-progress { animation: _pp_ov_progress 1.5s ease-in-out infinite }
+      @media (prefers-reduced-motion: reduce) {
+        ._pp-ov-spin, ._pp-ov-progress { animation: none }
+      }
     </style>
-    <div style="position:relative;width:56px;height:56px">
+    <div style="position:relative;width:56px;height:56px" aria-hidden="true">
       <div style="position:absolute;inset:0;border-radius:50%;border:3px solid #e5e7eb"></div>
-      <div style="position:absolute;inset:0;border-radius:50%;border:3px solid transparent;border-top-color:#0070ba;animation:_pp_spin .8s linear infinite"></div>
+      <div class="_pp-ov-spin" style="position:absolute;inset:0;border-radius:50%;border:3px solid transparent;border-top-color:#0070ba"></div>
       <svg viewBox="0 0 24 24" fill="none" stroke="#0070ba" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"
         style="position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:24px;height:24px">
         <path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/>
@@ -450,8 +530,8 @@ function showProcessingOverlay() {
         This may take a few moments. Please do not close<br>or refresh this page.
       </div>
     </div>
-    <div style="width:200px;height:3px;background:#e5e7eb;border-radius:3px;overflow:hidden;margin-top:4px">
-      <div style="width:40%;height:100%;background:linear-gradient(90deg,#0070ba,#003087);border-radius:3px;animation:_pp_progress 1.5s ease-in-out infinite"></div>
+    <div style="width:200px;height:3px;background:#e5e7eb;border-radius:3px;overflow:hidden;margin-top:4px" aria-hidden="true">
+      <div class="_pp-ov-progress" style="width:40%;height:100%;background:linear-gradient(90deg,#0070ba,#003087);border-radius:3px"></div>
     </div>
   `;
   Object.assign(overlay.style, {
@@ -472,16 +552,7 @@ function showProcessingOverlay() {
     if (location.href !== startUrl) hideProcessingOverlay();
   };
   window.addEventListener("popstate", onNav);
-  const origPush = history.pushState.bind(history);
-  const origReplace = history.replaceState.bind(history);
-  history.pushState = function(...args) {
-    origPush(...args);
-    onNav();
-  };
-  history.replaceState = function(...args) {
-    origReplace(...args);
-    onNav();
-  };
+  const urlWatcher = window.setInterval(onNav, 250);
   const onPageShow = (e) => {
     if (e.persisted) hideProcessingOverlay();
   };
@@ -489,8 +560,7 @@ function showProcessingOverlay() {
   cleanupNavListener = () => {
     window.removeEventListener("popstate", onNav);
     window.removeEventListener("pageshow", onPageShow);
-    history.pushState = origPush;
-    history.replaceState = origReplace;
+    window.clearInterval(urlWatcher);
   };
 }
 function hideProcessingOverlay() {
@@ -500,12 +570,224 @@ function hideProcessingOverlay() {
   document.getElementById(OVERLAY_ID)?.remove();
 }
 
-// src/components/PayPalSmartButtons.tsx
+// src/components/internal/ui.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
-var SPIN_STYLE = `
+var ANIMATION_CSS = `
 @keyframes _pp_spin { to { transform: rotate(360deg) } }
 @keyframes _pp_progress { 0% { transform: translateX(-100%) } 100% { transform: translateX(350%) } }
+._pp-spin { animation: _pp_spin .8s linear infinite }
+._pp-spin-sm { animation: _pp_spin .7s linear infinite }
+._pp-progress { animation: _pp_progress 1.5s ease-in-out infinite }
+@media (prefers-reduced-motion: reduce) {
+  ._pp-spin, ._pp-spin-sm, ._pp-progress { animation: none }
+}
 `;
+function AnimationStyles() {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("style", { children: ANIMATION_CSS });
+}
+function ShieldIcon({
+  color,
+  size = 24,
+  style
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    "svg",
+    {
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: color,
+      strokeWidth: "1.8",
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": "true",
+      style: { width: size, height: size, ...style },
+      children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { d: "M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" })
+    }
+  );
+}
+function ProcessingOverlayView({ accent }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+    "div",
+    {
+      role: "status",
+      style: {
+        position: "fixed",
+        inset: 0,
+        zIndex: 9999,
+        background: "rgba(255,255,255,0.96)",
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 20
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: { position: "relative", width: 56, height: 56 }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+            "div",
+            {
+              style: {
+                position: "absolute",
+                inset: 0,
+                borderRadius: "50%",
+                border: "3px solid #e5e7eb"
+              }
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+            "div",
+            {
+              className: "_pp-spin",
+              style: {
+                position: "absolute",
+                inset: 0,
+                borderRadius: "50%",
+                border: "3px solid transparent",
+                borderTopColor: accent
+              }
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+            ShieldIcon,
+            {
+              color: accent,
+              style: {
+                position: "absolute",
+                top: "50%",
+                left: "50%",
+                transform: "translate(-50%, -50%)"
+              }
+            }
+          )
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: { textAlign: "center" }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+            "div",
+            {
+              style: {
+                fontSize: 18,
+                fontWeight: 600,
+                color: "#111827",
+                letterSpacing: "-0.01em"
+              },
+              children: "Processing your payment"
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+            "div",
+            {
+              style: {
+                fontSize: 14,
+                color: "#6b7280",
+                marginTop: 6,
+                lineHeight: 1.5
+              },
+              children: [
+                "This may take a few moments. Please do not close",
+                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("br", {}),
+                "or refresh this page."
+              ]
+            }
+          )
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+          "div",
+          {
+            style: {
+              width: 200,
+              height: 3,
+              background: "#e5e7eb",
+              borderRadius: 3,
+              overflow: "hidden",
+              marginTop: 4
+            },
+            "aria-hidden": "true",
+            children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+              "div",
+              {
+                className: "_pp-progress",
+                style: {
+                  width: "40%",
+                  height: "100%",
+                  background: `linear-gradient(90deg, ${accent}, #003087)`,
+                  borderRadius: 3
+                }
+              }
+            )
+          }
+        )
+      ]
+    }
+  );
+}
+function LoadingCard({ label }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+    "div",
+    {
+      role: "status",
+      style: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 10,
+        padding: "18px 16px",
+        background: "#f9fafb",
+        border: "1px solid #e5e7eb",
+        borderRadius: 8,
+        minHeight: 55
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+          "div",
+          {
+            className: "_pp-spin-sm",
+            "aria-hidden": "true",
+            style: {
+              width: 22,
+              height: 22,
+              borderRadius: "50%",
+              border: "2.5px solid #e5e7eb",
+              borderTopColor: "#0070ba",
+              flexShrink: 0
+            }
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#6b7280" }, children: label })
+      ]
+    }
+  );
+}
+function ErrorBanner({
+  children,
+  style
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+    "div",
+    {
+      role: "alert",
+      style: {
+        display: "flex",
+        alignItems: "flex-start",
+        gap: 8,
+        padding: "10px 14px",
+        background: "#fef2f2",
+        border: "1px solid #fecaca",
+        borderRadius: 8,
+        fontSize: 13,
+        color: "#b91c1c",
+        lineHeight: 1.5,
+        ...style
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { "aria-hidden": "true", style: { flexShrink: 0, fontSize: 15 }, children: "\u26A0\uFE0F" }),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children })
+      ]
+    }
+  );
+}
+
+// src/components/PayPalSmartButtons.tsx
+var import_jsx_runtime4 = require("react/jsx-runtime");
 var BUTTON_WIDTH_MAP = {
   small: "300px",
   medium: "400px",
@@ -513,24 +795,52 @@ var BUTTON_WIDTH_MAP = {
   responsive: "100%"
 };
 function PayPalSmartButtons(props) {
-  const { baseUrl, publishableApiKey, cartId, config, onPaid, onError } = props;
+  const {
+    baseUrl,
+    publishableApiKey,
+    credentials,
+    cartId,
+    config,
+    onPaid,
+    onError
+  } = props;
   const api = (0, import_react3.useMemo)(
-    () => createPayPalStoreApi({ baseUrl, publishableApiKey }),
-    [baseUrl, publishableApiKey]
+    () => createPayPalStoreApi({ baseUrl, publishableApiKey, credentials }),
+    [baseUrl, publishableApiKey, credentials]
   );
   const [error, setError] = (0, import_react3.useState)(null);
   const [processing, setProcessing] = (0, import_react3.useState)(false);
+  const processingRef = (0, import_react3.useRef)(false);
+  const [domOverlayUp, setDomOverlayUp] = (0, import_react3.useState)(false);
   const [buttonsReady, setButtonsReady] = (0, import_react3.useState)(false);
   const [loadTimedOut, setLoadTimedOut] = (0, import_react3.useState)(false);
   const capturedRef = (0, import_react3.useRef)(null);
   const [completionPending, setCompletionPending] = (0, import_react3.useState)(false);
   const [{ isPending, isResolved, isRejected }] = (0, import_react_paypal_js2.usePayPalScriptReducer)();
+  const startProcessing = (0, import_react3.useCallback)(() => {
+    processingRef.current = true;
+    setProcessing(true);
+  }, []);
+  const stopProcessing = (0, import_react3.useCallback)(() => {
+    hideProcessingOverlay();
+    setDomOverlayUp(false);
+    processingRef.current = false;
+    setProcessing(false);
+  }, []);
+  const showOverlay = (0, import_react3.useCallback)(() => {
+    showProcessingOverlay();
+    setDomOverlayUp(true);
+  }, []);
   const handleInit = (0, import_react3.useCallback)(() => {
     setButtonsReady(true);
   }, []);
   (0, import_react3.useEffect)(() => {
     const onPageShow = (e) => {
-      if (e.persisted) setProcessing(false);
+      if (e.persisted) {
+        processingRef.current = false;
+        setProcessing(false);
+        setDomOverlayUp(false);
+      }
     };
     window.addEventListener("pageshow", onPageShow);
     return () => window.removeEventListener("pageshow", onPageShow);
@@ -552,234 +862,46 @@ function PayPalSmartButtons(props) {
   const finalizeCapturedPayment = (0, import_react3.useCallback)(async () => {
     const captured = capturedRef.current;
     if (!captured) return;
-    setProcessing(true);
-    showProcessingOverlay();
+    startProcessing();
+    showOverlay();
     setError(null);
     try {
-      const completeResult = await markPaymentComplete(
-        baseUrl,
-        cartId,
-        publishableApiKey
-      );
+      const completeResult = await markPaymentComplete(baseUrl, cartId, {
+        publishableApiKey,
+        credentials
+      });
       clearCartCaptured(cartId);
       await onPaid?.({ ...captured, ...completeResult });
       setCompletionPending(false);
     } catch (e) {
       if (isNextRouterError(e)) return;
-      hideProcessingOverlay();
-      setProcessing(false);
+      stopProcessing();
       setCompletionPending(true);
       const msg = "Your payment was received, but finalizing your order failed. Please use the Retry button below \u2014 do not pay again.";
       setError(msg);
       onError?.(msg);
     }
-  }, [baseUrl, cartId, publishableApiKey, onPaid, onError]);
+  }, [
+    baseUrl,
+    cartId,
+    publishableApiKey,
+    credentials,
+    onPaid,
+    onError,
+    startProcessing,
+    showOverlay,
+    stopProcessing
+  ]);
   const showSpinner = (isPending || isResolved && !buttonsReady) && !loadTimedOut;
   if (!config.currency_supported) return null;
   const containerWidth = BUTTON_WIDTH_MAP[config.button_width ?? "responsive"] ?? "100%";
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: { width: containerWidth, position: "relative" }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("style", { children: SPIN_STYLE }),
-    processing && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-      "div",
-      {
-        role: "status",
-        "aria-label": "Processing payment",
-        style: {
-          position: "fixed",
-          inset: 0,
-          zIndex: 9999,
-          background: "rgba(255,255,255,0.96)",
-          display: "flex",
-          flexDirection: "column",
-          alignItems: "center",
-          justifyContent: "center",
-          gap: 20
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: { position: "relative", width: 56, height: 56 }, children: [
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              "div",
-              {
-                style: {
-                  position: "absolute",
-                  inset: 0,
-                  borderRadius: "50%",
-                  border: "3px solid #e5e7eb"
-                }
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              "div",
-              {
-                style: {
-                  position: "absolute",
-                  inset: 0,
-                  borderRadius: "50%",
-                  border: "3px solid transparent",
-                  borderTopColor: "#0070ba",
-                  animation: "_pp_spin .8s linear infinite"
-                }
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              "svg",
-              {
-                viewBox: "0 0 24 24",
-                fill: "none",
-                stroke: "#0070ba",
-                strokeWidth: "1.8",
-                strokeLinecap: "round",
-                strokeLinejoin: "round",
-                style: {
-                  position: "absolute",
-                  top: "50%",
-                  left: "50%",
-                  transform: "translate(-50%, -50%)",
-                  width: 24,
-                  height: 24
-                },
-                children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { d: "M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" })
-              }
-            )
-          ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: { textAlign: "center" }, children: [
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              "div",
-              {
-                style: {
-                  fontSize: 18,
-                  fontWeight: 600,
-                  color: "#111827",
-                  letterSpacing: "-0.01em"
-                },
-                children: "Processing your payment"
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-              "div",
-              {
-                style: {
-                  fontSize: 14,
-                  color: "#6b7280",
-                  marginTop: 6,
-                  lineHeight: 1.5
-                },
-                children: [
-                  "This may take a few moments. Please do not close",
-                  /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("br", {}),
-                  "or refresh this page."
-                ]
-              }
-            )
-          ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-            "div",
-            {
-              style: {
-                width: 200,
-                height: 3,
-                background: "#e5e7eb",
-                borderRadius: 3,
-                overflow: "hidden",
-                marginTop: 4
-              },
-              children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                "div",
-                {
-                  style: {
-                    width: "40%",
-                    height: "100%",
-                    background: "linear-gradient(90deg, #0070ba, #003087)",
-                    borderRadius: 3,
-                    animation: "_pp_progress 1.5s ease-in-out infinite"
-                  }
-                }
-              )
-            }
-          )
-        ]
-      }
-    ),
-    showSpinner && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-      "div",
-      {
-        role: "status",
-        "aria-label": "Loading PayPal",
-        style: {
-          display: "flex",
-          alignItems: "center",
-          justifyContent: "center",
-          gap: 10,
-          padding: "18px 16px",
-          background: "#f9fafb",
-          border: "1px solid #e5e7eb",
-          borderRadius: 8,
-          minHeight: 55
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-            "div",
-            {
-              style: {
-                width: 22,
-                height: 22,
-                borderRadius: "50%",
-                border: "2.5px solid #e5e7eb",
-                borderTopColor: "#0070ba",
-                animation: "_pp_spin .7s linear infinite",
-                flexShrink: 0
-              }
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#6b7280" }, children: "Loading PayPal\u2026" })
-        ]
-      }
-    ),
-    loadTimedOut && !buttonsReady && !isRejected && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-      "div",
-      {
-        role: "alert",
-        style: {
-          display: "flex",
-          alignItems: "flex-start",
-          gap: 8,
-          padding: "10px 14px",
-          background: "#fef2f2",
-          border: "1px solid #fecaca",
-          borderRadius: 8,
-          fontSize: 13,
-          color: "#b91c1c",
-          lineHeight: 1.5
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { style: { flexShrink: 0, fontSize: 15 }, children: "\u26A0\uFE0F" }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children: "PayPal is not available for this purchase. Please try a different payment method." })
-        ]
-      }
-    ),
-    isRejected && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-      "div",
-      {
-        role: "alert",
-        style: {
-          display: "flex",
-          alignItems: "flex-start",
-          gap: 8,
-          padding: "10px 14px",
-          background: "#fef2f2",
-          border: "1px solid #fecaca",
-          borderRadius: 8,
-          fontSize: 13,
-          color: "#b91c1c",
-          lineHeight: 1.5
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { style: { flexShrink: 0, fontSize: 15 }, children: "\u26A0\uFE0F" }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children: "PayPal failed to load. Please refresh the page or try a different payment method." })
-        ]
-      }
-    ),
-    config.environment === "sandbox" && buttonsReady && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { width: containerWidth, position: "relative" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(AnimationStyles, {}),
+    processing && !domOverlayUp && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ProcessingOverlayView, { accent: "#0070ba" }),
+    showSpinner && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LoadingCard, { label: "Loading PayPal\u2026" }),
+    loadTimedOut && !buttonsReady && !isRejected && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ErrorBanner, { children: "PayPal is not available for this purchase. Please try a different payment method." }),
+    isRejected && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ErrorBanner, { children: "PayPal failed to load. Please refresh the page or try a different payment method." }),
+    config.environment === "sandbox" && buttonsReady && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
       "div",
       {
         style: {
@@ -796,7 +918,7 @@ function PayPalSmartButtons(props) {
           marginBottom: 10
         },
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
             "svg",
             {
               width: "16",
@@ -806,18 +928,19 @@ function PayPalSmartButtons(props) {
               stroke: "#1e40af",
               strokeWidth: "2",
               strokeLinecap: "round",
+              "aria-hidden": "true",
               style: { flexShrink: 0, marginTop: 1 },
               children: [
-                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("circle", { cx: "12", cy: "12", r: "10" }),
-                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("path", { d: "M12 8v4M12 16h.01" })
+                /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("circle", { cx: "12", cy: "12", r: "10" }),
+                /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("path", { d: "M12 8v4M12 16h.01" })
               ]
             }
           ),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children: "Sandbox mode \u2014 you will not be charged. Use your PayPal sandbox account to complete the payment." })
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { children: "Sandbox mode \u2014 you will not be charged. Use your PayPal sandbox account to complete the payment." })
         ]
       }
     ),
-    isResolved && !completionPending && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    isResolved && !completionPending && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
       "div",
       {
         style: buttonsReady ? void 0 : {
@@ -826,7 +949,7 @@ function PayPalSmartButtons(props) {
           opacity: 0,
           pointerEvents: "none"
         },
-        children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+        children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
           import_react_paypal_js2.PayPalButtons,
           {
             forceReRender: [config.currency, config.intent, cartId],
@@ -839,7 +962,8 @@ function PayPalSmartButtons(props) {
               height: config.button_height
             },
             createOrder: async () => {
-              if (processing) throw new Error("Payment already processing");
+              if (processingRef.current)
+                throw new Error("Payment already processing");
               if (capturedRef.current) {
                 void finalizeCapturedPayment();
                 throw new Error(
@@ -847,19 +971,19 @@ function PayPalSmartButtons(props) {
                 );
               }
               setError(null);
-              setProcessing(true);
+              startProcessing();
               try {
                 const r = await api.createOrder(cartId);
                 return r.id;
               } catch (e) {
-                setProcessing(false);
+                stopProcessing();
                 throw e;
               }
             },
             onApprove: async (data) => {
               try {
-                setProcessing(true);
-                showProcessingOverlay();
+                startProcessing();
+                showOverlay();
                 setError(null);
                 const orderId = String(data?.orderID || "");
                 if (!orderId)
@@ -871,8 +995,7 @@ function PayPalSmartButtons(props) {
                 markCartCaptured(cartId);
               } catch (e) {
                 if (isNextRouterError(e)) return;
-                hideProcessingOverlay();
-                setProcessing(false);
+                stopProcessing();
                 const msg = e instanceof Error ? e.message : "Payment capture failed";
                 setError(msg);
                 onError?.(msg);
@@ -881,12 +1004,10 @@ function PayPalSmartButtons(props) {
               await finalizeCapturedPayment();
             },
             onCancel: () => {
-              hideProcessingOverlay();
-              setProcessing(false);
+              stopProcessing();
             },
             onError: (err) => {
-              hideProcessingOverlay();
-              setProcessing(false);
+              stopProcessing();
               const msg = err instanceof Error ? err.message : err?.message || "PayPal error";
               setError(msg);
               onError?.(msg);
@@ -895,7 +1016,7 @@ function PayPalSmartButtons(props) {
         )
       }
     ),
-    completionPending && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    completionPending && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
       "button",
       {
         type: "button",
@@ -918,40 +1039,14 @@ function PayPalSmartButtons(props) {
         children: "Retry \u2014 finish placing my order"
       }
     ),
-    error ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
-      "div",
-      {
-        role: "alert",
-        style: {
-          marginTop: 10,
-          display: "flex",
-          alignItems: "flex-start",
-          gap: 8,
-          padding: "10px 14px",
-          background: "#fef2f2",
-          border: "1px solid #fecaca",
-          borderRadius: 8,
-          fontSize: 13,
-          color: "#b91c1c",
-          lineHeight: 1.5
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { style: { flexShrink: 0, fontSize: 15 }, children: "\u26A0\uFE0F" }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { children: error })
-        ]
-      }
-    ) : null
+    error ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ErrorBanner, { style: { marginTop: 10 }, children: error }) : null
   ] });
 }
 
 // src/components/PayPalAdvancedCard.tsx
 var import_react4 = __toESM(require("react"), 1);
 var import_react_paypal_js3 = require("@paypal/react-paypal-js");
-var import_jsx_runtime4 = require("react/jsx-runtime");
-var SPIN_STYLE2 = `
-@keyframes _pp_spin { to { transform: rotate(360deg) } }
-@keyframes _pp_progress { 0% { transform: translateX(-100%) } 100% { transform: translateX(350%) } }
-`;
+var import_jsx_runtime5 = require("react/jsx-runtime");
 var cardStyle = {
   input: {
     "font-size": "15px",
@@ -996,18 +1091,19 @@ var labelStyle = {
 };
 function SubmitButton({
   disabled,
+  busy,
   label,
   onSubmit,
   onSubmitError
 }) {
   const { cardFieldsForm } = (0, import_react_paypal_js3.usePayPalCardFields)();
   const isDisabled = disabled || !cardFieldsForm;
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
     "button",
     {
       type: "button",
       disabled: isDisabled,
-      "aria-busy": disabled,
+      "aria-busy": busy,
       onClick: () => {
         onSubmit();
         Promise.resolve(cardFieldsForm?.submit()).catch((e) => {
@@ -1050,20 +1146,34 @@ function SubmitButton({
   );
 }
 function PayPalAdvancedCard(props) {
-  const { baseUrl, publishableApiKey, cartId, config, onPaid, onError } = props;
+  const {
+    baseUrl,
+    publishableApiKey,
+    credentials,
+    cartId,
+    config,
+    onPaid,
+    onError
+  } = props;
   const api = (0, import_react4.useMemo)(
-    () => createPayPalStoreApi({ baseUrl, publishableApiKey }),
-    [baseUrl, publishableApiKey]
+    () => createPayPalStoreApi({ baseUrl, publishableApiKey, credentials }),
+    [baseUrl, publishableApiKey, credentials]
   );
   const [error, setError] = (0, import_react4.useState)(null);
   const [submitting, setSubmitting] = (0, import_react4.useState)(false);
   const submittingRef = (0, import_react4.useRef)(false);
   const creatingOrderRef = (0, import_react4.useRef)(false);
+  const [domOverlayUp, setDomOverlayUp] = (0, import_react4.useState)(false);
   const capturedRef = (0, import_react4.useRef)(null);
   const [completionPending, setCompletionPending] = (0, import_react4.useState)(false);
   const [{ isPending, isResolved, isRejected }] = (0, import_react_paypal_js3.usePayPalScriptReducer)();
+  const showOverlay = import_react4.default.useCallback(() => {
+    showProcessingOverlay();
+    setDomOverlayUp(true);
+  }, []);
   const resetSubmitState = import_react4.default.useCallback(() => {
     hideProcessingOverlay();
+    setDomOverlayUp(false);
     creatingOrderRef.current = false;
     submittingRef.current = false;
     setSubmitting(false);
@@ -1074,6 +1184,7 @@ function PayPalAdvancedCard(props) {
         creatingOrderRef.current = false;
         submittingRef.current = false;
         setSubmitting(false);
+        setDomOverlayUp(false);
       }
     };
     window.addEventListener("pageshow", onPageShow);
@@ -1091,14 +1202,13 @@ function PayPalAdvancedCard(props) {
     const captured = capturedRef.current;
     if (!captured) return;
     setSubmitting(true);
-    showProcessingOverlay();
+    showOverlay();
     setError(null);
     try {
-      const completeResult = await markPaymentComplete(
-        baseUrl,
-        cartId,
-        publishableApiKey
-      );
+      const completeResult = await markPaymentComplete(baseUrl, cartId, {
+        publishableApiKey,
+        credentials
+      });
       clearCartCaptured(cartId);
       await onPaid?.({ ...captured, ...completeResult });
       setCompletionPending(false);
@@ -1110,34 +1220,22 @@ function PayPalAdvancedCard(props) {
       setError(msg);
       onError?.(msg);
     }
-  }, [baseUrl, cartId, publishableApiKey, onPaid, onError, resetSubmitState]);
+  }, [
+    baseUrl,
+    cartId,
+    publishableApiKey,
+    credentials,
+    onPaid,
+    onError,
+    showOverlay,
+    resetSubmitState
+  ]);
   if (!config.currency_supported) return null;
   if (isRejected) {
-    return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
-      "div",
-      {
-        role: "alert",
-        style: {
-          display: "flex",
-          alignItems: "flex-start",
-          gap: 8,
-          padding: "10px 14px",
-          background: "#fef2f2",
-          border: "1px solid #fecaca",
-          borderRadius: 8,
-          fontSize: 13,
-          color: "#b91c1c",
-          lineHeight: 1.5
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { style: { flexShrink: 0, fontSize: 15 }, children: "\u26A0\uFE0F" }),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { children: "PayPal failed to load. Please refresh the page or try a different payment method." })
-        ]
-      }
-    );
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ErrorBanner, { children: "PayPal failed to load. Please refresh the page or try a different payment method." });
   }
   if (!config.client_token) {
-    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
       "div",
       {
         style: {
@@ -1154,168 +1252,16 @@ function PayPalAdvancedCard(props) {
   }
   const isSandbox = config.environment === "sandbox";
   if (isPending) {
-    return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
-      "div",
-      {
-        role: "status",
-        "aria-label": "Loading PayPal",
-        style: {
-          display: "flex",
-          alignItems: "center",
-          justifyContent: "center",
-          gap: 10,
-          padding: "18px 16px",
-          background: "#f9fafb",
-          border: "1px solid #e5e7eb",
-          borderRadius: 8,
-          minHeight: 55
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: SPIN_STYLE2 }),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            "div",
-            {
-              style: {
-                width: 22,
-                height: 22,
-                borderRadius: "50%",
-                border: "2.5px solid #e5e7eb",
-                borderTopColor: "#0070ba",
-                animation: "_pp_spin .7s linear infinite",
-                flexShrink: 0
-              }
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#6b7280" }, children: "Loading card fields\u2026" })
-        ]
-      }
-    );
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(AnimationStyles, {}),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(LoadingCard, { label: "Loading card fields\u2026" })
+    ] });
   }
   if (!isResolved) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { position: "relative" }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: SPIN_STYLE2 }),
-    submitting && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
-      "div",
-      {
-        role: "status",
-        "aria-label": "Processing payment",
-        style: {
-          position: "fixed",
-          inset: 0,
-          zIndex: 9999,
-          background: "rgba(255,255,255,0.96)",
-          display: "flex",
-          flexDirection: "column",
-          alignItems: "center",
-          justifyContent: "center",
-          gap: 20
-        },
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { position: "relative", width: 56, height: 56 }, children: [
-            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-              "div",
-              {
-                style: {
-                  position: "absolute",
-                  inset: 0,
-                  borderRadius: "50%",
-                  border: "3px solid #e5e7eb"
-                }
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-              "div",
-              {
-                style: {
-                  position: "absolute",
-                  inset: 0,
-                  borderRadius: "50%",
-                  border: "3px solid transparent",
-                  borderTopColor: "#2563eb",
-                  animation: "_pp_spin .8s linear infinite"
-                }
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-              "svg",
-              {
-                viewBox: "0 0 24 24",
-                fill: "none",
-                stroke: "#2563eb",
-                strokeWidth: "1.8",
-                strokeLinecap: "round",
-                strokeLinejoin: "round",
-                style: {
-                  position: "absolute",
-                  top: "50%",
-                  left: "50%",
-                  transform: "translate(-50%, -50%)",
-                  width: 24,
-                  height: 24
-                },
-                children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("path", { d: "M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" })
-              }
-            )
-          ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { textAlign: "center" }, children: [
-            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-              "div",
-              {
-                style: {
-                  fontSize: 18,
-                  fontWeight: 600,
-                  color: "#111827",
-                  letterSpacing: "-0.01em"
-                },
-                children: "Processing your payment"
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
-              "div",
-              {
-                style: {
-                  fontSize: 14,
-                  color: "#6b7280",
-                  marginTop: 6,
-                  lineHeight: 1.5
-                },
-                children: [
-                  "This may take a few moments. Please do not close",
-                  /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("br", {}),
-                  "or refresh this page."
-                ]
-              }
-            )
-          ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            "div",
-            {
-              style: {
-                width: 200,
-                height: 3,
-                background: "#e5e7eb",
-                borderRadius: 3,
-                overflow: "hidden",
-                marginTop: 4
-              },
-              children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-                "div",
-                {
-                  style: {
-                    width: "40%",
-                    height: "100%",
-                    background: "linear-gradient(90deg, #2563eb, #1d4ed8)",
-                    borderRadius: 3,
-                    animation: "_pp_progress 1.5s ease-in-out infinite"
-                  }
-                }
-              )
-            }
-          )
-        ]
-      }
-    ),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: { position: "relative" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(AnimationStyles, {}),
+    submitting && !domOverlayUp && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ProcessingOverlayView, { accent: "#2563eb" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
       import_react_paypal_js3.PayPalCardFieldsProvider,
       {
         style: cardStyle,
@@ -1341,7 +1287,7 @@ function PayPalAdvancedCard(props) {
         onApprove: async (data) => {
           try {
             setError(null);
-            showProcessingOverlay();
+            showOverlay();
             const orderId = String(data?.orderID || "");
             if (!orderId)
               throw new Error(
@@ -1361,21 +1307,15 @@ function PayPalAdvancedCard(props) {
           await finalizeCapturedPayment();
         },
         onCancel: () => {
-          hideProcessingOverlay();
-          creatingOrderRef.current = false;
-          submittingRef.current = false;
-          setSubmitting(false);
+          resetSubmitState();
         },
         onError: (e) => {
           const msg = e instanceof Error ? e.message : e?.message || "CardFields error";
           setError(msg);
           onError?.(msg);
-          hideProcessingOverlay();
-          creatingOrderRef.current = false;
-          submittingRef.current = false;
-          setSubmitting(false);
+          resetSubmitState();
         },
-        children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+        children: /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
           "div",
           {
             style: {
@@ -1385,7 +1325,7 @@ function PayPalAdvancedCard(props) {
               width: "100%"
             },
             children: [
-              isSandbox && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+              isSandbox && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
                 "div",
                 {
                   style: {
@@ -1401,11 +1341,18 @@ function PayPalAdvancedCard(props) {
                     lineHeight: 1.55
                   },
                   children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { style: { fontSize: 15, flexShrink: 0, marginTop: 1 }, children: "\u{1F9EA}" }),
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { children: [
+                    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+                      "span",
+                      {
+                        "aria-hidden": "true",
+                        style: { fontSize: 15, flexShrink: 0, marginTop: 1 },
+                        children: "\u{1F9EA}"
+                      }
+                    ),
+                    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { children: [
                       "Sandbox mode \u2014 use test card",
                       " ",
-                      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+                      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
                         "strong",
                         {
                           style: { fontFamily: "monospace", letterSpacing: "0.05em" },
@@ -1418,11 +1365,11 @@ function PayPalAdvancedCard(props) {
                   ]
                 }
               ),
-              /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { children: [
-                /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("label", { style: labelStyle, children: "Card number" }),
-                /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_paypal_js3.PayPalNumberField, {})
+              /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("label", { style: labelStyle, id: "_pp-label-card-number", children: "Card number" }),
+                /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_paypal_js3.PayPalNumberField, {})
               ] }),
-              /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+              /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
                 "div",
                 {
                   style: {
@@ -1431,18 +1378,18 @@ function PayPalAdvancedCard(props) {
                     gap: 16
                   },
                   children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { children: [
-                      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("label", { style: labelStyle, children: "Expiration date" }),
-                      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_paypal_js3.PayPalExpiryField, {})
+                    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("label", { style: labelStyle, id: "_pp-label-expiry", children: "Expiration date" }),
+                      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_paypal_js3.PayPalExpiryField, {})
                     ] }),
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { children: [
-                      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("label", { style: labelStyle, children: "Security code" }),
-                      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_paypal_js3.PayPalCVVField, {})
+                    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("label", { style: labelStyle, id: "_pp-label-cvv", children: "Security code" }),
+                      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_paypal_js3.PayPalCVVField, {})
                     ] })
                   ]
                 }
               ),
-              /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+              /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
                 "div",
                 {
                   style: {
@@ -1453,25 +1400,12 @@ function PayPalAdvancedCard(props) {
                     color: "#6b7280"
                   },
                   children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-                      "svg",
-                      {
-                        width: "14",
-                        height: "14",
-                        viewBox: "0 0 24 24",
-                        fill: "none",
-                        stroke: "#10b981",
-                        strokeWidth: "2.5",
-                        strokeLinecap: "round",
-                        strokeLinejoin: "round",
-                        children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("path", { d: "M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" })
-                      }
-                    ),
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { children: "Your payment is secured with 256-bit SSL encryption" })
+                    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ShieldIcon, { color: "#10b981", size: 14 }),
+                    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { children: "Your payment is secured with 256-bit SSL encryption" })
                   ]
                 }
               ),
-              completionPending ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+              completionPending ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
                 "button",
                 {
                   type: "button",
@@ -1493,17 +1427,18 @@ function PayPalAdvancedCard(props) {
                   },
                   children: "Retry \u2014 finish placing my order"
                 }
-              ) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+              ) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
                 SubmitButton,
                 {
                   disabled: submitting,
+                  busy: submitting,
                   label: submitting ? "Processing\u2026" : "Pay by Card",
                   onSubmit: () => {
                     if (submittingRef.current) return;
                     submittingRef.current = true;
                     setError(null);
                     setSubmitting(true);
-                    showProcessingOverlay();
+                    showOverlay();
                   },
                   onSubmitError: (msg) => {
                     resetSubmitState();
@@ -1512,28 +1447,7 @@ function PayPalAdvancedCard(props) {
                   }
                 }
               ),
-              error && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
-                "div",
-                {
-                  role: "alert",
-                  style: {
-                    display: "flex",
-                    alignItems: "flex-start",
-                    gap: 10,
-                    padding: "10px 14px",
-                    background: "#fef2f2",
-                    border: "1px solid #fecaca",
-                    borderRadius: 8,
-                    fontSize: 13,
-                    color: "#b91c1c",
-                    lineHeight: 1.5
-                  },
-                  children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { style: { flexShrink: 0, marginTop: 1 }, children: "\u26A0\uFE0F" }),
-                    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { children: error })
-                  ]
-                }
-              )
+              error && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ErrorBanner, { children: error })
             ]
           }
         )
@@ -1544,30 +1458,12 @@ function PayPalAdvancedCard(props) {
 
 // src/adapters/MedusaNextPayPalAdapter.tsx
 var import_react5 = require("react");
-
-// src/constants.ts
-var PAYPAL_WALLET_PROVIDER_ID = "pp_paypal_paypal";
-var PAYPAL_CARD_PROVIDER_ID = "pp_paypal_card_paypal_card";
-var PAYPAL_PROVIDER_IDS = [
-  PAYPAL_WALLET_PROVIDER_ID,
-  PAYPAL_CARD_PROVIDER_ID
-];
-function isPayPalProviderId(providerId) {
-  if (!providerId) return false;
-  return PAYPAL_PROVIDER_IDS.includes(
-    providerId
-  );
-}
-
-// src/adapters/MedusaNextPayPalAdapter.tsx
-var import_jsx_runtime5 = require("react/jsx-runtime");
-var SPIN_STYLE3 = `@keyframes _pp_spin { to { transform: rotate(360deg) } }`;
+var import_jsx_runtime6 = require("react/jsx-runtime");
 function PayPalLoadingCard() {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
     "div",
     {
       role: "status",
-      "aria-label": "Connecting to PayPal",
       style: {
         display: "flex",
         alignItems: "center",
@@ -1578,31 +1474,35 @@ function PayPalLoadingCard() {
         borderRadius: 10
       },
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("style", { children: SPIN_STYLE3 }),
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(AnimationStyles, {}),
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
           "div",
           {
+            className: "_pp-spin-sm",
+            "aria-hidden": "true",
             style: {
               width: 22,
               height: 22,
               borderRadius: "50%",
               border: "2.5px solid #e5e7eb",
               borderTopColor: "#0070ba",
-              animation: "_pp_spin .7s linear infinite",
               flexShrink: 0
             }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#111827" }, children: "Connecting to PayPal\u2026" }),
-          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { style: { fontSize: 12, color: "#6b7280", marginTop: 2 }, children: "Setting up secure payment" })
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#111827" }, children: "Connecting to PayPal\u2026" }),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: { fontSize: 12, color: "#6b7280", marginTop: 2 }, children: "Setting up secure payment" })
         ] })
       ]
     }
   );
 }
-function PayPalErrorCard({ message }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+function PayPalErrorCard({
+  message,
+  onRetry
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
     "div",
     {
       role: "alert",
@@ -1614,12 +1514,34 @@ function PayPalErrorCard({ message }) {
         fontSize: 13,
         color: "#b91c1c"
       },
-      children: message
+      children: [
+        message,
+        onRetry && /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+          "button",
+          {
+            type: "button",
+            onClick: onRetry,
+            style: {
+              display: "block",
+              marginTop: 8,
+              padding: "6px 14px",
+              background: "#ffffff",
+              color: "#b91c1c",
+              border: "1px solid #fecaca",
+              borderRadius: 6,
+              fontSize: 13,
+              fontWeight: 500,
+              cursor: "pointer"
+            },
+            children: "Try again"
+          }
+        )
+      ]
     }
   );
 }
 function PayPalUnavailableCard({ label }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
     "div",
     {
       role: "status",
@@ -1644,6 +1566,8 @@ function MedusaNextPayPalAdapter(props) {
     selectedProviderId,
     baseUrl,
     publishableApiKey,
+    credentials,
+    currencyCode,
     providerIds,
     onSuccess,
     onError,
@@ -1652,10 +1576,12 @@ function MedusaNextPayPalAdapter(props) {
   const paypalProviderId = providerIds?.paypal || PAYPAL_WALLET_PROVIDER_ID;
   const paypalCardProviderId = providerIds?.paypalCard || PAYPAL_CARD_PROVIDER_ID;
   const shouldRender = selectedProviderId === paypalProviderId || selectedProviderId === paypalCardProviderId;
-  const { config, loading, error } = usePayPalConfig({
+  const { config, loading, error, retry } = usePayPalConfig({
     baseUrl,
     publishableApiKey,
+    credentials,
     cartId,
+    currencyCode,
     enabled: shouldRender
   });
   const handlePaid = (0, import_react5.useCallback)(
@@ -1666,40 +1592,42 @@ function MedusaNextPayPalAdapter(props) {
     [cartId, onPaid, onSuccess]
   );
   if (!shouldRender) return null;
-  if (loading) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PayPalLoadingCard, {});
-  if (error) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PayPalErrorCard, { message: error });
+  if (loading) return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PayPalLoadingCard, {});
+  if (error) return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PayPalErrorCard, { message: error, onRetry: retry });
   if (!config) return null;
   const isCardProvider = selectedProviderId === paypalCardProviderId;
   if (config.paypal_enabled === false && !isCardProvider) {
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PayPalUnavailableCard, { label: config.paypal_title || "PayPal" });
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PayPalUnavailableCard, { label: config.paypal_title || "PayPal" });
   }
   if (isCardProvider && config.card_enabled === false) {
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PayPalUnavailableCard, { label: config.card_title || "Card payment" });
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PayPalUnavailableCard, { label: config.card_title || "Card payment" });
   }
   const disableFunding = Array.isArray(config.disable_buttons) ? config.disable_buttons.join(",") : void 0;
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: { display: "grid", gap: 12 }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(PayPalCurrencyNotice, { config }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { display: "grid", gap: 12 }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PayPalCurrencyNotice, { config }),
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
       PayPalProvider,
       {
         config,
         intent: config.intent === "authorize" ? "authorize" : "capture",
         disableFunding,
-        children: isCardProvider ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        children: isCardProvider ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
           PayPalAdvancedCard,
           {
             baseUrl,
             publishableApiKey,
+            credentials,
             cartId,
             config,
             onPaid: handlePaid,
             onError
           }
-        ) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        ) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
           PayPalSmartButtons,
           {
             baseUrl,
             publishableApiKey,
+            credentials,
             cartId,
             config,
             onPaid: handlePaid,
@@ -1712,14 +1640,12 @@ function MedusaNextPayPalAdapter(props) {
 }
 
 // src/components/PayPalPaymentSection.tsx
-var import_jsx_runtime6 = require("react/jsx-runtime");
-var SPIN_STYLE4 = `@keyframes _pp_section_spin { to { transform: rotate(360deg) } }`;
+var import_jsx_runtime7 = require("react/jsx-runtime");
 function SessionInitCard() {
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
     "div",
     {
       role: "status",
-      "aria-label": "Setting up payment",
       style: {
         display: "flex",
         alignItems: "center",
@@ -1731,22 +1657,23 @@ function SessionInitCard() {
         borderRadius: 10
       },
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("style", { children: SPIN_STYLE4 }),
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(AnimationStyles, {}),
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           "div",
           {
+            className: "_pp-spin-sm",
+            "aria-hidden": "true",
             style: {
               width: 20,
               height: 20,
               borderRadius: "50%",
               border: "2.5px solid #e5e7eb",
               borderTopColor: "#0070ba",
-              animation: "_pp_section_spin .7s linear infinite",
               flexShrink: 0
             }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#111827" }, children: "Setting up payment\u2026" })
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: { fontSize: 13, fontWeight: 500, color: "#111827" }, children: "Setting up payment\u2026" })
       ]
     }
   );
@@ -1756,20 +1683,24 @@ function PayPalPaymentSection({
   selectedProviderId,
   baseUrl,
   publishableApiKey,
+  credentials,
+  currencyCode,
   sessionLoading = false,
   onSuccess,
   onError,
   onPaid
 }) {
   if (!isPayPalProviderId(selectedProviderId)) return null;
-  if (sessionLoading) return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(SessionInitCard, {});
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+  if (sessionLoading) return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(SessionInitCard, {});
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
     MedusaNextPayPalAdapter,
     {
       cartId,
       selectedProviderId,
       baseUrl,
       publishableApiKey,
+      credentials,
+      currencyCode,
       onSuccess,
       onError,
       onPaid
@@ -1779,19 +1710,6 @@ function PayPalPaymentSection({
 
 // src/hooks/usePayPalPaymentMethods.ts
 var import_react6 = require("react");
-var MAX_CACHE_ENTRIES2 = 50;
-var _cache2 = /* @__PURE__ */ new Map();
-var CACHE_TTL2 = 5 * 60 * 1e3;
-function cacheSet2(key, value) {
-  if (_cache2.size >= MAX_CACHE_ENTRIES2) {
-    const oldest = _cache2.keys().next().value;
-    if (oldest !== void 0) _cache2.delete(oldest);
-  }
-  _cache2.set(key, value);
-}
-function cacheKey2(baseUrl, cartId) {
-  return `ppm::${baseUrl}::${cartId ?? ""}`;
-}
 var DEFAULT_RESULT = {
   paypalEnabled: true,
   paypalTitle: "PayPal",
@@ -1800,21 +1718,37 @@ var DEFAULT_RESULT = {
   loading: false,
   error: null
 };
+function toResult(cfg) {
+  return {
+    paypalEnabled: cfg.paypal_enabled !== false,
+    paypalTitle: typeof cfg.paypal_title === "string" && cfg.paypal_title ? cfg.paypal_title : "PayPal",
+    cardEnabled: cfg.card_enabled !== false,
+    cardTitle: typeof cfg.card_title === "string" && cfg.card_title ? cfg.card_title : "Credit or Debit Card",
+    loading: false,
+    error: null
+  };
+}
 function usePayPalPaymentMethods({
   baseUrl,
   publishableApiKey,
   cartId,
+  currencyCode,
+  credentials,
   enabled = true
 }) {
   const api = (0, import_react6.useMemo)(
-    () => createPayPalStoreApi({ baseUrl, publishableApiKey }),
-    [baseUrl, publishableApiKey]
+    () => createPayPalStoreApi({ baseUrl, publishableApiKey, credentials }),
+    [baseUrl, publishableApiKey, credentials]
   );
-  const key = cacheKey2(baseUrl, cartId);
-  const hit = _cache2.get(key);
-  const seed = hit && Date.now() - hit.at < CACHE_TTL2 ? hit.result : null;
+  const key = configCacheKey({
+    baseUrl,
+    publishableApiKey,
+    cartId,
+    currencyCode
+  });
+  const seed = getCachedPayPalConfig(key);
   const [result, setResult] = (0, import_react6.useState)(
-    seed ?? { ...DEFAULT_RESULT, loading: enabled }
+    seed ? toResult(seed) : { ...DEFAULT_RESULT, loading: enabled }
   );
   const fetchIdRef = (0, import_react6.useRef)(0);
   (0, import_react6.useEffect)(() => {
@@ -1822,43 +1756,33 @@ function usePayPalPaymentMethods({
       setResult((prev) => ({ ...prev, loading: false }));
       return;
     }
-    const k = cacheKey2(baseUrl, cartId);
-    const cached = _cache2.get(k);
-    if (cached && Date.now() - cached.at < CACHE_TTL2) {
-      setResult(cached.result);
+    const cached = getCachedPayPalConfig(key);
+    if (cached) {
+      setResult(toResult(cached));
       return;
     }
     const id = ++fetchIdRef.current;
     let mounted = true;
-    const controller = new AbortController();
     setResult((prev) => ({ ...prev, loading: true }));
     (async () => {
       try {
-        const cfg = await api.getConfig(cartId, controller.signal);
+        const cfg = await fetchPayPalConfigShared(
+          key,
+          () => api.getConfig(cartId)
+        );
         if (!mounted || id !== fetchIdRef.current) return;
-        const next = {
-          paypalEnabled: cfg.paypal_enabled !== false,
-          paypalTitle: typeof cfg.paypal_title === "string" && cfg.paypal_title ? cfg.paypal_title : "PayPal",
-          cardEnabled: cfg.card_enabled !== false,
-          cardTitle: typeof cfg.card_title === "string" && cfg.card_title ? cfg.card_title : "Credit or Debit Card",
-          loading: false,
-          error: null
-        };
-        cacheSet2(k, { result: next, at: Date.now() });
-        setResult(next);
+        setResult(toResult(cfg));
       } catch (e) {
-        const msg = e instanceof Error ? e.message : "";
-        if (e instanceof Error && e.name === "AbortError") return;
         if (!mounted || id !== fetchIdRef.current) return;
-        if (msg.includes("403") || msg.includes("Forbidden")) {
-          const disabled = {
+        const msg = e instanceof Error ? e.message : "";
+        if (e instanceof HttpError && e.status === 403) {
+          setResult({
             ...DEFAULT_RESULT,
             paypalEnabled: false,
             cardEnabled: false,
             loading: false,
             error: msg || "PayPal is disabled"
-          };
-          setResult(disabled);
+          });
           return;
         }
         setResult({
@@ -1870,15 +1794,16 @@ function usePayPalPaymentMethods({
     })();
     return () => {
       mounted = false;
-      controller.abort();
     };
-  }, [api, baseUrl, cartId, enabled]);
+  }, [api, key, cartId, enabled]);
   return result;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HttpError,
   MedusaNextPayPalAdapter,
   PAYPAL_CARD_PROVIDER_ID,
+  PAYPAL_PROVIDER_IDS,
   PAYPAL_WALLET_PROVIDER_ID,
   PayPalAdvancedCard,
   PayPalCurrencyNotice,
@@ -1886,9 +1811,11 @@ function usePayPalPaymentMethods({
   PayPalProvider,
   PayPalSmartButtons,
   clearCartCaptured,
+  createHttpClient,
   createPayPalStoreApi,
   generateIdempotencyKey,
   hideProcessingOverlay,
+  invalidatePayPalConfigCache,
   isPayPalProviderId,
   markCartCaptured,
   markPaymentComplete,