> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Numéros d'identification fiscale

> Formatez les numéros de TVA, de GST et d'autres numéros d'enregistrement fiscal pour que Whop les accepte et les applique au calcul des taxes.

Un numéro d'identification fiscale est le numéro d'enregistrement qu'une autorité fiscale attribue à une entreprise. Vous l'envoyez sous la forme d'un `tax_id_type`, comme `eu_vat` ou `gb_vat`, accompagné du numéro lui-même. Vous envoyez des numéros d'identification fiscale à deux endroits. Sur un compte, un numéro d'identification fiscale indique aussi que l'entreprise est immatriculée à la TVA dans ce pays. Sur un devis de paiement, le numéro d'identification fiscale de l'acheteur sert à tarifer un achat professionnel. Cette page décrit le format attendu pour chaque type, ce que Whop modifie dans un numéro que vous envoyez et ce qu'il rejette. Pour savoir qui collecte et reverse les taxes sur les ventes Whop, consultez [Taxes](https://docs.whop.com/fr/payments-and-billing/fees/taxes.md).

> [!NOTE]
>
> Tous les États membres de l'UE partagent le type `eu_vat`. Whop déduit le pays des deux premières lettres du numéro : un numéro de TVA d'un pays de l'UE doit donc commencer par son code pays.

| | Numéros fiscaux du compte | Numéro fiscal de l'acheteur |
| - | - | - |
| **Champ** | `tax_identifiers` sur [Update Account](https://docs.whop.com/fr/api-reference/accounts/update-account.md) | `tax_ids` sur [Create Payment Quote](https://docs.whop.com/fr/api-reference/payment-quotes/create-payment-quote.md) |
| **Rôle** | Indique où l'entreprise est immatriculée fiscalement. Lorsque l'entreprise reverse elle-même ses taxes, Whop ne collecte les taxes hors des États-Unis que dans les pays où le compte possède un numéro d'identification fiscale. La collecte aux États-Unis suit `tax_collection_enabled_states`. | Tarife l'achat comme une transaction entre entreprises lorsque cela s'applique, par exemple pour l'autoliquidation dans l'UE. |
| **Nombre** | Un par `tax_id_type`. | Un par devis. |
| **Formatage** | `eu_vat` : espaces, points et tirets supprimés, lettres mises en majuscules, et un préfixe `GR` remplacé par `EL`. Autres types : enregistrés tels que vous les envoyez. | `eu_vat` : espaces, points et tirets supprimés. Whop conserve la casse et le préfixe que vous envoyez. Autres types : espaces supprimés. |

## Ajouter un numéro d'identification fiscale à un compte

Envoyez chaque numéro d'identification fiscale sous la forme d'un `tax_id_type` et d'une `tax_id_value`. Whop enregistre `DE 123.456.789` ci-dessous sous la forme `DE123456789`.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

await client.accounts.update({
  id: "biz_xxxxxxxxxxxxx",
  tax_identifiers: [{ tax_id_type: "eu_vat", tax_id_value: "DE 123.456.789" }],
});
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

client.accounts.update(
    "biz_xxxxxxxxxxxxx",
    tax_identifiers=[{"tax_id_type": "eu_vat", "tax_id_value": "DE 123.456.789"}],
)
```

Un compte détient un numéro d'identification fiscale par `tax_id_type`. Envoyer un type que le compte possède déjà remplace sa valeur au lieu d'ajouter un second numéro. Tous les pays de l'UE partagent `eu_vat` : un compte détient donc un seul numéro de TVA pour toute l'UE.

## Le type `eu_vat`

Un numéro `eu_vat` commence par le code à deux lettres de l'État membre qui l'a émis, suivi du numéro national.

* **La Grèce utilise `EL`**, et non `GR` : `EL123456789`. Sur un compte, un numéro envoyé avec `GR` est enregistré avec `EL`. Sur un devis de paiement, envoyez vous-même `EL`.
* **L'Irlande du Nord utilise `XI`** avec le type `eu_vat` : `XI123456789`. Sur un compte, un numéro `XI` compte comme l'immatriculation de l'entreprise au Royaume-Uni, mais le checkout ne l'utilise pas pour les taxes britanniques. Ajoutez un numéro `gb_vat` pour cela.
* **Les espaces, points et tirets sont supprimés.** Sur un compte, les lettres sont aussi mises en majuscules : `de 123.456.789` et `DE-123-456-789` deviennent donc tous deux `DE123456789`.

Une entreprise hors de l'UE immatriculée au régime du guichet unique non-Union (One Stop Shop, OSS) envoie son numéro OSS en tant que `eu_oss_vat`, par exemple `EU123456789`. Sur un compte, un seul numéro `eu_oss_vat` vaut immatriculation dans tous les pays de l'UE.

Sur un compte, Whop vérifie un numéro `eu_vat` par rapport au format de son pays. Le numéro doit commencer par le préfixe de TVA d'un État membre de l'UE ou par `XI`, et le reste doit avoir la longueur et les caractères que ce pays attribue. Par exemple, un numéro belge est composé de `BE` suivi de 10 chiffres commençant par `0` ou `1` : `BE123456789` est donc rejeté. Whop n'ajoute pas de préfixe manquant, car un numéro `eu_vat` n'indique pas de quel pays il provient.

Sur un devis de paiement, Whop ne rejette qu'un numéro qui ne commence pas par deux lettres suivies d'au moins deux lettres ou chiffres.

Les deux endpoints répondent par une erreur `400`. Sur un compte, l'erreur comporte un `code` que vous pouvez tester :

```json theme={null}
{
  "error": {
    "type": "bad_request",
    "message": "Enter your EU VAT number with its two-letter country code, for example DE123456789.",
    "code": "eu_vat_number_invalid"
  }
}
```

Sur un devis de paiement, le message est `tax_ids.value is not a valid eu_vat registration`.

## Autres types de numéros fiscaux

Tous les autres types conservent la ponctuation et la casse de leur format publié. Un UID suisse reste `CHE-123.456.789`, et un CNPJ brésilien reste `12.345.678/0001-00`. Envoyez le numéro tel que l'autorité fiscale l'imprime. Sur un devis de paiement, les espaces sont tout de même supprimés : `CHE-123.456.789 MWST` devient donc `CHE-123.456.789MWST`.

Au Canada, un numéro `ca_gst_hst` vaut immatriculation dans toutes les provinces. Un numéro provincial, comme `ca_qst` ou `ca_pst_bc`, ne vaut que dans sa province, et un numéro d'entreprise `ca_bn` seul ne vaut nulle part.

## Exemples par pays

Ces exemples correspondent à ceux affichés dans le tableau de bord Whop, qui utilise `eu_vat` pour la Pologne et l'Irlande du Nord. La référence [Update Account](https://docs.whop.com/fr/api-reference/accounts/update-account.md) liste les autres valeurs de `tax_id_type` acceptées. Un devis de paiement accepte aussi `pl_nip` et `xi_vat`.

| Pays | `tax_id_type` | Exemple |
| - | - | - |
| Albanie | `al_tin` | `J12345678N` |
| Andorre | `ad_nrt` | `A-123456-B` |
| Angola | `ao_tin` | `1234567890` |
| Argentine | `ar_cuit` | `20-12345678-9` |
| Arménie | `am_tin` | `12345678` |
| Aruba | `aw_tin` | `1234567` |
| Australie | `au_abn` | `12345678901` |
| Australie | `au_arn` | `12345678901` |
| Autriche | `eu_vat` | `ATU12345678` |
| Azerbaïdjan | `az_tin` | `1234567890` |
| Bahamas | `bs_tin` | `123456789` |
| Bahreïn | `bh_vat` | `123456789012345` |
| Bangladesh | `bd_bin` | `123456789` |
| Barbade | `bb_tin` | `1234567890` |
| Biélorussie | `by_tin` | `123456789` |
| Belgique | `eu_vat` | `BE0123456789` |
| Bénin | `bj_ifu` | `1234567890123` |
| Bolivie | `bo_tin` | `1234567` |
| Bosnie-Herzégovine | `ba_tin` | `1234567890123` |
| Brésil | `br_cnpj` | `12.345.678/0001-00` |
| Brésil | `br_cpf` | `123.456.789-00` |
| Bulgarie | `bg_uic` | `123456789` |
| Bulgarie | `eu_vat` | `BG123456789` |
| Burkina Faso | `bf_ifu` | `12345678901234` |
| Cambodge | `kh_tin` | `K001-234567890` |
| Cameroun | `cm_niu` | `M012345678901A` |
| Canada | `ca_bn` | `123456789` |
| Canada | `ca_gst_hst` | `123456789RT0001` |
| Canada | `ca_pst_bc` | `PST-1234-5678` |
| Canada | `ca_pst_mb` | `123456-7` |
| Canada | `ca_pst_sk` | `1234567` |
| Canada | `ca_qst` | `1234567890TQ1234` |
| Cap-Vert | `cv_nif` | `123456789` |
| Chili | `cl_tin` | `12.345.678-9` |
| Chine | `cn_tin` | `123456789012345678` |
| Colombie | `co_nit` | `123.456.789-0` |
| Costa Rica | `cr_tin` | `1-234-567890` |
| Croatie | `eu_vat` | `HR12345678901` |
| Croatie | `hr_oib` | `12345678901` |
| Chypre | `eu_vat` | `CY12345678A` |
| Tchéquie | `eu_vat` | `CZ12345678` |
| République démocratique du Congo | `cd_nif` | `A1234567B` |
| Danemark | `eu_vat` | `DK12345678` |
| République dominicaine | `do_rcn` | `123-4567890-1` |
| Équateur | `ec_ruc` | `1234567890001` |
| Égypte | `eg_tin` | `123456789` |
| Salvador | `sv_nit` | `0614-123456-123-4` |
| Estonie | `eu_vat` | `EE123456789` |
| Éthiopie | `et_tin` | `1234567890` |
| Union européenne (OSS non-Union) | `eu_oss_vat` | `EU123456789` |
| Finlande | `eu_vat` | `FI12345678` |
| France | `eu_vat` | `FR12345678901` |
| Géorgie | `ge_vat` | `123456789` |
| Allemagne | `de_stn` | `12/345/67890` |
| Allemagne | `eu_vat` | `DE123456789` |
| Ghana | `gh_tin` | `C0001234567` |
| Grèce | `eu_vat` | `EL123456789` |
| Guinée | `gn_nif` | `123456789` |
| Hong Kong | `hk_br` | `12345678` |
| Hongrie | `eu_vat` | `HU12345678` |
| Hongrie | `hu_tin` | `12345678` |
| Islande | `is_vat` | `123456` |
| Inde | `in_gst` | `22AAAAA0000A1Z5` |
| Indonésie | `id_npwp` | `12.345.678.9-012.345` |
| Irlande | `eu_vat` | `IE1234567A` |
| Israël | `il_vat` | `123456789` |
| Italie | `eu_vat` | `IT12345678901` |
| Japon | `jp_cn` | `1234-56-7890` |
| Japon | `jp_rn` | `12345` |
| Japon | `jp_trn` | `T1234567890123` |
| Kazakhstan | `kz_bin` | `123456789012` |
| Kenya | `ke_pin` | `P000123456A` |
| Kirghizistan | `kg_tin` | `12345678` |
| Laos | `la_tin` | `1234567890` |
| Lettonie | `eu_vat` | `LV12345678901` |
| Liechtenstein | `li_uid` | `CHE-123.456.789` |
| Liechtenstein | `li_vat` | `12345` |
| Lituanie | `eu_vat` | `LT123456789012` |
| Luxembourg | `eu_vat` | `LU12345678` |
| Malaisie | `my_frp` | `12345678` |
| Malaisie | `my_itn` | `C1234567890` |
| Malaisie | `my_sst` | `A12-3456-78901234` |
| Malte | `eu_vat` | `MT12345678` |
| Mauritanie | `mr_nif` | `12345678` |
| Mexique | `mx_rfc` | `XAXX010101000` |
| Moldavie | `md_vat` | `1234567` |
| Monténégro | `me_pib` | `12345678` |
| Maroc | `ma_vat` | `12345678` |
| Népal | `np_pan` | `123456789` |
| Pays-Bas | `eu_vat` | `NL123456789B01` |
| Nouvelle-Zélande | `nz_gst` | `123456789` |
| Nigeria | `ng_tin` | `12345678-0001` |
| Macédoine du Nord | `mk_vat` | `MK1234567890123` |
| Irlande du Nord | `eu_vat` | `XI123456789` |
| Norvège | `no_vat` | `123456789MVA` |
| Norvège | `no_voec` | `1234567` |
| Oman | `om_vat` | `OM1234567890` |
| Pérou | `pe_ruc` | `12345678901` |
| Philippines | `ph_tin` | `123-456-789-000` |
| Pologne | `eu_vat` | `PL1234567890` |
| Portugal | `eu_vat` | `PT123456789` |
| Roumanie | `eu_vat` | `RO1234567890` |
| Roumanie | `ro_tin` | `1234567890` |
| Russie | `ru_inn` | `1234567890` |
| Russie | `ru_kpp` | `123456789` |
| Arabie saoudite | `sa_vat` | `123456789012345` |
| Sénégal | `sn_ninea` | `12345678901` |
| Serbie | `rs_pib` | `123456789` |
| Singapour | `sg_gst` | `M12345678X` |
| Singapour | `sg_uen` | `123456789A` |
| Slovaquie | `eu_vat` | `SK1234567890` |
| Slovénie | `eu_vat` | `SI12345678` |
| Slovénie | `si_tin` | `12345678` |
| Afrique du Sud | `za_vat` | `4123456789` |
| Corée du Sud | `kr_brn` | `123-45-67890` |
| Espagne | `es_cif` | `A12345678` |
| Espagne | `eu_vat` | `ESA12345678` |
| Suriname | `sr_fin` | `12345678` |
| Suède | `eu_vat` | `SE123456789012` |
| Suisse | `ch_uid` | `CHE-123.456.789` |
| Suisse | `ch_vat` | `CHE-123.456.789 MWST` |
| Taïwan | `tw_vat` | `12345678` |
| Tadjikistan | `tj_tin` | `123456789` |
| Tanzanie | `tz_vat` | `12-345-6789` |
| Thaïlande | `th_vat` | `1234567890123` |
| Turquie | `tr_tin` | `1234567890` |
| Ouganda | `ug_tin` | `1234567890` |
| Ukraine | `ua_vat` | `1234567890` |
| Émirats arabes unis | `ae_trn` | `123456789012345` |
| Royaume-Uni | `gb_vat` | `GB123456789` |
| États-Unis | `us_ein` | `12-3456789` |
| Uruguay | `uy_ruc` | `123456789012` |
| Ouzbékistan | `uz_tin` | `123456789` |
| Ouzbékistan | `uz_vat` | `123456789012` |
| Venezuela | `ve_rif` | `J-12345678-9` |
| Viêt Nam | `vn_tin` | `1234567890` |
| Zambie | `zm_tin` | `1234567890` |
| Zimbabwe | `zw_tin` | `1234567890` |

## Étapes suivantes

> [card] [Mettre à jour un compte](https://docs.whop.com/fr/api-reference/accounts/update-account.md)
>
> Définissez les numéros d'identification fiscale d'un compte et la façon dont il reverse les taxes.

> [card] [Établir un devis pour un achat professionnel](https://docs.whop.com/fr/api-reference/payment-quotes/create-payment-quote.md)
>
> Tarifez un achat avec le numéro d'identification fiscale de l'acheteur avant de le débiter.
