twimco.Let’s talk ↗︎
Menu
Field notes / Commerce

The quote is not the charge until you prove it.

The buyer agreed to a total. Then the payment capture came out different, or the invoice did, or both. Nobody lied. Three systems each told a local truth, and those numbers are worth lining up before the cart is allowed to go out.

Editorial illustration for Field Note: The quote is not the charge until you prove it.

Before a cart or invoice can go out, fill a TWIMCO Quote-to-Charge Truth Card: price, tax, shipping, and fees as shown, beside what payment and the invoice will charge. If a line does not match, freeze that quote. Do not ship the cart on a number you have not reconciled. The card is a check, not a revenue metric.

The number on the screen is a claim

A buyer sees a total. It includes a price, a tax, a shipping charge, a fee, or some arrangement of those. They agree. Later the payment capture is different, or the invoice is different, or both are different from each other. Nobody lied in the meeting where the page was designed. Three systems each told a local truth, and the buyer met only one of them.

Quote-to-charge truth is the dull habit of putting those numbers on one card before the cart, the invoice, or the payment request is allowed to leave. It is not a catalog scorecard, which asks whether the listing’s claims about the thing are fair. It is not a campaign promise diff, which asks whether marketing said something the operation cannot keep. This card asks a narrower question: for this quote, do the amounts the buyer was shown match the amounts money systems will use?

This note is the TWIMCO Quote-to-Charge Truth Card. One card per quote type you actually send: a marketplace checkout, an invoice after an auction, a revised shipping quote, a fee schedule applied at pay time. It does not report a mismatch rate. You either filled the lines from the systems in front of you, or you marked a line unknown. Unknown does not ship.

TWIMCO built Paddle8’s fine-art auction house and marketplace, where a total can gather a hammer price, fees, and the cost of getting a fragile object somewhere. That is the shape of commerce this card is for. The surface that shows the number is a web application problem when the quote, the payment, and the invoice do not share a single explained total. There is no live calculator on this site for the card. Copy the lines. Do not wait on a path that is not published.

Do the card on a real quote shape from your own operation, with the awkward line included. A demo total made of round numbers will match too easily and teach you nothing.

Four lines, two sides, one freeze

The TWIMCO Quote-to-Charge Truth Card has four amount lines. Each line has a shown side and a charged side. Shown means what the buyer can see before they commit. Charged means what the payment system will capture and what the invoice will state. If payment and invoice can diverge, split the charged side into those two columns rather than averaging them in your head.

Price. The merchandise amount, the hammer, the unit price times quantity. Say which discounts are already inside it. A discount that appears only on the invoice fails the line even if the grand total was nudged to match.

Tax. The tax the buyer was shown, and the tax the charge will apply. Include who calculates it. If a vendor calculates tax at capture and your quote calculated it earlier, those are two engines. The card is where you notice they are not the same engine. Do not write “tax applies” as if that were an amount.

Shipping. The shipping or handling the buyer was shown, and the shipping the charge will use. If the real cost can change after the quote because weight, route, or crate choice was estimated, the card says the quote is an estimate and says whether the buyer must re-accept a change. An estimate that can be replaced silently is not a match. It is a permission you have not written down.

Fees. Buyer premiums, service fees, payment surcharges, duties you present as fees. List them. A fee that exists only in the processor’s receipt, and not on the quote, fails the line. A fee on the quote that the invoice renames so the buyer cannot recognize it fails the line too, even if the arithmetic lands.

Under the four lines, write the grand total on both sides and the currency. A match hidden by rounding needs a rounding rule on the card: who rounds, at which line, and what the buyer sees. “Close enough” is not a rule.

Identity of the quote. An id that ties the shown version to the charge. If the buyer was shown version two and you charge version three, the card is about version three only after they have seen it. Charging an older shown total against a newer invoice is a miss.

Freeze rule. If any required line is unknown or not equal, this quote does not proceed to payment or to a final invoice. Name the role who may lift the freeze, and what they must attach: a corrected quote the buyer saw, or a written acceptance of the delta. A freeze that anyone can click past is a caption.

You may mark a line not applicable, such as shipping on a pickup, but you write “not applicable” rather than leaving it blank. Blank looks like a match to a hurried reader.

Decision guide

Shown beside charged

ConsiderationWhat the buyer sawWhat will be charged
PriceMerchandise or hammer, with discounts already visible.The same amount on capture and on the invoice, same discounts.
TaxThe tax shown before commit, not a placeholder.The tax the engine will capture, after the real address.
ShippingA final figure, or an estimate labeled as an estimate.The same figure, or a stop for re-acceptance if it changed.
FeesEvery premium or surcharge the buyer could name.Those same fees, recognizable, with one owner for the rate.
Decision framework: assess these lines against one real quote type.
The amount on the screen is a claim until payment and invoice agree with it.

Where the amounts drift without a villain

Most mismatches are ordinary plumbing. These are composites from commerce delivery, not measurements, and not a claim about any house’s error rate.

The quote includes a shipping estimate from one carrier rate, and the label is bought later at another. The buyer’s total already felt final. The card’s shipping line asks whether the later figure needs a new acceptance. If your answer is yes, the product should stop and show the new number. If your answer is no, because the estimate was a ceiling you will eat the difference under, write that policy on the card so the invoice does not surprise either side.

Tax is calculated on a ship-to address the buyer had not finished. The shown tax was a default. The captured tax is the real address. That can be legitimate and still fail the card until the shown side is updated before commit. The freeze exists for this moment, not for a postmortem.

A fee is configured in the payment provider and also in your invoice template, and only one of them was changed when the rate moved. The buyer sees the template. The capture uses the provider. Two owners, one fee. The card’s fee line has a single owner for the rate, even if two systems display it. Dual editors without a precedence rule will drift.

Currency or a minor unit differs. A quote in whole units, a capture in minor units, a display that truncates. The rounding rule is the line that prevents a one-unit argument from becoming a trust argument.

A human reprints the invoice from a different record than the one the buyer approved. The payment is right and the paper is wrong, or the reverse. The identity line is what makes that visible. If the invoice cannot point at the quote id, you do not have truth yet. You have two documents with similar numbers.

None of these needs a dashboard to start. They need one quote walked from the screen the buyer sees to the capture and the invoice, with the four lines written down. If you cannot walk one quote, you are not ready to automate the check. Automation of a walk you have not done will freeze the wrong carts and miss the right ones.

When a line fails, the next step is a correction the buyer can see, not a quiet adjustment in the ledger. Quiet adjustments are how the shown number becomes decorative.

Run the card before the cart is trusted

Use the card at three moments, and do not skip to the third.

First, when you design or buy the checkout or invoicing path. Fill a card from the test quote. If shown and charged live in different systems, write the system names on the card. A vendor demo that only shows a pretty total gets the same discipline as any other demo: open the capture amount and the invoice draft. If they cannot, the charged side is unknown, and unknown fails the freeze rule.

Second, when a rate, a tax engine, a carrier, or a fee changes. The card is redone for the quote types that use the changed line. A change that “only affects the backend” is exactly the change that splits shown from charged. Retire the old card. Do not let two generations of the fee coexist without a date.

Third, when a real quote is disputed. Reconstruct the card from what the buyer was shown and what was captured. You will learn whether you have the records to do that. If you do not, the gap is the product work, not the buyer’s memory.

The role who may lift a freeze should be scarce. Support agents need a path to request a corrected quote. They should not need a path to make the old shown total and the new charge both “fine.” Scarcity of the lift is what keeps the freeze real.

Keep filled cards for the quote types with the release notes or the fee schedule. You are not building an archive of every order unless you already have one. You are keeping the specification of each quote type, plus any dispute reconstruction that taught you a line you had marked not applicable too quickly.

Do not add a tolerance percentage for fun. If your business already has a written tolerance, cite it on the card and say who bears the difference. If you do not, equality is the rule and estimates must be labeled as estimates that require re-acceptance. Inventing a tolerance in the draft will be used, and it will be used on the line you cared about most.

How the work moves

Prove the quote, then release it

  1. Take one quote

    A real shape, including the awkward fee or the estimated ship cost.

  2. Write both sides

    Shown, payment capture, and invoice. Unknown stays unknown.

  3. Freeze a miss

    Any unequal or blank required line stops payment and the final invoice.

  4. Correct in daylight

    The buyer sees the new number, or a named role lifts the freeze with evidence.

  5. Redo on change

    A new fee, tax engine, or carrier path retires the old card.

Illustrative check, not a client screenshot or measured result.

Put this into practice

  1. Pick one quote type a buyer actually sees. Not the happy total in a slide.
  2. Fill the TWIMCO Quote-to-Charge Truth Card: price, tax, shipping, fees, both sides, currency, rounding, quote identity.
  3. Apply the freeze rule. Unknown or unequal does not proceed. Name who may lift it and what corrected evidence they need.
  4. Re-fill the card when a fee, tax engine, or carrier path changes. Walk one real dispute back onto the card to see if the records exist.
  5. If the totals live in a web application that does not yet explain itself to payment and invoice, take the card into that build. Paddle8 is the kind of marketplace where fees and shipping sit on top of a price the buyer already understood. The card is how that understanding survives contact with the charge.

A buyer can accept only the number they were shown. Everything else is a correction you still owe them, or a freeze you should not have lifted.

twimco.

We build alongside the people doing the work.
Bring us the problem you’re thinking about.

Related work

Paddle8 ↗︎