Tax registrations

The Tax registrations component gives your connected accounts control over their tax compliance. Your connected accounts interact with this component by managing their tax registrations directly in your platform. This component is suitable for software platforms, which means that your connected accounts are liable to collect taxes.

If you’re a platform integrating Stripe Tax, you must collect information about the registrations with tax authorities of your connected accounts in the applicable jurisdictions. Your connected accounts need to register with their tax authorities before they add their tax registrations in your platform. To correctly calculate and collect taxes for your platform, you must collect the tax registrations of your connected accounts.

The Tax registrations component uses the Tax Registrations API to display a list of tax registrations to your connected accounts. To calculate tax on their payments in a location, connected accounts need to add their tax registration with the Tax registrations component. If the connected account wish to stop calculating tax in a certain location, they can end the tax registration in the component.

Requirements

• Your integration must follow the software platforms guide for Tax on Connect. This means that your connected accounts are liable to collect taxes.
• If you haven’t already, render the Tax settings component. You need both the Tax settings component and the Tax registrations component to provide tax compliance control to your connected accounts.

Integrate the tax registrations component

When creating an Account Session, enable tax registrations by specifying tax_registrations in the components parameter.

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

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

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

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Registrations</h2>
      <ConnectTaxRegistrations
        // Optional
        // displayCountries={["US", "CA", "DE"]}
        // onAfterTaxRegistrationAdded={({id: registrationId}) => console.log({registrationId})}
       />
    </div>
  </ConnectComponentsProvider>
);

Limitations

The following features are available in the Dashboard and the API, but aren’t currently supported by the Tax registrations component:

• Scheduling start or end dates for registrations. You can only create or end registrations immediately.
• Specifying US state sales tax elections when creating tax registrations.