coinley-pay 0.61.0 → 0.63.0

package/dist/{CoinleyPayment-BofSrJBx.js → CoinleyPayment-DcxnhCxE.js}

@@ -6,7 +6,7 @@ import { useState, useRef, useEffect, useCallback, useMemo } from "react";
 import ReactDOM, { createPortal } from "react-dom";
 import { useConnect, useAccount, useSwitchChain, useSendTransaction, useWaitForTransactionReceipt, WagmiProvider, useDisconnect } from "wagmi";
 import { QueryClientProvider, QueryClient } from "@tanstack/react-query";
-import { s as sdkAnalytics, c as clarityAnalytics, d as dist, a as Buffer2, B as Buffer$1, g as getCurrencyInfo, p as prefetchRates, i as isSupportedCurrency, b as convertToUSD, f as formatCurrency } from "./index-Dssajde4.js";
+import { s as sdkAnalytics, c as clarityAnalytics, d as dist, a as Buffer2, B as Buffer$1, g as getCurrencyInfo, p as prefetchRates, i as isSupportedCurrency, b as convertToUSD, f as formatCurrency } from "./index-BFlZCZrz.js";
 import { createConfig, fallback, http, getAccount as getAccount$1, getWalletClient, simulateContract, writeContract, readContract, waitForTransactionReceipt, estimateFeesPerGas as estimateFeesPerGas$1 } from "@wagmi/core";
 import { injected, metaMask, coinbaseWallet, walletConnect } from "@wagmi/connectors";
 import { defineChain as defineChain$1, erc20Abi, http as http$1, createPublicClient, fallback as fallback$1 } from "viem";
