TaxSettings

Source: src/Stripe/TaxSettings.ts

Account-level Stripe Tax Settings — default tax behavior, default tax code, and head-office address used by Stripe Tax calculations.

This is an account singleton: GET /v1/tax/settings always returns the merchant’s settings, and POST /v1/tax/settings updates them in place. There is no create or hard-delete. The first reconcile captures the pre-management snapshot (initialSettings); destroy posts that snapshot back. Stripe will not unset a field once it has been set, so a null original is left as-is on restore.

The Tax Settings object has no metadata. Alchemy does not stamp ownership keys.

Configuring defaults

Exclusive default tax behavior

const settings = yield* Stripe.TaxSettings("tax", {
  defaults: { taxBehavior: "exclusive" },
});

Default tax code

const settings = yield* Stripe.TaxSettings("tax", {
  defaults: {
    taxBehavior: "exclusive",
    taxCode: "txcd_99999999",
  },
});

Head office

const settings = yield* Stripe.TaxSettings("tax", {
  headOffice: {
    address: { country: "US", state: "CA" },
  },
});

Restoring on destroy

// stack.destroy() posts `initialSettings` back (fields Stripe allows)
const settings = yield* Stripe.TaxSettings("tax", {
  defaults: { taxBehavior: "inclusive" },
});