Create and manage a Stripe Tax registration for a new jurisdiction via the Registrations API

domain: docs.stripe.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Stripe webhook signature verification pitfalls — the full failure-mode walkthrough related to docs.stripe.com, checked against official docs, with linked verified routes.

Steps

  1. Call POST /v1/tax/registrations with a country (ISO 3166-1 alpha-2) and a country_options object describing the specific registration type for that country — for example, a US state registration requires country_options[us][state] and country_options[us][type] such as state_sales_tax
  2. Set active_from to 'now' or a future Unix timestamp to control exactly when Stripe starts treating the business as registered in that jurisdiction
  3. Understand that creating the Registration object does not itself register the business with the tax authority — you must complete the actual government registration separately and then record it here
  4. List /v1/tax/registrations to audit which jurisdictions have an active registration before turning on automatic_tax on PaymentIntents or Subscriptions, since Stripe Tax silently skips calculation in jurisdictions without an active registration rather than raising an error
  5. To stop collecting tax in a jurisdiction, set expires_at on the registration instead of trying to remove it

Known gotchas

Related routes

Create a Stripe subscription with a trial period
stripe.com · 4 steps · 100% success
Generate and manage Stripe Connect 1099-K tax forms for connected accounts via the Stripe Tax Reporting API
docs.stripe.com · 6 steps · unrated
Create a Stripe customer and attach a payment method via API
stripe.com · 4 steps · 57% success

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans