@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.231

package/src/lib/server/cart-checkout.js

@@ -22,11 +22,19 @@ import { claimAttempt, deriveStripeObjectKey } from "@aglyn/aglyn/server";
 import { consumeRateLimit, firebaseAdmin, getOrgForHost, isYoungWorkspace } from "@aglyn/tenant-data-admin";
 import { merchantAccountIsReady } from "@aglyn/tenant-data-admin/server/payment-provider";
 import { checkoutSessionCardAuthenticationParams } from "@aglyn/tenant-data-admin/server/stripe-card-authentication";
+import { CARRIER_POSTAL_CODE_MESSAGE, planCheckoutShippingWithCarriers } from "./carrier-shipping.js";
 import { readCartId } from "./cart-cookie.js";
 import { resolveManualTaxRateId } from "./manual-tax-rate.js";
+import { allocateCentsByWeight, engineLineTaxPercentages, taxEngineSessionMetadata } from "../model/commerce-tax-engine.js";
+import { quoteSaleTaxWithEngine } from "./tax-engine-quote.js";
 import { holdPromotionSlot, promotionHoldKey } from "./promotion-hold.js";
 import { holdStock, stockHoldKey } from "./stock-hold.js";
 import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSessionPayload, resolveNativeCheckoutMode } from "./native-checkout.js";
+import { ensureCheckoutDomain } from "./payment-method-domains.js";
+import { raiseCheckoutStarted } from "./order-events.js";
+import { checkoutExtrasCents, encodeCheckoutExtrasMetadata, readChosenCheckoutExtras } from "@aglyn/aglyn/plugin-manager/plugin-checkout-extras";
+import { quoteCartExtras } from "./checkout-extras.js";
+/** An option the buyer ticked is no longer offered (AGL-3635). */ export const CHECKOUT_EXTRA_UNAVAILABLE_MESSAGE = 'An option you picked is no longer available. Review your cart and try again.';
 /**
  * Cart checkout (AGL-293): the whole cart in one Stripe Checkout
  * session on the merchant's account. Every line re-prices from its
@@ -89,8 +97,8 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         if (held) await held.release();
     };
     try {
-        var _cartSnapshot_data, _ref1, _storeSettings_get, _req_headers_referer, _req_headers_host, _ref2;
-        var _ownerOrg_org, _ownerOrg_org1, _ownerOrg_org2;
+        var _cartSnapshot_data, _ref1, _storeSettings_get, _storeSettings_get1, _req_headers_referer, _req_headers_host, _ref2, _ref3;
+        var _ownerOrg_org, _ownerOrg_org1, _ownerOrg_org2, _engineTax_quote;
         const firestore = firebaseAdmin.app().firestore();
         const hostRef = firestore.collection('hosts').doc(hostId);
         const cartSnapshot = await hostRef.collection('carts').doc(cartId).get();
@@ -164,6 +172,8 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
      * reservation and the price must be taken against the same variant, and a
      * second resolution is a second chance to pick a different one.
      */ const reserveLines = [];
+        /** The basket as `checkout.started` reports it (AGL-3639). */ const startedItems = [];
+        /** The basket as an extras offer prices it (AGL-3635). */ const extrasLines = [];
         // Cart checkout never builds subscription sessions — every line bills
         // one-time in `payment` mode (recurring products subscribe through the
         // PDP's direct checkout, AGL-303) — so the buyer-chosen billing field
@@ -172,7 +182,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             mode: 'payment'
         }, checkoutSessionCardAuthenticationParams('payment')));
         cart.lines.forEach((line, index)=>{
-            var _variant_weightGrams, _product_type, _product_type1, _variant_options, _variant_options1;
+            var _product_type, _variant_id, _variant_sku, _variant_weightGrams, _product_type1, _product_type2, _variant_options, _variant_options1;
             const product = productsById.get(line.productId);
             if (!product || product.deletedAt || product.status !== 'active') {
                 var _ref;
@@ -219,6 +229,24 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             }
             const unitCents = Math.round(Number(variant.priceUsd) * 100);
             itemsCents += unitCents * line.quantity;
+            extrasLines.push(_extends({
+                productId: line.productId,
+                name: product.name
+            }, variant.sku ? {
+                sku: String(variant.sku)
+            } : {}, {
+                quantity: line.quantity,
+                unitCents,
+                physical: ((_product_type = product.type) != null ? _product_type : 'physical') === 'physical'
+            }));
+            startedItems.push({
+                productId: line.productId,
+                variantId: (_variant_id = variant.id) != null ? _variant_id : null,
+                name: product.name,
+                sku: (_variant_sku = variant.sku) != null ? _variant_sku : null,
+                quantity: line.quantity,
+                unitCents
+            });
             if (product.giftCard) giftCardCents += unitCents * line.quantity;
             // What THIS line is worth, so a product-scoped discount can be priced
             // against the lines it actually covers rather than the whole basket
@@ -232,7 +260,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             // reads it — `liftLegacyProduct` only defaults the field on docs it
             // synthesizes variants for, so a part-migrated doc can reach here
             // without one and the two reads must not disagree about what it is.
-            if (((_product_type = product.type) != null ? _product_type : 'physical') === 'physical') hasPhysicalLine = true;
+            if (((_product_type1 = product.type) != null ? _product_type1 : 'physical') === 'physical') hasPhysicalLine = true;
             // `?? 'physical'`, which the comment four lines up already promised and
             // the code did not deliver (AGL-2251). `resolveTransactionFeePct` keys
             // on `productType === 'physical'` and sends everything else — `undefined`
@@ -241,7 +269,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             // 'physical'`) priced the identical product at the physical rate. The
             // same basket cost the merchant a different fee depending on which
             // button the shopper pressed.
-            const feePct = Aglyn.resolveTransactionFeePct(ownerOrg.org, (_product_type1 = product.type) != null ? _product_type1 : 'physical');
+            const feePct = Aglyn.resolveTransactionFeePct(ownerOrg.org, (_product_type2 = product.type) != null ? _product_type2 : 'physical');
             // WHETHER a rate applies is not the same fact as what it rounds to
             // (AGL-2232), and only the sum was being kept. `checkout.ts`,
             // `draft-order.ts` and `reserve.ts` all floor at `Math.max(1, …)` when
@@ -260,7 +288,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // visitor per day, lower while the workspace is young. Above the claim,
         // like the line refusals, so a refusal keeps the key.
         if (giftCardCents > 0) {
-            var _ref3;
+            var _ref4;
             var _req_socket;
             const young = isYoungWorkspace(ownerOrg.org);
             const overCeiling = CommerceModel.giftCardPurchaseRefusal({
@@ -272,7 +300,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
                     visible: overCeiling
                 });
             }
-            const buys = await consumeRateLimit(`giftcard:buy:${hostId}:${String((_ref3 = (_req_socket = req.socket) == null ? void 0 : _req_socket.remoteAddress) != null ? _ref3 : '') || 'no-address'}`, {
+            const buys = await consumeRateLimit(`giftcard:buy:${hostId}:${String((_ref4 = (_req_socket = req.socket) == null ? void 0 : _req_socket.remoteAddress) != null ? _ref4 : '') || 'no-address'}`, {
                 limit: young ? CommerceModel.GIFT_CARD_PURCHASE_LIMITS.perVisitorDailyYoung : CommerceModel.GIFT_CARD_PURCHASE_LIMITS.perVisitorDaily,
                 windowMs: 24 * 60 * 60 * 1000
             });
@@ -297,13 +325,34 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // session byte-identical to today's: no shipping charged, exactly as
         // before. Only a merchant who set rates up starts collecting them.
         const storeSettings = await hostRef.collection('settings').doc('store').get();
-        const shippingPlan = hasPhysicalLine ? CommerceModel.planCheckoutShipping(storeSettings.get('shipping'), {
-            subtotalCents: itemsCents,
-            totalGrams
-        }, body.shippingCountry) : {
+        // A live carrier rate (AGL-3612) is quoted here too, before the session,
+        // for the destination the shopper declared; a store with none plans from
+        // its table exactly as before. See `carrier-shipping.ts`.
+        const shippingPlan = hasPhysicalLine ? await planCheckoutShippingWithCarriers({
+            hostId,
+            settings: storeSettings.get('shipping'),
+            cart: {
+                subtotalCents: itemsCents,
+                totalGrams
+            },
+            destination: {
+                country: body.shippingCountry,
+                postalCode: body.shippingPostalCode
+            }
+        }) : {
             countries: CommerceModel.CHECKOUT_SHIPPING_COUNTRIES,
             options: []
         };
+        if (shippingPlan.needsPostalCode) {
+            return res.status(400).json({
+                error: CARRIER_POSTAL_CODE_MESSAGE,
+                needsShippingCountry: true,
+                needsShippingPostalCode: true,
+                shippingCountries: [
+                    ...CommerceModel.CHECKOUT_SHIPPING_COUNTRIES
+                ]
+            });
+        }
         // The shopper is asked, then the answer is ENFORCED (AGL-1721): a declared
         // destination narrows `allowed_countries` to itself, so the rate resolved
         // for it is the only one on the session and no other address can be
@@ -338,6 +387,43 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
                 error: CommerceModel.CART_UNPRICEABLE_SHIPPING_MESSAGE
             });
         }
+        // OPTIONAL LINES THE BUYER TICKED (AGL-3635) — package protection — asked
+        // of core's checkout-extras seam AGAIN here, never taken from the request:
+        // the body names which offers, the provider names the price. Above the
+        // claim, so a refusal keeps the key. An offer the buyer ticked that is no
+        // longer made refuses rather than selling without it: they asked for
+        // cover, and a parcel that silently has none is the worse surprise.
+        const chosenExtras = readChosenCheckoutExtras(body.extras);
+        const chargedExtras = chosenExtras.length ? (await quoteCartExtras({
+            hostId,
+            lines: extrasLines,
+            destination: {
+                country: body.shippingCountry,
+                postalCode: body.shippingPostalCode
+            }
+        })).filter((extra)=>chosenExtras.includes(extra.id)) : [];
+        if (chargedExtras.length !== chosenExtras.length) {
+            return res.status(409).json({
+                error: CHECKOUT_EXTRA_UNAVAILABLE_MESSAGE,
+                extrasChanged: true
+            });
+        }
+        const extrasCents = checkoutExtrasCents(chargedExtras);
+        // Each as its own line after the goods, untaxed (`txcd_00000000`, Stripe's
+        // nontaxable code) and outside every per-line tax, engine and fee loop
+        // below, which read `cart.lines` only: an extra is not goods, so the
+        // platform's take is not charged on it.
+        chargedExtras.forEach((extra, offset)=>{
+            const index = cart.lines.length + offset;
+            params.set(`line_items[${index}][quantity]`, '1');
+            params.set(`line_items[${index}][price_data][currency]`, 'usd');
+            params.set(`line_items[${index}][price_data][unit_amount]`, String(extra.amountCents));
+            params.set(`line_items[${index}][price_data][product_data][name]`, extra.label.slice(0, 120));
+            params.set(`line_items[${index}][price_data][product_data][tax_code]`, 'txcd_00000000');
+        });
+        for (const [key, value] of Object.entries(encodeCheckoutExtrasMetadata(chargedExtras))){
+            params.set(`metadata[${key}]`, value);
+        }
         chargedItemsCents = itemsCents;
         // Discounts engine (AGL-305): entered codes and automatic
         // promotions from hosts/{id}/discounts; the AGL-96 coupons remain a
@@ -527,11 +613,11 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             })) : shippingPlan.options;
         // Coupons (AGL-96 semantics): percent off the items total.
         if (couponCode && !resolvedDiscount) {
-            var _ref4;
+            var _ref5;
             const couponRef = hostRef.collection('coupons').doc(couponCode);
             const couponSnapshot = await couponRef.get();
             const coupon = couponSnapshot.data();
-            const percentOff = Number((_ref4 = coupon == null ? void 0 : coupon.percentOff) != null ? _ref4 : 0);
+            const percentOff = Number((_ref5 = coupon == null ? void 0 : coupon.percentOff) != null ? _ref5 : 0);
             const expired = (coupon == null ? void 0 : coupon.expiresAtMs) != null && Number(coupon.expiresAtMs) < Date.now();
             if (!coupon || coupon.enabled === false || expired || !(percentOff > 0 && percentOff <= 100)) {
                 // Deterministic and retryable — the shopper fixes the code and
@@ -721,16 +807,61 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // `application_fee_amount` is fixed at creation), and the manual origin tax
         // rate the lines carry. A store on Stripe Tax is the one residual — its tax
         // is computed inside Stripe after the session is made.
+        // The merchant's own tax service, where they connected one (AGL-3631).
+        // Asked once, here, because the card-cost estimate just below and the
+        // tax lines further down both need its answer. Each line goes over at
+        // what Stripe will tax it at — its amount less its share of the session
+        // coupon, shared the way Stripe shares it — so the rate derived from
+        // the answer reproduces it. Taxed at the store's address, like the store's
+        // own rate: the shopper's address arrives inside Stripe Checkout, after
+        // this session exists. When the service does not answer, the store's
+        // rate stands and the order says so.
+        const cartEngineLines = cart.lines.map((line, index)=>{
+            var _params_get;
+            const unitCents = Number((_params_get = params.get(`line_items[${index}][price_data][unit_amount]`)) != null ? _params_get : NaN);
+            return {
+                index,
+                line,
+                amountCents: Number.isFinite(unitCents) ? unitCents * line.quantity : 0
+            };
+        }).filter((entry)=>entry.amountCents > 0);
+        const cartEngineDiscounts = allocateCentsByWeight(Math.max(0, itemsCents - chargedItemsCents), cartEngineLines.map((entry)=>entry.amountCents));
+        const cartEngineNet = cartEngineLines.map((entry, position)=>entry.amountCents - cartEngineDiscounts[position]);
+        const engineTax = chargedItemsCents > 0 ? await quoteSaleTaxWithEngine({
+            hostId,
+            settings: (_storeSettings_get = storeSettings.get('tax')) != null ? _storeSettings_get : {},
+            channel: 'online',
+            lines: cartEngineLines.map((entry, position)=>{
+                var _productsById_get;
+                return _extends({
+                    id: String(entry.index),
+                    productId: entry.line.productId
+                }, entry.line.variantId ? {
+                    variantId: entry.line.variantId
+                } : {}, {
+                    quantity: entry.line.quantity,
+                    amountCents: cartEngineNet[position]
+                }, ((_productsById_get = productsById.get(entry.line.productId)) == null ? void 0 : _productsById_get.taxExempt) ? {
+                    exempt: true
+                } : {});
+            }),
+            customerEmail: email || null
+        }) : {
+            quote: null,
+            stamp: null
+        };
         if (chargedItemsCents > 0) {
-            var _storeSettings_get1, _cartTaxSettings_origin;
+            var _storeSettings_get2, _cartTaxSettings_origin;
             const shippingCeilingCents = shippingOptions.reduce((most, option)=>{
                 var _option_amountCents;
                 return Math.max(most, Math.max(0, Number((_option_amountCents = option.amountCents) != null ? _option_amountCents : 0)));
             }, 0);
-            const cartTaxSettings = (_storeSettings_get1 = storeSettings.get('tax')) != null ? _storeSettings_get1 : {};
+            const cartTaxSettings = (_storeSettings_get2 = storeSettings.get('tax')) != null ? _storeSettings_get2 : {};
             const manualRate = cartTaxSettings.mode === 'manual' && !cartTaxSettings.pricesIncludeTax ? CommerceModel.resolveTaxRate(cartTaxSettings, (_cartTaxSettings_origin = cartTaxSettings.origin) != null ? _cartTaxSettings_origin : {}) : null;
             const manualTaxPct = manualRate && manualRate.pct > 0 ? manualRate.pct : 0;
-            const chargeCents = chargedItemsCents + Math.round(chargedItemsCents * manualTaxPct / 100) + shippingCeilingCents;
+            const chargeCents = chargedItemsCents + // Stripe's cost on the extras is a real cost of this charge, passed
+            // through at cost like the rest; no take is added on them (AGL-3635).
+            extrasCents + (engineTax.quote ? engineTax.quote.taxCents : Math.round(chargedItemsCents * manualTaxPct / 100)) + shippingCeilingCents;
             feeCents = Math.min(chargeCents, feeCents + Aglyn.saleProcessingCostCents(chargeCents));
         }
         // THE CONNECT SPLIT IS EMITTED BELOW, NOT HERE (AGL-1956). It used to be
@@ -768,7 +899,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // `automatic_tax.enabled` stays false on a manual sale, so
         // `storefront-tax.ts` still classifies it `manual` and it is never summed
         // into the Aglyn-liable figure (AGL-1904).
-        const taxSettings = (_storeSettings_get = storeSettings.get('tax')) != null ? _storeSettings_get : {};
+        const taxSettings = (_storeSettings_get1 = storeSettings.get('tax')) != null ? _storeSettings_get1 : {};
         // AGL-1999: an unset tax mode is NOT a decision, and it must not sell.
         // `mode` was `undefined` for every store whose owner never opened the
         // Taxes card — the default state of every new storefront — and each
@@ -808,6 +939,44 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         }
         if (taxDecision.kind === 'stripe-automatic') {
             params.set('automatic_tax[enabled]', 'true');
+        } else if (engineTax.quote) {
+            // The tax service's cents per line as one rate per line (AGL-3631),
+            // applied after the coupon exactly like the store's own rate below. One
+            // Tax Rate per distinct percentage, cached under the host like the
+            // store's, so a store's usual rates are minted once.
+            const engineAnswer = new Map(engineTax.quote.lines.map((line)=>[
+                    line.id,
+                    line.taxCents
+                ]));
+            const percentages = engineLineTaxPercentages(cartEngineLines.map((entry, position)=>{
+                var _engineAnswer_get;
+                return {
+                    amountCents: cartEngineNet[position],
+                    taxCents: (_engineAnswer_get = engineAnswer.get(String(entry.index))) != null ? _engineAnswer_get : 0
+                };
+            }), 0);
+            for(let position = 0; position < cartEngineLines.length; position++){
+                const pct = percentages[position];
+                if (pct === null) continue;
+                const taxRateId = await resolveManualTaxRateId({
+                    hostRef,
+                    taxPct: pct,
+                    taxLabel: 'Sales tax',
+                    headers: stripeKeyHeader(`tax-rate-engine-${Math.round(pct * 10000)}`)
+                });
+                if (!taxRateId) {
+                    // The same visible refusal as the store's own rate: never an
+                    // untaxed session.
+                    await releaseGiftCardHold();
+                    await releasePromotionHolds();
+                    await releaseStock();
+                    await claim.release();
+                    return res.status(502).json({
+                        error: 'Checkout failed'
+                    });
+                }
+                params.set(`line_items[${cartEngineLines[position].index}][tax_rates][0]`, taxRateId);
+            }
         } else if (taxSettings.mode === 'manual' && !taxSettings.pricesIncludeTax) {
             var _taxSettings_origin;
             // Origin-based, exactly as buy-now resolves it: the cart collects the
@@ -858,12 +1027,13 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // The site's own page, never a header's say-so (AGL-3363): a caller
         // writes `Referer` and `Host`, and this URL is where Stripe sends the
         // payer — and what the receipt's download links are built from.
+        const returnSite = await readSiteReturnHost(hostRef);
         const backUrl = siteReturnUrl({
             candidates: [
                 String((_req_headers_referer = req.headers.referer) != null ? _req_headers_referer : ''),
                 `https://${req.headers.host}`
             ],
-            site: await readSiteReturnHost(hostRef),
+            site: returnSite,
             requestHost: String((_req_headers_host = req.headers.host) != null ? _req_headers_host : '')
         });
         const separator = backUrl.includes('?') ? '&' : '?';
@@ -891,10 +1061,19 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             accountId: String(accountId),
             feeCents,
             taxOwner: cartTaxOwner,
-            merchantGoodsCents: chargedItemsCents,
+            // The extras are the merchant's to keep and remit (AGL-3635).
+            merchantGoodsCents: chargedItemsCents + extrasCents,
             shippingFloorCents: cartShippingFloorCents
         })).forEach(([key, value])=>params.set(key, value));
         params.set('metadata[type]', 'commerce-cart');
