Tax registrations
Learn how to allow connected accounts to manage their tax registrations for Stripe Tax.
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.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
After creating the account session and initializing ConnectJS, you can render the tax registrations component in the frontend:
taxRegistrationPage.jsx
Select a language
React
HTML + JavaScript
No results
// 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})}
// onAfterTaxRegistrationExpired={({id: registrationId}) => console.log({registrationId})}
/>
</div>
</ConnectComponentsProvider>
);
| Method | Type | Description | Default |
|---|---|---|---|
setDisplayCountries | string[] | Array of two-letter country codes that the connected account can choose from for a new tax registration. | undefined (all countries permitted) |
setOnAfterTaxRegistrationAdded | ({id: string}) => void | Callback executed with an object containing the newly added tax registration ID | undefined (not a required method) |
setOnAfterTaxRegistrationExpired | ({id: string}) => void | Callback executed with an object containing the tax registration ID ended by the user | undefined (not a required method) |
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.