@develemit/commerce-server 0.8.0 → 0.9.0

package/docs/payments.md

@@ -58,6 +58,43 @@ buyer is charged the undiscounted price while the order records the discount.
 `duration: 'once'`, `max_redemptions: 1`) and passes it in `discounts`.
 `createFakeGateway` records the discount on `sessions`.
 
+## Sales tax (Stripe Tax)
+
+Pass `tax` to `createStripeGateway` (or `resolvePayment(env, { tax })`):
+
+```ts
+createStripeGateway({
+  secretKey,
+  webhookSecret,
+  tax: {
+    enabled: true,
+    behavior: 'exclusive',
+    shippingTaxCode: 'txcd_92010001',
+  },
+});
+```
+
+With tax on, Checkout Sessions get `automatic_tax: { enabled: true }` and a
+`tax_behavior` (`exclusive` by default; `inclusive` for VAT-style prices) on
+every line and shipping option. A `CheckoutLine.taxCode` is sent as the
+product's `tax_code`. The completed-session webhook stores
+`total_details.amount_tax` as the order's `taxCents`; `shippingCents` stays
+pre-tax, so `subtotal - discount + shipping + tax = total`. The discount
+applies before tax. Without the option, sessions are exactly as before.
+
+A product can carry an optional `taxCode` (a Stripe tax code such as
+`txcd_20010000`, see [Stripe's list](https://docs.stripe.com/tax/tax-categories)),
+set through the admin API (`taxCode` on create and patch, `null` clears it) and
+shown in `AdminProductFlow` when the host passes `taxCodes`. Checkout puts it on
+that line; products without one use the account's default tax code. The public
+catalog never exposes it. Migration `0011` adds `commerce_products.tax_code`.
+
+The host sets up Stripe Tax in the Stripe dashboard (origin address and tax
+registrations); the kit does neither.
+
+For local checkout, `createFakeGateway({ tax: { rate: 0.0825 } })` taxes
+merchandise less discount plus shipping, and `devCheckout` records it.
+
 ## Manual Stripe test-mode purchase
 
 Uses the playground apps in this repo and a Stripe account in test mode.

package/migrations/0010_order_tax.sql

@@ -0,0 +1 @@
+ALTER TABLE "commerce_orders" ADD COLUMN "tax_cents" integer DEFAULT 0 NOT NULL;

package/migrations/0011_product_tax_code.sql

@@ -0,0 +1 @@
+ALTER TABLE "commerce_products" ADD COLUMN "tax_code" text;