Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Overview
Customers
Products and Prices
Tax Rates
Customer portal
Quotes
Start with a use case
Subscriptions with Checkout
Fixed-price subscriptions with Elements
Metered billing with Elements
Per-seat billing with Elements
Manage subscriptions
How subscriptions work
Subscription webhooks
Change subscriptions
Strong Customer Authentication (SCA)
Improved tax support
Invoices API updates
Migrating to Prices
Additional features
Testing
Add payment methods
Bacs Direct Debit in the UK
BECS Direct Debit in Australia
SEPA Direct Debit in the EU
Invoice customers
How invoices work
Create an invoice
Customize invoices
Hosted invoice page
Additional features
Account tax IDs
Automated reconciliation
Automatic collection and dunning
Charging automatically
Credit notes
Pay by mailed check
Sending invoices to customers
Subscription invoices
Tax rates on invoices
Types of Tax IDs on invoices
Revenue recognition
Overview
Reports
Methodology
Examples
Overrides
Testing
billing
·
HomePaymentsSubscriptions and invoicesAdditional features

Tax rates on invoices

Assign tax rates to draft invoices to have Stripe calculate tax amounts for you.

You can assign tax rates:

  • On individual invoice-items (recommended).
  • On the entire invoice’s subtotal.

You need to create tax rates before you can use them on invoices. See creating tax rates for instructions.

Recommended: Setting tax rates on individual items

If creating an invoice through the Dashboard, assign tax rates to individual line items. When modifying or creating invoice line items through the API, set the invoice item’s tax_rates:

Terminal
curl https://api.stripe.com/v1/invoiceitems/ii_CWYWo9Ham19N4a \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "tax_rates[0]"="txr_1EO66sClCIKljWvs98IiVfHW" \ -d "tax_rates[1]"="txr_1EEOvcClCIKljWvsqYb9U0MB"

Old API versions

2018-05-21 API version and earlier: pass unique_line_item_id instead of the item’s id field. Pass the id field that starts with sli_.

You can add as many as five tax rates to each line item.

For type subscription or invoiceitem, use the line item id. For type=invoiceitem, you can also use the value of invoice_item.

Setting default tax rates for the entire invoice

If you sell one type of product, or have simple tax needs, you can set a default tax rate on the invoice. Default tax rates apply to all line items on the invoice. For more complex use cases, you can also set an item level tax rate that overrides the default tax rate.

If creating an invoice through the Dashboard, assign default tax rates to apply to the invoice.

Set the invoice’s default tax rates through the API:

Terminal
curl https://api.stripe.com/v1/invoices/in_18jwqyLlRB0eXbMtrUQ97YBw \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "default_tax_rates[0]"="txr_1EO66sClCIKljWvs98IiVfHW" \ -d "default_tax_rates[1]"="txr_1EEOvcClCIKljWvsqYb9U0MB"

You can add as many as five default tax rates to each invoice.

Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Recommended: Setting tax rates on individual items
Setting default tax rates for the entire invoice