CheckoutPreviewResult
Side-effect-free preview used by checkout UIs to show line totals as the customer types a discount code or gift-card code, before committing to purchase. Pricing rules apply first, the discount code subtracts, then tax is computed on the post-discount line; the gift card covers the resulting tax-inclusive total up to its balanceRemaining. The customer pays amountDueCents via Stripe.
Fields
subtotalInt!discountCentsInt!taxCentsInt!Sales tax computed on the post-discount line. Zero when the business has tax collection disabled or the line is exempt.
totalInt!Post-discount, tax-inclusive line total — subtotal − discountCents + taxCents. This is the amount the gift card is applied against and that the buyer owes in total (split between gift card and Stripe).
taxCalculationIdStringStripe Tax calculation reference (taxcalc_…) that callers should pass back into purchaseProduct / registerForActivity so the numbers the buyer saw on the preview are the ones charged. Null when no tax was computed.
giftCardCreditCentsInt!amountDueCentsInt!buyerAddressRequiredBoolean!Whether the buyer's own address is the only thing that can locate this line for tax, and so must be collected before checkout.
Almost always false. An in-person activity is taxed where it is delivered (the session's location), and every other line falls back to the seller's registered tax origin. This flips true only when the seller collects tax, the line is not exempt, and neither of those fallbacks exists — the one case where a missing country turns a quote into an error. Checkout UIs should use it to decide whether to ask for an address at all, rather than asking every buyer unconditionally.
errors[OperationError!]!