Billflare Tax Pack

Stripe Tax on Checkout → webhook mirrors tax into D1 · v1.0.0

Stripe secret keyset

Webhook signing secretset

Admin secretset

automatic_taxenabled

Tax ID collectionon

Customers (D1)1

Subscriptions (D1)0

Tax invoices (D1)0

How tax is calculated (test mode)

Checkout collects a billing address. Stripe Tax applies rates for jurisdictions where you have active tax registrations in the Dashboard. Without a registration for the customer's location, tax is often 0 — that is expected. Use Stripe's test addresses after enabling Tax + a registration (e.g. a US state or EU country).

Try it Billing email

Results appear here.

Endpoints

POST /api/checkout — subscription Checkout with automatic_tax.enabled + billing address + optional tax IDs
GET /api/tax?email= — entitlement + tax invoice snapshots
POST /api/portal — Billing Portal session
POST /api/webhook — SubtleCrypto; checkout + subscription + invoice.paid|finalized
GET /api/health — JSON health (secret flags only)
GET /api/admin/tax — recent tax rows (X-Admin-Secret)

Buyers enable Stripe Tax + registrations in the Dashboard — this kit wires Checkout and D1. Add-on to the Billflare spine.