+        for (const [key, value] of Object.entries(taxEngineSessionMetadata(engineTax.stamp))){
+            params.set(key, value);
+        }
+        // The postal code live carrier rates were quoted for (AGL-3612), so the
+        // order can show it beside the address the shopper then entered.
+        if (shippingPlan.quotedPostalCode) {
+            params.set('metadata[shippingQuotePostalCode]', shippingPlan.quotedPostalCode);
+        }
         params.set('metadata[hostId]', hostId);
         params.set('metadata[cartId]', cartId);
         params.set('metadata[feeCents]', String(Math.max(0, feeCents)));
@@ -905,7 +1084,7 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         if (cartTaxOwner === 'platform') {
             params.set('metadata[transferCents]', String(CommerceModel.platformLiableTransferCents({
                 feeCents,
-                merchantGoodsCents: chargedItemsCents,
+                merchantGoodsCents: chargedItemsCents + extrasCents,
                 shippingFloorCents: cartShippingFloorCents
             })));
             params.set('metadata[transferShippingCents]', String(cartShippingFloorCents));
@@ -923,6 +1102,10 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // the SESSION is what bounds it; see `CHECKOUT_SESSION_TTL_MS` for why the
         // figure is 31 minutes and not Stripe's advertised 30-minute floor.
         params.set('expires_at', String(Math.floor((Date.now() + CommerceModel.CHECKOUT_SESSION_TTL_MS) / 1000)));
+        // The payment methods the merchant switched off (AGL-3629): exclusions
+        // only, on the hosted page and the in-page one alike.
+        const paymentMethodControls = CommerceModel.resolveStorefrontPaymentMethodControls(CommerceModel.normalizeStorefrontPaymentMethodSettings(storeSettings.get('paymentMethods')));
+        CommerceModel.appendStorefrontPaymentMethodParams(params, paymentMethodControls);
         // The Payment Element (AGL-1944), LAST and touching nothing above it. Every
         // figure the shopper is charged — line prices, the discount coupon, the tax
         // construction, the shipping rates, the fee — was decided before this line
@@ -933,12 +1116,19 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         if (nativeMode.native) {
             applyNativeCheckoutParams(params, `${backUrl}${separator}order=success&session_id={CHECKOUT_SESSION_ID}`);
         }
+        // Apple Pay shows on a registered domain only (AGL-3629): registered
+        // beside the session create, inside a budget, never failing the sale.
+        const domainRegistration = nativeMode.native ? ensureCheckoutDomain({
+            pageUrl: backUrl,
+            site: returnSite,
+            hostId
+        }).catch(()=>null) : Promise.resolve(null);
         const response = await fetch('https://api.stripe.com/v1/checkout/sessions', {
             method: 'POST',
             headers: _extends({
                 Authorization: `Bearer ${process.env.STRIPE_SECRET_KEY}`,
                 'Content-Type': 'application/x-www-form-urlencoded'
-            }, stripeKeyHeader('session'), nativeCheckoutStripeHeaders(nativeMode)),
+            }, stripeKeyHeader(`${engineTax.stamp ? `session-tax-${(_ref3 = (_engineTax_quote = engineTax.quote) == null ? void 0 : _engineTax_quote.taxCents) != null ? _ref3 : 'own'}-${engineTax.stamp.status}` : 'session'}${extrasCents > 0 ? `-x${extrasCents}` : ''}`), nativeCheckoutStripeHeaders(nativeMode)),
             body: params.toString()
         });
         const session = await response.json();
