Collecter les numéros fiscaux des clients avec Checkout
Découvrez comment collecter les numéros de TVA et autres numéros fiscaux des clients avec Checkout.
L’affichage du numéro fiscal et de la dénomination sociale d’un client sur les factures est une obligation courante à laquelle vous pouvez satisfaire en activant la collecte du numéro fiscal. Ce guide part du principe que vous avez déjà intégré Elements à l’API Checkout Sessions. Si vous n’avez pas effectué cette intégration, consultez le guide Accepter un paiement…
Activer la collecte du numéro fiscalCôté serveur
Nouveaux clients
Pour activer la collecte du numéro fiscal pour les nouveaux clients, définissez tax_id_collection[enabled] sur true
lors de la création d’une session Checkout.
Clients existants
Créez une session Checkout avec un client existant pour modifier les informations d’identification fiscale recueillies lors du paiement. La session Checkout enregistre le nom de l’entreprise recueilli en tant que nom du client et ajoute le numéro fiscal recueilli à customer.tax_ids. Étant donné que la collecte d’un nom d’entreprise peut remplacer le nom existant du client, vous devez définir customer_update.name sur auto
lors de la création de la session Checkout.
Si vous n’avez pas enregistré les adresses de vos clients existants, vous pouvez baser leur localisation sur l’adresse de facturation ou de livraison saisie lors du paiement. Pour utiliser l’adresse de facturation saisie lors du paiement afin d’évaluer la localisation du client, définissez customer_update.address sur auto
. Lorsque le paramètre customer_update.address est défini sur auto
, toutes les adresses précédemment enregistrées pour ce client sont remplacées par l’adresse saisie lors du paiement.
Si vous recueillez les adresses de livraison de clients existants, vous devez baser leur localisation sur l’adresse de livraison saisie lors du règlement. Pour ce faire, définissez le paramètre customer_update.shipping sur auto
. Lorsque le paramètre customer_update.shipping est défini sur auto
, toutes les adresses de livraison précédemment enregistrées pour ce client sont remplacées par l’adresse de livraison saisie lors du paiement.
Cet exemple crée une session en mode payment
avec collecte des numéros fiscaux activée. Pour les abonnements, faites les mêmes changements avec le mode défini sur subscription
.
Récupérer le numéro fiscal d'un client après une session
Checkout inclut les numéros fiscaux fournis dans l’objet Session correspondant. Lorsqu’une session est finalisée, Checkout génère un événement checkout.session.completed que vous pouvez écouter à l’aide d’un endpoint de webhook. Si vous souhaitez récupérer le numéro fiscal collecté par un objet Session, vous pouvez le trouver dans le tableau customer_details.tax_ids de la session :
{ "object": { "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y", "object": "checkout.session", ... "customer": "cus_id_of_new_customer", "customer_details": { ... "tax_ids": [ { "type": "eu_vat", "value": "FRAB123456789" } ] }, ... "tax_id_collection": { "enabled": true }, ... } }
Checkout enregistre également les dénominations sociales et numéros fiscaux recueillis dans l’objet Customer associé à la session, le cas échéant. Les numéros fiscaux recueillis lors du règlement sont accessibles dans le tableau customer.tax_ids de l’objet Customer. Vous pouvez également retrouver tous les numéros fiscaux enregistrés d’un objet Customer à l’aide de la ressource Tax IDs en définissant le paramètre owner.type sur customer
et le paramètre owner.customer sur l’ID du client. Tout nouveau numéro fiscal comporte une dénomination sociale associée, que Checkout enregistre dans la propriété nom de l’objet Customer. De cette façon, la dénomination sociale recueillie apparaît sur toutes les factures d’abonnement de ce client.
Tester votre intégration
In test mode, you can enter any alphanumeric string that is in the correct format of a supported tax ID type (for example, DE123456789
for eu_
). For a full list of example tax IDs you can reference our Customer Tax ID guide. You can also use our test tax IDs to test various verification state flows.
Validation
Durant les sessions, Checkout vérifie que les numéros fiscaux sont correctement formatés. Nous ne vérifions pas si un numéro fiscal est valide lors des sessions. Il vous appartient de vérifier la validité des informations recueillies sur vos clients lors du règlement. Pour vous aider, Stripe compare les informations à celles de différentes bases de données gouvernementales afin de valider automatiquement les numéros d’identification australiens (ABN), de taxe sur la valeur ajoutée (TVA) européenne et de taxe sur la valeur ajoutée (TVA) au Royaume-Uni). Pour en savoir plus sur notre processus de validation et consulter l’état de ces vérifications, veuillez consulter notre guide sur les numéros fiscaux des clients.
Types de numéros fiscaux pris en charge
La session Checkout collecte les types de numéros fiscaux suivants dans les régions indiquées :
Pays | Enum | Description | Exemple |
---|---|---|---|
Afrique du Sud | za_ | Numéro de TVA sud-africain | 4123456789 |
Albanie | al_ | Numéro d'identification fiscale albanais | J12345678N |
Allemagne | eu_ | European VAT number | DE123456789 |
Angola | ao_ | Numéro fiscal de l'Angola | 5123456789 |
Arabie saoudite | sa_ | TVA Arabie Saoudite | 123456789012345 |
Arménie | am_ | Numéro fiscal de l’Arménie | 02538904 |
Australie | au_ | Numéro d'identification australien (AU ABN) | 12345678912 |
Autriche | eu_ | European VAT number | ATU12345678 |
Bahamas | bs_ | Numéro fiscal des Bahamas | 123.456.789 |
Bahreïn | bh_ | Numéro de TVA bahreïnien | 123456789012345 |
Barbade | bb_ | Numéro fiscal de la Barbade | 1123456789012 |
Belgique | eu_ | European VAT number | BE0123456789 |
Biélorussie | by_ | Numéro d'identification fiscale de la Biélorussie | 123456789 |
Bosnie-Herzégovine | ba_ | Numéro fiscal de la Bosnie-Herzégovine | 123456789012 |
Bulgarie | eu_ | European VAT number | BG0123456789 |
Cambodge | kh_ | Numéro fiscal du Cambodge | 1001-123456789 |
Canada | ca_ | Numéro BN canadien | 123456789 |
Canada | ca_ | Numéro GST/HST canadien | 123456789RT0002 |
Canada | ca_ | Numéro PST canadien (Colombie-Britannique) | PST-1234-5678 |
Canada | ca_ | Numéro PST canadien (Manitoba) | 123456-7 |
Canada | ca_ | Numéro PST canadien (Saskatchewan) | 1234567 |
Canada | ca_ | Numéro QST canadien (Québec) | 1234567890TQ1234 |
Chili | cl_ | Numéro TIN chilien | 12.345.678-K |
Chypre | eu_ | European VAT number | CY12345678Z |
Congo-Kinshasa | cd_ | Numéro fiscal de la République démocratique du Congo (Número de Identificação Fiscal) | A0123456M |
Corée du Sud | kr_ | Numéro BRN coréen | 123-45-67890 |
Costa Rica | cr_ | Numéro fiscal du Costa Rica | 1-234-567890 |
Croatie | eu_ | European VAT number | HR12345678912 |
Danemark | eu_ | European VAT number | DK12345678 |
Égypte | eg_ | Numéro d'identification fiscale égyptien | 123456789 |
Émirats arabes unis | ae_ | Numéro TRN des Émirats arabes unis | 123456789012345 |
Équateur | ec_ | Numéro RUC équatorien | 1234567890001 |
Espagne | es_ | Numéro NIF espagnol (auparavant numéro CIF espagnol) | A12345678 |
Espagne | eu_ | European VAT number | ESA1234567Z |
Estonie | eu_ | European VAT number | EE123456789 |
Finlande | eu_ | European VAT number | FI12345678 |
France | eu_ | European VAT number | FRAB123456789 |
Géorgie | ge_ | TVA Géorgie | 123456789 |
Grèce | eu_ | European VAT number | EL123456789 |
Guinée | gn_ | Numéro fiscal de la Guinée (Número de Identificação Fiscal) | 123456789 |
Hongrie | eu_ | European VAT number | HU12345678 |
Inde | in_ | Numéro GST indien | 12ABCDE3456FGZH |
Irlande | eu_ | European VAT number | IE1234567AB |
Islande | is_ | TVA Islande | 123456 |
Italie | eu_ | European VAT number | IT12345678912 |
Kazakhstan | kz_ | Numéro d'identification de l'entreprise kazakhe | 123456789012 |
Kenya | ke_ | Numéro d'identification personnel de la Kenya Revenue Authority | P000111111A |
Lettonie | eu_ | European VAT number | LV12345678912 |
Liechtenstein | li_ | Numéro de TVA au Liechtenstein | 12345 |
Lituanie | eu_ | European VAT number | LT123456789123 |
Luxembourg | eu_ | European VAT number | LU12345678 |
Macédoine du Nord | mk_ | Numéro de TVA de la Macédoine du Nord | MK1234567890123 |
Malte | eu_ | European VAT number | MT12345678 |
Maroc | ma_ | Numéro de TVA du Maroc | 12345678 |
Mauritanie | mr_ | Numéro fiscal de la Mauritanie (Número de Identificação Fiscal) | 12345678 |
Mexique | mx_ | Numéro RFC mexicain | ABC010203AB9 |
Moldavie | md_ | Numéro de TVA de la Moldavie | 1234567 |
Monténégro | me_ | Numéro PIB du Monténégro | 12345678 |
Népal | np_ | Numéro PAN du Népal | 123456789 |
Nigéria | ng_ | Numéro fiscal nigérian | 12345678-0001 |
Norvège | no_ | Numéro de TVA norvégien | 123456789MVA |
Nouvelle-Zélande | nz_ | Numéro GST Nouvelle-Zélande | 123456789 |
Oman | om_ | Numéro de TVA omanais | OM1234567890 |
Ouganda | ug_ | Numéro fiscal de l’Ouganda | 1014751879 |
Ouzbékistan | uz_ | Numéro d'identification fiscale de l'Ouzbékistan | 123456789 |
Ouzbékistan | uz_ | Numéro de TVA de l'Ouzbékistan | 123456789012 |
Pays-Bas | eu_ | European VAT number | NL123456789B12 |
Pérou | pe_ | Numéro RUC péruvien | 12345678901 |
Pologne | eu_ | European VAT number | PL1234567890 |
Portugal | eu_ | European VAT number | PT123456789 |
République tchèque | eu_ | European VAT number | CZ1234567890 |
Roumanie | eu_ | European VAT number | RO1234567891 |
Royaume-Uni | eu_ | Northern Ireland VAT number | XI123456789 |
Royaume-Uni | gb_ | Numéro de TVA du Royaume-Uni | GB123456789 |
Russie | ru_ | Numéro INN russe | 1234567891 |
Russie | ru_ | Numéro KPP russe | 123456789 |
Sénégal | sn_ | Numéro NINEA du Sénégal | 12345672A2 |
Serbie | rs_ | Numéro PIB de la Serbie | 123456789 |
Singapour | sg_ | Numéro GST singapourien | M12345678X |
Slovaquie | eu_ | European VAT number | SK1234567891 |
Slovénie | eu_ | European VAT number | SI12345678 |
Suède | eu_ | European VAT number | SE123456789123 |
Suisse | ch_ | Numéro de TVA suisse | CHE-123.456.789 MWST |
Suriname | sr_ | Numéro FIN du Suriname | 1234567890 |
Tadjikistan | tj_ | Numéro fiscal du Tadjikistan | 123456789 |
Taïwan | tw_ | TVA Taïwan | 12345678 |
Tanzanie | tz_ | Numéro de TVA de la Tanzanie | 12345678A |
Thaïlande | th_ | TVA Thaïlande | 1234567891234 |
Turquie | tr_ | Numéro d'identification fiscale turc | 0123456789 |
Ukraine | ua_ | TVA Ukraine | 123456789 |
Uruguay | uy_ | Numéro RUC uruguayen | 123456789012 |
Zambie | zm_ | Numéro fiscal de la Zambie | 1004751879 |
Zimbabwe | zw_ | Numéro fiscal du Zimbabwe | 1234567890 |