@ic-pay/icpay-sdk 1.4.93 → 1.4.103

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IcpayWallet = exports.IcpayError = exports.Icpay = void 0;
+const base_builder_code_1 = require("./base-builder-code");
 const builders_1 = require("./x402/builders");
 const errors_1 = require("./errors");
 const events_1 = require("./events");
@@ -319,12 +320,15 @@ class Icpay {
     async notifyPayment(params) {
         this.emitMethodStart('notifyPayment', { paymentIntentId: params.paymentIntentId });
         try {
-            const resp = await this.publicApiClient.post('/sdk/public/payments/notify', {
+            const body = {
                 paymentIntentId: params.paymentIntentId,
                 canisterTxId: params.canisterTxId,
                 transactionId: params.transactionId,
                 orderId: params.orderId,
-            });
+            };
+            if (params.icpayPaymentLink && typeof params.icpayPaymentLink === 'object')
+                body.icpayPaymentLink = params.icpayPaymentLink;
+            const resp = await this.publicApiClient.post('/sdk/public/payments/notify', body);
             this.emitMethodSuccess('notifyPayment', { status: resp?.status, paymentIntentId: resp?.paymentIntentId });
             return resp;
         }
@@ -765,6 +769,7 @@ class Icpay {
                     paymentIntentId: paymentIntentId,
                     maxAttempts: 120,
                     delayMs: 1000,
+                    icpayPaymentLink: request?.metadata?.icpayPaymentLink,
                 });
                 // Derive status from API response
                 let statusString = 'pending';
@@ -1099,7 +1104,7 @@ class Icpay {
                 return out;
             }
             try {
-                await this.performNotifyPaymentIntent({ paymentIntentId: params.paymentIntentId, transactionId: signature, maxAttempts: 1 });
+                await this.performNotifyPaymentIntent({ paymentIntentId: params.paymentIntentId, transactionId: signature, maxAttempts: 1, icpayPaymentLink: params.metadata?.icpayPaymentLink });
             }
             catch { }
             const finalQuick = await this.awaitIntentTerminal({
@@ -1164,6 +1169,13 @@ class Icpay {
             }
         }
         catch { }
+        // Resolve current chain id for Base Builder Code attribution (only EVM)
+        let currentChainId = null;
+        try {
+            const currentHex = await eth.request({ method: 'eth_chainId' });
+            currentChainId = parseInt(currentHex, 16);
+        }
+        catch { }
         const tokenAddress = params.ledgerCanisterId || null;
         const isNative = !tokenAddress || /^0x0{40}$/i.test(String(tokenAddress));
         const amountHex = '0x' + params.amount.toString(16);
@@ -1242,8 +1254,9 @@ class Icpay {
                     throw new errors_1.IcpayError({ code: errors_1.ICPAY_ERROR_CODES.INVALID_CONFIG, message: 'Missing payNative selector from API; update API/chain metadata.' });
                 }
                 const data = extSel + idHex + toUint64(accountIdNum) + toUint256(externalCost) + toAddressPadded(recipient);
-                (0, utils_1.debugLog)(this.config.debug || false, 'evm native tx', { to: contractAddress, from: owner, dataLen: data.length, value: amountHex, recipient });
-                txHash = await eth.request({ method: 'eth_sendTransaction', params: [{ from: owner, to: contractAddress, data, value: amountHex }] });
+                const dataWithAttribution = (0, base_builder_code_1.appendBaseBuilderSuffixIfNeeded)(currentChainId, data);
+                (0, utils_1.debugLog)(this.config.debug || false, 'evm native tx', { to: contractAddress, from: owner, dataLen: dataWithAttribution.length, value: amountHex, recipient });
+                txHash = await eth.request({ method: 'eth_sendTransaction', params: [{ from: owner, to: contractAddress, data: dataWithAttribution, value: amountHex }] });
             }
             else {
                 // Ensure allowance(owner -> spender=contractAddress)
@@ -1257,8 +1270,9 @@ class Icpay {
                     (0, utils_1.debugLog)(this.config.debug || false, 'evm erc20 allowance result', { allowance: allowance.toString() });
                     if (allowance < params.amount) {
                         const approveData = approveSelector + toAddressPadded(contractAddress) + toUint256(params.amount);
-                        (0, utils_1.debugLog)(this.config.debug || false, 'evm erc20 approve', { to: tokenAddress, from: owner, dataLen: approveData.length, amount: params.amount.toString() });
-                        const approveTx = await eth.request({ method: 'eth_sendTransaction', params: [{ from: owner, to: String(tokenAddress), data: approveData }] });
+                        const approveDataWithAttribution = (0, base_builder_code_1.appendBaseBuilderSuffixIfNeeded)(currentChainId, approveData);
+                        (0, utils_1.debugLog)(this.config.debug || false, 'evm erc20 approve', { to: tokenAddress, from: owner, dataLen: approveDataWithAttribution.length, amount: params.amount.toString() });
+                        const approveTx = await eth.request({ method: 'eth_sendTransaction', params: [{ from: owner, to: String(tokenAddress), data: approveDataWithAttribution }] });
                         (0, utils_1.debugLog)(this.config.debug || false, 'evm erc20 approve sent', { tx: approveTx });
                         await waitForReceipt(approveTx, 90, 1000);
                     }
@@ -1271,8 +1285,9 @@ class Icpay {
                 }
                 const base = idHex + toUint64(accountIdNum) + toAddressPadded(String(tokenAddress)) + toUint256(params.amount) + toUint256(externalCost);
                 const data = extSel + base + toAddressPadded(recipient);
-                (0, utils_1.debugLog)(this.config.debug || false, 'evm erc20 pay', { to: contractAddress, from: owner, token: tokenAddress, dataLen: data.length, recipient });
-                txHash = await eth.request({ method: 'eth_sendTransaction', params: [{ from: owner, to: contractAddress, data }] });
+                const dataWithAttribution = (0, base_builder_code_1.appendBaseBuilderSuffixIfNeeded)(currentChainId, data);
+                (0, utils_1.debugLog)(this.config.debug || false, 'evm erc20 pay', { to: contractAddress, from: owner, token: tokenAddress, dataLen: dataWithAttribution.length, recipient });
+                txHash = await eth.request({ method: 'eth_sendTransaction', params: [{ from: owner, to: contractAddress, data: dataWithAttribution }] });
             }
         }
         catch (e) {
@@ -1289,7 +1304,7 @@ class Icpay {
         catch { }
         // Inform API immediately with tx hash so it can start indexing
         try {
-            await this.performNotifyPaymentIntent({ paymentIntentId: params.paymentIntentId, transactionId: txHash, maxAttempts: 1 });
+            await this.performNotifyPaymentIntent({ paymentIntentId: params.paymentIntentId, transactionId: txHash, maxAttempts: 1, icpayPaymentLink: params.metadata?.icpayPaymentLink });
         }
         catch { }
         const finalResponse = await this.awaitIntentTerminal({
@@ -1425,6 +1440,40 @@ class Icpay {
         }
         return new Uint8Array(out);
     }
+    /**
+     * Resolve payment intent from config or request: use full intent if provided, else fetch by id via API.
+     * Returns null when no pre-provided intent (caller should create via POST).
+     */
+    async getOrResolvePaymentIntent(request) {
+        const isFullIntent = (o) => o && typeof o === 'object' && o.id && typeof (o.amount === 'string' ? o.amount : String(o.amount ?? '')) === 'string' &&
+            (o.chainType != null || o.chainId != null || (o.ledgerCanisterId != null && o.ledgerCanisterId !== ''));
+        const fromRequest = request?.paymentIntent;
+        const fromConfig = this.config?.paymentIntent;
+        if (fromRequest && isFullIntent(fromRequest)) {
+            (0, utils_1.debugLog)(this.config.debug || false, 'using payment intent from request');
+            return { paymentIntent: fromRequest, onramp: null };
+        }
+        if (fromConfig && isFullIntent(fromConfig)) {
+            (0, utils_1.debugLog)(this.config.debug || false, 'using payment intent from config');
+            return { paymentIntent: fromConfig, onramp: null };
+        }
+        const intentId = (fromRequest && typeof fromRequest.id === 'string' && fromRequest.id) ||
+            (fromConfig && typeof fromConfig.id === 'string' && fromConfig.id) ||
+            (typeof this.config?.paymentIntentId === 'string' && this.config.paymentIntentId) || null;
+        if (intentId && this.publicApiClient) {
+            try {
+                (0, utils_1.debugLog)(this.config.debug || false, 'fetching payment intent by id', { intentId });
+                const resp = await this.publicApiClient.get(`/sdk/public/payments/intents/${encodeURIComponent(intentId)}`);
+                if (resp?.paymentIntent) {
+                    return { paymentIntent: resp.paymentIntent, onramp: resp.onramp ?? null };
+                }
+            }
+            catch (e) {
+                (0, utils_1.debugLog)(this.config.debug || false, 'fetch payment intent failed', e);
+            }
+        }
+        return null;
+    }
     /**
      * Create a payment to a specific canister/ledger (public method)
      * This is now a real transaction
@@ -1437,17 +1486,18 @@ class Icpay {
             let ledgerCanisterId = request.ledgerCanisterId;
             const tokenShortcode = request?.tokenShortcode;
             const isOnrampFlow = (request?.onrampPayment === true) || (this?.config?.onrampPayment === true);
-            if (!ledgerCanisterId && !tokenShortcode && !request.symbol && !isOnrampFlow) {
+            const hasPaymentIntent = request?.paymentIntent != null || this.config?.paymentIntent != null || (typeof this.config?.paymentIntentId === 'string' && this.config.paymentIntentId);
+            if (!ledgerCanisterId && !tokenShortcode && !request.symbol && !isOnrampFlow && !hasPaymentIntent) {
                 const err = new errors_1.IcpayError({
                     code: errors_1.ICPAY_ERROR_CODES.INVALID_CONFIG,
-                    message: 'Provide either tokenShortcode or ledgerCanisterId (symbol is deprecated).',
+                    message: 'Provide either tokenShortcode or ledgerCanisterId (symbol is deprecated), or pass paymentIntent.',
                     details: { request }
                 });
                 this.emitMethodError('createPayment', err);
                 throw err;
             }
             let memo = undefined;
-            // 1) Create payment intent via API (backend will finalize amount/price)
+            // 1) Resolve or create payment intent: use pre-provided (config/request) or fetch by id, else create via API
             let paymentIntentId = null;
             let paymentIntentCode = null;
             let intentChainType;
@@ -1455,114 +1505,162 @@ class Icpay {
             let accountCanisterId;
             let resolvedAmountStr = typeof request.amount === 'string' ? request.amount : (request.amount != null ? String(request.amount) : undefined);
             let intentResp;
+            let expectedSenderPrincipal;
             try {
-                (0, utils_1.debugLog)(this.config.debug || false, 'creating payment intent');
-                // Resolve expected sender principal:
-                // Start with any value explicitly provided on the request or via connectedWallet.
-                let expectedSenderPrincipal = request.expectedSenderPrincipal ||
-                    this.connectedWallet?.owner ||
-                    this.connectedWallet?.principal?.toString();
-                // If none yet and a Solana provider is present (e.g., Phantom), prefer its publicKey (base58).
-                try {
-                    const solProv = this.config?.solanaProvider || globalThis?.solana;
-                    const solPk = solProv?.publicKey ? String(solProv.publicKey) : undefined;
-                    if (!expectedSenderPrincipal && solPk) {
-                        expectedSenderPrincipal = String(solPk);
-                    }
-                }
-                catch { }
-                // Only if still missing, fall back to EVM accounts.
-                if (!expectedSenderPrincipal) {
-                    const evm = this.config?.evmProvider || globalThis?.ethereum;
-                    if (evm?.request) {
-                        try {
-                            const accounts = await evm.request({ method: 'eth_accounts' });
-                            if (Array.isArray(accounts) && accounts[0]) {
-                                const lowerAccounts = accounts.map((a) => String(a).toLowerCase());
-                                const providedRaw = request?.expectedSenderPrincipal;
-                                if (providedRaw) {
-                                    const provided = String(providedRaw).toLowerCase();
-                                    expectedSenderPrincipal = lowerAccounts.includes(provided) ? accounts[lowerAccounts.indexOf(provided)] : accounts[0];
+                const meta = request?.metadata || {};
+                const isAtxp = Boolean(meta?.icpay_atxp_request) && typeof (meta?.atxp_request_id) === 'string';
+                const onramp = (request.onrampPayment === true || this.config.onrampPayment === true) && this.config.onrampDisabled !== true ? true : false;
+                // If we have a pre-provided intent or an id to fetch, resolve first (skip create for non-ATXP/non-onramp create flows)
+                if (!isAtxp && !onramp) {
+                    const resolved = await this.getOrResolvePaymentIntent(request);
+                    if (resolved) {
+                        let pi = resolved.paymentIntent;
+                        const intentHasToken = (pi?.ledgerId != null) || (pi?.ledgerCanisterId && String(pi.ledgerCanisterId).trim() !== '');
+                        if (!intentHasToken) {
+                            const tokenToSet = request?.tokenShortcode;
+                            if (tokenToSet && typeof tokenToSet === 'string' && this.publicApiClient) {
+                                try {
+                                    await this.publicApiClient.patch(`/sdk/public/payments/intents/${encodeURIComponent(pi.id)}/set-token`, { tokenShortcode: tokenToSet.trim() });
+                                    const refetched = await this.publicApiClient.get(`/sdk/public/payments/intents/${encodeURIComponent(pi.id)}`);
+                                    if (refetched?.paymentIntent)
+                                        pi = refetched.paymentIntent;
                                 }
-                                else {
-                                    expectedSenderPrincipal = accounts[0];
+                                catch (e) {
+                                    (0, utils_1.debugLog)(this.config.debug || false, 'set-token failed', e);
+                                    throw new errors_1.IcpayError({
+                                        code: errors_1.ICPAY_ERROR_CODES.API_ERROR,
+                                        message: 'Payment intent requires a token to be selected. Setting token failed.',
+                                        details: e,
+                                        retryable: true,
+                                        userAction: 'Ensure tokenShortcode is valid and try again',
+                                    });
                                 }
                             }
+                            else {
+                                throw new errors_1.IcpayError({
+                                    code: errors_1.ICPAY_ERROR_CODES.INVALID_CONFIG,
+                                    message: 'Payment intent requires a token to be selected before payment. Provide tokenShortcode in the request.',
+                                    details: { paymentIntentId: pi?.id },
+                                    retryable: false,
+                                    userAction: 'Select a token (e.g. pass tokenShortcode) and try again',
+                                });
+                            }
                         }
-                        catch { }
+                        intentResp = { paymentIntent: pi, onramp: resolved.onramp };
+                        expectedSenderPrincipal = request.expectedSenderPrincipal ||
+                            this.connectedWallet?.owner || this.connectedWallet?.principal?.toString();
                     }
                 }
-                if (!expectedSenderPrincipal && !((request?.onrampPayment === true) || (this?.config?.onrampPayment === true))) {
-                    throw new errors_1.IcpayError({
-                        code: errors_1.ICPAY_ERROR_CODES.WALLET_NOT_CONNECTED,
-                        message: 'Wallet must be connected to create payment intent',
-                        details: { connectedWallet: this.connectedWallet },
-                        retryable: false,
-                        userAction: 'Connect your wallet first'
-                    });
-                }
-                const onramp = (request.onrampPayment === true || this.config.onrampPayment === true) && this.config.onrampDisabled !== true ? true : false;
-                const meta = request?.metadata || {};
-                const isAtxp = Boolean(meta?.icpay_atxp_request) && typeof (meta?.atxp_request_id) === 'string';
-                // Resolve recipientAddress only for non-onramp flows
-                const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
-                const reqAny = request;
-                const addrObj = (reqAny?.recipientAddresses) || {};
-                const candidateEvm = addrObj.evm ? addrObj.evm : undefined;
-                const candidateIC = addrObj.ic ? addrObj.ic : undefined;
-                const candidateSol = addrObj.sol ? addrObj.sol : undefined;
-                let recipientAddress = undefined;
-                if (!onramp) {
-                    // Choose a default to persist on the intent; EVM will override to ZERO if non-hex when building tx
-                    recipientAddress = (reqAny?.recipientAddress) || candidateEvm || candidateIC || candidateSol || ZERO_ADDRESS;
-                    (0, utils_1.debugLog)(this.config.debug || false, 'recipientAddress resolved for intent', { recipientAddress });
-                }
-                if (isAtxp) {
-                    // Route ATXP intents to the ATXP endpoint so they link to the request
-                    const atxpRequestId = String(meta.atxp_request_id);
-                    const endpoint = `/sdk/public/atxp/requests/${encodeURIComponent(atxpRequestId)}/payment-intents`;
-                    intentResp = await this.publicApiClient.post(endpoint, {
-                        tokenShortcode: tokenShortcode || undefined,
-                        description: request.description,
-                        recipientAddress,
-                        recipientAddresses: request?.recipientAddresses || undefined,
-                        externalCostAmount: request?.externalCostAmount ?? request?.metadata?.externalCostAmount ?? undefined,
-                        fiat_currency: request?.fiat_currency,
-                    });
-                }
-                else {
-                    if (onramp) {
-                        // Route onramp flows to the dedicated onramp endpoint without requiring token/ledger
-                        intentResp = await this.publicApiClient.post('/sdk/public/onramp/intents', {
-                            usdAmount: request.amountUsd,
-                            description: request.description,
-                            metadata: normalizeSdkMetadata(request.metadata || {}),
-                            widgetParams: request.widgetParams || undefined,
-                            recipientAddresses: request?.recipientAddresses || undefined,
-                            fiat_currency: request?.fiat_currency,
+                if (!intentResp) {
+                    (0, utils_1.debugLog)(this.config.debug || false, 'creating payment intent via API');
+                    // Resolve expected sender principal:
+                    // Start with any value explicitly provided on the request or via connectedWallet.
+                    expectedSenderPrincipal =
+                        request.expectedSenderPrincipal ||
+                            this.connectedWallet?.owner ||
+                            this.connectedWallet?.principal?.toString();
+                    // If none yet and a Solana provider is present (e.g., Phantom), prefer its publicKey (base58).
+                    try {
+                        const solProv = this.config?.solanaProvider || globalThis?.solana;
+                        const solPk = solProv?.publicKey ? String(solProv.publicKey) : undefined;
+                        if (!expectedSenderPrincipal && solPk) {
+                            expectedSenderPrincipal = String(solPk);
+                        }
+                    }
+                    catch { }
+                    // Only if still missing, fall back to EVM accounts.
+                    if (!expectedSenderPrincipal) {
+                        const evm = this.config?.evmProvider || globalThis?.ethereum;
+                        if (evm?.request) {
+                            try {
+                                const accounts = await evm.request({ method: 'eth_accounts' });
+                                if (Array.isArray(accounts) && accounts[0]) {
+                                    const lowerAccounts = accounts.map((a) => String(a).toLowerCase());
+                                    const providedRaw = request?.expectedSenderPrincipal;
+                                    if (providedRaw) {
+                                        const provided = String(providedRaw).toLowerCase();
+                                        expectedSenderPrincipal = lowerAccounts.includes(provided) ? accounts[lowerAccounts.indexOf(provided)] : accounts[0];
+                                    }
+                                    else {
+                                        expectedSenderPrincipal = accounts[0];
+                                    }
+                                }
+                            }
+                            catch { }
+                        }
+                    }
+                    if (!expectedSenderPrincipal && !((request?.onrampPayment === true) || (this?.config?.onrampPayment === true))) {
+                        throw new errors_1.IcpayError({
+                            code: errors_1.ICPAY_ERROR_CODES.WALLET_NOT_CONNECTED,
+                            message: 'Wallet must be connected to create payment intent',
+                            details: { connectedWallet: this.connectedWallet },
+                            retryable: false,
+                            userAction: 'Connect your wallet first'
                         });
                     }
-                    else {
-                        intentResp = await this.publicApiClient.post('/sdk/public/payments/intents', {
-                            amount: (typeof request.amount === 'string' ? request.amount : (request.amount != null ? String(request.amount) : undefined)),
-                            // Prefer tokenShortcode if provided
+                    const onramp = (request.onrampPayment === true || this.config.onrampPayment === true) && this.config.onrampDisabled !== true ? true : false;
+                    const meta = request?.metadata || {};
+                    const isAtxp = Boolean(meta?.icpay_atxp_request) && typeof (meta?.atxp_request_id) === 'string';
+                    // Resolve recipientAddress only for non-onramp flows
+                    const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+                    const reqAny = request;
+                    const addrObj = (reqAny?.recipientAddresses) || {};
+                    const candidateEvm = addrObj.evm ? addrObj.evm : undefined;
+                    const candidateIC = addrObj.ic ? addrObj.ic : undefined;
+                    const candidateSol = addrObj.sol ? addrObj.sol : undefined;
+                    let recipientAddress = undefined;
+                    if (!onramp) {
+                        // Choose a default to persist on the intent; EVM will override to ZERO if non-hex when building tx
+                        recipientAddress = (reqAny?.recipientAddress) || candidateEvm || candidateIC || candidateSol || ZERO_ADDRESS;
+                        (0, utils_1.debugLog)(this.config.debug || false, 'recipientAddress resolved for intent', { recipientAddress });
+                    }
+                    if (isAtxp) {
+                        // Route ATXP intents to the ATXP endpoint so they link to the request
+                        const atxpRequestId = String(meta.atxp_request_id);
+                        const endpoint = `/sdk/public/atxp/requests/${encodeURIComponent(atxpRequestId)}/payment-intents`;
+                        intentResp = await this.publicApiClient.post(endpoint, {
                             tokenShortcode: tokenShortcode || undefined,
-                            // Legacy fields for backwards compatibility
-                            symbol: tokenShortcode ? undefined : request.symbol,
-                            ledgerCanisterId: tokenShortcode ? undefined : ledgerCanisterId,
                             description: request.description,
-                            expectedSenderPrincipal,
-                            metadata: normalizeSdkMetadata(request.metadata || {}),
-                            amountUsd: request.amountUsd,
-                            // With tokenShortcode, backend derives chain. Keep legacy chainId for old flows.
-                            chainId: tokenShortcode ? undefined : request.chainId,
-                            widgetParams: request.widgetParams || undefined,
                             recipientAddress,
                             recipientAddresses: request?.recipientAddresses || undefined,
                             externalCostAmount: request?.externalCostAmount ?? request?.metadata?.externalCostAmount ?? undefined,
                             fiat_currency: request?.fiat_currency,
                         });
                     }
+                    else {
+                        if (onramp) {
+                            // Route onramp flows to the dedicated onramp endpoint without requiring token/ledger
+                            intentResp = await this.publicApiClient.post('/sdk/public/onramp/intents', {
+                                usdAmount: request.amountUsd,
+                                description: request.description,
+                                metadata: normalizeSdkMetadata(request.metadata || {}),
+                                widgetParams: request.widgetParams || undefined,
+                                recipientAddresses: request?.recipientAddresses || undefined,
+                                fiat_currency: request?.fiat_currency,
+                            });
+                        }
+                        else {
+                            intentResp = await this.publicApiClient.post('/sdk/public/payments/intents', {
+                                amount: (typeof request.amount === 'string' ? request.amount : (request.amount != null ? String(request.amount) : undefined)),
+                                // Prefer tokenShortcode if provided
+                                tokenShortcode: tokenShortcode || undefined,
+                                // Legacy fields for backwards compatibility
+                                symbol: tokenShortcode ? undefined : request.symbol,
+                                ledgerCanisterId: tokenShortcode ? undefined : ledgerCanisterId,
+                                description: request.description,
+                                expectedSenderPrincipal,
+                                metadata: normalizeSdkMetadata(request.metadata || {}),
+                                amountUsd: request.amountUsd,
+                                // With tokenShortcode, backend derives chain. Keep legacy chainId for old flows.
+                                chainId: tokenShortcode ? undefined : request.chainId,
+                                widgetParams: request.widgetParams || undefined,
+                                recipientAddress,
+                                recipientAddresses: request?.recipientAddresses || undefined,
+                                externalCostAmount: request?.externalCostAmount ?? request?.metadata?.externalCostAmount ?? undefined,
+                                fiat_currency: request?.fiat_currency,
+                            });
+                        }
+                    }
                 }
                 paymentIntentId = intentResp?.paymentIntent?.id || null;
                 paymentIntentCode = intentResp?.paymentIntent?.intentCode ?? null;
@@ -2251,6 +2349,12 @@ class Icpay {
             // We forward both amountUsd and amount (if provided), and do not resolve canister here.
             const ledgerCanisterId = request.ledgerCanisterId || '';
             const tokenShortcode = request?.tokenShortcode;
+            // Resolve existing payment intent id so API reuses it instead of creating a second intent (e.g. pay link page)
+            const existingIntentId = (typeof request?.paymentIntentId === 'string' && request.paymentIntentId) ||
+                (typeof request?.paymentIntent?.id === 'string' && request.paymentIntent.id) ||
+                (typeof this.config?.paymentIntentId === 'string' && this.config.paymentIntentId) ||
+                (typeof this.config?.paymentIntent?.id === 'string' && this.config.paymentIntent.id) ||
+                null;
             // Hit X402 endpoint
             const body = {
                 amount: request.amount,
@@ -2266,6 +2370,9 @@ class Icpay {
                 recipientAddress: request?.recipientAddress || '0x0000000000000000000000000000000000000000',
                 fiat_currency: request?.fiat_currency ?? request?.fiatCurrency ?? this.config?.fiat_currency,
             };
+            if (existingIntentId) {
+                body.paymentIntentId = existingIntentId;
+            }
             if (body.fiat_currency === undefined || body.fiat_currency === '') {
                 delete body.fiat_currency;
             }
@@ -2589,7 +2696,7 @@ class Icpay {
                                             catch { }
                                             if (sig) {
                                                 try {
-                                                    await this.performNotifyPaymentIntent({ paymentIntentId, transactionId: sig, maxAttempts: 1 });
+                                                    await this.performNotifyPaymentIntent({ paymentIntentId, transactionId: sig, maxAttempts: 1, icpayPaymentLink: request.metadata?.icpayPaymentLink });
                                                 }
                                                 catch { }
                                             }
@@ -3857,6 +3964,8 @@ class Icpay {
                     body.externalCostAmount = params.externalCostAmount;
                 if (typeof params.recipientPrincipal === 'string')
                     body.recipientPrincipal = params.recipientPrincipal;
+                if (params.icpayPaymentLink && typeof params.icpayPaymentLink === 'object')
+                    body.icpayPaymentLink = params.icpayPaymentLink;
                 const resp = await notifyClient.post(notifyPath, body);
                 // If this is the last attempt, return whatever we got
                 if (attempt === maxAttempts) {
@@ -3908,6 +4017,7 @@ class Icpay {
                     accountCanisterId: params.accountCanisterId,
                     externalCostAmount: params.externalCostAmount,
                     recipientPrincipal: params.recipientPrincipal,
+                    icpayPaymentLink: params.metadata?.icpayPaymentLink,
                 });
                 const status = resp?.paymentIntent?.status || resp?.payment?.status || resp?.status || '';
                 const norm = typeof status === 'string' ? status.toLowerCase() : '';