Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Invoicing
Usage-based billing
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Test your integration
Tax
Overview
Use Stripe tax
    How Tax works
    Set up collection
    Configure behaviour
    Testing
    Find your payment type
    Find your business type
      Connect
      Ticket sales
        Integration guide
      Physical goods
      Custom integration
    Supported countries
Manage compliance
Reporting
Overview
Select a report
Configure reports
Reports API
Reports for multiple accounts
Revenue recognition
Data
OverviewSchema
Custom reports
Data Pipeline
Data management
HomeRevenueUse Stripe taxFind your business typeTicket sales

Tax ticket sales based on event locationPrivate preview

Integrate Stripe Tax to calculate taxes on admission fees and tickets.

VAT and sales tax generally apply anywhere you charge admission (for example, tickets to concerts, conferences, museums, or sporting events) based on the event location, not based on the customer’s location. In the US, specific local taxes (such as entertainment or amusement taxes) might apply, in addition to state and local sales tax.

Update the Stripe SDK

This new feature is a private preview feature and requires an update to the newest API version. To upgrade the version of your SDK and API, follow the API upgrade guide and upgrade the library to the latest version. You can inspect the changelog to make sure your changes are backwards-compatible.

If needed, you can access SDK private parameters. You can also use custom requests in any of the following SDKs to call private endpoints related to this feature.

  • Ruby
  • Python
  • PHP
  • Node
  • Java
  • .NET
  • Go

Configure Stripe Tax

When you set up Stripe Tax for tickets, set the default product tax code to txcd_20030000, General - Services. You can’t set any of the event tax codes as the default product tax code.

To add a registration for testing:

  1. From the tax registrations page in the Dashboard, click Add registration.
  2. Add the following recommended registrations:
    1. United States - Colorado, Sales Tax
    2. United States - Colorado, Boulder Admissions Tax

Stripe Tax calculations don’t incur fees in a sandbox environment. After you add a tax registration, calculating tax in live mode incurs a fee.

In most cases, tax calculations are based on the transaction destination, which is usually the customer’s shipping or billing address. However, tax calculations for ticket sales are based on the event location. The following steps describe how to calculate taxes using the event location.

Design your checkout flow

Stripe Tax only supports ticket sales using the Stripe Tax Calculation API. This means that you can integrate only with Payment Elements or directly with the Tax Calculation API. You can’t use other integrations such as Stripe Checkout or Stripe Subscriptions.

Depending on your payment integration, you can choose between two integration paths:

Tax Payment Intent integration (Recommended)Manual Tax Calculation API integration
Advantages
  • Easier to integrate.
  • Automated handling of refunds.
  • Dashboard support, specifically useful for testing.
  • Built-in receipts support.
  • Takes full control of the checkout flow.
  • You can use it with other payment providers such as PayPal.
Disadvantages
  • In public preview.
  • Doesn’t work well with other payment providers such as PayPal.
  • Refunds require more implementation work.
  • Limited Dashboard support; testing is more difficult.
  • Receipts aren’t automatically generated.

Whatever integration you choose, you need to create a tax location and perform a tax calculation. This works the same way for both integration paths.

Using the Tax Location API to create an event location

Each ticket sale requires a tax location you create and save in your database to specify when you calculate the taxes. For this example, create a tax location of type performance, representing the Greenleaf Park, a park in Boulder, Coloardo, in the United States.

Command Line
cURL
No results
curl https://api.stripe.com/v1/tax/locations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.basil" \ -d type=performance \ --data-urlencode "address[line1]"="Folsom and, Pearl St" \ -d "address[city]"=Boulder \ -d "address[state]"=CO \ -d "address[postal_code]"=80302 \ -d "address[country]"=US \ -d description="Greenleaf Park"

The response includes an id field. This is the identifier for the tax location that you can save in your own database.

