@ticketboothapp/booking 1.2.75 → 1.2.77

package/CHANGE_BOOKING_BE_HANDOFF.md

@@ -100,3 +100,39 @@ Pickers show **catalog** prices by default (same booking **currency** as the ori
 - **Provider change API:** When `pricingAdjustment.additionalAdjustments` includes the same rows, persist them on the new receipt and charge the **same** total as `newTotalAmount` (within your rounding rules).
 
 If the server ignores `manualLineAdjustments` or `additionalAdjustments`, the customer will see the FE total but pay a different amount.
+
+---
+
+## Admin FE-authoritative quote path (new)
+
+For provider dashboard / admin tooling, we need a dedicated quote route where the **frontend is authoritative** for
+the full receipt preview (totals + line items), and BE does not re-price those values.
+
+### Endpoint
+
+- **`POST /1/admin/bookings/:bookingReference/change/quote?lastName=...`**
+
+Keep the public self-serve endpoint unchanged.
+
+### Request contract (admin)
+
+Same selection fields as `ChangeBookingQuoteRequest`, plus:
+
+- `feReceipt`:
+  - `subtotal` (major units)
+  - `tax` (major units)
+  - `total` (major units)
+  - `currency?`
+  - `lineItems: Array<{ label?: string; amount?: number; type?: string; quantity?: number }>`
+- `feAmountDueMajorUnits?` (optional signed delta the FE displays; `newTotal - previousTotal`)
+
+### Backend expectations
+
+- Validate admin auth + booking/availability eligibility only.
+- Persist `feReceipt` on the change intent as the quote source-of-truth.
+- Return a `ChangeBookingQuoteResponse`-compatible payload using the stored FE receipt:
+  - `newReceipt` / `proposed` line items from `feReceipt.lineItems`
+  - `newReceipt.subtotal/tax/total` from `feReceipt`
+  - `amountDueCents` / `balanceDeltaMajorUnits` / `priceDiff` coherent with stored totals
+  - `changeIntentId`, `canProceed`, `reasonIfBlocked`
+- Payment intent + apply/confirm for this change intent must use persisted FE totals/lines (no repricing).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticketboothapp/booking",
-  "version": "1.2.75",
+  "version": "1.2.77",
   "private": false,
   "sideEffects": [
     "**/*.css",

package/src/components/booking/AdminChangeBookingFlow.tsx

@@ -9,6 +9,7 @@ import {
   cancelReservationBestEffort,
   createPaymentIntent,
   quoteChangeBooking,
+  quoteChangeBookingAdminFeReceipt,
   confirmFreeChangeBooking,
   createChangeBookingPaymentIntent,
   confirmBookingWithoutPayment,
@@ -25,6 +26,7 @@ import {
   isInsufficientCapacityReserveError,
   describeStandardTourCapacityConflictMessage,
   reportReserveCapacityConflictClientContext,
+  type AdminFeAuthoritativeReceipt,
 } from '../../lib/booking-api';
 import {
   EARLIEST_AVAILABILITY_DATE,
@@ -126,6 +128,9 @@ function mergeQuoteSliceWithServerPreview(
     serverPreview: buildChangeBookingServerPreview(quote, fallbackCart, currency),
     pricingDriftDetail: normalizePricingDriftDetailFromQuote(quote),
     ticketPricingTrace: normalizeTicketPricingTraceFromQuote(quote),
+    /** Same cent pair the BE uses for `amountDueCents` / intent & receipt "New Booking Difference" — use for signed refund display. */
+    quotePreviousTotalCents: quote.previousTotalCents,
+    quoteNewTotalCents: quote.newTotalCents,
   };
 }
 
@@ -145,6 +150,26 @@ function omitZeroAmountPromoDiscountSummaryLines(lines: PriceSummaryLine[]): Pri
   });
 }
 
+function mapSummaryLinesToFeReceiptLineItems(lines: PriceSummaryLine[]): NonNullable<AdminFeAuthoritativeReceipt['lineItems']> {
+  return lines.map((line) => {
+    if (line.kind === 'ticket') {
+      return {
+        label: line.category,
+        amount: roundMoney(line.itemTotal),
+        type: 'TICKET',
+        quantity: line.qty,
+      };
+    }
+    const normalizedType = String(line.type ?? '').trim().toUpperCase();
+    return {
+      label: line.label,
+      amount: roundMoney(line.amount),
+      type: normalizedType || undefined,
+      quantity: line.quantity ?? undefined,
+    };
+  });
+}
+
 function formatTicketLineItemsForSummary(lines: Array<{ category: string; qty: number }>): string {
   const labels: Record<string, string> = {
     ADULT: 'adult',
@@ -730,6 +755,8 @@ export function AdminChangeBookingFlow({
   const [adminCustomReceiptLines, setAdminCustomReceiptLines] = useState<
     Array<{ id: string; label: string; amountInput: string; amountSign: 1 | -1 }>
   >([]);
+  const [editableSummaryLineAmountInputs, setEditableSummaryLineAmountInputs] = useState<Record<string, string>>({});
+  const [editableSummaryLineLabelInputs, setEditableSummaryLineLabelInputs] = useState<Record<string, string>>({});
   const adminCustomLineIdRef = useRef(0);
 
   // Auto-apply promo code when parent page passes one (e.g. partner pages).
@@ -828,6 +855,10 @@ export function AdminChangeBookingFlow({
     }
   }, [initialValues?.dateTime, companyTimezone]);
   const isProviderDashboardChange = Boolean(onChangeBooking);
+  const useAdminFeAuthoritativeQuote =
+    isAdmin &&
+    isProviderDashboardChange &&
+    Boolean(flowUi?.adminFeAuthoritativeQuoteEnabled);
   /** Any change from an existing booking (public or provider). */
   const isChangeBookingContext = Boolean(initialValues?.bookingReference?.trim());
   /**
@@ -852,9 +883,10 @@ export function AdminChangeBookingFlow({
   const lockedPromoCode = initialValues?.promoCode?.trim()
     ? initialValues.promoCode.trim().toUpperCase()
     : null;
-  /** Public self-serve only: cannot reduce tickets below original counts. */
+  /** Public self-serve only: cannot reduce tickets below original counts. Provider-dashboard admins may reduce party size. */
   const changeBookingMinimumQuantities = useMemo(() => {
     if (!isCustomerSelfServeChange || !initialValues?.bookingItems?.length) return undefined;
+    if (isAdmin && isProviderDashboardChange) return undefined;
     const m: Record<string, number> = {};
     for (const item of initialValues.bookingItems) {
       const key = item.category?.trim();
@@ -862,7 +894,7 @@ export function AdminChangeBookingFlow({
       m[key] = Math.max(0, Number(item.count) || 0);
     }
     return m;
-  }, [isCustomerSelfServeChange, initialValues?.bookingItems]);
+  }, [isCustomerSelfServeChange, initialValues?.bookingItems, isAdmin, isProviderDashboardChange]);
   const [adminChoiceData, setAdminChoiceData] = useState<{
     reservationReference: string;
     reservationExpiration?: string;
@@ -895,6 +927,9 @@ export function AdminChangeBookingFlow({
     quotedTotal?: number;
     /** From `quoteChangeBooking` receipt fields — drives PriceSummary when self-serve. */
     serverDisplay?: { total: number; subtotal: number; tax: number };
+    /** Server quote cents — authoritative vs `serverDisplay` scaling (aligns with receipt difference line). */
+    quotePreviousTotalCents?: number;
+    quoteNewTotalCents?: number;
     /** Parsed from last quote — unified server-owned preview for lines + picker overrides. */
     serverPreview: ReturnType<typeof buildChangeBookingServerPreview>;
     pricingDriftDetail?: ChangeBookingQuotePricingDriftDetail;
@@ -3113,6 +3148,140 @@ export function AdminChangeBookingFlow({
       ),
     [checkoutPriceSummaryLinesForCheckout],
   );
+  const getEditableSummaryLineKey = useCallback((line: PriceSummaryLine, index: number): string => {
+    if (line.lineKey) return line.lineKey;
+    return line.kind === 'ticket'
+      ? `change-ticket-${line.category}-${index}`
+      : `change-line-${line.label}-${line.type ?? 'line'}-${index}`;
+  }, []);
+  const editableCheckoutPriceSummaryLines = useMemo((): PriceSummaryLine[] => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    return checkoutPriceSummaryLinesForCheckout.map((line, index) => {
+      const isBeforeSubtotal = firstTaxLineIndex < 0 || index < firstTaxLineIndex;
+      const lineKey = getEditableSummaryLineKey(line, index);
+      if (line.kind === 'ticket') {
+        const amountInput = editableSummaryLineAmountInputs[lineKey];
+        const parsedAmount = amountInput == null || amountInput.trim() === '' ? line.itemTotal : Number(amountInput);
+        return {
+          ...line,
+          lineKey,
+          editable: isBeforeSubtotal,
+          category: editableSummaryLineLabelInputs[lineKey] ?? line.category,
+          itemTotal: Number.isFinite(parsedAmount) ? roundMoney(parsedAmount) : line.itemTotal,
+        };
+      }
+      const amountInput = editableSummaryLineAmountInputs[lineKey];
+      const parsedAmount = amountInput == null || amountInput.trim() === '' ? line.amount : Number(amountInput);
+      return {
+        ...line,
+        lineKey,
+        editable: isBeforeSubtotal,
+        label: editableSummaryLineLabelInputs[lineKey] ?? line.label,
+        amount: Number.isFinite(parsedAmount) ? roundMoney(parsedAmount) : line.amount,
+      };
+    });
+  }, [
+    checkoutPriceSummaryLinesForCheckout,
+    editableSummaryLineAmountInputs,
+    editableSummaryLineLabelInputs,
+    getEditableSummaryLineKey,
+  ]);
+  useEffect(() => {
+    setEditableSummaryLineAmountInputs((prev) => {
+      const next: Record<string, string> = {};
+      for (let i = 0; i < editableCheckoutPriceSummaryLines.length; i += 1) {
+        const line = editableCheckoutPriceSummaryLines[i];
+        const key = line.lineKey;
+        if (!key) continue;
+        if (prev[key] != null) {
+          next[key] = prev[key];
+          continue;
+        }
+        next[key] = line.kind === 'ticket' ? String(line.itemTotal) : String(line.amount);
+      }
+      const prevKeys = Object.keys(prev);
+      const nextKeys = Object.keys(next);
+      if (
+        prevKeys.length === nextKeys.length &&
+        nextKeys.every((key) => prev[key] === next[key])
+      ) {
+        return prev;
+      }
+      return next;
+    });
+    setEditableSummaryLineLabelInputs((prev) => {
+      const next: Record<string, string> = {};
+      for (let i = 0; i < editableCheckoutPriceSummaryLines.length; i += 1) {
+        const line = editableCheckoutPriceSummaryLines[i];
+        const key = line.lineKey;
+        if (!key) continue;
+        if (prev[key] != null) {
+          next[key] = prev[key];
+          continue;
+        }
+        next[key] = line.kind === 'ticket' ? line.category : line.label;
+      }
+      const prevKeys = Object.keys(prev);
+      const nextKeys = Object.keys(next);
+      if (
+        prevKeys.length === nextKeys.length &&
+        nextKeys.every((key) => prev[key] === next[key])
+      ) {
+        return prev;
+      }
+      return next;
+    });
+  }, [editableCheckoutPriceSummaryLines]);
+  const editableSummaryPreSubtotalDelta = useMemo(() => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    let delta = 0;
+    for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+      if (firstTaxLineIndex >= 0 && i >= firstTaxLineIndex) break;
+      const line = checkoutPriceSummaryLinesForCheckout[i];
+      const lineKey = getEditableSummaryLineKey(line, i);
+      const baselineAmount = line.kind === 'ticket' ? line.itemTotal : line.amount;
+      const raw = editableSummaryLineAmountInputs[lineKey];
+      const parsed = raw == null || raw.trim() === '' ? baselineAmount : Number(raw);
+      const editedAmount = Number.isFinite(parsed) ? roundMoney(parsed) : baselineAmount;
+      delta += editedAmount - baselineAmount;
+    }
+    return roundMoney(delta);
+  }, [
+    checkoutPriceSummaryLinesForCheckout,
+    editableSummaryLineAmountInputs,
+    getEditableSummaryLineKey,
+  ]);
+  const editableSummaryPreSubtotalDebugRows = useMemo(() => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    const rows: Array<{ label: string; baseline: number; edited: number; delta: number }> = [];
+    for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+      if (firstTaxLineIndex >= 0 && i >= firstTaxLineIndex) break;
+      const line = checkoutPriceSummaryLinesForCheckout[i];
+      const lineKey = getEditableSummaryLineKey(line, i);
+      const baselineAmount = line.kind === 'ticket' ? line.itemTotal : line.amount;
+      const raw = editableSummaryLineAmountInputs[lineKey];
+      const parsed = raw == null || raw.trim() === '' ? baselineAmount : Number(raw);
+      const editedAmount = Number.isFinite(parsed) ? roundMoney(parsed) : baselineAmount;
+      const delta = roundMoney(editedAmount - baselineAmount);
+      rows.push({
+        label: line.kind === 'ticket' ? line.category : line.label,
+        baseline: roundMoney(baselineAmount),
+        edited: editedAmount,
+        delta,
+      });
+    }
+    return rows;
+  }, [
+    checkoutPriceSummaryLinesForCheckout,
+    editableSummaryLineAmountInputs,
+    getEditableSummaryLineKey,
+  ]);
 
   // Promo discount from backend (order-level only; rates are pre-promo)
   const [promoDiscountAmount, setPromoDiscountAmount] = useState(0);
@@ -3687,6 +3856,23 @@ export function AdminChangeBookingFlow({
     providerHasAdditionalAdjustments ||
     Math.abs(adminCustomAdjustmentTotal) >= 0.005;
 
+  /**
+   * True until `quoteChangeBooking` returns a confirmed `serverDisplay` for the current selection.
+   * Named so manual price-line UI can align with “still settling final price” without touching ticket/receipt math.
+   */
+  const changeFlowFinalPricePending =
+    suppressSelfServeCurrencyUi &&
+    selectedAvailability != null &&
+    totalQuantity > 0 &&
+    !selfServePricingConfirmed;
+
+  /**
+   * Provider inline edits + admin custom lines: show while waiting on or after the authoritative quote.
+   * UI-only gate — does not alter ticket line items or receipt-floor rules.
+   */
+  const showChangeFlowManualPriceLines =
+    changeFlowFinalPricePending || selfServePricingConfirmed;
+
   const displayedChangeAmountsRaw = resolveChangeFlowDisplayedAmounts({
     providerPreview: providerTotalsPreview,
     serverQuotePreview:
@@ -3713,25 +3899,173 @@ export function AdminChangeBookingFlow({
   );
   const displayChangeFlowTax = roundMoney(displayedChangeAmountsRaw.tax + adminTaxDeltaForExternalDisplay);
   const displayChangeFlowProposedTotal = roundMoney(
-    displayedChangeAmountsRaw.total + adminCustomAdjustmentTotal + adminTaxDeltaForExternalDisplay
+    displayLayerUsesExternalPricing
+      ? displayedChangeAmountsRaw.total + adminCustomAdjustmentTotal + adminTaxDeltaForExternalDisplay
+      : displayedChangeAmountsRaw.total
   );
+  const displayChangeFlowProposedTotalWithEditableLines = roundMoney(
+    displayChangeFlowProposedTotal + editableSummaryPreSubtotalDelta
+  );
+  const adminFeAuthoritativeReceipt = useMemo((): AdminFeAuthoritativeReceipt => {
+    const hasTaxLine = editableCheckoutPriceSummaryLines.some(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    const lineItems = mapSummaryLinesToFeReceiptLineItems(editableCheckoutPriceSummaryLines);
+    if (!hasTaxLine && Math.abs(displayChangeFlowTax) >= 0.0005) {
+      lineItems.push({
+        label: t('booking.tax') !== 'booking.tax' ? t('booking.tax') : 'Taxes and fees',
+        amount: roundMoney(displayChangeFlowTax),
+        type: 'TAX',
+      });
+    }
+    let subtotal = roundMoney(displayChangeFlowSubtotal + editableSummaryPreSubtotalDelta);
+    const tax = roundMoney(displayChangeFlowTax);
+    const expectedTotal = roundMoney(displayChangeFlowProposedTotalWithEditableLines);
+    const recomputed = roundMoney(subtotal + tax);
+    if (Math.abs(recomputed - expectedTotal) >= 0.005) {
+      subtotal = roundMoney(expectedTotal - tax);
+    }
+    return {
+      subtotal,
+      tax,
+      total: expectedTotal,
+      currency,
+      lineItems,
+    };
+  }, [
+    editableCheckoutPriceSummaryLines,
+    displayChangeFlowTax,
+    displayChangeFlowSubtotal,
+    editableSummaryPreSubtotalDelta,
+    displayChangeFlowProposedTotalWithEditableLines,
+    currency,
+    t,
+  ]);
 
-  const changeFlowClientEstimateDue = (() => {
+  const changeFlowClientEstimateDueBase = (() => {
     if (!originalReceipt) return totalPrice;
-    // Customer self-serve: amount due comes from POST .../change/quote (`amountDueCents` / priceDiff), not FE delta math.
+    // Self-serve quote: match BE receipt / intent: (newTotalCents − previousTotalCents) / 100.
     if (isCustomerSelfServeChange && latestChangeQuote != null && !changeQuoteFetchError) {
+      const pq = latestChangeQuote.quotePreviousTotalCents;
+      const nq = latestChangeQuote.quoteNewTotalCents;
+      if (pq != null && nq != null) {
+        return normalizeNearZeroOwed(roundMoney((nq - pq) / 100));
+      }
+      if (latestChangeQuote.serverDisplay != null) {
+        return normalizeNearZeroOwed(
+          roundMoney(latestChangeQuote.serverDisplay.total - originalReceipt.total),
+        );
+      }
       return normalizeNearZeroOwed(latestChangeQuote.priceDiff);
     }
     return changeFlowBalanceVsOriginal({
       newTotal: displayChangeFlowProposedTotal,
       originalReceiptTotal: originalReceipt.total,
-      audience: isProviderDashboardChange ? 'provider' : 'customer',
+      audience: 'admin',
     });
   })();
+  const changeFlowClientEstimateDue = normalizeNearZeroOwed(
+    roundMoney(changeFlowClientEstimateDueBase + editableSummaryPreSubtotalDelta)
+  );
 
   const changeFlowAmountDueRaw = changeFlowClientEstimateDue;
   const changeFlowAmountDue = normalizeNearZeroOwed(changeFlowAmountDueRaw);
 
+  const changeFlowAdminPricingDebugPanel = useMemo(() => {
+    if (!isAdmin || !selectedAvailability || totalQuantity <= 0) return null;
+    const fmt = (n: number) => formatCurrencyAmount(roundMoney(n), currency, locale as 'en' | 'fr');
+    const path = (() => {
+      if (!originalReceipt) return 'totalPrice (no original receipt)';
+      if (isCustomerSelfServeChange && latestChangeQuote != null && !changeQuoteFetchError) {
+        if (
+          latestChangeQuote.quotePreviousTotalCents != null &&
+          latestChangeQuote.quoteNewTotalCents != null
+        ) {
+          return 'POST /change/quote: (quoteNewTotalCents − quotePreviousTotalCents) / 100';
+        }
+        if (latestChangeQuote.serverDisplay != null) {
+          return 'POST /change/quote: serverDisplay.total − originalReceipt.total';
+        }
+        return 'POST /change/quote: priceDiff (API balance delta)';
+      }
+      return 'FE: displayChangeFlowProposedTotal − originalReceipt.total (signed; used when quote not driving amount-due)';
+    })();
+    const quoteTotalPreview =
+      latestChangeQuote?.serverDisplay != null ? fmt(latestChangeQuote.serverDisplay.total) : '—';
+    return (
+      <details className="mt-3 rounded-md border border-amber-200/80 bg-amber-50/50 p-2 text-left text-xs text-amber-950">
+        <summary className="cursor-pointer select-none font-medium text-stone-800">
+          Price calculation (admin debug)
+        </summary>
+        <pre className="mt-2 max-h-64 overflow-auto whitespace-pre-wrap break-words font-mono text-[11px] leading-relaxed text-stone-800">
+          {[
+            `Amount-due path: ${path}`,
+            `adminFeAuthoritativeQuoteEnabled: ${String(useAdminFeAuthoritativeQuote)}`,
+            `displayLayerUsesExternalPricing: ${String(displayLayerUsesExternalPricing)} (server/provider totals omit FE admin lines until overlaid)`,
+            `selfServePricingConfirmed: ${String(selfServePricingConfirmed)} · changeQuoteLoading: ${String(changeQuoteLoading)}`,
+            `Cart subtotal (excl. admin custom lines): ${fmt(effectiveSubtotal)}`,
+            `Admin custom lines (sum): ${fmt(adminCustomAdjustmentTotal)}`,
+            `Pre-subtotal line overrides:`,
+            ...editableSummaryPreSubtotalDebugRows.map(
+              (row, idx) =>
+                `  ${idx + 1}. ${row.label} | baseline ${fmt(row.baseline)} -> edited ${fmt(row.edited)} (delta ${fmt(row.delta)})`
+            ),
+            `Checkout subtotal (incl. admin lines): ${fmt(effectiveSubtotalForCheckout)}`,
+            `effectiveTax · promo discount: ${fmt(effectiveTax)} · ${fmt(effectivePromoDiscountAmount)}`,
+            `totalPrice (subtotal + tax − promo): ${fmt(totalPrice)}`,
+            `changeFlowNewBookingTotal (after cent reconcile vs receipt): ${fmt(changeFlowNewBookingTotal)}`,
+            `Displayed layer subtotal / tax / total: ${fmt(displayedChangeAmountsRaw.subtotal)} / ${fmt(displayedChangeAmountsRaw.tax)} / ${fmt(displayedChangeAmountsRaw.total)}`,
+            `Pre-subtotal editable lines delta: ${fmt(editableSummaryPreSubtotalDelta)}`,
+            `displayChangeFlowProposedTotal (base): ${fmt(displayChangeFlowProposedTotal)}`,
+            `displayChangeFlowProposedTotal (with editable lines): ${fmt(displayChangeFlowProposedTotalWithEditableLines)}`,
+            `feReceipt sent subtotal/tax/total: ${fmt(adminFeAuthoritativeReceipt.subtotal)} / ${fmt(adminFeAuthoritativeReceipt.tax)} / ${fmt(adminFeAuthoritativeReceipt.total)}`,
+            `feReceipt sent lineItems count: ${String(adminFeAuthoritativeReceipt.lineItems.length)}`,
+            originalReceipt ? `originalReceipt.total: ${fmt(originalReceipt.total)}` : 'originalReceipt: —',
+            `Quote serverDisplay.total (if any): ${quoteTotalPreview}`,
+            `Quote serverDisplay subtotal/tax/total: ${
+              latestChangeQuote?.serverDisplay
+                ? `${fmt(latestChangeQuote.serverDisplay.subtotal)} / ${fmt(latestChangeQuote.serverDisplay.tax)} / ${fmt(latestChangeQuote.serverDisplay.total)}`
+                : '—'
+            }`,
+            `changeFlowClientEstimateDue (before near-zero): ${fmt(changeFlowClientEstimateDue)}`,
+            `changeFlowAmountDue (PriceSummary total row): ${fmt(changeFlowAmountDue)}`,
+          ].join('\n')}
+        </pre>
+      </details>
+    );
+  }, [
+    isAdmin,
+    selectedAvailability,
+    totalQuantity,
+    useAdminFeAuthoritativeQuote,
+    currency,
+    locale,
+    originalReceipt,
+    isCustomerSelfServeChange,
+    latestChangeQuote,
+    changeQuoteFetchError,
+    displayLayerUsesExternalPricing,
+    selfServePricingConfirmed,
+    changeQuoteLoading,
+    effectiveSubtotal,
+    adminCustomAdjustmentTotal,
+    editableSummaryPreSubtotalDebugRows,
+    effectiveSubtotalForCheckout,
+    effectiveTax,
+    effectivePromoDiscountAmount,
+    totalPrice,
+    changeFlowNewBookingTotal,
+    displayedChangeAmountsRaw.subtotal,
+    displayedChangeAmountsRaw.tax,
+    displayedChangeAmountsRaw.total,
+    editableSummaryPreSubtotalDelta,
+    displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
+    adminFeAuthoritativeReceipt,
+    changeFlowClientEstimateDue,
+    changeFlowAmountDue,
+  ]);
+
   const changeCheckoutButtonLabel = (() => {
     if (!hasEffectiveChangeSelection) return undefined;
     if (isProviderDashboardChange) {
@@ -3759,7 +4093,9 @@ export function AdminChangeBookingFlow({
         const d = Math.round(changeFlowClientEstimateDue * 100) / 100;
         return d > 0
           ? `Change booking (${formatCurrencyAmount(d, currency, locale as 'en' | 'fr')})`
-          : 'Change booking (no charge)';
+          : d < 0
+            ? `Change booking (${formatCurrencyAmount(d, currency, locale as 'en' | 'fr')})`
+            : 'Change booking (no charge)';
       }
       const tr = t('booking.changeBooking');
       return tr !== 'booking.changeBooking' ? tr : 'Change booking';
@@ -3767,7 +4103,9 @@ export function AdminChangeBookingFlow({
     const est = Math.round(changeFlowClientEstimateDue * 100) / 100;
     return est > 0
       ? `Change booking (${formatCurrencyAmount(est, currency, locale as 'en' | 'fr')})`
-      : 'Change booking (no charge)';
+      : est < 0
+        ? `Change booking (${formatCurrencyAmount(est, currency, locale as 'en' | 'fr')})`
+        : 'Change booking (no charge)';
   })();
   /** Partner deferred-invoice path applies to {@link NewBookingFlow} only. */
   const deferredInvoiceSubmitLabel = undefined;
@@ -3851,7 +4189,7 @@ export function AdminChangeBookingFlow({
         originalReceipt
           ? suppressSelfServeCurrencyUi && !selfServePricingConfirmed
             ? null
-            : displayChangeFlowProposedTotal
+            : displayChangeFlowProposedTotalWithEditableLines
           : totalPrice,
       selectionCurrency: currency,
     };
@@ -3865,7 +4203,7 @@ export function AdminChangeBookingFlow({
     totalPrice,
     currency,
     originalReceipt,
-    displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
     suppressSelfServeCurrencyUi,
     selfServePricingConfirmed,
   ]);
@@ -3910,7 +4248,7 @@ export function AdminChangeBookingFlow({
             ? displayChangeFlowTax
             : effectiveTax
           : 0,
-      total: originalReceipt ? displayChangeFlowProposedTotal : totalPrice,
+      total: originalReceipt ? displayChangeFlowProposedTotalWithEditableLines : totalPrice,
       currency,
     });
   }, [
@@ -3919,7 +4257,7 @@ export function AdminChangeBookingFlow({
     totalQuantity,
     effectiveSubtotalForCheckout,
     effectiveTax,
-    displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
     displayChangeFlowSubtotal,
     displayChangeFlowTax,
     currency,
@@ -3971,7 +4309,7 @@ export function AdminChangeBookingFlow({
           .filter(([, count]) => count > 0)
           .map(([category, count]) => ({ category, count }));
         try {
-          const quote = await quoteChangeBooking({
+          const quoteRequestBase = {
             bookingReference: bookingReferenceForQuote,
             lastName: lastName.trim(),
             newProductId: optionId,
@@ -3992,7 +4330,14 @@ export function AdminChangeBookingFlow({
               previousAvailabilityId: initialValues.availabilityId ?? null,
               previousReturnAvailabilityId: initialValues.returnAvailabilityId ?? null,
             },
-          });
+          };
+          const quote = useAdminFeAuthoritativeQuote
+            ? await quoteChangeBookingAdminFeReceipt({
+                ...quoteRequestBase,
+                feReceipt: adminFeAuthoritativeReceipt,
+                feAmountDueMajorUnits: roundMoney(changeFlowClientEstimateDue),
+              })
+            : await quoteChangeBooking(quoteRequestBase);
           if (seq !== changeQuoteRequestSeq.current) return;
           const slice = sliceChangeQuoteForUi(
             quote,
@@ -4040,6 +4385,7 @@ export function AdminChangeBookingFlow({
     addOnSelections,
     changeFlowInitialTicketCount,
     changeFlowNewBookingTotal,
+    changeFlowClientEstimateDue,
     effectiveSubtotalForCheckout,
     effectiveTax,
     totalPrice,
@@ -4048,6 +4394,8 @@ export function AdminChangeBookingFlow({
     initialValues?.availabilityId,
     initialValues?.returnAvailabilityId,
     adminCustomLinesAsAdditionalAdjustments,
+    adminFeAuthoritativeReceipt,
+    useAdminFeAuthoritativeQuote,
   ]);
 
   // Auto-select product option when date is selected: most popular if set, otherwise first available.
@@ -4568,7 +4916,7 @@ export function AdminChangeBookingFlow({
         if (!changeBookingReference || !changeLastName) {
           throw new Error('Missing booking reference or last name for change quote');
         }
-        const quote = await quoteChangeBooking({
+        const quoteRequestBase = {
           bookingReference: changeBookingReference,
           lastName: changeLastName,
           newProductId: availabilityProductOptionId,
@@ -4583,7 +4931,14 @@ export function AdminChangeBookingFlow({
             : {}),
           clientProposedTotal:
             latestChangeQuote?.serverDisplay?.total ?? changeFlowNewBookingTotal,
-        });
+        };
+        const quote = useAdminFeAuthoritativeQuote
+          ? await quoteChangeBookingAdminFeReceipt({
+              ...quoteRequestBase,
+              feReceipt: adminFeAuthoritativeReceipt,
+              feAmountDueMajorUnits: roundMoney(changeFlowClientEstimateDue),
+            })
+          : await quoteChangeBooking(quoteRequestBase);
         const quoteSlice = sliceChangeQuoteForUi(
           quote,
           {
@@ -4611,30 +4966,41 @@ export function AdminChangeBookingFlow({
           quote.proposed?.total ??
           quote.newReceipt?.total ??
           changeFlowNewBookingTotal;
-        const feChangeDue = changeFlowBalanceVsOriginal({
-          newTotal: serverNewTotalForGuard,
-          originalReceiptTotal: originalReceipt?.total ?? 0,
-          audience: 'customer',
-        });
-        const serverAmountDue =
-          quote.amountDueCents != null
-            ? Math.max(0, quote.amountDueCents / 100)
-            : Math.max(0, quote.priceDiff ?? 0);
-        if (feChangeDue > 0.02 && serverAmountDue <= 0.009) {
+        /** Signed proposed − previous (major units). Matches quote slices when cents present; refund owed < 0. */
+        const signedBalanceMajor =
+          quote.previousTotalCents != null && quote.newTotalCents != null
+            ? (quote.newTotalCents - quote.previousTotalCents) / 100
+            : quote.balanceDeltaMajorUnits ?? null;
+        const chargeDue =
+          signedBalanceMajor != null
+            ? Math.max(0, signedBalanceMajor)
+            : quote.amountDueCents != null
+              ? quote.amountDueCents / 100
+              : Math.max(0, quote.priceDiff ?? 0);
+        const feChangeDue =
+          signedBalanceMajor ??
+          changeFlowBalanceVsOriginal({
+            newTotal: serverNewTotalForGuard,
+            originalReceiptTotal: originalReceipt?.total ?? 0,
+            audience: 'admin',
+          });
+        if (feChangeDue > 0.02 && chargeDue <= 0.009) {
           throw new Error(
             'This change requires payment, but the price could not be confirmed. Please refresh and try again.'
           );
         }
-        // No-payment change: FE shows nothing owed — still require server agreement so we never confirm free when a charge is due.
-        if (serverAmountDue <= 0.009) {
+        // No additional charge (includes refund-owed / downgrade): confirm-free apply only when server agrees no payment due.
+        if (chargeDue <= 0.009) {
           if (feChangeDue > 0.02) {
             throw new Error(
               'This change requires payment, but the price could not be confirmed. Please refresh and try again.'
             );
           }
-          const p = quote.proposed?.total ?? quote.newReceipt?.total;
-          const o = quote.original?.total ?? quote.originalReceipt?.total;
-          if (p != null && o != null && p - o > 0.01) {
+          const upgradeWithoutCharge =
+            quote.newTotalCents != null &&
+            quote.previousTotalCents != null &&
+            quote.newTotalCents > quote.previousTotalCents + 1;
+          if (upgradeWithoutCharge) {
             throw new Error(
               'This change requires payment, but the price could not be confirmed. Please refresh and try again.'
             );
@@ -4686,11 +5052,14 @@ export function AdminChangeBookingFlow({
       // Backend will charge totalAmount and store this as the receipt so /manage matches.
       const taxForBreakdown = effectivePromoDiscountAmount > 0 ? effectiveTax : tax;
       const amountDueForCheckout = isCustomerSelfServeChange
-        ? changeFlowBalanceVsOriginal({
-            newTotal: changeFlowNewBookingTotal,
-            originalReceiptTotal: originalReceipt?.total ?? 0,
-            audience: 'customer',
-          })
+        ? Math.max(
+            0,
+            changeFlowBalanceVsOriginal({
+              newTotal: changeFlowNewBookingTotal,
+              originalReceiptTotal: originalReceipt?.total ?? 0,
+              audience: 'admin',
+            }),
+          )
         : totalPrice;
       const lines = [
         ...ticketLineItemsForChangeFlowDisplay.map((line) => ({
@@ -4923,7 +5292,7 @@ export function AdminChangeBookingFlow({
           isCustomerSelfServeChange && originalReceipt
             ? {
                 previousTotal: originalReceipt.total,
-                newTotal: displayChangeFlowProposedTotal,
+                newTotal: displayChangeFlowProposedTotalWithEditableLines,
                 differenceTotal: amountDueForCheckout,
               }
             : undefined,
@@ -5029,7 +5398,7 @@ export function AdminChangeBookingFlow({
           addOnSelections: addOnSelections.length > 0 ? addOnSelections : null,
           cancellationPolicyId: cancellationPolicyId ?? initialValues?.cancellationPolicyId ?? null,
           promoCode: appliedPromoCode ?? null,
-          newTotalAmount: displayChangeFlowProposedTotal,
+          newTotalAmount: displayChangeFlowProposedTotalWithEditableLines,
           additionalHoursCount: null,
           pricingAdjustment:
             providerPricingOverrides.length > 0 || mergedProviderAdditionalAdjustments.length > 0
@@ -5402,14 +5771,16 @@ export function AdminChangeBookingFlow({
           {selectedAvailability && (
             <>
             <CheckoutForm
-                priceSummaryLines={checkoutPriceSummaryLinesForCheckout}
+                priceSummaryLines={editableCheckoutPriceSummaryLines}
                 replacePriceSummary={selfServeCheckoutPlaceholder}
                 totalPrice={changeFlowAmountDue}
                 totalSummaryLabel={
-                  t('booking.totalOwedForBookingChange') &&
-                  t('booking.totalOwedForBookingChange') !== 'booking.totalOwedForBookingChange'
-                    ? t('booking.totalOwedForBookingChange')
-                    : 'Total owed for booking difference'
+                  changeFlowAmountDue < -0.005
+                    ? 'Refund owed (vs original booking)'
+                    : t('booking.totalOwedForBookingChange') &&
+                        t('booking.totalOwedForBookingChange') !== 'booking.totalOwedForBookingChange'
+                      ? t('booking.totalOwedForBookingChange')
+                      : 'Total owed for booking difference'
                 }
                 subtotal={displayChangeFlowSubtotal}
                 taxAmount={
@@ -5438,9 +5809,11 @@ export function AdminChangeBookingFlow({
                     !providerPricingUi.error ? (
                       <div className="mt-2 text-xs text-stone-500">{providerPricingUi.helperText}</div>
                     ) : null}
+                    {changeFlowAdminPricingDebugPanel}
                   </>
                 }
                 extraBeforeSubtotal={
+                  showChangeFlowManualPriceLines ? (
                   <>
                     {showProviderPricingInlineEditor && (providerPricingUi?.additionalAdjustments?.length ?? 0) > 0 ? (
                       <div className="space-y-1">
@@ -5623,6 +5996,7 @@ export function AdminChangeBookingFlow({
                       })}
                     </div>
                   </>
+                  ) : null
                 }
                 firstName={firstName}
                 lastName={lastName}
@@ -5686,16 +6060,49 @@ export function AdminChangeBookingFlow({
                 attributionConfirmLabel={flowUi?.partnerAttributionConfirmLabel}
                 attributionConfirmed={partnerAttributionConfirmed}
                 onAttributionConfirmedChange={setPartnerAttributionConfirmed}
-                lineAmountInputs={showProviderPricingInlineEditor ? providerPricingUi?.lineAmountInputs : undefined}
-                onLineAmountInputChange={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountInputChange : undefined
-                }
-                onLineAmountInputBlur={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountInputBlur : undefined
-                }
-                onLineAmountReset={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountReset : undefined
-                }
+                lineAmountInputs={editableSummaryLineAmountInputs}
+                onLineAmountInputChange={(lineKey, value) => {
+                  const sanitized = value.replace(/[^0-9.-]/g, '');
+                  setEditableSummaryLineAmountInputs((prev) => ({ ...prev, [lineKey]: sanitized }));
+                  if (showProviderPricingInlineEditor) {
+                    providerPricingUi?.onLineAmountInputChange?.(lineKey, sanitized);
+                  }
+                }}
+                onLineAmountInputBlur={(lineKey) => {
+                  setEditableSummaryLineAmountInputs((prev) => {
+                    const raw = prev[lineKey] ?? '';
+                    if (raw.trim() === '' || raw === '-' || raw === '.'
+                      || raw === '-.') {
+                      return prev;
+                    }
+                    const parsed = Number(raw);
+                    if (!Number.isFinite(parsed)) return prev;
+                    const normalized = roundMoney(parsed).toFixed(2);
+                    if (normalized === raw) return prev;
+                    return { ...prev, [lineKey]: normalized };
+                  });
+                  if (showProviderPricingInlineEditor) {
+                    providerPricingUi?.onLineAmountInputBlur?.(lineKey);
+                  }
+                }}
+                onLineAmountReset={(lineKey) => {
+                  const original = checkoutPriceSummaryLinesForCheckout.find(
+                    (line, index) => getEditableSummaryLineKey(line, index) === lineKey
+                  );
+                  if (!original) return;
+                  const nextValue =
+                    original.kind === 'ticket'
+                      ? String(roundMoney(original.itemTotal))
+                      : String(roundMoney(original.amount));
+                  setEditableSummaryLineAmountInputs((prev) => ({ ...prev, [lineKey]: nextValue }));
+                  if (showProviderPricingInlineEditor) {
+                    providerPricingUi?.onLineAmountReset?.(lineKey);
+                  }
+                }}
+                lineLabelInputs={editableSummaryLineLabelInputs}
+                onLineLabelInputChange={(lineKey, value) => {
+                  setEditableSummaryLineLabelInputs((prev) => ({ ...prev, [lineKey]: value }));
+                }}
               />
             </>
           )}

package/src/components/booking/CheckoutForm.tsx

@@ -32,6 +32,9 @@ interface CheckoutFormProps {
   onLineAmountInputChange?: (lineKey: string, value: string) => void;
   onLineAmountInputBlur?: (lineKey: string) => void;
   onLineAmountReset?: (lineKey: string) => void;
+  /** Optional map + handler for inline editable labels in PriceSummary. */
+  lineLabelInputs?: Record<string, string>;
+  onLineLabelInputChange?: (lineKey: string, value: string) => void;
   extraBeforeSubtotal?: ReactNode;
   // Promo (passed as extraBetweenTaxAndTotal content - we'll keep it in parent for now)
   // Contact info
@@ -95,6 +98,8 @@ export function CheckoutForm({
   onLineAmountInputChange,
   onLineAmountInputBlur,
   onLineAmountReset,
+  lineLabelInputs,
+  onLineLabelInputChange,
   extraBeforeSubtotal,
   firstName,
   lastName,
@@ -146,6 +151,7 @@ export function CheckoutForm({
       <div className={styles.summaryWrapper}>
         {replacePriceSummary ? (
           <>
+            {extraBeforeSubtotal ? <div className="mb-4 min-w-0">{extraBeforeSubtotal}</div> : null}
             {replacePriceSummary}
             <div className="mt-4">{extraBetweenTaxAndTotal}</div>
           </>
@@ -167,6 +173,8 @@ export function CheckoutForm({
             onLineAmountInputChange={onLineAmountInputChange}
             onLineAmountInputBlur={onLineAmountInputBlur}
             onLineAmountReset={onLineAmountReset}
+            lineLabelInputs={lineLabelInputs}
+            onLineLabelInputChange={onLineLabelInputChange}
             extraBeforeSubtotal={extraBeforeSubtotal}
           />
         )}

package/src/components/booking/PriceBreakdown.tsx

@@ -20,6 +20,8 @@ export interface PriceBreakdownProps {
   onEditableChange?: (value: string) => void;
   onEditableBlur?: () => void;
   onEditableReset?: () => void;
+  editableLabelValue?: string;
+  onEditableLabelChange?: (value: string) => void;
 }
 
 /**
@@ -65,6 +67,8 @@ export function PriceBreakdown({
   onEditableChange,
   onEditableBlur,
   onEditableReset,
+  editableLabelValue,
+  onEditableLabelChange,
 }: PriceBreakdownProps) {
   const [showTooltip, setShowTooltip] = useState(false);
   const { t } = useTranslations();
@@ -81,9 +85,19 @@ export function PriceBreakdown({
   if (!breakdown) {
     return (
       <div className="flex items-center justify-between">
-        <span className="text-sm text-stone-600">
-          {category} {qty > 1 ? `× ${qty}` : ''}
-        </span>
+        {editable && onEditableLabelChange ? (
+          <input
+            type="text"
+            className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+            value={editableLabelValue ?? category}
+            onChange={(e) => onEditableLabelChange(e.target.value)}
+            aria-label={`Edit ${category} label`}
+          />
+        ) : (
+          <span className="text-sm text-stone-600">
+            {category} {qty > 1 ? `× ${qty}` : ''}
+          </span>
+        )}
         {editable && onEditableChange ? (
           <div className="flex items-center gap-1">
             {onEditableReset ? (
@@ -118,9 +132,19 @@ export function PriceBreakdown({
 
   return (
     <div className="flex items-center justify-between gap-3 min-w-0">
-      <span className="text-sm text-stone-600 min-w-0 truncate">
-        {category} {qty > 1 ? `× ${qty}` : ''}
-      </span>
+      {editable && onEditableLabelChange ? (
+        <input
+          type="text"
+          className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+          value={editableLabelValue ?? category}
+          onChange={(e) => onEditableLabelChange(e.target.value)}
+          aria-label={`Edit ${category} label`}
+        />
+      ) : (
+        <span className="text-sm text-stone-600 min-w-0 truncate">
+          {category} {qty > 1 ? `× ${qty}` : ''}
+        </span>
+      )}
       <div className="relative flex-shrink-0 whitespace-nowrap">
         {editable && onEditableChange ? (
           <div className="flex items-center gap-1">

package/src/components/booking/PriceSummary.tsx

@@ -73,8 +73,12 @@ export interface PriceSummaryProps {
   extraAfterTotal?: ReactNode;
   /** Optional map of editable line input values by line key. */
   lineAmountInputs?: Record<string, string>;
+  /** Optional map of editable line label values by line key. */
+  lineLabelInputs?: Record<string, string>;
   /** Optional change handler for inline editable line amounts. */
   onLineAmountInputChange?: (lineKey: string, value: string) => void;
+  /** Optional change handler for inline editable line labels. */
+  onLineLabelInputChange?: (lineKey: string, value: string) => void;
   /** Optional blur handler for enforcing display format (e.g. 2 decimals). */
   onLineAmountInputBlur?: (lineKey: string) => void;
   /** Optional reset handler for inline editable line amounts. */
@@ -134,7 +138,9 @@ export function PriceSummary({
   totalLabel,
   extraAfterTotal,
   lineAmountInputs,
+  lineLabelInputs,
   onLineAmountInputChange,
+  onLineLabelInputChange,
   onLineAmountInputBlur,
   onLineAmountReset,
 }: PriceSummaryProps) {
@@ -161,6 +167,7 @@ export function PriceSummary({
   return (
     <div className={`space-y-2 min-w-0 ${className}`}>
       {lines.map((row, index) => {
+        const isBeforeSubtotalBoundary = firstTaxLineIndex < 0 || index < firstTaxLineIndex;
         if (row.kind === 'ticket') {
           return (
             <PriceBreakdown
@@ -171,23 +178,29 @@ export function PriceSummary({
               breakdown={row.breakdown ?? null}
               currency={currency}
               locale={locale}
-              editable={row.editable}
+              editable={Boolean(row.editable && isBeforeSubtotalBoundary)}
               editableValue={row.lineKey ? lineAmountInputs?.[row.lineKey] : undefined}
               onEditableChange={
-                row.editable && row.lineKey && onLineAmountInputChange
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountInputChange
                   ? (value) => onLineAmountInputChange(row.lineKey!, value)
                   : undefined
               }
               onEditableBlur={
-                row.editable && row.lineKey && onLineAmountInputBlur
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountInputBlur
                   ? () => onLineAmountInputBlur(row.lineKey!)
                   : undefined
               }
               onEditableReset={
-                row.editable && row.lineKey && onLineAmountReset
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountReset
                   ? () => onLineAmountReset(row.lineKey!)
                   : undefined
               }
+              editableLabelValue={row.lineKey ? lineLabelInputs?.[row.lineKey] : undefined}
+              onEditableLabelChange={
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineLabelInputChange
+                  ? (value) => onLineLabelInputChange(row.lineKey!, value)
+                  : undefined
+              }
             />
           );
         }
@@ -209,10 +222,20 @@ export function PriceSummary({
             )}
             <div className={`flex justify-between gap-3 min-w-0 ${textSize}`}>
               <span className="text-stone-600 min-w-0 flex items-center gap-1">
-                <span className="min-w-0 truncate">
-                  {label}
-                  {type === 'TICKET' && quantity != null && quantity > 1 ? ` (x${quantity})` : ''}
-                </span>
+                {editable && isBeforeSubtotalBoundary && lineKey && onLineLabelInputChange ? (
+                  <input
+                    type="text"
+                    className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+                    value={lineLabelInputs?.[lineKey] ?? label}
+                    onChange={(e) => onLineLabelInputChange(lineKey, e.target.value)}
+                    aria-label={`Edit ${label} label`}
+                  />
+                ) : (
+                  <span className="min-w-0 truncate">
+                    {label}
+                    {type === 'TICKET' && quantity != null && quantity > 1 ? ` (x${quantity})` : ''}
+                  </span>
+                )}
                 {tooltip && <InfoTooltip text={tooltip} />}
               </span>
               {editable && lineKey && onLineAmountInputChange ? (

package/src/components/booking/booking-flow-ui.ts

@@ -65,6 +65,11 @@ export interface BookingFlowUiOptions {
   itineraryStickyTopOffsetPx?: number;
   /** Provider dashboard change flow: quote/override panel shown immediately before confirm CTA. */
   providerDashboardChangePricingUi?: ProviderDashboardChangePricingUi;
+  /**
+   * Admin/provider-dashboard change flow: when true, use the admin FE-authoritative quote API.
+   * This is a rollout flag; public self-serve must stay on the existing public quote endpoint.
+   */
+  adminFeAuthoritativeQuoteEnabled?: boolean;
 }
 
 /**

package/src/lib/booking/change-flow-pricing.ts

@@ -178,16 +178,16 @@ export function resolveChangeFlowNewBookingTotal(input: {
 
 /**
  * Product: **What the customer owes** for the difference is `max(0, newTotal − oldReceipt)`.
- * **Provider dashboard** may show a signed delta (credits/refunds as negative).
+ * **Provider dashboard** and **admin change booking** may show a signed delta (refund owed as negative).
  */
 export function changeFlowBalanceVsOriginal(input: {
   newTotal: number;
   originalReceiptTotal: number;
-  /** `customer` = self-serve & admin change; `provider` = provider inline editor (can owe the guest). */
-  audience: 'customer' | 'provider';
+  /** `customer` = self-serve change only; `provider` | `admin` = signed newTotal − original receipt total. */
+  audience: 'customer' | 'provider' | 'admin';
 }): number {
   const delta = input.newTotal - input.originalReceiptTotal;
-  return input.audience === 'provider' ? delta : Math.max(0, delta);
+  return input.audience === 'customer' ? Math.max(0, delta) : delta;
 }
 
 /**
@@ -255,8 +255,13 @@ export function sliceChangeQuoteForUi(
   fallbackCart: { total: number; subtotal: number; tax: number },
   currencyFallback: string
 ): ChangeQuoteUiSlice {
+  /** Staff JWT on quote: signed new − previous (refund owed negative). Otherwise same as legacy nonnegative amount-due. */
   const priceDiff =
-    quote.amountDueCents != null ? quote.amountDueCents / 100 : quote.priceDiff ?? 0;
+    quote.balanceDeltaMajorUnits != null
+      ? quote.balanceDeltaMajorUnits
+      : quote.amountDueCents != null
+        ? quote.amountDueCents / 100
+        : quote.priceDiff ?? 0;
   const serverDisplay = serverTotalsFromChangeQuoteResponse(quote, fallbackCart);
   return {
     priceDiff,

package/src/lib/booking-api.ts

@@ -870,6 +870,30 @@ export interface ChangeBookingQuoteRequest {
   } | null;
 }
 
+/** FE-authored receipt payload for admin quote path (major units, booking currency). */
+export interface AdminFeAuthoritativeReceipt {
+  subtotal: number;
+  tax: number;
+  total: number;
+  currency?: string;
+  lineItems: Array<{
+    label?: string;
+    amount?: number;
+    type?: string;
+    quantity?: number;
+  }>;
+}
+
+/**
+ * Admin quote path where FE is authoritative for receipt lines/totals.
+ * Mirrors {@link ChangeBookingQuoteRequest} selection fields and adds a full receipt payload.
+ */
+export interface AdminChangeBookingQuoteRequest extends ChangeBookingQuoteRequest {
+  feReceipt: AdminFeAuthoritativeReceipt;
+  /** Optional explicit signed delta shown by FE (new total − original total), major units. */
+  feAmountDueMajorUnits?: number;
+}
+
 export interface ChangeBookingQuoteReceipt {
   subtotal?: number;
   tax?: number;
@@ -987,6 +1011,11 @@ export interface ChangeBookingQuoteResponse {
   originalReceipt?: ChangeBookingQuoteReceipt;
   newReceipt?: ChangeBookingQuoteReceipt;
   priceDiff: number;
+  /**
+   * Present when the quote was requested with a **staff** JWT: signed (new total − previous receipt total) in major units.
+   * Negative = refund owed to the guest. Omitted for unauthenticated / customer-only quotes.
+   */
+  balanceDeltaMajorUnits?: number;
   currency?: string;
   canProceed?: boolean;
   reasonIfBlocked?: string;
@@ -1103,6 +1132,31 @@ export async function quoteChangeBooking(
     data) as ChangeBookingQuoteResponse;
 }
 
+/** Admin-only quote endpoint: FE-authored receipt totals + line items are authoritative. */
+export async function quoteChangeBookingAdminFeReceipt(
+  request: AdminChangeBookingQuoteRequest
+): Promise<ChangeBookingQuoteResponse> {
+  const { bookingReference, lastName, ...payload } = request;
+  const res = await fetch(
+    `${API_BASE}/1/admin/bookings/${encodeURIComponent(bookingReference)}/change/quote?lastName=${encodeURIComponent(lastName)}`,
+    {
+      method: 'POST',
+      headers: getAuthHeaders(),
+      body: JSON.stringify(payload),
+    }
+  );
+  if (!res.ok) {
+    const err = await parseJsonSafely(res);
+    const message = isApiErrorPayload(err)
+      ? err.errorMessage || err.error || 'Failed to quote admin booking change'
+      : 'Failed to quote admin booking change';
+    throw new Error(message);
+  }
+  const data = await parseJsonSafely(res);
+  return ((data as { data?: ChangeBookingQuoteResponse } | null)?.data ??
+    data) as ChangeBookingQuoteResponse;
+}
+
 export async function createChangeBookingPaymentIntent(
   changeIntentId: string
 ): Promise<CreateChangePaymentIntentResponse> {