# Tax threshold monitoring

Allow connected accounts to track their sales tax thresholds.

The tax threshold monitoring component enables connected accounts to track their potential sales tax collection requirements for payments processed through Stripe. Connected accounts interact with this component by viewing their volume and total amount of sales across all tax locations that Stripe monitors. This component is suitable for [software platforms](https://docs.stripe.com/tax/tax-for-platforms.md), which means that connected accounts are liable to collect taxes.

If you integrate Stripe Tax for your platform, you must collect information about the [registrations with tax authorities](https://docs.stripe.com/tax/registering.md) of connected accounts in the applicable location. Connected accounts need to register with their tax authorities before adding their tax registrations in your platform. To correctly calculate and collect taxes for your platform, you must collect the tax registrations of connected accounts.

More details about how Stripe monitors user obligations are available at [Monitor your obligations](https://docs.stripe.com/tax/monitoring.md). The embedded component differs from the Dashboard and doesn’t include information such as [unattributed revenue](https://docs.stripe.com/tax/monitoring.md#handling-unattributed-revenue).

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

## Requirements

- Your integration must follow the [software platforms guide](https://docs.stripe.com/tax/tax-for-platforms.md) for [Tax on Connect](https://docs.stripe.com/tax/connect.md). This means that connected accounts are liable to collect taxes.
- If you’ve not already done so, render the [Tax settings component](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md) and [Tax registrations component](https://docs.stripe.com/connect/supported-embedded-components/tax-registrations.md). You need both the Tax settings component and the Tax registrations component to provide tax compliance control to connected accounts.

## Integrate the tax threshold monitoring component 

When [creating an Account Session](https://docs.stripe.com/api/account_sessions/create.md), enable tax threshold monitoring by specifying `tax_threshold_monitoring` in the `components` parameter.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[tax_threshold_monitoring][enabled]=true"
```

After creating the account session and [initializing ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), you can render the tax threshold component in the frontend:

#### React

```jsx
// Include this React component
import {
  ConnectTaxThresholdMonitoring,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Threshold Monitoring</h2>
      <ConnectTaxThresholdMonitoring
        // Optional
        // displayCountries={["US", "CA", "DE"]}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| Method                | Type       | Description                                                                                                                                                                                                                                                                         | Default                             |
| --------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| `setDisplayCountries` | `string[]` | Array of [two-letter country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that limit the threshold monitoring locations that the connected account sees [choose from](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options). | undefined (all countries permitted) |

#### React

| React prop         | Type       | Description                                                                                                                                                                                                                                                                         | Default                             | Required or optional |
| ------------------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | -------------------- |
| `displayCountries` | `string[]` | Array of [two-letter country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that limit the threshold monitoring locations that the connected account sees [choose from](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options). | undefined (all countries permitted) | optional             |

## Request early access  (Private preview)

Sign in or [register for Stripe](https://dashboard.stripe.com/register) to request access to this Connect embedded component preview.

## See also

- [Tax on Connect](https://docs.stripe.com/tax/connect.md)
- [Tax for software platforms](https://docs.stripe.com/tax/tax-for-platforms.md)
- [Tax settings component](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md)
- [Tax registrations component](https://docs.stripe.com/connect/supported-embedded-components/tax-registrations.md)