Stripe "amount_tax_display" inclusive vs exclusive on invoice PDFs

TL;DR

amounttaxdisplay controls presentation only: whether the Stripe invoice PDF shows line amounts with tax included or excluded. It does not change the tax computed; taxbehavior on the price does that. Set the display to match local convention and your taxbehavior so the PDF is internally consistent: inclusive display with inclusive behavior for VAT regions, exclusive display with exclusive behavior for US sales tax. A mismatch (exclusive computation shown as inclusive) is the classic source of 'your invoice math is wrong' tickets.

The query

Stripe "amount_tax_display" inclusive vs exclusive on invoice PDFs

Use this when

• Invoice PDF totals confusing customers about tax
• Matching PDF display to VAT-inclusive pricing
• amounttaxdisplay setting on Stripe invoices

Not for

• Changing how much tax is charged (use tax_behavior and tax rates)
• Email receipt formatting (separate template)

Steps

1. Confirm the tax_behavior on your prices first: inclusive or exclusive.

Expected output: The computation convention is established.

1. Set amounttaxdisplay to match that convention on the invoice settings.

Expected output: Display and computation agree.

1. Generate a sample PDF and walk the line items: base, tax, total.

Expected output: The PDF reads correctly to a customer in that market.

1. Check both a VAT-region and a US-style customer if you serve both.

Expected output: Each market's PDF follows its convention.

1. Document the pairing in your billing setup notes.

Expected output: Nobody flips one without the other later.

Variant phrasings

Stripe amounttaxdisplay inclusive exclusive

invoice PDF shows tax included Stripe

Stripe tax display on invoice PDF

Root cause

Stripe separates computation (taxbehavior) from presentation (amounttax_display) because the same computed tax can be legally displayed either way depending on jurisdiction. The bug class is display disagreeing with computation, which reads as wrong math even though the money is right.

Edge cases

• The display setting can be overridden per invoice; prefer account or customer defaults
• Credit notes mirror the invoice's display; check them too

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_Oz0501ii60Pbbppk1tbOYA