Tax settings

The Tax settings component allows your connected accounts to set up Stripe Tax in your platform. Connected accounts can change their head office address and preset tax code with this component. This component is suitable for software platforms, which means that your connected accounts are liable to collect taxes.

To calculate taxes on payments of your connected accounts you have to collect four data points of information:

• The head office address
• The type of product the connected account sells
• The address of the customer
• The registrations of the connected account with the tax authorities

The tax settings component helps you to collect the first two pieces of information of your connected accounts with minimal integration effort.

The embedded tax settings component uses the Tax Settings API to display the head office address and preset tax code to your connected accounts.

Requirements

• Your integration must follow the software platforms guide for Tax on Connect. This means that your connected accounts are liable to collect taxes.
• After integrating the Tax settings component, render the Tax registrations component to collect tax registration information of your connected accounts. This is a requirement for Tax to calculate tax in a specific location.

Integrate the tax settings component

When creating an Account Session, enable tax settings by specifying tax_settings in the components parameter.

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[tax_settings][enabled]"=true

After creating the account session and initializing ConnectJS, you can render the tax settings component in the frontend:

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

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Settings</h2>
      <ConnectTaxSettings
        // Optional
        // displayHeadOfficeCountries={["US", "CA", "DE"]}
        // onTaxSettingsUpdated={({id: settingsId}) => console.log({settingsId})}
        // hideProductTaxCodeSelector
       />
    </div>
  </ConnectComponentsProvider>
);

To give your connected accounts full control over their tax compliance, you need to integrate the tax registrations component as well. Please follow the guide for tax compliance for software platforms. The guide also covers how to calculate and collect the taxes and help your connected accounts to report their taxes.