@@ -946,7 +1136,8 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
         // so it moves with the mode (AGL-1944) — otherwise every successful native
         // session reads as a Stripe failure: a 502 at the shopper, a released claim,
         // and a real Checkout Session left open on the merchant's account.
-        const payload = response.ok ? readCheckoutSessionPayload(session, nativeMode) : null;
+        await domainRegistration;
+        const payload = response.ok ? readCheckoutSessionPayload(session, nativeMode, paymentMethodControls.wallets) : null;
         if (!payload) {
             console.error('Stripe cart checkout error', session.error);
             // The checkout did not happen — hand the key back so one flaky moment
@@ -992,6 +1183,19 @@ import { applyNativeCheckoutParams, nativeCheckoutStripeHeaders, readCheckoutSes
             }),
             createdAtMs: Date.now()
         })).catch(()=>undefined);
+        // The fact a merchant's own email platform starts an abandoned-cart flow
+        // from (AGL-3639); nothing subscribes unless a site connected one.
+        if (email) {
+            await raiseCheckoutStarted(String(hostId), {
+                id: String(session.id),
+                email,
+                marketingOptIn,
+                currency: 'usd',
+                itemsCents,
+                resumeUrl: backUrl != null ? backUrl : null,
+                items: startedItems
+            });
+        }
         await claim.record(200, payload);
         return res.status(200).json(payload);
     } catch (error) {