@zonos/elements 1.3.284 → 1.3.286

package/dist/collection/components/checkout/zonos-checkout/zonos-cart-subtotal/zonos-cart-subtotal.js

@@ -1,5 +1,5 @@
 import { Fragment, h, Host } from "@stencil/core";
-import { cartStore, cartStoreHasOneEligibleItem, } from "../../../store/checkout/cart";
+import { cartStore, cartStoreHasOneEligibleItem, cartStoreIsOrderModificationPaymentOnlySession, } from "../../../store/checkout/cart";
 import { stripeStore, stripeStoreApplyPromoCode, stripeStoreRemovePromoCode, } from "../../../store/checkout/stripe";
 import { localizationStore } from "../../../store/hello/localization";
 import { translate } from "../../../store/translationStore";
@@ -111,7 +111,14 @@ export class ZonosCartSubtotal {
         const cartTotal = cartStore.step === 'customer-info'
             ? cartStore.subtotal + cartStore.adjustmentTotal
             : cartStore.total;
-        const showDutyTaxesInfo = cartStore.step === 'payment' || cartStore.step === 'shipping';
+        // Order-modification payment-only sessions have no landedCost at all
+        // (see validateCheckoutSession) - they're paying a flat delta, not a
+        // shipment - so duty/tax/shipping figures here would just be
+        // meaningless zeros rather than real data.
+        const isOrderModificationPaymentOnlySession = cartStoreIsOrderModificationPaymentOnlySession();
+        const showDutyTaxesInfo = !isOrderModificationPaymentOnlySession &&
+            (cartStore.step === 'payment' || cartStore.step === 'shipping');
+        const showShippingRow = !isOrderModificationPaymentOnlySession;
         // EU 3-EUR cutover (05CHECK-893): when we collect and remit taxes for an EU
         // DAP quote, taxes and fees are included while duties are paid on delivery.
         const euDapDetails = this.getEuDapDetails();
@@ -123,7 +130,12 @@ export class ZonosCartSubtotal {
         // Store with no discount rules added in the dashboard, checkout would not display have promo code input
         !cartStore.shouldHideDiscountInput &&
             // Only show promo stuff if they are past customer info session in order to get landed cost with promo adjustment
-            cartStore.step !== 'customer-info';
+            cartStore.step !== 'customer-info' &&
+            // Order-modification payment-only sessions skip straight to the payment
+            // step with no customer-info/shipping step behind them — applying a
+            // promo code here would re-quote against a landed cost these sessions
+            // never went through, with no shipping step to return to.
+            !isOrderModificationPaymentOnlySession;
         const appliedPromoCode = (_e = (_d = (_c = (_b = (_a = cartStore.landedCostData) === null || _a === void 0 ? void 0 : _a.find(Boolean)) === null || _b === void 0 ? void 0 : _b.landedCost.appliedAdjustments) === null || _c === void 0 ? void 0 : _c.find(x => { var _a; return ((_a = x.adjustment) === null || _a === void 0 ? void 0 : _a.source) === 'PROMO_CODE'; })) === null || _d === void 0 ? void 0 : _d.adjustment) === null || _e === void 0 ? void 0 : _e.name;
         const applyPromoCode = async () => {
             // Promo code apply button is clicked
@@ -208,12 +220,12 @@ export class ZonosCartSubtotal {
         return (h(Host, { class: "zonos--cart-subtotal zonos--elements" }, h("table", { class: "zonos--cart-table" }, h("tr", { class: "zonos--row zonos--cart-subtotal" }, h("td", { class: "zonos--column" }), h("td", { class: "zonos--column zonos--cart-subtotal-title" }, h("zonos-text", { type: "semiBoldLabel" }, translate('Cart subtotal')), h("zonos-text", { class: "zonos--caption", type: "caption" }, this.getCartSubtotalSubtitle())), h("td", { class: "zonos--column zonos--cart-subtotal-price" }, h("zonos-text", { type: "semiBoldLabel" }, renderCheckoutCurrency({
             amount: subtotal,
             isForeign: true,
-        })))), h("tr", { class: "zonos--row zonos--cart-shipping" }, h("td", { class: "zonos--column" }), h("td", { class: "zonos--column zonos--cart-subtotal-title" }, renderShippingInfo()), h("td", { class: "zonos--column zonos--cart-subtotal-price" }, cartStore.shipping
+        })))), showShippingRow && (h("tr", { class: "zonos--row zonos--cart-shipping" }, h("td", { class: "zonos--column" }), h("td", { class: "zonos--column zonos--cart-subtotal-title" }, renderShippingInfo()), h("td", { class: "zonos--column zonos--cart-subtotal-price" }, cartStore.shipping
             ? renderCheckoutCurrency({
                 amount: cartStore.shipping,
                 isForeign: true,
             })
-            : '-')), showDutyTaxesInfo &&
+            : '-'))), showDutyTaxesInfo &&
             (euDapDetails ? (
             // EU DAP remittance: taxes and fees are collected/included, duties
             // are estimated and paid upon delivery — show them on two lines.

package/dist/collection/components/checkout/zonos-checkout/zonos-checkout.js

@@ -1,5 +1,5 @@
 import { Fragment, h, Host, } from "@stencil/core";
-import { cartStore, cartStoreClearCheckoutInterval, cartStoreNextStep, cartStoreOnChange, cartStoreReset, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateToErrorState, } from "../../store/checkout/cart";
+import { cartStore, cartStoreClearCheckoutInterval, cartStoreIsOrderModificationPaymentOnlySession, cartStoreNextStep, cartStoreOnChange, cartStoreReset, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateToErrorState, } from "../../store/checkout/cart";
 import { paypalInitScript, paypalStore, paypalStoreHasPaypalEnabled, } from "../../store/checkout/paypal";
 import { isPolicyConsentRequired, policyConsentStore, policyConsentStoreReset, } from "../../store/checkout/policyConsent";
 import { storeCreditStoreApplyCredit, storeCreditStoreCoversFullAmount, storeCreditStoreCreateOrder, storeCreditStoreGetEffectiveAmount, } from "../../store/checkout/storeCredit";
@@ -9,6 +9,7 @@ import { storageStore, storageStoreSetEnabledVariantTestKeys, VARIANT_TEST_KEY_E
 import { translate } from "../../store/translationStore";
 import { getZonosStoreTheme, zonosStore, } from "../../store/zonosStore";
 import { buildCartItemsByTempCart } from "../../utils/api/buildCartItemsByTempCart";
+import { getCheckoutSession } from "../../utils/api/getCheckoutSession";
 import { isStoreDiscountEnabled } from "../../utils/api/isStoreDiscountEnabl";
 import { selectVarianceTest } from "../../utils/api/selectVarianceTest";
 import { trackConversionEvent } from "../../utils/api/trackConversionEvent";
@@ -232,6 +233,48 @@ export class ZonosCheckout {
             log('Payment intent is not succeeded, proceed to order');
             return { shouldAllowOrder: true };
         };
+        /**
+         * Recover an order-modification payment-only session that was already
+         * completed (or already paid but not yet completed) by the time this cart
+         * link is opened/reopened — e.g. the shopper paid, closed the tab before
+         * the async order-creation webhook finished, then reopened the same
+         * payment link. Without this, re-rendering the payment form would let them
+         * attempt to pay again against an already-resolved session. Mirrors
+         * zonos-collect's recoverCompletedCollectSession for its own no-shipping
+         * flow, minus the Airwallex branch (this checkout only supports Stripe).
+         *
+         * @returns `true` when it routed to the finish step, `false` when the
+         * caller should proceed with a normal init.
+         */
+        this.recoverCompletedOrderModificationSession = async (checkoutSessionId) => {
+            // getCheckoutSession() reads storageStore.checkoutSessionId internally.
+            storageStore.checkoutSessionId = checkoutSessionId;
+            const { errors, json } = await getCheckoutSession();
+            if (errors.length || !json) {
+                return false;
+            }
+            const { checkoutSession } = json;
+            // Session already finalized → straight to finish. An order-mod
+            // payment-only session always has `order` set *before* payment too (see
+            // isOrderModificationPaymentOnlySession) - checking `order` alone would
+            // treat every first-ever open as already paid, so both must be true.
+            if (checkoutSession.completedAt && checkoutSession.order) {
+                void this.setToFinishStep('succeeded');
+                return true;
+            }
+            // Not completed and no order yet — verify the live payment intent status.
+            if (checkoutSession.clientSecret) {
+                const { status } = await stripeStoreRetrievePayment({
+                    clientSecret: checkoutSession.clientSecret,
+                });
+                if (status === 'processing' || status === 'succeeded') {
+                    stripeStore.clientSecret = checkoutSession.clientSecret;
+                    void this.setToFinishStep(status);
+                    return true;
+                }
+            }
+            return false;
+        };
         this.initializeTestKeys = () => {
             // cleanup expired test keys
             storageStore.enabledVariantTestKeys = filterExpiredTests(storageStore.enabledVariantTestKeys || []);
@@ -581,6 +624,7 @@ export class ZonosCheckout {
         (_b = (_a = zonosStore.checkoutSettings).onClose) === null || _b === void 0 ? void 0 : _b.call(_a);
     }
     async buildCartAndInit() {
+        var _a;
         // if createCartId is provided, use it to build cart. Merchant will provide create a cart from their server side and give the cart id to us.
         if (typeof zonosStore.checkoutSettings.createCartId === 'function') {
             log('"createCartId" is provided, start building cart');
@@ -620,6 +664,37 @@ export class ZonosCheckout {
         // if tempCartUUID is provided, use it instead of buildCartDetail
         else if (window.Zonos.cartData) {
             log('tempCartUUID is provided, start building cart');
+            // A cart created against an already-existing checkout session (e.g. an
+            // order-modification payment request) must reuse that session instead
+            // of creating a fresh one — otherwise the reused cart's order/landedCost
+            // context (and, downstream, the payment-only step skip below) is lost.
+            // Mirrors the same reference lookup zonos-collect/zonos-invoice already
+            // do for their own cart types.
+            const cartCheckoutSessionId = (_a = window.Zonos.cartData.references) === null || _a === void 0 ? void 0 : _a.checkoutSessionId;
+            if (cartCheckoutSessionId) {
+                log('Setting checkout session id from cart reference', 'info', cartCheckoutSessionId);
+                // The shopper may be reopening this same payment link after already
+                // paying — e.g. they closed the tab before the async order-creation
+                // webhook finished. Check the session/payment-intent status before
+                // rendering the payment form again.
+                const recovered = await this.recoverCompletedOrderModificationSession(cartCheckoutSessionId);
+                if (recovered) {
+                    // Recovery routes straight to the finish step, bypassing the
+                    // cartStoreUpdateItems call below that would normally clear this -
+                    // without it, the finish screen would spin forever (dialogLoading
+                    // stays true while isFetchingSession is true).
+                    stripeStore.isFetchingSession = false;
+                    return true;
+                }
+                storageStore.checkoutSessionId = cartCheckoutSessionId;
+            }
+            else {
+                // Same as zonos-collect/zonos-invoice: without this, a checkout
+                // session id left over from a previous cart in this tab would leak
+                // into this unrelated one.
+                log('Clear checkout session id from storage so we start from a fresh session for this cart');
+                storageStore.checkoutSessionId = null;
+            }
             const { adjustments, cartItems } = buildCartItemsByTempCart(window.Zonos.cartData);
             await cartStoreUpdateItems({ adjustments, cartItems });
         }
@@ -663,6 +738,17 @@ export class ZonosCheckout {
             successBehavior === 'REDIRECT_TO_SUCCESS_PAGE' ||
                 (successBehavior === 'CLOSE_MODAL' && !!successRedirectUrl) ||
                 !!cartStore.externalConfirmationPageURL;
+        // A session tied to an order that hasn't completed yet is an
+        // order-modification/adjustment collection: the shopper is only paying a
+        // delta against an already-approved landed cost, so the address/shipping
+        // steps (which would re-quote against the synthetic delta line item
+        // instead of the real shipment) are skipped in favor of jumping straight
+        // to payment, same as the Collect flow does for its own cart type. Lives
+        // here (rather than at each buildCartAndInit call site) so every caller
+        // gets it, including the forceDialogOpen/preview init path.
+        if (cartStoreIsOrderModificationPaymentOnlySession()) {
+            cartStore.step = 'payment';
+        }
         return true;
     }
     reloadCheckoutSession() {
@@ -1526,7 +1612,13 @@ export class ZonosCheckout {
                 return;
             }
             try {
-                await stripeStoreConfirmPayment();
+                // Order-modification payment-only sessions skip the shipping step,
+                // so cartStore.selectedLandedCost is never populated — bypass the
+                // landed-cost guard the same way zonos-collect does for its own
+                // no-shipping-step flow.
+                await stripeStoreConfirmPayment({
+                    noLandedCostCheck: cartStoreIsOrderModificationPaymentOnlySession(),
+                });
                 cartStoreNextStep();
                 // clear the checkout session timeout timer when purchase is complete
                 cartStoreClearCheckoutInterval();
@@ -1793,6 +1885,13 @@ export class ZonosCheckout {
             cartStore.step !== 'error' &&
             !stripeStore.stripeElements) ||
             stripeStore.isFetchingSession;
+        // An order-modification/adjustment session (order attached, not yet
+        // completed) skips straight to payment — see buildCartAndInit. The
+        // customer-info/shipping steps never ran, so the progress tabs (which
+        // track completion via cartStore.tabItems, only ever flipped by those
+        // steps' own continue handlers) would otherwise show a stale, frozen
+        // bar instead of reflecting that this is a single-step flow.
+        const isPaymentOnlySession = cartStoreIsOrderModificationPaymentOnlySession();
         const { colorPrimary, colorSecondary, logoUrl, style } = mergeConfig(zonosStore.appearance, this.appearanceSettingsOverride || null);
         const hasFooter = zonosStore.appearance.zonosAttribution === 'ENABLED';
         const rightSideTheme = zonosStore.appearance.theme;
@@ -1823,9 +1922,9 @@ export class ZonosCheckout {
             const zonosDebug = urlParams.get('zonosDebug');
             const zonosE2ETest = urlParams.get('zonosE2ETest');
             const zonosStagingMode = this.overrideStagingMode || getIsStagingMode();
-            return (h("zonos-v-stack", null, h("div", { class: "zonos--logo-wrapper" }, renderLogo(), isTestMode && (h("zonos-badge", { badgeColor: "orange", size: "small" }, translate('Test mode'))), zonosStagingMode && (h("zonos-badge", { badgeColor: "red", size: "small" }, translate('Staging mode'))), zonosDebug === '1' && (h("zonos-badge", { badgeColor: "cyan", size: "small" }, "debug")), zonosQaUrl && (h("zonos-badge", { badgeColor: "purple", size: "small" }, zonosQaUrl)), zonosE2ETest && (h("zonos-badge", { badgeColor: "gray", size: "small" }, "E2E Test"))), h("zonos-checkout-progress-tabs", { backgroundColor: 
+            return (h("zonos-v-stack", null, h("div", { class: "zonos--logo-wrapper" }, renderLogo(), isTestMode && (h("zonos-badge", { badgeColor: "orange", size: "small" }, translate('Test mode'))), zonosStagingMode && (h("zonos-badge", { badgeColor: "red", size: "small" }, translate('Staging mode'))), zonosDebug === '1' && (h("zonos-badge", { badgeColor: "cyan", size: "small" }, "debug")), zonosQaUrl && (h("zonos-badge", { badgeColor: "purple", size: "small" }, zonosQaUrl)), zonosE2ETest && (h("zonos-badge", { badgeColor: "gray", size: "small" }, "E2E Test"))), !isPaymentOnlySession && (h("zonos-checkout-progress-tabs", { backgroundColor: 
                 // only use different contrast color when the secondary color is too off with the background in mobile
-                this.isMobile ? '--zonos-elements-gray-0' : null }), filteredMessages.map(x => (h("zonos-custom-message", { icon: MessageIcon, message: x.message })))));
+                this.isMobile ? '--zonos-elements-gray-0' : null })), filteredMessages.map(x => (h("zonos-custom-message", { icon: MessageIcon, message: x.message })))));
         };
         const renderContent = () => {
             if (cartStore.checkoutSessionTimeoutShow) {
@@ -2191,7 +2290,7 @@ export class ZonosCheckout {
                     "signature": "(session: CheckoutSessionDetailsFragment) => Promise<void>",
                     "parameters": [{
                             "name": "session",
-                            "type": "{ cartId: string | null; clientSecret: string; completedAt: string | null; customerProfile: { email: string | null; locations: { administrativeArea: string; countryCode: CountryCode; email: string | null; line1: string; line2: string | null; locality: string; name: string | null; phone: string | null; postalCode: string; }[] | null; name: string | null; storeCreditBalance: number | null; } | null; customerSessionClientSecret: string | null; id: string; landedCost: { amountSubtotals: { discounts: number | null; duties: number; fees: number; items: number; landedCostTotal: number; shipping: number; taxes: number; } | null; appliedAdjustments: { adjustment: { name: string | null; source: AdjustmentSource | null; } | null; amount: number; item: { amount: number; } | null; type: LandedCostAdjustmentType | null; }[] | null; currencyCode: CurrencyCode; deMinimis: { formula: string; method: IncotermCode; note: string; threshold: DeMinimisThreshold; type: DeMinimisType; }[]; duties: { amount: number; currencyCode: CurrencyCode; }[]; fees: { amount: number; currencyCode: CurrencyCode; }[]; id: string; landedCostGuaranteeCode: LandedCostGuaranteeCode; method: IncotermCode; remittance: { amount: number; description: string; }[]; rootId: string; shipmentRating: { amount: number; currencyCode: CurrencyCode; displayName: string; id: string; shippingProfile: { serviceLevel: { code: string; deliveryType: DeliveryType | null; }; transitTime: { guaranteedDelivery: string | null; max: number | null; min: number | null; type: TransitTypeCode | null; } | null; } | null; }; taxes: { amount: number; currencyCode: CurrencyCode; }[]; } | null; metadata: ({ key: string; value: string; } | null)[] | null; organizationId: string; paymentProcessor: CheckoutPaymentProcessorType | null; references: { inclusivePriceConfigurationId: string | null; } | null; subtotals: { adjustments: number; duties: number; exchangeRate: { id: string; rate: number; sourceCurrencyCode: CurrencyCode; targetCurrencyCode: CurrencyCode; type: ExchangeRateType; }; fees: number; items: number; landedCostTotal: number; presentmentCurrencyCode: CurrencyCode; shipping: number; storeCredit: number; taxes: number; total: number; }; varianceTestResults: { selectedVariantKey: string; testKey: string; }[] | null; }",
+                            "type": "{ cartId: string | null; clientSecret: string; completedAt: string | null; customerProfile: { email: string | null; locations: { administrativeArea: string; countryCode: CountryCode; email: string | null; line1: string; line2: string | null; locality: string; name: string | null; phone: string | null; postalCode: string; }[] | null; name: string | null; storeCreditBalance: number | null; } | null; customerSessionClientSecret: string | null; id: string; landedCost: { amountSubtotals: { discounts: number | null; duties: number; fees: number; items: number; landedCostTotal: number; shipping: number; taxes: number; } | null; appliedAdjustments: { adjustment: { name: string | null; source: AdjustmentSource | null; } | null; amount: number; item: { amount: number; } | null; type: LandedCostAdjustmentType | null; }[] | null; currencyCode: CurrencyCode; deMinimis: { formula: string; method: IncotermCode; note: string; threshold: DeMinimisThreshold; type: DeMinimisType; }[]; duties: { amount: number; currencyCode: CurrencyCode; }[]; fees: { amount: number; currencyCode: CurrencyCode; }[]; id: string; landedCostGuaranteeCode: LandedCostGuaranteeCode; method: IncotermCode; remittance: { amount: number; description: string; }[]; rootId: string; shipmentRating: { amount: number; currencyCode: CurrencyCode; displayName: string; id: string; shippingProfile: { serviceLevel: { code: string; deliveryType: DeliveryType | null; }; transitTime: { guaranteedDelivery: string | null; max: number | null; min: number | null; type: TransitTypeCode | null; } | null; } | null; }; taxes: { amount: number; currencyCode: CurrencyCode; }[]; } | null; metadata: ({ key: string; value: string; } | null)[] | null; order: { id: string; } | null; organizationId: string; paymentProcessor: CheckoutPaymentProcessorType | null; references: { inclusivePriceConfigurationId: string | null; } | null; subtotals: { adjustments: number; duties: number; exchangeRate: { id: string; rate: number; sourceCurrencyCode: CurrencyCode; targetCurrencyCode: CurrencyCode; type: ExchangeRateType; }; fees: number; items: number; landedCostTotal: number; presentmentCurrencyCode: CurrencyCode; shipping: number; storeCredit: number; taxes: number; total: number; }; varianceTestResults: { selectedVariantKey: string; testKey: string; }[] | null; }",
                             "docs": ""
                         }],
                     "references": {

package/dist/collection/components/common/zonos-stripe-phone-input/zonos-stripe-phone-input.js

@@ -268,7 +268,7 @@ export class ZonosStripePhoneInput {
                 "mutable": false,
                 "complexType": {
                     "original": "GenericZonosSettings['countryFields'] | null",
-                    "resolved": "null | undefined | { EG: CountryFields; MO: CountryFields; PN: CountryFields; KG: CountryFields; LB: CountryFields; BH: CountryFields; ML: CountryFields; NO: CountryFields; CG: CountryFields; CM: CountryFields; MM: CountryFields; AQ: CountryFields; AX: CountryFields; CC: CountryFields; ER: CountryFields; PF: CountryFields; SO: CountryFields; SX: CountryFields; TO: CountryFields; AD: CountryFields; AE: CountryFields; AF: CountryFields; AG: CountryFields; AI: CountryFields; AL: CountryFields; AM: CountryFields; AO: CountryFields; AR: CountryFields; AS: CountryFields; AT: CountryFields; AU: CountryFields; AW: CountryFields; AZ: CountryFields; BA: CountryFields; BB: CountryFields; BD: CountryFields; BE: CountryFields; BF: CountryFields; BG: CountryFields; BI: CountryFields; BJ: CountryFields; BL: CountryFields; BM: CountryFields; BN: CountryFields; BO: CountryFields; BQ: CountryFields; BR: CountryFields; BS: CountryFields; BT: CountryFields; BV: CountryFields; BW: CountryFields; BY: CountryFields; BZ: CountryFields; CA: CountryFields; CD: CountryFields; CF: CountryFields; CH: CountryFields; CI: CountryFields; CK: CountryFields; CL: CountryFields; CN: CountryFields; CO: CountryFields; CR: CountryFields; CU: CountryFields; CV: CountryFields; CW: CountryFields; CX: CountryFields; CY: CountryFields; CZ: CountryFields; DE: CountryFields; DJ: CountryFields; DK: CountryFields; DM: CountryFields; DO: CountryFields; DZ: CountryFields; EC: CountryFields; EE: CountryFields; EH: CountryFields; ES: CountryFields; ET: CountryFields; FI: CountryFields; FJ: CountryFields; FK: CountryFields; FM: CountryFields; FO: CountryFields; FR: CountryFields; GA: CountryFields; GB: CountryFields; GD: CountryFields; GE: CountryFields; GF: CountryFields; GG: CountryFields; GH: CountryFields; GI: CountryFields; GL: CountryFields; GM: CountryFields; GN: CountryFields; GP: CountryFields; GQ: CountryFields; GR: CountryFields; GS: CountryFields; GT: CountryFields; GU: CountryFields; GW: CountryFields; GY: CountryFields; HK: CountryFields; HM: CountryFields; HN: CountryFields; HR: CountryFields; HT: CountryFields; HU: CountryFields; IC: CountryFields; ID: CountryFields; IE: CountryFields; IL: CountryFields; IM: CountryFields; IN: CountryFields; IO: CountryFields; IQ: CountryFields; IR: CountryFields; IS: CountryFields; IT: CountryFields; JE: CountryFields; JM: CountryFields; JO: CountryFields; JP: CountryFields; KE: CountryFields; KH: CountryFields; KI: CountryFields; KM: CountryFields; KN: CountryFields; KP: CountryFields; KR: CountryFields; KW: CountryFields; KY: CountryFields; KZ: CountryFields; LA: CountryFields; LC: CountryFields; LI: CountryFields; LK: CountryFields; LR: CountryFields; LS: CountryFields; LT: CountryFields; LU: CountryFields; LV: CountryFields; LY: CountryFields; MA: CountryFields; MC: CountryFields; MD: CountryFields; ME: CountryFields; MF: CountryFields; MG: CountryFields; MH: CountryFields; MK: CountryFields; MN: CountryFields; MP: CountryFields; MQ: CountryFields; MR: CountryFields; MS: CountryFields; MT: CountryFields; MU: CountryFields; MV: CountryFields; MW: CountryFields; MX: CountryFields; MY: CountryFields; MZ: CountryFields; NA: CountryFields; NC: CountryFields; NE: CountryFields; NF: CountryFields; NG: CountryFields; NI: CountryFields; NL: CountryFields; NP: CountryFields; NR: CountryFields; NU: CountryFields; NZ: CountryFields; OM: CountryFields; PA: CountryFields; PE: CountryFields; PG: CountryFields; PH: CountryFields; PK: CountryFields; PL: CountryFields; PM: CountryFields; PR: CountryFields; PS: CountryFields; PT: CountryFields; PW: CountryFields; PY: CountryFields; QA: CountryFields; RE: CountryFields; RO: CountryFields; RS: CountryFields; RU: CountryFields; RW: CountryFields; SA: CountryFields; SB: CountryFields; SC: CountryFields; SD: CountryFields; SE: CountryFields; SG: CountryFields; SH: CountryFields; SI: CountryFields; SJ: CountryFields; SK: CountryFields; SL: CountryFields; SM: CountryFields; SN: CountryFields; SR: CountryFields; SS: CountryFields; ST: CountryFields; SV: CountryFields; SY: CountryFields; SZ: CountryFields; TC: CountryFields; TD: CountryFields; TF: CountryFields; TG: CountryFields; TH: CountryFields; TJ: CountryFields; TK: CountryFields; TL: CountryFields; TM: CountryFields; TN: CountryFields; TR: CountryFields; TT: CountryFields; TV: CountryFields; TW: CountryFields; TZ: CountryFields; UA: CountryFields; UG: CountryFields; UM: CountryFields; US: CountryFields; UY: CountryFields; UZ: CountryFields; VA: CountryFields; VC: CountryFields; VE: CountryFields; VG: CountryFields; VI: CountryFields; VN: CountryFields; VU: CountryFields; WF: CountryFields; WS: CountryFields; YE: CountryFields; YT: CountryFields; ZA: CountryFields; ZM: CountryFields; ZW: CountryFields; }",
+                    "resolved": "null | undefined | { EG: CountryFields; MO: CountryFields; PN: CountryFields; KG: CountryFields; LB: CountryFields; BH: CountryFields; ML: CountryFields; NO: CountryFields; CG: CountryFields; CM: CountryFields; MM: CountryFields; AQ: CountryFields; AX: CountryFields; CC: CountryFields; ER: CountryFields; PF: CountryFields; SO: CountryFields; SX: CountryFields; TO: CountryFields; AD: CountryFields; AE: CountryFields; AF: CountryFields; AG: CountryFields; AI: CountryFields; AL: CountryFields; AM: CountryFields; AO: CountryFields; AR: CountryFields; AS: CountryFields; AT: CountryFields; AU: CountryFields; AW: CountryFields; AZ: CountryFields; BA: CountryFields; BB: CountryFields; BD: CountryFields; BE: CountryFields; BF: CountryFields; BG: CountryFields; BI: CountryFields; BJ: CountryFields; BL: CountryFields; BM: CountryFields; BN: CountryFields; BO: CountryFields; BQ: CountryFields; BR: CountryFields; BS: CountryFields; BT: CountryFields; BV: CountryFields; BW: CountryFields; BY: CountryFields; BZ: CountryFields; CA: CountryFields; CD: CountryFields; CF: CountryFields; CH: CountryFields; CI: CountryFields; CK: CountryFields; CL: CountryFields; CN: CountryFields; CO: CountryFields; CR: CountryFields; CU: CountryFields; CV: CountryFields; CW: CountryFields; CX: CountryFields; CY: CountryFields; CZ: CountryFields; DE: CountryFields; DJ: CountryFields; DK: CountryFields; DM: CountryFields; DO: CountryFields; DZ: CountryFields; EC: CountryFields; EE: CountryFields; EH: CountryFields; ES: CountryFields; ET: CountryFields; FI: CountryFields; FJ: CountryFields; FK: CountryFields; FM: CountryFields; FO: CountryFields; FR: CountryFields; GA: CountryFields; GB: CountryFields; GD: CountryFields; GE: CountryFields; GF: CountryFields; GG: CountryFields; GH: CountryFields; GI: CountryFields; GL: CountryFields; GM: CountryFields; GN: CountryFields; GP: CountryFields; GQ: CountryFields; GR: CountryFields; GS: CountryFields; GT: CountryFields; GU: CountryFields; GW: CountryFields; GY: CountryFields; HK: CountryFields; HM: CountryFields; HN: CountryFields; HR: CountryFields; HT: CountryFields; HU: CountryFields; IC: CountryFields; ID: CountryFields; IE: CountryFields; IL: CountryFields; IM: CountryFields; IN: CountryFields; IO: CountryFields; IQ: CountryFields; IR: CountryFields; IS: CountryFields; IT: CountryFields; JE: CountryFields; JM: CountryFields; JO: CountryFields; JP: CountryFields; KE: CountryFields; KH: CountryFields; KI: CountryFields; KM: CountryFields; KN: CountryFields; KP: CountryFields; KR: CountryFields; KW: CountryFields; KY: CountryFields; KZ: CountryFields; LA: CountryFields; LC: CountryFields; LI: CountryFields; LK: CountryFields; LR: CountryFields; LS: CountryFields; LT: CountryFields; LU: CountryFields; LV: CountryFields; LY: CountryFields; MA: CountryFields; MC: CountryFields; MD: CountryFields; ME: CountryFields; MF: CountryFields; MG: CountryFields; MH: CountryFields; MK: CountryFields; MN: CountryFields; MP: CountryFields; MQ: CountryFields; MR: CountryFields; MS: CountryFields; MT: CountryFields; MU: CountryFields; MV: CountryFields; MW: CountryFields; MX: CountryFields; MY: CountryFields; MZ: CountryFields; NA: CountryFields; NC: CountryFields; NE: CountryFields; NF: CountryFields; NG: CountryFields; NI: CountryFields; NL: CountryFields; NP: CountryFields; NR: CountryFields; NU: CountryFields; NZ: CountryFields; OM: CountryFields; PA: CountryFields; PE: CountryFields; PG: CountryFields; PH: CountryFields; PK: CountryFields; PL: CountryFields; PM: CountryFields; PR: CountryFields; PS: CountryFields; PT: CountryFields; PW: CountryFields; PY: CountryFields; QA: CountryFields; RE: CountryFields; RO: CountryFields; RS: CountryFields; RU: CountryFields; RW: CountryFields; SA: CountryFields; SB: CountryFields; SC: CountryFields; SD: CountryFields; SE: CountryFields; SG: CountryFields; SH: CountryFields; SI: CountryFields; SJ: CountryFields; SK: CountryFields; SL: CountryFields; SM: CountryFields; SN: CountryFields; SR: CountryFields; SS: CountryFields; ST: CountryFields; SV: CountryFields; SY: CountryFields; SZ: CountryFields; TC: CountryFields; TD: CountryFields; TF: CountryFields; TG: CountryFields; TH: CountryFields; TJ: CountryFields; TK: CountryFields; TL: CountryFields; TM: CountryFields; TN: CountryFields; TR: CountryFields; TT: CountryFields; TV: CountryFields; TW: CountryFields; TZ: CountryFields; UA: CountryFields; UG: CountryFields; UM: CountryFields; US: CountryFields; UY: CountryFields; UZ: CountryFields; VA: CountryFields; VC: CountryFields; VE: CountryFields; VG: CountryFields; VI: CountryFields; VN: CountryFields; VU: CountryFields; WF: CountryFields; WS: CountryFields; XK: CountryFields; YE: CountryFields; YT: CountryFields; ZA: CountryFields; ZM: CountryFields; ZW: CountryFields; }",
                     "references": {
                         "GenericZonosSettings": {
                             "location": "import",

package/dist/collection/components/main/zonos-controller.js

@@ -619,7 +619,7 @@ export class ZonosController {
                     "signature": "(countryCode: CountryCode) => Promise<void>",
                     "parameters": [{
                             "name": "countryCode",
-                            "type": "\"EG\" | \"MO\" | \"PN\" | \"KG\" | \"LB\" | \"BH\" | \"ML\" | \"NO\" | \"CG\" | \"CM\" | \"MM\" | \"AQ\" | \"AX\" | \"CC\" | \"ER\" | \"PF\" | \"SO\" | \"SX\" | \"TO\" | \"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CD\" | \"CF\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EH\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"IC\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"MN\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\"",
+                            "type": "\"EG\" | \"MO\" | \"PN\" | \"KG\" | \"LB\" | \"BH\" | \"ML\" | \"NO\" | \"CG\" | \"CM\" | \"MM\" | \"AQ\" | \"AX\" | \"CC\" | \"ER\" | \"PF\" | \"SO\" | \"SX\" | \"TO\" | \"AD\" | \"AE\" | \"AF\" | \"AG\" | \"AI\" | \"AL\" | \"AM\" | \"AO\" | \"AR\" | \"AS\" | \"AT\" | \"AU\" | \"AW\" | \"AZ\" | \"BA\" | \"BB\" | \"BD\" | \"BE\" | \"BF\" | \"BG\" | \"BI\" | \"BJ\" | \"BL\" | \"BM\" | \"BN\" | \"BO\" | \"BQ\" | \"BR\" | \"BS\" | \"BT\" | \"BV\" | \"BW\" | \"BY\" | \"BZ\" | \"CA\" | \"CD\" | \"CF\" | \"CH\" | \"CI\" | \"CK\" | \"CL\" | \"CN\" | \"CO\" | \"CR\" | \"CU\" | \"CV\" | \"CW\" | \"CX\" | \"CY\" | \"CZ\" | \"DE\" | \"DJ\" | \"DK\" | \"DM\" | \"DO\" | \"DZ\" | \"EC\" | \"EE\" | \"EH\" | \"ES\" | \"ET\" | \"FI\" | \"FJ\" | \"FK\" | \"FM\" | \"FO\" | \"FR\" | \"GA\" | \"GB\" | \"GD\" | \"GE\" | \"GF\" | \"GG\" | \"GH\" | \"GI\" | \"GL\" | \"GM\" | \"GN\" | \"GP\" | \"GQ\" | \"GR\" | \"GS\" | \"GT\" | \"GU\" | \"GW\" | \"GY\" | \"HK\" | \"HM\" | \"HN\" | \"HR\" | \"HT\" | \"HU\" | \"IC\" | \"ID\" | \"IE\" | \"IL\" | \"IM\" | \"IN\" | \"IO\" | \"IQ\" | \"IR\" | \"IS\" | \"IT\" | \"JE\" | \"JM\" | \"JO\" | \"JP\" | \"KE\" | \"KH\" | \"KI\" | \"KM\" | \"KN\" | \"KP\" | \"KR\" | \"KW\" | \"KY\" | \"KZ\" | \"LA\" | \"LC\" | \"LI\" | \"LK\" | \"LR\" | \"LS\" | \"LT\" | \"LU\" | \"LV\" | \"LY\" | \"MA\" | \"MC\" | \"MD\" | \"ME\" | \"MF\" | \"MG\" | \"MH\" | \"MK\" | \"MN\" | \"MP\" | \"MQ\" | \"MR\" | \"MS\" | \"MT\" | \"MU\" | \"MV\" | \"MW\" | \"MX\" | \"MY\" | \"MZ\" | \"NA\" | \"NC\" | \"NE\" | \"NF\" | \"NG\" | \"NI\" | \"NL\" | \"NP\" | \"NR\" | \"NU\" | \"NZ\" | \"OM\" | \"PA\" | \"PE\" | \"PG\" | \"PH\" | \"PK\" | \"PL\" | \"PM\" | \"PR\" | \"PS\" | \"PT\" | \"PW\" | \"PY\" | \"QA\" | \"RE\" | \"RO\" | \"RS\" | \"RU\" | \"RW\" | \"SA\" | \"SB\" | \"SC\" | \"SD\" | \"SE\" | \"SG\" | \"SH\" | \"SI\" | \"SJ\" | \"SK\" | \"SL\" | \"SM\" | \"SN\" | \"SR\" | \"SS\" | \"ST\" | \"SV\" | \"SY\" | \"SZ\" | \"TC\" | \"TD\" | \"TF\" | \"TG\" | \"TH\" | \"TJ\" | \"TK\" | \"TL\" | \"TM\" | \"TN\" | \"TR\" | \"TT\" | \"TV\" | \"TW\" | \"TZ\" | \"UA\" | \"UG\" | \"UM\" | \"US\" | \"UY\" | \"UZ\" | \"VA\" | \"VC\" | \"VE\" | \"VG\" | \"VI\" | \"VN\" | \"VU\" | \"WF\" | \"WS\" | \"XK\" | \"YE\" | \"YT\" | \"ZA\" | \"ZM\" | \"ZW\"",
                             "docs": ""
                         }],
                     "references": {

package/dist/collection/components/store/checkout/cart.js

@@ -183,6 +183,19 @@ const cartStoreHasOneEligibleItem = () => {
     // if there is no item restricted found => all items are restricted
     return !!checkItems.find(item => !item.isRestricted);
 };
+/**
+ * An order-modification payment-only session (skip-to-payment, no shipping
+ * step): a session tied to an order that hasn't completed yet, meaning the
+ * shopper is only paying a delta against an already-approved landed cost.
+ * Single source of truth for this detection — previously duplicated inline
+ * at each call site, which let one of them (the forceDialogOpen/preview init
+ * path) miss it entirely.
+ */
+const cartStoreIsOrderModificationPaymentOnlySession = () => {
+    var _a, _b;
+    return !!(((_b = (_a = cartStore.checkoutSession) === null || _a === void 0 ? void 0 : _a.order) === null || _b === void 0 ? void 0 : _b.id) &&
+        !cartStore.checkoutSession.completedAt);
+};
 const cartStoreSetCheckoutSession = (checkoutSession) => {
     var _a, _b, _c, _d, _e, _f, _g;
     // update stripe store with updated information
@@ -539,4 +552,4 @@ const cartStoreUpdateStoreCredit = () => {
         void cartStoreUpdateStoreCreditImmediate();
     }, 300);
 };
-export { cartStore, cartStoreApplySubtotals, cartStoreCheckItemRestrictions, cartStoreClearCheckoutInterval, cartStoreGetMethod, cartStoreGetShippingTransitInfo, cartStoreHasOneEligibleItem, cartStoreNextStep, cartStoreOnChange, cartStorePreviousStep, cartStoreReCalculateTotal, cartStoreReset, cartStoreResetCartItems, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateSelectedShippingOption, cartStoreUpdateStoreCredit, cartStoreUpdateToErrorState, };
+export { cartStore, cartStoreApplySubtotals, cartStoreCheckItemRestrictions, cartStoreClearCheckoutInterval, cartStoreGetMethod, cartStoreGetShippingTransitInfo, cartStoreHasOneEligibleItem, cartStoreIsOrderModificationPaymentOnlySession, cartStoreNextStep, cartStoreOnChange, cartStorePreviousStep, cartStoreReCalculateTotal, cartStoreReset, cartStoreResetCartItems, cartStoreResetTabItems, cartStoreSetCheckoutSession, cartStoreStartCheckoutInterval, cartStoreUpdateItems, cartStoreUpdateSelectedShippingOption, cartStoreUpdateStoreCredit, cartStoreUpdateToErrorState, };

package/dist/collection/components/utils/validateCheckoutSession.js

@@ -7,7 +7,7 @@ import { sendErrorLog } from "./logging/sendErrorLog";
  * Validate checkout session before confirming payment
  */
 export const validateCheckoutSession = async () => {
-    var _a;
+    var _a, _b;
     // get checkout session info
     const { errors, json } = await getCheckoutSession();
     if (errors.length || !json) {
@@ -22,8 +22,16 @@ export const validateCheckoutSession = async () => {
             valid: false,
         };
     }
-    // Make sure landed cost is found in the checkout session
-    if (!((_a = json.checkoutSession.landedCost) === null || _a === void 0 ? void 0 : _a.id)) {
+    // Make sure landed cost is found in the checkout session. Order-modification
+    // payment-only sessions (skip-to-payment, no shipping step) never carry a
+    // landedCost on the checkout session — same reason stripeStoreConfirmPayment
+    // skips its own selectedLandedCost guard for this flow. Inferred here from
+    // the session itself (order attached + not completed) rather than a
+    // caller-supplied flag, so every call site behaves consistently without
+    // needing to know about this special case.
+    const isOrderModificationPaymentOnlySession = !!(((_a = json.checkoutSession.order) === null || _a === void 0 ? void 0 : _a.id) && !json.checkoutSession.completedAt);
+    if (!isOrderModificationPaymentOnlySession &&
+        !((_b = json.checkoutSession.landedCost) === null || _b === void 0 ? void 0 : _b.id)) {
         logError('Landed cost is not found in the checkout session before confirming payment.');
         void sendErrorLog({
             endpoint: 'validateCheckoutSession',

package/dist/collection/types/generated/graphql.frontend.types.js

@@ -37,6 +37,7 @@ export const featureAspectKeyEnum = {
     NewPayoutReport: 'new_payout_report',
     NewRefundsUx: 'new_refunds_ux',
     OnboardingBeta: 'onboarding_beta',
+    OrderModifications: 'order_modifications',
     OrderReturns: 'order_returns',
     PageAuditor: 'page_auditor',
     PromptExplorer: 'prompt_explorer',
@@ -72,6 +73,7 @@ export const featureAudienceNameEnum = {
     NewRefundsUxMerchant: 'new_refunds_ux_merchant',
     Onboarding: 'onboarding',
     OnboardingBetaMerchant: 'onboarding_beta_merchant',
+    OrderModificationsMerchant: 'order_modifications_merchant',
     OrderReturnsMerchant: 'order_returns_merchant',
     PrincipalEngineer: 'principal_engineer',
     ProServeHead: 'pro_serve_head',