# Simplified Stripe Tax API

Attach tax calculations to PaymentIntents for automatic tax transaction management.

With the simplified integration, you link a tax calculation to a PaymentIntent and Stripe automatically manages tax transactions and reversals in the payment lifecycle.
A diagram providing a high level overview of the tax api integration outlined in this doc (See full diagram at https://docs.stripe.com/tax/payment-intent/simplified)
## Link tax calculation to the PaymentIntent

[Create or modify a PaymentIntent](https://docs.stripe.com/payments/quickstart.md) to include the Tax `Calculation` ID and set the `amount` to `tax_calculation.amount_total` from the [Tax Calculation](https://docs.stripe.com/api/tax/calculations/object.md) response.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1082 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true" \
  -d "hooks[inputs][tax][calculation]={{TAXCALCULATION_ID}}"
```

### Supported endpoints

The following endpoints support setting a calculation on a PaymentIntent.

- Create: [/v1/payment_intents](https://docs.stripe.com/api/payment_intents/create.md)
- Update: [/v1/payment_intents/:id](https://docs.stripe.com/api/payment_intents/update.md)
- Confirm: [/v1/payment_intents/:id/confirm](https://docs.stripe.com/api/payment_intents/confirm.md)
- Capture: [/v1/payment_intents/:id/capture](https://docs.stripe.com/api/payment_intents/capture.md)

### Limitations

- You can only link new calculations to a PaymentIntent until it transitions to a `succeeded` state.
- A tax calculation can transition to only one tax `Transaction`. If multiple PaymentIntents transition to a `succeeded` state with the same linked calculation, accounting reflects only the first one.

## 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 [flat amount](https://docs.stripe.com/tax/payment-intent/custom.md#reversals-partial-flat-amount) 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:

- Recalculate tax based on PaymentIntent changes
- 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 PaymentIntent created using that connected account.

> You can’t use destination charges if you create the tax calculation on a connected account and the PaymentIntent on the platform account. Create the tax calculation and the PaymentIntent on the same account.

## Optional: Retrieve automatically committed tax transactions

Use the [/v1/tax/associations/find](https://docs.stripe.com/api/tax/associations/find.md) endpoint to retrieve information about the tax transactions that Stripe created (or failed to create) for a PaymentIntent. This allows you to verify that your integration works as intended, handle card dispute cases, or review what was created automatically.

```curl
curl -G https://api.stripe.com/v1/tax/associations/find \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "payment_intent={{PAYMENTINTENT_ID}}"
```

If your PaymentIntent succeeds and is refunded afterwards, you might receive the following response.

> The Tax reversals are only recorded and appear in the Tax Association object after several minutes.

```json
// TaxAssociation find response
{
  "id": "taxa_1PXmsbE5ebw4kUHWxtSTF08x",
  "object": "tax.association",
  "calculation": "taxcalc_1PXmsRE5ebw4kUHW9SOln70o",
  "payment_intent": "pi_1PXmsSE5ebw4kUHWK7FIhQlS",
  "tax_transaction_attempts": [
    {
      "source": "pi_1PXmsSE5ebw4kUHWK7FIhQlS",
      "status": "committed",
      "committed": {"transaction": "tax_1PXmsRE5ebw4kUHWLyVEiMis",
      }
    },
    {
      "source": "re_1PXmsSE5ebw4kUHWK7FIhQlS",
      "status": "committed",
      "committed": {"transaction": "tax_1PXmsgE5ebw4kUHW7Gg8jvpX",
      }
    }
  ]
}
```

## See also

- [Stripe Tax with PaymentIntents](https://docs.stripe.com/tax/payment-intent.md)
- [Custom Stripe Tax API](https://docs.stripe.com/tax/payment-intent/custom.md)
- [Reporting and filing](https://docs.stripe.com/tax/reports.md)
- [Use Stripe Tax with Connect](https://docs.stripe.com/tax/connect.md)