# Sélecteur de code de taxe produit

Autorisez les comptes connectés à classer les produits par code de taxe.

Le composant pour le sélecteur de code de taxe produit permet à vos comptes connectés de classer leurs produits. Les comptes connectés ont généralement accès à ce composant sur la page produit de votre plateforme. Celui-ci convient aussi bien aux [plateformes logicielles](https://docs.stripe.com/tax/tax-for-platforms.md) qu’aux [marketplaces](https://docs.stripe.com/tax/tax-for-marketplaces.md) pour l’intégration dans leurs interfaces utilisateur. Les comptes connectés peuvent utiliser le sélecteur de code de taxe produit pour choisir le code de taxe approprié pour chaque produit. La plateforme ou les comptes connectés peuvent être responsables de la collecte des taxes.

Si votre plateforme intègre Stripe Tax, vous devez indiquer le code de taxe d’un produit pour que Stripe Tax puisse calculer correctement les taxes.

Le composant pour le sélecteur de code de taxe produit utilise l’API [Tax codes](https://docs.stripe.com/api/tax_codes.md) pour afficher tous les codes de taxe disponibles. Lorsqu’un compte connecté sélectionne un nouveau code de taxe produit, un gestionnaire d’événements est appelé, que vous pouvez écouter. Utilisez-le pour mettre à jour le code de taxe d’un produit au sein de votre plateforme. Tous les codes de taxe de ce composant sont traduits dans [toutes les langues prises en charge par les composants intégrés Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md?platform=web#localization).

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

## Intégrer le composant pour le sélecteur de code de taxe produit

Lors de la création d’une [session de compte](https://docs.stripe.com/api/account_sessions/create.md), activez le composant pour le sélecteur de code de taxe produit en indiquant `product_tax_code_selector` dans le paramètre `components`.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview; embedded_connect_beta=v2;" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[product_tax_code_selector][enabled]=true"
```

Après avoir créé la session de compte et [initialisé Connect.js](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), affichez le composant de sélection du code fiscal produit dans le front-end&nbsp;:

#### React

```jsx
// 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>
);
```

#### HTML + JS

| Méthode              | Type                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                              | Par défaut | Obligatoire ou facultatif |
| -------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------------------------- |
| `setOnTaxCodeSelect` | `(id: string | null, {analyticsName: string} | null) => void` | Une fonction de rappel qui accepte le numéro fiscal et le nom du code fiscal lorsque l’utilisateur en sélectionne un, ou `null` si l’utilisateur efface sa sélection. Utilisez le champ `analyticsName` uniquement à des fins d’analyse, car sa valeur est susceptible d’être modifiée ou supprimée. Exécutez [Récupérer un code fiscal](https://docs.stripe.com/api/tax_codes/retrieve.md) pour obtenir des détails sur le code fiscal. | non défini | Facultatif                |
| `setHideDescription` | `boolean`                                                     | Définissez sur true pour masquer la description du code de taxe dans le sélecteur de code de taxe produit.                                                                                                                                                                                                                                                                                                                               | false      | Facultatif                |
| `setDisabled`        | `boolean`                                                     | Définissez sur true pour désactiver la liste déroulante du sélecteur de code de taxe produit.                                                                                                                                                                                                                                                                                                                                            | false      | Facultatif                |
| `setInitialTaxCode`  | `string`                                                      | Définissez-le sur l’un des [codes de taxe pris en charge](https://docs.stripe.com/tax/tax-codes.md) de Stripe, tel que `txcd_10000000`, pour sélectionner automatiquement un code de taxe initial.                                                                                                                                                                                                                                       | non défini | Facultatif                |

#### React

| Propriété React   | Type                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                              | Par défaut | Obligatoire ou facultatif |
| ----------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------------------------- |
| `onTaxCodeSelect` | `(id: string | null, {analyticsName: string} | null) => void` | Une fonction de rappel qui accepte le numéro fiscal et le nom du code fiscal lorsque l’utilisateur en sélectionne un, ou `null` si l’utilisateur efface sa sélection. Utilisez le champ `analyticsName` uniquement à des fins d’analyse, car sa valeur est susceptible d’être modifiée ou supprimée. Exécutez [Récupérer un code fiscal](https://docs.stripe.com/api/tax_codes/retrieve.md) pour obtenir des détails sur le code fiscal. | non défini | Facultatif                |
| `hideDescription` | `boolean`                                                     | Définissez sur true pour masquer la description du code de taxe dans le sélecteur de code de taxe produit.                                                                                                                                                                                                                                                                                                                               | false      | Facultatif                |
| `disabled`        | `boolean`                                                     | Définissez sur true pour désactiver la liste déroulante du sélecteur de code de taxe produit.                                                                                                                                                                                                                                                                                                                                            | false      | Facultatif                |
| `initialTaxCode`  | `string`                                                      | Définissez-le sur l’un des [codes de taxe pris en charge](https://docs.stripe.com/tax/tax-codes.md) de Stripe, tel que `txcd_10000000`, pour sélectionner automatiquement un code de taxe initial.                                                                                                                                                                                                                                       | non défini | Facultatif                |

## Demander un accès anticipé (Private preview)

Connectez-vous ou [inscrivez-vous à Stripe](https://dashboard.stripe.com/register) pour demander l’accès à ce composant intégré Connect en mode aperçu.

## See also

- [Tax sur Connect](https://docs.stripe.com/tax/connect.md)
- [Tax pour les plateformes logicielles](https://docs.stripe.com/tax/tax-for-platforms.md)
- [Tax pour les places de marché](https://docs.stripe.com/tax/tax-for-marketplaces.md)