Product tax code selectorPrivate preview

The product tax code selector component lets your connected accounts classify their products. Connected accounts typically interact with this component on the product page within your platform. This component suits both software platforms and marketplaces for integration into their user interfaces. Connected accounts can use the product tax code selector to choose the appropriate tax code for each product. Either the platform or the connected accounts can be liable for tax collection.

If you’re a platform integrating Stripe Tax, you must specify the tax code of a product for Stripe Tax to calculate taxes correctly.

The Product tax code selector component uses the Tax codes API to display all available tax codes. When a connected account selects a new product tax code, an event handler is called that you can listen to. Use this to update the tax code of a product within your platform. All tax codes in this component are translated into all languages that Connect embedded components support.

Integrate the product tax code selector component

When creating an Account Session, enable the product tax code selector component by specifying product_tax_code_selector in the components parameter.

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-09-30.clover; embedded_connect_beta=v2;" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "components[product_tax_code_selector][enabled]"=true

After creating the account session and initializing Connect.js, render the product tax code selector component in the front end:

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

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax code</h2>
      <ConnectProductTaxCodeSelector
        // Optional
        // onTaxCodeSelect={(id: string | null, {analyticsName: string} | null) => {console.log({id, analyticsName})}}
        // hideDescription={false}
        // disabled={false}
        // initialTaxCode={"txcd_99999999"}
       />
    </div>
  </ConnectComponentsProvider>
);

Request early access Private preview

Sign in or register for Stripe to request access to this Connect embedded component preview.