@@ -21126,7 +21126,7 @@ const WalletSelector = ({
         try {
           setAppKitError(null);
           setWalletConnectAddress(solanaAccountState.address);
-          const { createWalletConnectAdapter } = await import("./appKitSolana-C_InTqyc.js");
+          const { createWalletConnectAdapter } = await import("./appKitSolana-Dyj8Yus-.js");
           const adapter = createWalletConnectAdapter(solanaAccountState.address);
           await solanaWallet.connectWalletConnect(adapter, solanaAccountState.address);
           console.log("✅ WalletConnect synced with SDK");
@@ -21231,7 +21231,7 @@ const WalletSelector = ({
     setAppKitLoading(true);
     setAppKitError(null);
     try {
-      const { initializeAppKitEVM, openAppKitModal } = await import("./appKitEVM-BzMDYdux.js");
+      const { initializeAppKitEVM, openAppKitModal } = await import("./appKitEVM-f4GTnd8I.js");
       await initializeAppKitEVM(wagmiConfig);
       await openAppKitModal();
     } catch (error) {
@@ -21251,7 +21251,7 @@ const WalletSelector = ({
     setAppKitError(null);
     try {
       console.log("📦 Loading AppKit Solana module...");
-      const { initializeAppKitSolana } = await import("./appKitSolana-C_InTqyc.js");
+      const { initializeAppKitSolana } = await import("./appKitSolana-Dyj8Yus-.js");
       console.log("✅ Module loaded, initializing...");
       const modal = await initializeAppKitSolana(solanaWallet);
       console.log("✅ AppKit Solana initialized successfully");
@@ -23128,6 +23128,29 @@ const injectCoinleyFonts = () => {
 `;
   document.head.appendChild(style);
 };
+const FIVE_MINUTES_MS = 5 * 60 * 1e3;
+const TEN_MINUTES_MS = 10 * 60 * 1e3;
+const getRefundPendingGuidance = (elapsedMs = 0) => {
+  if (elapsedMs >= TEN_MINUTES_MS) {
+    return {
+      title: "Refund is taking longer than expected",
+      description: "Your refund is still being processed. You can safely close this window while we continue in the background.",
+      eta: "Most refunds arrive within 15 minutes. If yours does not, check again later or contact support with your payment ID."
+    };
+  }
+  if (elapsedMs >= FIVE_MINUTES_MS) {
+    return {
+      title: "Refund is still being processed",
+      description: "Your refund request has been accepted and is still processing. You do not need to keep this window open.",
+      eta: "Most refunds at this stage arrive within about 10 minutes."
+    };
+  }
+  return {
+    title: "Refund request received",
+    description: "Your refund is being processed automatically. You can safely close this window.",
+    eta: "Most refunds arrive within about 5 minutes."
+  };
+};
 const CHECKOUT_BUILD = "checkout-2026-04-22b-route-destination-trials";
 const UNDERPAYMENT_RECOVERY_STORAGE_PREFIX = "coinley_underpayment_recovery:";
 const UNDERPAYMENT_RECOVERY_TTL_MS = 2 * 60 * 60 * 1e3;
@@ -23356,11 +23379,13 @@ const CoinleyPaymentInternal = ({
   const [refundRequestMessage, setRefundRequestMessage] = useState("");
   const [offsetSuccessDetails, setOffsetSuccessDetails] = useState(null);
   const [refundSuccessDetails, setRefundSuccessDetails] = useState(null);
+  const [overpaymentInfo, setOverpaymentInfo] = useState(null);
   const [recoveryLoadingAction, setRecoveryLoadingAction] = useState(null);
   const [recoveryLoadingStatus, setRecoveryLoadingStatus] = useState(null);
   const manualCheckTimeout = useRef(null);
   const recoveryLoadingStartedAt = useRef(0);
   const recoveryLoadingTimeout = useRef(null);
+  const refundPendingStartedAt = useRef(0);
   const [copiedField, setCopiedField] = useState(null);
   const [expirationTime, setExpirationTime] = useState(null);
   const STANDARD_PAYMENT_TIMEOUT_MS = 15 * 60 * 1e3;
@@ -24291,11 +24316,13 @@ const CoinleyPaymentInternal = ({
           const txHash = resolvePaymentTransactionHash(statusResult.payment);
           if ((status === "completed" || status === "swept") && txHash) {
             clearInterval(pollInterval);
-            captureOffsetSuccessDetails(statusResult.payment, txHash);
             clearUnderpaymentRecovery(paymentData.id);
             setProcessingStatusMessage("");
             persistSuccessfulPaymentHash(statusResult.payment, txHash);
-            setCurrentStep(PAYMENT_STEPS.SUCCESS);
+            const rawPmt = statusResult.payment;
+            const rcvd = parseFloat(rawPmt.amountReceived || 0);
+            const expd = parseFloat(rawPmt.amount || 0);
+            const isOverpaid = rawPmt.refundReason === "overpaid_excess" || rawPmt.excessOwed != null || rcvd > 0 && expd > 0 && rcvd > expd;
             sdkAnalytics.trackPaymentSuccess(
               paymentData.id,
               config == null ? void 0 : config.amount,
@@ -24314,12 +24341,29 @@ const CoinleyPaymentInternal = ({
               onSuccess({
                 paymentId: paymentData.id,
                 transactionHash: txHash,
-                depositAddress: statusResult.payment.depositAddress,
+                depositAddress: rawPmt.depositAddress,
                 network: selectedNetwork == null ? void 0 : selectedNetwork.shortName,
                 currency: selectedToken == null ? void 0 : selectedToken.symbol,
-                paymentDetails: statusResult.payment
+                paymentDetails: rawPmt
+              });
+            }
+            if (isOverpaid) {
+              const excessStr = rawPmt.excessOwed != null ? rawPmt.excessOwed : rcvd > 0 && expd > 0 ? String((rcvd - expd).toFixed(6)) : null;
+              setOverpaymentInfo({
+                paymentId: paymentData.id,
+                excessOwed: excessStr,
+                tokenSymbol: rawPmt.currency || (selectedToken == null ? void 0 : selectedToken.symbol) || "tokens",
+                networkLabel: (selectedNetwork == null ? void 0 : selectedNetwork.displayName) || (selectedNetwork == null ? void 0 : selectedNetwork.name) || (selectedNetwork == null ? void 0 : selectedNetwork.shortName) || "the deposit network"
               });
+              setRefundAddress("");
+              setRefundRequestStatus(null);
+              setRefundRequestSubmitted(false);
+              setRefundRequestMessage("");
+              refundPendingStartedAt.current = 0;
+            } else {
+              captureOffsetSuccessDetails(rawPmt, txHash);
             }
+            setCurrentStep(PAYMENT_STEPS.SUCCESS);
             return;
           }
           if (activateUnderpaymentFlow(statusResult.payment)) {
@@ -24354,6 +24398,25 @@ const CoinleyPaymentInternal = ({
     }, 5e3);
     return () => clearInterval(pollInterval);
   }, [currentStep, paymentData == null ? void 0 : paymentData.id, paymentData == null ? void 0 : paymentData.depositAddress, selectedNetwork, selectedToken, onSuccess, activateUnderpaymentFlow, captureOffsetSuccessDetails, clearUnderpaymentRecovery, resolvePaymentTransactionHash, persistSuccessfulPaymentHash]);
+  useEffect(() => {
+    if (currentStep !== PAYMENT_STEPS.SUCCESS || !(overpaymentInfo == null ? void 0 : overpaymentInfo.paymentId) || !refundRequestSubmitted || refundRequestStatus !== "pending") {
+      return;
+    }
+    const pollInterval = setInterval(async () => {
+      var _a2;
+      try {
+        const statusResult = await paymentFlow.api.getDepositStatus(overpaymentInfo.paymentId);
+        if (statusResult.success && ((_a2 = statusResult.payment) == null ? void 0 : _a2.refundStatus) === "refunded") {
+          clearInterval(pollInterval);
+          refundPendingStartedAt.current = 0;
+          setRefundRequestStatus("refunded");
+        }
+      } catch (e) {
+        console.warn("[OverpaymentRefundPoll] Error:", e.message);
+      }
+    }, 5e3);
+    return () => clearInterval(pollInterval);
+  }, [currentStep, overpaymentInfo, refundRequestSubmitted, refundRequestStatus, paymentFlow.api]);
   useEffect(() => {
     const shouldPoll = (paymentData == null ? void 0 : paymentData.id) && (activeTab === PAYMENT_TABS.QR || activeTab === PAYMENT_TABS.TRANSFER) && currentStep === PAYMENT_STEPS.CONFIRM && !verifyingPayment && paymentType !== PAYMENT_TYPES.DEPOSIT && !(paymentData == null ? void 0 : paymentData.isDepositPayment) && !(paymentData == null ? void 0 : paymentData.depositAddress);
     if (!shouldPoll) {
@@ -24453,6 +24516,7 @@ const CoinleyPaymentInternal = ({
     setRecoveryLoadingAction(null);
     setRecoveryLoadingStatus(null);
     setCcSuccessDetails(null);
+    setOverpaymentInfo(null);
     if (recoveryLoadingTimeout.current) {
       clearTimeout(recoveryLoadingTimeout.current);
       recoveryLoadingTimeout.current = null;
@@ -25377,6 +25441,7 @@ const CoinleyPaymentInternal = ({
       setRecoveryLoadingStatus({ action, ...status });
     });
   }, [runAfterRecoveryMinimum]);
+  const getRefundPendingElapsedMs = useCallback(() => refundPendingStartedAt.current ? Math.max(Date.now() - refundPendingStartedAt.current, 0) : 0, []);
   const getOffsetWaitingStatus = useCallback((overrides = {}) => {
     const shortfallLabel = underpaymentInfo ? `${formatAmount(underpaymentInfo.shortfallAmount || underpaymentInfo.amountRemaining || 0)} ${underpaymentInfo.tokenSymbol || (selectedToken == null ? void 0 : selectedToken.symbol) || ""}`.trim() : "the remaining amount";
     const networkLabel = (underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel) || (selectedNetwork == null ? void 0 : selectedNetwork.name) || (selectedNetwork == null ? void 0 : selectedNetwork.shortName) || "the selected network";
@@ -25387,24 +25452,27 @@ const CoinleyPaymentInternal = ({
       ...overrides
     };
   }, [selectedNetwork == null ? void 0 : selectedNetwork.name, selectedNetwork == null ? void 0 : selectedNetwork.shortName, selectedToken == null ? void 0 : selectedToken.symbol, underpaymentInfo]);
-  const getRefundPendingStatus = useCallback(() => ({
-    title: "Refund request received",
-    description: "We will process it automatically.",
-    detail: `Refunding the received ${(underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol) || (selectedToken == null ? void 0 : selectedToken.symbol) || "tokens"} on ${(underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel) || (selectedNetwork == null ? void 0 : selectedNetwork.name) || (selectedNetwork == null ? void 0 : selectedNetwork.shortName) || "the selected network"}.`
-  }), [selectedNetwork == null ? void 0 : selectedNetwork.name, selectedNetwork == null ? void 0 : selectedNetwork.shortName, selectedToken == null ? void 0 : selectedToken.symbol, underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel, underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol]);
+  const getRefundPendingStatus = useCallback(() => {
+    const guidance = getRefundPendingGuidance(getRefundPendingElapsedMs());
+    return {
+      ...guidance,
+      detail: `${guidance.eta} Refunding the received ${(underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol) || (selectedToken == null ? void 0 : selectedToken.symbol) || "tokens"} on ${(underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel) || (selectedNetwork == null ? void 0 : selectedNetwork.name) || (selectedNetwork == null ? void 0 : selectedNetwork.shortName) || "the selected network"}.`
+    };
+  }, [getRefundPendingElapsedMs, selectedNetwork == null ? void 0 : selectedNetwork.name, selectedNetwork == null ? void 0 : selectedNetwork.shortName, selectedToken == null ? void 0 : selectedToken.symbol, underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel, underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol]);
   const getCrossChainRefundPendingStatus = useCallback((status = ccRefundPendingInfo) => {
     var _a2, _b, _c, _d;
     const details = (status == null ? void 0 : status.refundPendingDetails) || {};
     const tokenSymbol = ((_a2 = status == null ? void 0 : status.underpayment) == null ? void 0 : _a2.tokenSymbol) || ((_b = status == null ? void 0 : status.underpayment) == null ? void 0 : _b.currency) || (underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol) || (ccOriginToken == null ? void 0 : ccOriginToken.symbol) || (selectedToken == null ? void 0 : selectedToken.symbol) || "tokens";
     const networkLabel = ((_c = status == null ? void 0 : status.underpayment) == null ? void 0 : _c.refundNetworkLabel) || (underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel) || ccChainName(((_d = status == null ? void 0 : status.relay) == null ? void 0 : _d.originChainId) || (ccResult == null ? void 0 : ccResult.originChainId) || ccOriginChainId);
     const refundAddressLabel = (status == null ? void 0 : status.refundRecipient) || refundAddress.trim();
+    const guidance = getRefundPendingGuidance(getRefundPendingElapsedMs());
     const available = details.available && details.available !== "0.0" ? ` Relay has returned ${details.available} ${tokenSymbol}.` : "";
     return {
-      title: "Waiting for Relay refund",
-      description: "Relay is returning the underpaid funds before Coinley can send your refund.",
-      detail: `We will keep checking automatically and refund ${tokenSymbol} on ${networkLabel}${refundAddressLabel ? ` to ${truncateAddress(refundAddressLabel)}` : ""}.${available}`
+      title: guidance.title,
+      description: guidance.description,
+      detail: `${guidance.eta} Refund will be sent as ${tokenSymbol} on ${networkLabel}${refundAddressLabel ? ` to ${truncateAddress(refundAddressLabel)}` : ""}.${available}`
     };
-  }, [ccOriginChainId, ccOriginToken == null ? void 0 : ccOriginToken.symbol, ccRefundPendingInfo, ccResult == null ? void 0 : ccResult.originChainId, refundAddress, selectedToken == null ? void 0 : selectedToken.symbol, underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel, underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol]);
+  }, [ccOriginChainId, ccOriginToken == null ? void 0 : ccOriginToken.symbol, ccRefundPendingInfo, ccResult == null ? void 0 : ccResult.originChainId, getRefundPendingElapsedMs, refundAddress, selectedToken == null ? void 0 : selectedToken.symbol, underpaymentInfo == null ? void 0 : underpaymentInfo.refundNetworkLabel, underpaymentInfo == null ? void 0 : underpaymentInfo.tokenSymbol]);
   useEffect(() => () => {
     if (recoveryLoadingTimeout.current) {
       clearTimeout(recoveryLoadingTimeout.current);
@@ -25419,6 +25487,7 @@ const CoinleyPaymentInternal = ({
       const status = await paymentFlow.api.getCrossChainStatus(ccResult.id);
       setCcPhase(status.phase);
       if (status.refundStatus === "refunded") {
+        refundPendingStartedAt.current = 0;
         finishRecoveryLoading(() => {
           setCcRefundPendingInfo(null);
           ccSucceeded.current = true;
@@ -25429,6 +25498,7 @@ const CoinleyPaymentInternal = ({
           setCurrentStep(PAYMENT_STEPS.SUCCESS);
         });
       } else if (status.refundStatus === "pending") {
+        refundPendingStartedAt.current = refundPendingStartedAt.current || Date.now();
         activateUnderpaymentFromCrossChainStatus(status);
         setCcRefundPendingInfo(status);
         setRefundRequestSubmitted(true);
@@ -25498,6 +25568,7 @@ const CoinleyPaymentInternal = ({
         if (cancelled) return;
         setCcPhase(s.phase);
         if (s.refundStatus === "refunded") {
+          refundPendingStartedAt.current = 0;
           ccSucceeded.current = true;
           setCcRefundPendingInfo(null);
           setRefundRequestStatus("refunded");
@@ -25506,6 +25577,7 @@ const CoinleyPaymentInternal = ({
           clearUnderpaymentRecovery(s.paymentId || ccResult.id);
           setCurrentStep(PAYMENT_STEPS.SUCCESS);
         } else if (s.refundStatus === "pending") {
+          refundPendingStartedAt.current = refundPendingStartedAt.current || Date.now();
           activateUnderpaymentFromCrossChainStatus(s);
           setCcRefundPendingInfo(s);
           setRefundRequestSubmitted(true);
@@ -26357,6 +26429,7 @@ const CoinleyPaymentInternal = ({
       setUnderpaymentChoice(recoveryState.choice);
       setUnderpaymentView(recoveryState.view === "refund" ? "refund" : "offset");
       setManualCheckStatus(null);
+      refundPendingStartedAt.current = 0;
       setRefundRequestSubmitted(false);
       setRefundRequestStatus(null);
       setRefundRequestMessage("");
@@ -26366,6 +26439,7 @@ const CoinleyPaymentInternal = ({
     setUnderpaymentChoice(null);
     setUnderpaymentView("choice");
     setRefundAddress("");
+    refundPendingStartedAt.current = 0;
     setRefundRequestSubmitted(false);
     setRefundRequestStatus(null);
     setRefundRequestMessage("");
@@ -26381,6 +26455,7 @@ const CoinleyPaymentInternal = ({
     const trimmedAddress = refundAddress.trim();
     if (!trimmedAddress || !activeTransferPaymentId || refundRequestStatus === "submitting") return;
     startRecoveryLoading("refund");
+    refundPendingStartedAt.current = Date.now();
     setRefundRequestStatus("submitting");
     setRefundRequestMessage("");
     setManualCheckStatus(null);
@@ -26413,6 +26488,7 @@ const CoinleyPaymentInternal = ({
       setRefundRequestSubmitted(true);
       setRefundRequestStatus(refundStatus === "refunded" ? "refunded" : "pending");
       if (refundStatus === "refunded") {
+        refundPendingStartedAt.current = 0;
         finishRecoveryLoading(() => {
           var _a3;
           setRefundRequestMessage("");
@@ -26421,6 +26497,7 @@ const CoinleyPaymentInternal = ({
           setCurrentStep(PAYMENT_STEPS.SUCCESS);
         });
       } else {
+        refundPendingStartedAt.current = refundPendingStartedAt.current || Date.now();
         setRefundRequestMessage("");
         if (ccResult) {
           const pendingStatus = {
@@ -26438,6 +26515,7 @@ const CoinleyPaymentInternal = ({
         }
       }
     } catch (error2) {
+      refundPendingStartedAt.current = 0;
       console.warn("[RefundRequest] Error:", error2.message);
       finishRecoveryLoading(() => {
         setRefundRequestSubmitted(false);
@@ -26446,6 +26524,31 @@ const CoinleyPaymentInternal = ({
       });
     }
   }, [activeTransferPaymentId, captureRefundSuccessDetails, ccOriginChainId, ccOriginToken == null ? void 0 : ccOriginToken.symbol, ccResult, clearUnderpaymentRecovery, config, finishRecoveryLoading, getCrossChainRefundPendingStatus, getRefundPendingStatus, holdRecoveryLoading, refundAddress, refundRequestStatus, paymentFlow.api, selectedNetwork == null ? void 0 : selectedNetwork.shortName, selectedToken == null ? void 0 : selectedToken.symbol, startRecoveryLoading, underpaymentInfo]);
+  const handleOverpaymentRefundSubmit = useCallback(async () => {
+    var _a2;
+    const trimmedAddress = refundAddress.trim();
+    if (!trimmedAddress || !(overpaymentInfo == null ? void 0 : overpaymentInfo.paymentId) || refundRequestStatus === "submitting") return;
+    setRefundRequestStatus("submitting");
+    setRefundRequestMessage("");
+    refundPendingStartedAt.current = Date.now();
+    try {
+      const result = await paymentFlow.api.requestDepositRefund(overpaymentInfo.paymentId, trimmedAddress);
+      const refundSt = ((_a2 = result == null ? void 0 : result.payment) == null ? void 0 : _a2.refundStatus) || (result == null ? void 0 : result.status) || "pending";
+      setRefundRequestSubmitted(true);
+      if (refundSt === "refunded") {
+        refundPendingStartedAt.current = 0;
+        setRefundRequestStatus("refunded");
+      } else {
+        refundPendingStartedAt.current = refundPendingStartedAt.current || Date.now();
+        setRefundRequestStatus("pending");
+      }
+      setRefundRequestMessage("");
+    } catch (error2) {
+      refundPendingStartedAt.current = 0;
+      setRefundRequestStatus("error");
+      setRefundRequestMessage(error2.message || "Failed to submit refund request. Please try again.");
+    }
+  }, [overpaymentInfo, refundAddress, refundRequestStatus, paymentFlow.api]);
   const handleDepositManualCheck = useCallback(async () => {
     if (manualCheckStatus === "checking" || !(paymentData == null ? void 0 : paymentData.id)) return;
     const isOffsetRecovery = Boolean(underpaymentInfo && underpaymentView === "offset");
@@ -26458,22 +26561,41 @@ const CoinleyPaymentInternal = ({
         if ((status === "completed" || status === "swept") && txHash) {
           finishRecoveryLoading(() => {
             setManualCheckStatus(null);
-            captureOffsetSuccessDetails(statusResult.payment, txHash);
             clearUnderpaymentRecovery(paymentData.id);
             persistSuccessfulPaymentHash(statusResult.payment, txHash);
-            setCurrentStep(PAYMENT_STEPS.SUCCESS);
+            const rawPmt = statusResult.payment;
+            const rcvd = parseFloat(rawPmt.amountReceived || 0);
+            const expd = parseFloat(rawPmt.amount || 0);
+            const isOverpaid = rawPmt.refundReason === "overpaid_excess" || rawPmt.excessOwed != null || rcvd > 0 && expd > 0 && rcvd > expd;
             sdkAnalytics.trackPaymentSuccess(paymentData.id, config == null ? void 0 : config.amount, selectedNetwork == null ? void 0 : selectedNetwork.shortName, selectedToken == null ? void 0 : selectedToken.symbol, txHash);
             clarityAnalytics.trackPaymentSuccess(paymentData.id, config == null ? void 0 : config.amount, selectedNetwork == null ? void 0 : selectedNetwork.shortName, selectedToken == null ? void 0 : selectedToken.symbol, txHash);
             if (onSuccess) {
               onSuccess({
                 paymentId: paymentData.id,
                 transactionHash: txHash,
-                depositAddress: statusResult.payment.depositAddress,
+                depositAddress: rawPmt.depositAddress,
                 network: selectedNetwork == null ? void 0 : selectedNetwork.shortName,
                 currency: selectedToken == null ? void 0 : selectedToken.symbol,
-                paymentDetails: statusResult.payment
+                paymentDetails: rawPmt
+              });
+            }
+            if (isOverpaid) {
+              const excessStr = rawPmt.excessOwed != null ? rawPmt.excessOwed : rcvd > 0 && expd > 0 ? String((rcvd - expd).toFixed(6)) : null;
+              setOverpaymentInfo({
+                paymentId: paymentData.id,
+                excessOwed: excessStr,
+                tokenSymbol: rawPmt.currency || (selectedToken == null ? void 0 : selectedToken.symbol) || "tokens",
+                networkLabel: (selectedNetwork == null ? void 0 : selectedNetwork.displayName) || (selectedNetwork == null ? void 0 : selectedNetwork.name) || (selectedNetwork == null ? void 0 : selectedNetwork.shortName) || "the deposit network"
               });
+              setRefundAddress("");
+              setRefundRequestStatus(null);
+              setRefundRequestSubmitted(false);
+              setRefundRequestMessage("");
+              refundPendingStartedAt.current = 0;
+            } else {
+              captureOffsetSuccessDetails(rawPmt, txHash);
             }
+            setCurrentStep(PAYMENT_STEPS.SUCCESS);
           });
           return;
         }
@@ -26582,6 +26704,92 @@ const CoinleyPaymentInternal = ({
     );
   }
   if (currentStep === PAYMENT_STEPS.SUCCESS) {
+    if (overpaymentInfo) {
+      const opElapsedMs = refundPendingStartedAt.current ? Math.max(Date.now() - refundPendingStartedAt.current, 0) : 0;
+      const opGuidance = refundRequestSubmitted && refundRequestStatus === "pending" ? getRefundPendingGuidance(opElapsedMs) : null;
+      return renderInPortal(
+        /* @__PURE__ */ jsxs("div", { id: SDK_ROOT_ID, className: `${SDK_ROOT_CLASS} fixed inset-0 z-50`, style: { fontFamily: FONT_FAMILY }, children: [
+          /* @__PURE__ */ jsx("div", { className: "fixed inset-0 bg-black bg-opacity-50", onClick: onClose }),
+          /* @__PURE__ */ jsx("div", { className: isMobile ? "fixed inset-0 flex items-end" : "fixed inset-0 flex items-center justify-center p-4", style: { zIndex: 51 }, children: /* @__PURE__ */ jsxs("div", { className: isMobile ? "coinley-mobile-sheet relative flex w-full max-h-[92dvh] flex-col overflow-hidden rounded-t-[24px] bg-white px-4 pb-5 pt-7 shadow-2xl animate-slide-up-sheet" : "relative flex h-auto min-h-[520px] w-[430px] max-w-[calc(100vw-32px)] flex-col overflow-hidden rounded-[28px] bg-white px-4 pb-5 pt-7 shadow-2xl", children: [
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                onClick: onClose,
+                className: "absolute right-4 top-5 flex h-8 w-8 items-center justify-center rounded-full text-[#111827] transition-colors hover:bg-gray-100",
+                "aria-label": "Close payment modal",
+                children: /* @__PURE__ */ jsx("svg", { className: "h-5 w-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) })
+              }
+            ),
+            /* @__PURE__ */ jsxs("div", { className: "flex flex-1 flex-col overflow-y-auto pt-2", children: [
+              /* @__PURE__ */ jsxs("div", { className: "mb-5 text-center", children: [
+                /* @__PURE__ */ jsx("div", { className: "mx-auto mb-3 flex h-16 w-16 items-center justify-center rounded-full bg-[#D9F8E6]", children: /* @__PURE__ */ jsx("div", { className: "flex h-11 w-11 items-center justify-center rounded-full bg-[#08C65A] text-white", children: /* @__PURE__ */ jsx("svg", { className: "h-5 w-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2.5, d: "M5 13l4 4L19 7" }) }) }) }),
+                /* @__PURE__ */ jsx("h3", { className: "mb-1 text-lg font-semibold text-black", children: "Payment Received" }),
+                /* @__PURE__ */ jsx("p", { className: "text-sm text-[#6B7280]", children: overpaymentInfo.excessOwed ? `You sent ${formatAmount(overpaymentInfo.excessOwed)} ${overpaymentInfo.tokenSymbol} more than required. We will refund the excess to you.` : `You sent more than the required amount. We will refund the excess to you.` })
+              ] }),
+              /* @__PURE__ */ jsx("div", { className: "mb-5 rounded-lg border border-[#F5E5B8] bg-[#FFF9E8] px-3 py-2", children: /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2", children: [
+                /* @__PURE__ */ jsx("svg", { className: "mt-0.5 h-4 w-4 flex-shrink-0 text-[#B54708]", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 9v4m0 4h.01M12 3a9 9 0 110 18 9 9 0 010-18z" }) }),
+                /* @__PURE__ */ jsxs("p", { className: "text-xs leading-5 text-[#B54708]", children: [
+                  overpaymentInfo.excessOwed ? `We are holding ${formatAmount(overpaymentInfo.excessOwed)} ${overpaymentInfo.tokenSymbol} for you.` : `We are holding your excess ${overpaymentInfo.tokenSymbol} for you.`,
+                  " ",
+                  "Provide a wallet address below. You can safely close this window after submitting — the refund processes automatically."
+                ] })
+              ] }) }),
+              refundRequestStatus === "refunded" ? /* @__PURE__ */ jsxs("div", { className: "rounded-xl border border-[#D1FAE5] bg-[#ECFDF5] px-3 py-3 text-center", children: [
+                /* @__PURE__ */ jsx("p", { className: "text-sm font-semibold text-[#065F46]", children: "Excess refunded" }),
+                /* @__PURE__ */ jsxs("p", { className: "mt-1 text-xs leading-5 text-[#047857]", children: [
+                  "Your excess ",
+                  overpaymentInfo.tokenSymbol,
+                  " has been sent to your wallet."
+                ] })
+              ] }) : opGuidance ? /* @__PURE__ */ jsxs("div", { className: "rounded-xl border border-[#EEF0F4] bg-[#FAFAFB] px-3 py-3", children: [
+                /* @__PURE__ */ jsx("p", { className: "text-sm font-semibold text-[#111827]", children: opGuidance.title }),
+                /* @__PURE__ */ jsx("p", { className: "mt-1 text-xs leading-5 text-[#535865]", children: opGuidance.description }),
+                /* @__PURE__ */ jsx("p", { className: "mt-2 text-xs leading-5 text-[#8B8E98]", children: opGuidance.eta })
+              ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+                /* @__PURE__ */ jsxs("label", { className: "mb-2 block text-xs font-medium text-[#111827]", children: [
+                  "Your ",
+                  overpaymentInfo.tokenSymbol,
+                  " (",
+                  overpaymentInfo.networkLabel,
+                  ") wallet address for refund"
+                ] }),
+                /* @__PURE__ */ jsx(
+                  "input",
+                  {
+                    type: "text",
+                    value: refundAddress,
+                    onChange: (e) => setRefundAddress(e.target.value),
+                    placeholder: "Paste your wallet address here",
+                    className: "mb-4 h-11 w-full rounded-xl border border-[#E4E6EB] bg-white px-3 text-sm text-[#1F2430] outline-none transition-colors placeholder:text-[#8B8E98] focus:border-[#B49AF0]"
+                  }
+                ),
+                refundRequestMessage && /* @__PURE__ */ jsx("p", { className: `mb-3 text-xs leading-5 ${refundRequestStatus === "error" ? "text-red-600" : "text-[#8B8E98]"}`, children: refundRequestMessage }),
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    onClick: handleOverpaymentRefundSubmit,
+                    disabled: !refundAddress.trim() || refundRequestStatus === "submitting",
+                    className: "h-12 w-full rounded-xl bg-[#7042D2] px-4 text-sm font-semibold text-white transition-colors hover:bg-[#5b34b1] disabled:opacity-50 disabled:cursor-not-allowed",
+                    children: refundRequestStatus === "submitting" ? "Submitting..." : "Submit Refund Address"
+                  }
+                )
+              ] })
+            ] }),
+            (refundRequestStatus === "refunded" || opGuidance) && /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                onClick: onClose,
+                className: "mt-4 h-12 w-full rounded-lg border border-[#E4E6EB] px-4 text-sm font-semibold text-[#374151] transition-colors hover:bg-gray-50",
+                children: "Close"
+              }
+            )
+          ] }) })
+        ] })
+      );
+    }
     if (offsetSuccessDetails) {
       return renderInPortal(
         /* @__PURE__ */ jsxs("div", { id: SDK_ROOT_ID, className: `${SDK_ROOT_CLASS} fixed inset-0 z-50`, style: { fontFamily: FONT_FAMILY }, children: [
@@ -26835,7 +27043,7 @@ const CoinleyPaymentInternal = ({
     /* @__PURE__ */ jsx("div", { className: "flex overflow-hidden rounded-xl bg-[#F6F6F7] p-1", children: [
       { tab: PAYMENT_TABS.TRANSFER, label: "Transfer to address", mobileLabel: "Transfer" },
       { tab: PAYMENT_TABS.QR, label: "QR Code", mobileLabel: "QR Code" },
-      { tab: PAYMENT_TABS.WALLET, label: "Wallet Extension", mobileLabel: "Wallet" }
+      { tab: PAYMENT_TABS.WALLET, label: "Wallet Extension", mobileLabel: "Wallet Extension" }
     ].map((method) => /* @__PURE__ */ jsx(
       "button",
       {
@@ -27525,6 +27733,7 @@ const CoinleyPaymentInternal = ({
   );
   const handleUnderpaymentChoiceContinue = () => {
     if (!underpaymentChoice) return;
+    refundPendingStartedAt.current = 0;
     setRefundRequestSubmitted(false);
     const nextView = underpaymentChoice === "refund" ? "refund" : "offset";
     writeUnderpaymentRecovery(underpaymentChoice, nextView, underpaymentInfo);
@@ -28135,6 +28344,7 @@ const CoinleyPaymentInternal = ({
     setUnderpaymentChoice(null);
     setUnderpaymentView("choice");
     setRefundAddress("");
+    refundPendingStartedAt.current = 0;
     setRefundRequestSubmitted(false);
     setRefundRequestStatus(null);
     setRefundRequestMessage("");
@@ -28238,4 +28448,4 @@ export {
   chainTransports as c,
   isFeatureEnabled as i
 };
-//# sourceMappingURL=CoinleyPayment-BofSrJBx.js.map
+//# sourceMappingURL=CoinleyPayment-DcxnhCxE.js.map

package/dist/{appKitEVM-BzMDYdux.js → appKitEVM-f4GTnd8I.js}

@@ -1,4 +1,4 @@
-import { i as isFeatureEnabled, F as FEATURES, c as chainTransports, W as WALLETCONNECT_PROJECT_ID } from "./CoinleyPayment-BofSrJBx.js";
+import { i as isFeatureEnabled, F as FEATURES, c as chainTransports, W as WALLETCONNECT_PROJECT_ID } from "./CoinleyPayment-DcxnhCxE.js";
 const logo = "https://coinley.io/logo.png";
 let appKitInstance = null;
 let isInitializing = false;
@@ -113,4 +113,4 @@ export {
   initializeAppKitEVM,
   openAppKitModal
 };
-//# sourceMappingURL=appKitEVM-BzMDYdux.js.map
+//# sourceMappingURL=appKitEVM-f4GTnd8I.js.map

package/dist/{appKitSolana-C_InTqyc.js → appKitSolana-Dyj8Yus-.js}

@@ -1,4 +1,4 @@
-import { F as FEATURES, W as WALLETCONNECT_PROJECT_ID } from "./CoinleyPayment-BofSrJBx.js";
+import { F as FEATURES, W as WALLETCONNECT_PROJECT_ID } from "./CoinleyPayment-DcxnhCxE.js";
 const logo = "https://coinley.io/logo.png";
 let appKitInstance = null;
 let isInitializing = false;
@@ -243,4 +243,4 @@ export {
   disconnectWalletConnect,
   initializeAppKitSolana
 };
-//# sourceMappingURL=appKitSolana-C_InTqyc.js.map
+//# sourceMappingURL=appKitSolana-Dyj8Yus-.js.map