Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Get started with Connect
Integration fundamentals
Example integrations
Onboard accounts
Configure account Dashboards
    Get started with Connect embedded components
    Supported Connect embedded components
      Available Components
      Account management
      Account onboarding
      Balances
      Documents
      Financial account
      Financial account transactions
      Issuing card
      Issuing cards list
      Notification banner
      Payment details
      Payments
      Payouts
      Payouts list
      Tax registrations
      Tax settings
      Preview components
      App install
      App viewport
      Capital financing
      Capital financing application
      Capital financing promotion
      Disputes for a payment
      Export Tax Transactions
      Payment method settings
      Reporting chart
    Customize Connect embedded components
    Stripe Dashboard customization
    Platform controls for Stripe Dashboard accounts
    Express Dashboard
Accept payments
Pay out to accounts
Manage your Connect platform
Tax forms for your Connect platform
Work with connected account types
HomePlatforms and marketplacesConfigure account DashboardsSupported Connect embedded components

Tax registrations

Learn how to allow connected accounts to manage their tax registrations for Stripe Tax.

Copy page

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
cURL
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:

taxRegistrationPage.jsx
React
// 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> );
MethodTypeDescriptionDefault
setDisplayCountriesstring[]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}) => voidCallback executed with an object containing the newly added tax registration IDundefined (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.

See also

  • Tax on Connect
  • Tax for software platforms
  • Tax settings component
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc