Calculate tax in your custom payment flowsPublic preview

The Stripe Tax API enables you to calculate tax in your custom payment flows. If you use the Payment Intents API, Stripe can submit tax transactions in the payment lifecycle.

Using tax calculations with the Payment Intents API requires the beta SDK versions. Update your SDK before using this feature.

curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d "line_items[0][amount]"=1000 \
  -d "line_items[0][reference]"=L1 \
  -d "line_items[0][tax_code]"=txcd_99999999 \
  -d "customer_details[address][line1]"="920 5th Ave" \
  -d "customer_details[address][city]"=Seattle \
  -d "customer_details[address][state]"=WA \
  -d "customer_details[address][postal_code]"=98104 \
  -d "customer_details[address][country]"=US \
  -d "customer_details[address_source]"=shipping

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.preview" \
  -d amount=1000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d "hooks[inputs][tax][calculation]"=
{{CALCULATION_ID}}

Resulting Stripe actions

If the PaymentIntent is correctly linked to the Tax Calculation object, Stripe automatically:

• Creates a tax transaction from the calculation after the PaymentIntent transitions to a succeeded state
• Performs a tax reversal of a tax transaction for any refunds (created with API or Dashboard) for the PaymentIntent
• Creates a tax reversal for a reversal, if a refund has failed
• Includes the total tax information in PaymentIntent receipts

Stripe won’t:

• Change the PaymentIntent amount based on the linked tax calculation
• Alter the tax transaction amount based on the PaymentIntent captured amount
• Automatically create a tax reversal for disputes

Integrate taxes for your Connect platform with the Stripe Tax and Payment Intents APIs

The Payment Intents API works with connected accounts on your Connect platform. This means that if you calculate tax using a connected account, you can link the tax calculation to a Payment Intent created using that connected account.