Sales-tax collection configuration for a business. Local switches (enabled, display mode, default code, origin) live in our database; per-jurisdiction registrations live on the connected Stripe account and are surfaced through registrations.
Fields
enabledBoolean!Effective master toggle. False unless the saved tax switch is on and payments onboarding has been submitted; when false, the rest of this object is informational only — checkout flows skip all tax computation and behave as if the feature didn't exist.
displayModeTaxDisplayMode!defaultTaxCodeStringDefault Stripe tax code (e.g. txcd_10000000) applied to items that don't override it. Null means use Stripe Tax's product-type default.
suggestedDefaultTaxCodeStringServer's suggestion for defaultTaxCode derived from the business's declared activity structures and types (e.g. recreational services for class/league/session/booking). Surfaced as a hint in the UI; the server never auto-applies it.
originLocationLocationOrigin location used as ship_from_details when calculating tax. When null at calculation time, the helper falls back to the first available business location.
registrations[BusinessTaxRegistration!]!Active and scheduled tax registrations on the connected Stripe account. Listed in activeFrom order (oldest first). Empty when Stripe is not yet connected. Returns the empty list on Stripe API error rather than failing the query.