@funnelfox/billing 0.9.3-ffb-apple-pay-continue-button.33 → 0.10.0

package/dist/funnelfox-billing.js

@@ -123,6 +123,8 @@
             this.errorType = options.errorType || null;
             this.requestId = options.requestId || null;
             this.response = options.response || null;
+            this.declineCode = options.declineCode || null;
+            this.declineCodeSource = options.declineCodeSource || null;
         }
     }
     class PrimerError extends FunnefoxSDKError {
@@ -327,6 +329,48 @@
     /**
      * @fileoverview Helper utilities for Funnefox SDK
      */
+    // Mirrors Stripe Elements: a card number that can never become valid is reported while the buyer
+    // types, an incomplete value only after they leave the field, and an empty one only after a submit
+    // attempt. Primer reports every error on every keystroke, even for fields the buyer has not reached
+    // yet, and its expiry codes cannot tell a typo from a half-typed date ("1" is already
+    // expiryYearInvalid, "01/2" is cardExpired), so expiry errors wait for the buyer to leave the field.
+    const HOSTED_INPUT_ERRORS_SHOWN_WHILE_TYPING = new Set(['cardInvalid']);
+    const HOSTED_INPUT_ERRORS_FOR_EMPTY_FIELD = new Set([
+        'cardRequired',
+        'expiryRequired',
+        'cvvRequired',
+    ]);
+    function getVisibleHostedInputError(input) {
+        if (!input.error) {
+            return null;
+        }
+        if (input.errorCode &&
+            HOSTED_INPUT_ERRORS_SHOWN_WHILE_TYPING.has(input.errorCode)) {
+            return input.error;
+        }
+        if (input.active) {
+            return null;
+        }
+        if (input.submitted) {
+            return input.error;
+        }
+        if (input.errorCode &&
+            HOSTED_INPUT_ERRORS_FOR_EMPTY_FIELD.has(input.errorCode)) {
+            return null;
+        }
+        return input.touched ? input.error : null;
+    }
+    function resolveTaxDisplay(source) {
+        const taxBehavior = source.tax_behavior ??
+            ((source.tax_amount ?? 0) > 0 ? 'exclusive' : undefined);
+        if (taxBehavior === 'inclusive') {
+            return { taxBehavior, taxAmount: source.tax_inclusive_amount ?? 0 };
+        }
+        if (taxBehavior === 'exclusive') {
+            return { taxBehavior, taxAmount: source.tax_amount ?? 0 };
+        }
+        return { taxAmount: 0 };
+    }
     function merge(...objects) {
         const result = {};
         for (const obj of objects) {
@@ -495,7 +539,7 @@
     /**
      * @fileoverview Constants for Funnefox SDK
      */
-    const SDK_VERSION = '0.9.3-ffb-apple-pay-continue-button.33';
+    const SDK_VERSION = '0.10.0';
     const DEFAULTS = {
         BASE_URL: 'https://billing.funnelfox.com',
         REGION: 'default',
@@ -632,117 +676,6 @@
         return true;
     }
 
-    /**
-     * @fileoverview Support for Apple's official <apple-pay-button> custom element.
-     *
-     * Primer's checkout-web v2 renders the Apple Pay button through the CSS
-     * approach (-webkit-appearance: -apple-pay-button), and WebKit only accepts
-     * the 7 legacy values for -apple-pay-button-type. Newer types such as
-     * 'continue' are silently dropped and fall back to 'plain' (verified in
-     * Safari 26 on macOS and iOS — see PRD-1426).
-     *
-     * Apple's official custom element supports the full set of button types, so
-     * for "native-only" types we overlay it on top of the (visually hidden)
-     * Primer button and forward clicks, keeping Primer's payment flow untouched.
-     */
-    const APPLE_PAY_SDK_URL = 'https://applepay.cdn-apple.com/jsapi/v1/apple-pay-sdk.js';
-    /** How long to wait for the <apple-pay-button> element definition before
-     * giving up and falling back to Primer's own button. */
-    const ELEMENT_DEFINITION_TIMEOUT_MS = 4000;
-    /**
-     * Button types WebKit can render through Primer's CSS approach.
-     * Everything outside this list requires the native <apple-pay-button> element.
-     */
-    const CSS_RENDERABLE_APPLE_PAY_TYPES = [
-        'plain',
-        'buy',
-        'set-up',
-        'donate',
-        'check-out',
-        'book',
-        'subscribe',
-    ];
-    /**
-     * Returns true when the requested Apple Pay buttonType can only be rendered
-     * with Apple's native <apple-pay-button> element.
-     */
-    function isNativeOnlyApplePayButtonType(type) {
-        return !!type && !CSS_RENDERABLE_APPLE_PAY_TYPES.includes(type);
-    }
-    /**
-     * Loads Apple's apple-pay-sdk.js (defines the <apple-pay-button> custom
-     * element). Resolves to true when the element is available.
-     */
-    async function loadApplePayButtonElement() {
-        if (typeof window === 'undefined' || !window.customElements) {
-            return false;
-        }
-        if (window.customElements.get('apple-pay-button')) {
-            return true;
-        }
-        try {
-            await loadScript$1({
-                src: APPLE_PAY_SDK_URL,
-                crossOrigin: 'anonymous',
-                appendTo: 'head',
-            });
-            // Never hang on a script that loaded but did not define the element —
-            // fall back to Primer's own button instead.
-            const defined = window.customElements
-                .whenDefined('apple-pay-button')
-                .then(() => true);
-            const timeout = new Promise(resolve => {
-                setTimeout(() => resolve(false), ELEMENT_DEFINITION_TIMEOUT_MS);
-            });
-            return await Promise.race([defined, timeout]);
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Renders Apple's native <apple-pay-button> stretched over `wrapper` and
-     * forwards clicks to the Primer-rendered <button> inside it. The synchronous
-     * forwarded click preserves the user activation required by ApplePaySession.
-     *
-     * Returns the overlay element, or null when the Apple Pay SDK could not be
-     * loaded (callers should keep Primer's own button visible as a fallback).
-     */
-    async function overlayNativeApplePayButton(wrapper, options) {
-        const available = await loadApplePayButtonElement();
-        if (!available) {
-            return null;
-        }
-        // The overlay is only safe when Primer's own clickable button is present —
-        // otherwise there is nothing to forward the click to.
-        if (!wrapper.querySelector('button')) {
-            return null;
-        }
-        const native = document.createElement('apple-pay-button');
-        native.setAttribute('type', options.buttonType);
-        native.setAttribute('buttonstyle', options.buttonStyle || 'black');
-        native.setAttribute('locale', (typeof navigator !== 'undefined' && navigator.language) || 'en-US');
-        native.style.cssText = [
-            'position:absolute',
-            'inset:0',
-            'width:100%',
-            'height:100%',
-            '--apple-pay-button-width:100%',
-            '--apple-pay-button-height:100%',
-            '--apple-pay-button-border-radius:28px',
-            'display:block',
-            'cursor:pointer',
-            'z-index:1',
-        ].join(';');
-        wrapper.style.position = 'relative';
-        native.addEventListener('click', () => {
-            const primerButton = wrapper.querySelector('button');
-            primerButton?.click();
-        });
-        wrapper.appendChild(native);
-        return native;
-    }
-
     /**
      * @fileoverview Primer SDK integration wrapper
      */
@@ -781,7 +714,6 @@
         }
         async createHeadlessCheckout(clientToken, options, method) {
             await this.ensurePrimerLoaded();
-            this.applePayOptions = options.applePay;
             this.currentHeadless = PrimerWrapper.headlessManager.getOrCreate(clientToken, options, method);
             return this.currentHeadless;
         }
@@ -828,53 +760,16 @@
                 }
                 htmlNode.appendChild(wrapper);
                 /* end hack */
-                /* PRD-1426: WebKit cannot render newer Apple Pay button types (e.g.
-                 * 'continue') through the CSS approach Primer v2 uses. For those types
-                 * we overlay Apple's official <apple-pay-button> element on top of the
-                 * visually hidden Primer button and forward clicks, keeping Primer's
-                 * payment flow untouched. The Primer button is hidden BEFORE it renders
-                 * to avoid a flash of the plain button; if the Apple SDK fails to load,
-                 * the rule is removed and Primer's own button stays visible (graceful
-                 * fallback to 'plain'). */
-                const applePayConfig = this.applePayOptions;
-                const nativeButtonType = allowedPaymentMethod === exports.PaymentMethod.APPLE_PAY &&
-                    applePayConfig?.buttonType &&
-                    isNativeOnlyApplePayButtonType(applePayConfig.buttonType)
-                    ? applePayConfig.buttonType
-                    : null;
-                let hideRuleIndex = null;
-                if (nativeButtonType && sheet) {
-                    hideRuleIndex = sheet.insertRule(`
-          .${wrapper.className} > button {
-            opacity: 0 !important;
-          }
-        `);
-                }
                 button = pmManager.createButton();
                 await button.render(wrapper, {});
-                let nativeOverlay = null;
-                if (nativeButtonType) {
-                    nativeOverlay = await overlayNativeApplePayButton(wrapper, {
-                        buttonType: nativeButtonType,
-                        buttonStyle: applePayConfig?.buttonStyle,
-                    });
-                    if (!nativeOverlay && sheet && hideRuleIndex !== null) {
-                        sheet.deleteRule(hideRuleIndex);
-                    }
-                }
                 this.destroyCallbacks.push(() => button.clean());
                 onMethodRender(allowedPaymentMethod);
                 return {
                     setDisabled: (disabled) => {
                         button.setDisabled(disabled);
-                        if (nativeOverlay) {
-                            nativeOverlay.style.pointerEvents = disabled ? 'none' : '';
-                            nativeOverlay.style.opacity = disabled ? '0.5' : '';
-                        }
                     },
                     destroy: () => {
                         styleEl.remove();
-                        nativeOverlay?.remove();
                         button.clean();
                     },
                 };
@@ -959,11 +854,22 @@
                         ? 'Please enter a postal code'
                         : null;
                 };
+                const focusedHostedInputs = new Set();
                 const onHostedInputChange = (name) => (event) => {
                     const input = event;
-                    if (input.submitted) {
-                        dispatchError(name, input.error);
+                    const justFocused = input.active && !focusedHostedInputs.has(name);
+                    if (input.active) {
+                        focusedHostedInputs.add(name);
+                    }
+                    else {
+                        focusedHostedInputs.delete(name);
+                    }
+                    // Primer sends a change on focus before any keystroke; like Stripe, the error the buyer
+                    // came back to fix stays visible until they start typing.
+                    if (justFocused) {
+                        return;
                     }
+                    dispatchError(name, getVisibleHostedInputError(input));
                 };
                 const cardHolderOnChange = async (e) => {
                     pmManager.setCardholderName(e.target.value);
@@ -1221,6 +1127,37 @@
     }
     PrimerWrapper.headlessManager = new HeadlessManager();
 
+    /**
+     * @fileoverview Normalization of payment failure errors
+     */
+    const STRIPE_CARD_ERROR = 'card_error';
+    function declineCodeFromStripeError(error) {
+        const { type, code } = error;
+        if (type !== STRIPE_CARD_ERROR || typeof code !== 'string' || !code) {
+            return null;
+        }
+        return code.toUpperCase();
+    }
+    function toPaymentFailure(error) {
+        const failure = new Error(error?.message || 'Payment processing failed');
+        if (error instanceof APIError) {
+            if (error.declineCode) {
+                failure.declineCode = error.declineCode;
+            }
+            if (error.declineCodeSource) {
+                failure.declineCodeSource = error.declineCodeSource;
+            }
+        }
+        else if (error instanceof Error) {
+            const declineCode = declineCodeFromStripeError(error);
+            if (declineCode) {
+                failure.declineCode = declineCode;
+                failure.declineCodeSource = 'stripe';
+            }
+        }
+        return failure;
+    }
+
     /**
      * @fileoverview API client for Funnefox backend integration
      */
@@ -1418,7 +1355,11 @@
                             status: 'succeeded',
                         };
                     case 'failed':
-                        throw new APIError(data.failed_message_for_user || 'Payment failed', null, { response });
+                        throw new APIError(data.failed_message_for_user || 'Payment failed', null, {
+                            response,
+                            declineCode: data.decline_code,
+                            declineCodeSource: data.decline_code_source,
+                        });
                     case 'cancelled':
                         throw new APIError('Payment was cancelled by user', null, {
                             response,
@@ -2019,8 +1960,8 @@
                 }
                 return {
                     amountTotal: data.amount_total,
-                    taxAmount: data.tax_amount ?? 0,
                     currency: data.currency ?? '',
+                    ...resolveTaxDisplay(data),
                 };
             };
             this.emitTaxInfo = (info) => {
@@ -2053,8 +1994,8 @@
                     }
                     this.emitTaxInfo({
                         amountTotal: tax.amount_total,
-                        taxAmount: tax.tax_amount,
                         currency: tax.currency,
+                        ...resolveTaxDisplay(tax),
                     });
                 }
                 catch (err) {
@@ -2073,6 +2014,7 @@
                 if (this.taxRecalcDebounce) {
                     clearTimeout(this.taxRecalcDebounce);
                 }
+                this.checkoutConfig.onTaxPending?.();
                 this.emit(EVENTS.TAX_PENDING);
                 this.taxRecalcDebounce = setTimeout(this.runTaxRecalc, TAX_RECALC_DEBOUNCE_MS$1);
             };
@@ -2130,8 +2072,8 @@
                 }
                 catch (error) {
                     this._setState('error');
-                    this.emit(EVENTS.PURCHASE_FAILURE, new Error(error.message || 'Payment processing failed'));
-                    primerHandler.handleFailure(error.message || 'Payment processing failed');
+                    this.emit(EVENTS.PURCHASE_FAILURE, toPaymentFailure(error));
+                    primerHandler.handleFailure(error?.message || 'Payment processing failed');
                 }
                 finally {
                     this.onLoaderChangeWithRace(false);
@@ -2155,8 +2097,8 @@
                 }
                 catch (error) {
                     this._setState('error');
-                    this.emit(EVENTS.PURCHASE_FAILURE, new Error(error.message || 'Payment processing failed'));
-                    primerHandler.handleFailure(error.message || 'Payment processing failed');
+                    this.emit(EVENTS.PURCHASE_FAILURE, toPaymentFailure(error));
+                    primerHandler.handleFailure(error?.message || 'Payment processing failed');
                 }
                 finally {
                     this.emit(EVENTS.PURCHASE_COMPLETED);
@@ -2745,6 +2687,9 @@
             await this.primerWrapper.initializeHeadlessCheckout(this.clientToken, checkoutOptions, method);
             const methodInterface = await this.primerWrapper.initMethod(method, element, methodOptions);
             this.startUnhandledTelemetry(method);
+            if (this.isTaxEnabled() && !this.lastTaxInfo) {
+                this.emitSessionTaxEstimate();
+            }
             return {
                 ...methodInterface,
                 destroy: async () => {
@@ -2908,6 +2853,9 @@
                         ...DEFAULT_BUTTONS_OPTIONS[exports.PaymentMethod.GOOGLE_PAY],
                         ...(options.googlePay || {}),
                     },
+                    onTaxChange: options.onTaxChange,
+                    onTaxError: options.onTaxError,
+                    onTaxPending: options.onTaxPending,
                 },
             });
             return await checkoutInstance.initMethod(method, element, {
@@ -3098,7 +3046,7 @@
 
     var template = "<div>\n  <label class=\"ff-card-form-label\" for=\"cardNumberInput\">Card number</label>\n  <div id=\"cardNumberInput\"></div>\n  <div class=\"errorContainer\"></div>\n</div>\n<div class=\"card-form-row\">\n  <div>\n    <label class=\"ff-card-form-label\" for=\"expiryInput\">Expiration date</label>\n    <div id=\"expiryInput\"></div>\n    <div class=\"errorContainer\"></div>\n  </div>\n  <div>\n    <label class=\"ff-card-form-label\" for=\"cvvInput\">Security code</label>\n    <div id=\"cvvInput\">\n      <svg width=\"200\" height=\"200\" viewBox=\"0 0 200 200\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n        <rect width=\"200\" height=\"200\" fill=\"transparent\"/>\n        <g clip-path=\"url(#clip0_0_1)\">\n          <path d=\"M157.555 23C168.279 23.0002 177 31.7394 177 42.4854V80.5889C171.946 72.0151 164.749 64.8558 156.146 59.8457H166.394V42.4854C166.393 37.6004 162.43 33.6291 157.555 33.6289H27.4453C22.5704 33.6291 18.6066 37.6004 18.6064 42.4854V59.8457H97.8535C88.9153 65.0512 81.4954 72.5771 76.4189 81.5986H18.6064V127.515C18.6066 132.4 22.5704 136.371 27.4453 136.371H75.3281C77.2742 140.177 79.6285 143.739 82.333 147H27.4453C16.7215 147 8.00019 138.261 8 127.515V42.4854C8.0002 31.7394 16.7215 23.0002 27.4453 23H157.555Z\" fill=\"#93939A\"/>\n          <mask id=\"path-2-outside-1_0_1\" maskUnits=\"userSpaceOnUse\" x=\"68.5012\" y=\"52.0311\" width=\"135\" height=\"135\" fill=\"black\">\n            <rect fill=\"white\" x=\"68.5012\" y=\"52.0311\" width=\"135\" height=\"135\"/>\n            <path d=\"M190.242 160.457L170.136 140.351C166.533 145.552 162.023 150.063 156.821 153.666L176.927 173.772C178.693 175.538 181.088 176.53 183.585 176.53C186.082 176.53 188.477 175.538 190.242 173.772C192.008 172.007 193 169.612 193 167.115C193 164.618 192.008 162.223 190.242 160.457ZM126.436 157.901C116.955 157.901 107.688 155.089 99.8048 149.822C91.922 144.555 85.7781 137.069 82.15 128.31C78.5219 119.551 77.5727 109.913 79.4222 100.614C81.2718 91.3158 85.8371 82.7746 92.5409 76.0708C99.2447 69.367 107.786 64.8017 117.084 62.9521C126.383 61.1026 136.021 62.0518 144.78 65.6799C153.539 69.308 161.025 75.4519 166.292 83.3347C171.559 91.2175 174.371 100.485 174.371 109.966C174.371 122.679 169.32 134.871 160.331 143.861C151.341 152.85 139.149 157.901 126.436 157.901ZM163.719 109.966C163.719 102.592 161.532 95.3838 157.435 89.2527C153.339 83.1216 147.516 78.343 140.703 75.5212C133.891 72.6994 126.395 71.9611 119.162 73.3996C111.93 74.8382 105.287 78.389 100.073 83.6031C94.8591 88.8171 91.3083 95.4602 89.8697 102.692C88.4312 109.924 89.1695 117.421 91.9913 124.233C94.8131 131.046 99.5918 136.869 105.723 140.965C111.854 145.062 119.062 147.248 126.436 147.248C136.324 147.248 145.807 143.32 152.799 136.329C159.791 129.337 163.719 119.854 163.719 109.966ZM133.645 102.757C133.398 102.51 133.104 102.313 132.781 102.179C132.458 102.046 132.112 101.977 131.762 101.977C131.412 101.977 131.066 102.046 130.743 102.179C130.42 102.313 130.126 102.51 129.879 102.757L126.436 106.2L122.993 102.757C122.49 102.272 121.818 102.003 121.119 102.01C120.421 102.016 119.753 102.296 119.26 102.789C118.766 103.283 118.486 103.951 118.48 104.649C118.474 105.348 118.742 106.02 119.227 106.523L122.67 109.966L119.227 113.409C118.973 113.655 118.77 113.949 118.63 114.274C118.491 114.598 118.417 114.948 118.414 115.301C118.411 115.655 118.479 116.006 118.612 116.333C118.746 116.66 118.944 116.958 119.194 117.208C119.444 117.458 119.741 117.655 120.069 117.789C120.396 117.923 120.747 117.991 121.1 117.988C121.454 117.985 121.803 117.911 122.128 117.771C122.453 117.632 122.747 117.429 122.993 117.175L126.436 113.732L129.879 117.175C130.382 117.66 131.054 117.928 131.752 117.922C132.451 117.916 133.119 117.636 133.612 117.142C134.106 116.648 134.386 115.981 134.392 115.282C134.398 114.584 134.13 113.911 133.645 113.409L130.202 109.966L133.645 106.523C133.892 106.275 134.088 105.982 134.222 105.659C134.356 105.336 134.425 104.989 134.425 104.64C134.425 104.29 134.356 103.944 134.222 103.621C134.088 103.298 133.892 103.004 133.645 102.757ZM112.34 102.757C112.093 102.51 111.8 102.313 111.477 102.179C111.154 102.046 110.807 101.977 110.458 101.977C110.108 101.977 109.762 102.046 109.439 102.179C109.116 102.313 108.822 102.51 108.575 102.757L105.132 106.2L101.688 102.757C101.186 102.272 100.513 102.003 99.8151 102.01C99.1169 102.016 98.4489 102.296 97.9552 102.789C97.4614 103.283 97.1814 103.951 97.1753 104.649C97.1692 105.348 97.4377 106.02 97.9227 106.523L101.366 109.966L97.9227 113.409C97.6684 113.655 97.4655 113.949 97.326 114.274C97.1864 114.598 97.1129 114.948 97.1098 115.301C97.1068 115.655 97.1742 116.006 97.3081 116.333C97.442 116.66 97.6397 116.958 97.8897 117.208C98.1398 117.458 98.4371 117.655 98.7644 117.789C99.0917 117.923 99.4423 117.991 99.7959 117.988C100.15 117.985 100.499 117.911 100.824 117.771C101.149 117.632 101.443 117.429 101.688 117.175L105.132 113.732L108.575 117.175C109.077 117.66 109.75 117.928 110.448 117.922C111.146 117.916 111.814 117.636 112.308 117.142C112.802 116.648 113.082 115.981 113.088 115.282C113.094 114.584 112.826 113.911 112.34 113.409L108.897 109.966L112.34 106.523C112.588 106.275 112.784 105.982 112.918 105.659C113.052 105.336 113.121 104.989 113.121 104.64C113.121 104.29 113.052 103.944 112.918 103.621C112.784 103.298 112.588 103.004 112.34 102.757ZM151.506 109.966L154.949 106.523C155.434 106.02 155.703 105.348 155.697 104.649C155.691 103.951 155.41 103.283 154.917 102.789C154.423 102.296 153.755 102.016 153.057 102.01C152.359 102.003 151.686 102.272 151.184 102.757L147.74 106.2L144.297 102.757C143.795 102.272 143.122 102.003 142.424 102.01C141.726 102.016 141.058 102.296 140.564 102.789C140.07 103.283 139.79 103.951 139.784 104.649C139.778 105.348 140.046 106.02 140.531 106.523L143.974 109.966L140.531 113.409C140.277 113.655 140.074 113.949 139.935 114.274C139.795 114.598 139.722 114.948 139.719 115.301C139.715 115.655 139.783 116.006 139.917 116.333C140.051 116.66 140.248 116.958 140.498 117.208C140.748 117.458 141.046 117.655 141.373 117.789C141.7 117.923 142.051 117.991 142.405 117.988C142.758 117.985 143.108 117.911 143.433 117.771C143.757 117.632 144.051 117.429 144.297 117.175L147.74 113.732L151.184 117.175C151.686 117.66 152.359 117.928 153.057 117.922C153.755 117.916 154.423 117.636 154.917 117.142C155.41 116.648 155.691 115.981 155.697 115.282C155.703 114.584 155.434 113.911 154.949 113.409L151.506 109.966Z\"/>\n          </mask>\n          <path d=\"M190.242 160.457L170.136 140.351C166.533 145.552 162.023 150.063 156.821 153.666L176.927 173.772C178.693 175.538 181.088 176.53 183.585 176.53C186.082 176.53 188.477 175.538 190.242 173.772C192.008 172.007 193 169.612 193 167.115C193 164.618 192.008 162.223 190.242 160.457ZM126.436 157.901C116.955 157.901 107.688 155.089 99.8048 149.822C91.922 144.555 85.7781 137.069 82.15 128.31C78.5219 119.551 77.5727 109.913 79.4222 100.614C81.2718 91.3158 85.8371 82.7746 92.5409 76.0708C99.2447 69.367 107.786 64.8017 117.084 62.9521C126.383 61.1026 136.021 62.0518 144.78 65.6799C153.539 69.308 161.025 75.4519 166.292 83.3347C171.559 91.2175 174.371 100.485 174.371 109.966C174.371 122.679 169.32 134.871 160.331 143.861C151.341 152.85 139.149 157.901 126.436 157.901ZM163.719 109.966C163.719 102.592 161.532 95.3838 157.435 89.2527C153.339 83.1216 147.516 78.343 140.703 75.5212C133.891 72.6994 126.395 71.9611 119.162 73.3996C111.93 74.8382 105.287 78.389 100.073 83.6031C94.8591 88.8171 91.3083 95.4602 89.8697 102.692C88.4312 109.924 89.1695 117.421 91.9913 124.233C94.8131 131.046 99.5918 136.869 105.723 140.965C111.854 145.062 119.062 147.248 126.436 147.248C136.324 147.248 145.807 143.32 152.799 136.329C159.791 129.337 163.719 119.854 163.719 109.966ZM133.645 102.757C133.398 102.51 133.104 102.313 132.781 102.179C132.458 102.046 132.112 101.977 131.762 101.977C131.412 101.977 131.066 102.046 130.743 102.179C130.42 102.313 130.126 102.51 129.879 102.757L126.436 106.2L122.993 102.757C122.49 102.272 121.818 102.003 121.119 102.01C120.421 102.016 119.753 102.296 119.26 102.789C118.766 103.283 118.486 103.951 118.48 104.649C118.474 105.348 118.742 106.02 119.227 106.523L122.67 109.966L119.227 113.409C118.973 113.655 118.77 113.949 118.63 114.274C118.491 114.598 118.417 114.948 118.414 115.301C118.411 115.655 118.479 116.006 118.612 116.333C118.746 116.66 118.944 116.958 119.194 117.208C119.444 117.458 119.741 117.655 120.069 117.789C120.396 117.923 120.747 117.991 121.1 117.988C121.454 117.985 121.803 117.911 122.128 117.771C122.453 117.632 122.747 117.429 122.993 117.175L126.436 113.732L129.879 117.175C130.382 117.66 131.054 117.928 131.752 117.922C132.451 117.916 133.119 117.636 133.612 117.142C134.106 116.648 134.386 115.981 134.392 115.282C134.398 114.584 134.13 113.911 133.645 113.409L130.202 109.966L133.645 106.523C133.892 106.275 134.088 105.982 134.222 105.659C134.356 105.336 134.425 104.989 134.425 104.64C134.425 104.29 134.356 103.944 134.222 103.621C134.088 103.298 133.892 103.004 133.645 102.757ZM112.34 102.757C112.093 102.51 111.8 102.313 111.477 102.179C111.154 102.046 110.807 101.977 110.458 101.977C110.108 101.977 109.762 102.046 109.439 102.179C109.116 102.313 108.822 102.51 108.575 102.757L105.132 106.2L101.688 102.757C101.186 102.272 100.513 102.003 99.8151 102.01C99.1169 102.016 98.4489 102.296 97.9552 102.789C97.4614 103.283 97.1814 103.951 97.1753 104.649C97.1692 105.348 97.4377 106.02 97.9227 106.523L101.366 109.966L97.9227 113.409C97.6684 113.655 97.4655 113.949 97.326 114.274C97.1864 114.598 97.1129 114.948 97.1098 115.301C97.1068 115.655 97.1742 116.006 97.3081 116.333C97.442 116.66 97.6397 116.958 97.8897 117.208C98.1398 117.458 98.4371 117.655 98.7644 117.789C99.0917 117.923 99.4423 117.991 99.7959 117.988C100.15 117.985 100.499 117.911 100.824 117.771C101.149 117.632 101.443 117.429 101.688 117.175L105.132 113.732L108.575 117.175C109.077 117.66 109.75 117.928 110.448 117.922C111.146 117.916 111.814 117.636 112.308 117.142C112.802 116.648 113.082 115.981 113.088 115.282C113.094 114.584 112.826 113.911 112.34 113.409L108.897 109.966L112.34 106.523C112.588 106.275 112.784 105.982 112.918 105.659C113.052 105.336 113.121 104.989 113.121 104.64C113.121 104.29 113.052 103.944 112.918 103.621C112.784 103.298 112.588 103.004 112.34 102.757ZM151.506 109.966L154.949 106.523C155.434 106.02 155.703 105.348 155.697 104.649C155.691 103.951 155.41 103.283 154.917 102.789C154.423 102.296 153.755 102.016 153.057 102.01C152.359 102.003 151.686 102.272 151.184 102.757L147.74 106.2L144.297 102.757C143.795 102.272 143.122 102.003 142.424 102.01C141.726 102.016 141.058 102.296 140.564 102.789C140.07 103.283 139.79 103.951 139.784 104.649C139.778 105.348 140.046 106.02 140.531 106.523L143.974 109.966L140.531 113.409C140.277 113.655 140.074 113.949 139.935 114.274C139.795 114.598 139.722 114.948 139.719 115.301C139.715 115.655 139.783 116.006 139.917 116.333C140.051 116.66 140.248 116.958 140.498 117.208C140.748 117.458 141.046 117.655 141.373 117.789C141.7 117.923 142.051 117.991 142.405 117.988C142.758 117.985 143.108 117.911 143.433 117.771C143.757 117.632 144.051 117.429 144.297 117.175L147.74 113.732L151.184 117.175C151.686 117.66 152.359 117.928 153.057 117.922C153.755 117.916 154.423 117.636 154.917 117.142C155.41 116.648 155.691 115.981 155.697 115.282C155.703 114.584 155.434 113.911 154.949 113.409L151.506 109.966Z\" fill=\"#93939A\"/>\n          <path d=\"M190.242 160.457L170.136 140.351C166.533 145.552 162.023 150.063 156.821 153.666L176.927 173.772C178.693 175.538 181.088 176.53 183.585 176.53C186.082 176.53 188.477 175.538 190.242 173.772C192.008 172.007 193 169.612 193 167.115C193 164.618 192.008 162.223 190.242 160.457ZM126.436 157.901C116.955 157.901 107.688 155.089 99.8048 149.822C91.922 144.555 85.7781 137.069 82.15 128.31C78.5219 119.551 77.5727 109.913 79.4222 100.614C81.2718 91.3158 85.8371 82.7746 92.5409 76.0708C99.2447 69.367 107.786 64.8017 117.084 62.9521C126.383 61.1026 136.021 62.0518 144.78 65.6799C153.539 69.308 161.025 75.4519 166.292 83.3347C171.559 91.2175 174.371 100.485 174.371 109.966C174.371 122.679 169.32 134.871 160.331 143.861C151.341 152.85 139.149 157.901 126.436 157.901ZM163.719 109.966C163.719 102.592 161.532 95.3838 157.435 89.2527C153.339 83.1216 147.516 78.343 140.703 75.5212C133.891 72.6994 126.395 71.9611 119.162 73.3996C111.93 74.8382 105.287 78.389 100.073 83.6031C94.8591 88.8171 91.3083 95.4602 89.8697 102.692C88.4312 109.924 89.1695 117.421 91.9913 124.233C94.8131 131.046 99.5918 136.869 105.723 140.965C111.854 145.062 119.062 147.248 126.436 147.248C136.324 147.248 145.807 143.32 152.799 136.329C159.791 129.337 163.719 119.854 163.719 109.966ZM133.645 102.757C133.398 102.51 133.104 102.313 132.781 102.179C132.458 102.046 132.112 101.977 131.762 101.977C131.412 101.977 131.066 102.046 130.743 102.179C130.42 102.313 130.126 102.51 129.879 102.757L126.436 106.2L122.993 102.757C122.49 102.272 121.818 102.003 121.119 102.01C120.421 102.016 119.753 102.296 119.26 102.789C118.766 103.283 118.486 103.951 118.48 104.649C118.474 105.348 118.742 106.02 119.227 106.523L122.67 109.966L119.227 113.409C118.973 113.655 118.77 113.949 118.63 114.274C118.491 114.598 118.417 114.948 118.414 115.301C118.411 115.655 118.479 116.006 118.612 116.333C118.746 116.66 118.944 116.958 119.194 117.208C119.444 117.458 119.741 117.655 120.069 117.789C120.396 117.923 120.747 117.991 121.1 117.988C121.454 117.985 121.803 117.911 122.128 117.771C122.453 117.632 122.747 117.429 122.993 117.175L126.436 113.732L129.879 117.175C130.382 117.66 131.054 117.928 131.752 117.922C132.451 117.916 133.119 117.636 133.612 117.142C134.106 116.648 134.386 115.981 134.392 115.282C134.398 114.584 134.13 113.911 133.645 113.409L130.202 109.966L133.645 106.523C133.892 106.275 134.088 105.982 134.222 105.659C134.356 105.336 134.425 104.989 134.425 104.64C134.425 104.29 134.356 103.944 134.222 103.621C134.088 103.298 133.892 103.004 133.645 102.757ZM112.34 102.757C112.093 102.51 111.8 102.313 111.477 102.179C111.154 102.046 110.807 101.977 110.458 101.977C110.108 101.977 109.762 102.046 109.439 102.179C109.116 102.313 108.822 102.51 108.575 102.757L105.132 106.2L101.688 102.757C101.186 102.272 100.513 102.003 99.8151 102.01C99.1169 102.016 98.4489 102.296 97.9552 102.789C97.4614 103.283 97.1814 103.951 97.1753 104.649C97.1692 105.348 97.4377 106.02 97.9227 106.523L101.366 109.966L97.9227 113.409C97.6684 113.655 97.4655 113.949 97.326 114.274C97.1864 114.598 97.1129 114.948 97.1098 115.301C97.1068 115.655 97.1742 116.006 97.3081 116.333C97.442 116.66 97.6397 116.958 97.8897 117.208C98.1398 117.458 98.4371 117.655 98.7644 117.789C99.0917 117.923 99.4423 117.991 99.7959 117.988C100.15 117.985 100.499 117.911 100.824 117.771C101.149 117.632 101.443 117.429 101.688 117.175L105.132 113.732L108.575 117.175C109.077 117.66 109.75 117.928 110.448 117.922C111.146 117.916 111.814 117.636 112.308 117.142C112.802 116.648 113.082 115.981 113.088 115.282C113.094 114.584 112.826 113.911 112.34 113.409L108.897 109.966L112.34 106.523C112.588 106.275 112.784 105.982 112.918 105.659C113.052 105.336 113.121 104.989 113.121 104.64C113.121 104.29 113.052 103.944 112.918 103.621C112.784 103.298 112.588 103.004 112.34 102.757ZM151.506 109.966L154.949 106.523C155.434 106.02 155.703 105.348 155.697 104.649C155.691 103.951 155.41 103.283 154.917 102.789C154.423 102.296 153.755 102.016 153.057 102.01C152.359 102.003 151.686 102.272 151.184 102.757L147.74 106.2L144.297 102.757C143.795 102.272 143.122 102.003 142.424 102.01C141.726 102.016 141.058 102.296 140.564 102.789C140.07 103.283 139.79 103.951 139.784 104.649C139.778 105.348 140.046 106.02 140.531 106.523L143.974 109.966L140.531 113.409C140.277 113.655 140.074 113.949 139.935 114.274C139.795 114.598 139.722 114.948 139.719 115.301C139.715 115.655 139.783 116.006 139.917 116.333C140.051 116.66 140.248 116.958 140.498 117.208C140.748 117.458 141.046 117.655 141.373 117.789C141.7 117.923 142.051 117.991 142.405 117.988C142.758 117.985 143.108 117.911 143.433 117.771C143.757 117.632 144.051 117.429 144.297 117.175L147.74 113.732L151.184 117.175C151.686 117.66 152.359 117.928 153.057 117.922C153.755 117.916 154.423 117.636 154.917 117.142C155.41 116.648 155.691 115.981 155.697 115.282C155.703 114.584 155.434 113.911 154.949 113.409L151.506 109.966Z\" stroke=\"transparent\" stroke-width=\"20\" mask=\"url(#path-2-outside-1_0_1)\"/>\n        </g>\n        <defs>\n          <clipPath id=\"clip0_0_1\">\n            <rect width=\"200\" height=\"200\" fill=\"white\"/>\n          </clipPath>\n        </defs>\n      </svg>\n    </div>\n    <div class=\"errorContainer\"></div>\n  </div>\n</div>\n<div>\n  <label class=\"ff-card-form-label\" for=\"cardHolderInput\">Cardholder name</label>\n  <input class=\"ff-card-form-text-input\" id=\"cardHolderInput\" type=\"text\" pattern=\"[A-Za-z\\s]+\" placeholder=\"Full name on card\">\n  <div class=\"errorContainer\"></div>\n</div>\n<div>\n  <label class=\"ff-card-form-label\" for=\"emailAddressInput\">Email</label>\n  <input class=\"ff-card-form-text-input\" id=\"emailAddressInput\" placeholder=\"Email\" type=\"email\">\n  <div class=\"errorContainer\"></div>\n</div>\n<div id=\"countrySelectorField\">\n  <label class=\"ff-card-form-label\" for=\"countrySelectorInput\">Country</label>\n  <div class=\"ff-select-wrap\">\n    <select class=\"ff-card-form-text-input ff-card-form-select\" id=\"countrySelectorInput\"></select>\n    <div class=\"ff-select-arrow\" aria-hidden=\"true\"></div>\n  </div>\n</div>\n<div>\n  <label class=\"ff-card-form-label\" for=\"postalCodeInput\">Zip code</label>\n  <input class=\"ff-card-form-text-input\" id=\"postalCodeInput\" placeholder=\"12345\">\n  <div class=\"errorContainer\"></div>\n</div>\n";
 
-    if(typeof document!=="undefined")document.head.appendChild(document.createElement("style")).textContent="\n\n.ff-card-form-label {\n    display: block;\n    font-size: 16px;\n    margin-bottom: 5px;\n  }\n  \n  .card-form-row {\n    display: flex;\n    flex-direction: row;\n    gap: 10px;\n  }\n  \n  .ff-card-form-text-input {\n    margin: 0 0 3px;\n    padding-left: 10px;\n    padding-right: 10px;\n    box-sizing: border-box;\n    height: 36px;\n    width: 100%;\n    font-size: 1rem;\n    background-color: transparent;\n    border: 1px solid rgb(0 0 0 / 10%);\n    border-radius: 6px;\n    transition: all 0.3s ease;\n    box-shadow: none;\n    outline: none;\n  }\n  .ff-card-form-text-input.error {\n    border-color: #e32f41;\n  }\n\n.ff-select-wrap {\n  position: relative;\n}\n\n.ff-card-form-select {\n  padding-right: 34px;\n  appearance: none;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  background-image: none;\n}\n\n.ff-card-form-select::-ms-expand {\n  display: none;\n}\n\n.ff-card-form-select:disabled {\n  color: #6b7280;\n  cursor: not-allowed;\n}\n\n.ff-select-arrow {\n  position: absolute;\n  top: 50%;\n  right: 12px;\n  width: 8px;\n  height: 8px;\n  border-right: 1.5px solid #6b7280;\n  border-bottom: 1.5px solid #6b7280;\n  transform: translateY(-65%) rotate(45deg);\n  pointer-events: none;\n}\n\n.ff-select-wrap:focus-within .ff-select-arrow {\n  border-right-color: #111827;\n  border-bottom-color: #111827;\n}\n  \n  .errorContainer:not(:empty) {\n    color: #d10000;\n    font-size: 16px;\n    line-height: 1;\n    margin: 0 0 10px;\n  }\n\n  #cvvInput {\n    position: relative;\n  }\n\n  #cvvInput > svg {\n    z-index: 1;\n    position: absolute;\n    top: 5px;\n    right: 5px;\n    width: 26px;\n    height: 26px;\n  }\n";
+    if(typeof document!=="undefined")document.head.appendChild(document.createElement("style")).textContent="\n\n.ff-card-form-label {\n    display: block;\n    font-size: 16px;\n    margin-bottom: 5px;\n  }\n  \n  .card-form-row {\n    display: flex;\n    flex-direction: row;\n    gap: 10px;\n  }\n  \n  .ff-card-form-text-input {\n    margin: 0 0 3px;\n    padding-left: 10px;\n    padding-right: 10px;\n    box-sizing: border-box;\n    height: 36px;\n    width: 100%;\n    font-size: 1rem;\n    background-color: transparent;\n    border: 1px solid rgb(0 0 0 / 10%);\n    border-radius: 6px;\n    transition: all 0.3s ease;\n    box-shadow: none;\n    outline: none;\n  }\n  .ff-card-form-text-input.error {\n    border-color: #e32f41;\n  }\n\n.ff-select-wrap {\n  position: relative;\n}\n\n.ff-card-form-select {\n  padding-right: 34px;\n  appearance: none;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  background-image: none;\n}\n\n.ff-card-form-select::-ms-expand {\n  display: none;\n}\n\n.ff-card-form-select:disabled {\n  color: #6b7280;\n  cursor: not-allowed;\n}\n\n.ff-select-arrow {\n  position: absolute;\n  top: 50%;\n  right: 12px;\n  width: 8px;\n  height: 8px;\n  border-right: 1.5px solid #6b7280;\n  border-bottom: 1.5px solid #6b7280;\n  transform: translateY(-65%) rotate(45deg);\n  pointer-events: none;\n}\n\n.ff-select-wrap:focus-within .ff-select-arrow {\n  border-right-color: #111827;\n  border-bottom-color: #111827;\n}\n  \n  .errorContainer:not(:empty) {\n    color: #df1b41;\n    font-size: 15px;\n    line-height: 1.15;\n    margin: 4px 0 10px;\n  }\n\n  #cvvInput {\n    position: relative;\n  }\n\n  #cvvInput > svg {\n    z-index: 1;\n    position: absolute;\n    top: 5px;\n    right: 5px;\n    width: 26px;\n    height: 26px;\n  }\n";
 
     class CardSkin {
         constructor(containerEl, checkoutConfig, cardSessionFieldConfig) {
@@ -3492,7 +3440,7 @@
 
     const TAX_RECALC_DEBOUNCE_MS = 600;
     async function mountStripeCardForm(element, session, params) {
-        const { stripe_public_key, amount, currency, order_id, is_link_enabled, tax_amount, amount_total, } = session.data;
+        const { stripe_public_key, amount, currency, order_id, is_link_enabled, amount_total, } = session.data;
         // Tax flow is driven by the tenant setting (session.tax_enabled); enableTax is a legacy override.
         const taxEnabled = session.data.tax_enabled ?? params.enableTax ?? false;
         const stripe = await getStripe(stripe_public_key);
@@ -3588,8 +3536,8 @@
                 taxCalc = { id: tax.tax_calculation_id, country, postal };
                 params.onTaxChange?.({
                     amountTotal: tax.amount_total,
-                    taxAmount: tax.tax_amount,
                     currency: tax.currency,
+                    ...resolveTaxDisplay(tax),
                 });
             }
             catch (err) {
@@ -3634,8 +3582,8 @@
         if (taxEnabled && amount_total != null) {
             params.onTaxChange?.({
                 amountTotal: amount_total,
-                taxAmount: tax_amount ?? 0,
                 currency,
+                ...resolveTaxDisplay(session.data),
             });
         }
         if (taxEnabled && collectLocation)
@@ -3697,7 +3645,7 @@
                     params.onPaymentSuccess?.(paymentMethod, order_id);
                 }
                 catch (err) {
-                    params.onPaymentFail?.(err);
+                    params.onPaymentFail?.(toPaymentFailure(err));
                     throw err;
                 }
                 finally {
@@ -3801,6 +3749,13 @@
             if (!canPay)
                 throw new Error('No wallet payment method available');
         }
+        if (taxEnabled && session.data.amount_total != null) {
+            params.onTaxChange?.({
+                amountTotal: session.data.amount_total,
+                currency: session.data.currency,
+                ...resolveTaxDisplay(session.data),
+            });
+        }
         return new Promise((resolve, reject) => {
             paymentRequest.on('paymentmethod', async (event) => {
                 let completed = false;
@@ -3857,7 +3812,7 @@
                 }
                 catch (err) {
                     completeOnce('fail');
-                    params.onPaymentFail?.(err);
+                    params.onPaymentFail?.(toPaymentFailure(err));
                     reject(err);
                 }
                 finally {