{ "id": "taxloc_yB7b4tVHRb", // ... other fields omitted }

For example, the database schema could look like the following:

idvenue_namecapacityseatplan…stripe_location_id
…Greenleaf Park500https://stripe.cdn.com/seatplan.png…taxloc_yB7b4tVHRb
………………

Table: your_business.venues

Calculating Tax

To calculate tax for ticket sales, Stripe Tax needs four pieces of information:

  • The location of your business (head office address), provided through the tax settings, which you configured earlier
  • The location of the event (tax location of type performance), created in the previous section
  • The location of the customer (billing address) – this is important because of B2B reverse charges
  • The type of product (ticket, merchandise, and so on), such as txcd_50010001 – Admission to Amusement, Entertainment and Recreation Venues – Participant.

Customer address collection

To collect the customer address, we recommend that you build an address form into your checkout that asks customers for their address with the Address Element. See which address information details are required.

You must verify that the billing address is a valid address for Stripe Tax. To validate the address with Stripe Tax, you can create a tax calculation. However, each calculation in live mode incurs fees, so we recommend performing as much validation as possible directly on your integration.

Before collecting and validating the address, disable the checkout button. After you enter the address and we validate it, you can enable the checkout button and perform a tax calculation. A tax calculation is a “preview” of the taxes that apply.

Types of products

You can find all ticket tax codes on our product tax code reference page, including txcd_50010001, Admission to Amusement, Entertainment and Recreation Venues – Participant.

Calculating taxes with tax locations

You must pass all the required data within the tax calculation API call. In this example, you calculate the taxes for a customer based in Ireland. This customer travels to the United States and buys a ticket for an event at Greenleaf Park in Boulder, Colorado.

Command Line
cURL
No results
curl https://api.stripe.com/v1/tax/calculations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.basil" \ -d currency=usd \ -d "line_items[0][amount]"=2500 \ -d "line_items[0][reference]"="Outdoor concert - L1" \ -d "line_items[0][tax_behavior]"=exclusive \ -d "line_items[0][tax_code]"=txcd_50010001 \ -d "line_items[0][performance_location]"=taxloc_yB7b4tVHRb \ -d "customer_details[address][country]"=IE \ -d "customer_details[address_source]"=billing

If the calculation endpoint returns a customer_tax_location_invalid error code, prompt your customer to check the address they entered for accuracy and completeness.

Understanding the calculation result and connecting it to a payment

The calculation API call calculates the taxes at the tax location of the event. In this case, the Greenleaf Park in Boulder, Colorado.

You can use the top-level tax breakdown to display all the taxes that are charged. In this case, the response looks similar to the following:

{ "id": "taxcalc_fQSaHNaU", "amount_total": 2697, // ... other fields omitted "tax_breakdown": [ // ... other entries omitted { "amount": 125, "inclusive": false, "tax_rate_details": { // ... other entries omitted "country": "US", "state": "CO", "percentage_decimal": "5.0", // This is just an example. The Stripe Tax calculation API returns the correct tax rate. "tax_type": "admissions_tax" }, "taxability_reason": "standard_rated", "taxable_amount": 2500 } ] }

The calculation object contains an ID. Each time one of the four input parameters (business location, customer address, event location, or product type) changes, you must perform a new calculation.

You save the latest calculation ID to commit a tax transaction later. You need this for compliant reporting.

Your checkout interface can display the taxes as a preview similar to the following example based on the tax_breakdown object of the response of the Tax Calculation API call.

2025 college football Rose Bowl Game on Mon, 1 Jan 2025 at Rose Bowl

Checkout preview lineAmount
Total Face Value25 USD
Sales Tax (2.90%)0.72 USD
Admission Tax (5.0%)1.25 USD
Sub Total26.97 USD

Create a payment

The payment is created with the amount_total from the tax calculation.

After the payment succeeds, you can create a tax transaction. Use this record for reporting and compliance.

With the Tax Payment Intent integration, you need to use the Payment Intents API. By defining the hooks field, you can pass the tax calculation ID to the payment intent.

This creates a payment intent and then creates a tax transaction in the background.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-05-28.preview" \ -d amount=2697 \ -d currency=usd \ -d "automatic_payment_methods[enabled]"=true \ -d "hooks[inputs][tax][calculation]"=
{{CALCULATION_ID}}

You can learn more about the Tax Payment Intent integration in the Tax Payment Intent integration guide.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access programme.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc