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 de démarrage rapide pour commencer.
Avis de non-responsabilité
L’API Checkout Sessions est conçue pour collecter les numéros fiscaux des entreprises, dont le format peut être similaire à celui des numéros fiscaux personnels dans certaines régions. Vous devez impérativement vous assurer que seuls des numéros fiscaux d’entreprise, tels que désignés pour ce champ, sont fournis lors de l’utilisation de cette fonctionnalité.
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 testing environments, 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
During the Checkout Session, Stripe verifies that the provided tax IDs are formatted correctly, but not that they’re valid. You’re responsible for ensuring the validity of customer information collected during checkout. To help, Stripe automatically performs asynchronous validation against government databases for European Value Added Tax (EU VAT) and United Kingdom Value Added Tax (GB VAT) numbers. Learn more about the validation we perform, and how to consume the status of those checks.
If you use Stripe Tax and your customer provides a tax ID, Stripe Tax applies the reverse charge or zero rate according to applicable laws, as long as the tax ID conforms to the necessary number format, regardless of its validity.
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 | Impact sur le calcul des taxes |
---|---|---|---|---|
Afrique du Sud | za_vat | Numéro de TVA sud-africain | 4123456789 | Oui |
Albanie | al_tin | Numéro d'identification fiscale albanais | J12345678N | Oui |
Allemagne | eu_vat | European VAT number | DE123456789 | Oui |
Angola | ao_tin | Numéro fiscal de l'Angola | 5123456789 | Non |
Arabie saoudite | sa_vat | TVA Arabie Saoudite | 123456789012345 | Oui |
Arménie | am_tin | Numéro fiscal de l’Arménie | 02538904 | Oui |
Aruba | aw_tin | Numéro fiscal d’Aruba | 12345678 | Oui |
Australie | au_abn | Numéro d'identification australien (AU ABN) | 12345678912 | Oui |
Autriche | eu_vat | European VAT number | ATU12345678 | Oui |
Azerbaïdjan | az_tin | Numéro fiscal de l’Azerbaïdjan | 0123456789 | Oui |
Bahamas | bs_tin | Numéro fiscal des Bahamas | 123.456.789 | Non |
Bahreïn | bh_vat | Numéro de TVA bahreïnien | 123456789012345 | Oui |
Bangladesh | bd_bin | Numéro d’identification d’entreprise du Bangladesh | 123456789-0123 | Oui |
Barbade | bb_tin | Numéro fiscal de la Barbade | 1123456789012 | Non |
Belgique | eu_vat | European VAT number | BE0123456789 | Oui |
Bénin | bj_ifu | Numéro fiscale du Bénin (Identifiant fiscal unique) | 1234567890123 | Oui |
Biélorussie | by_tin | Numéro d'identification fiscale de la Biélorussie | 123456789 | Oui |
Bosnie-Herzégovine | ba_tin | Numéro fiscal de la Bosnie-Herzégovine | 123456789012 | Oui |
Bulgarie | eu_vat | European VAT number | BG0123456789 | Oui |
Burkina Faso | bf_ifu | Numéro fiscal du Burkina Faso (Numéro d'Identifiant fiscal unique) | 12345678A | Oui |
Cambodge | kh_tin | Numéro fiscal du Cambodge | 1001-123456789 | Oui |
Cameroun | cm_niu | Numéro fiscale du Cameroun (Numéro d’Identifiant fiscal unique) | M123456789000L | Non |
Canada | ca_bn | Numéro BN canadien | 123456789 | Non |
Canada | ca_gst_hst | Numéro GST/HST canadien | 123456789RT0002 | Oui |
Canada | ca_pst_bc | Numéro PST canadien (Colombie-Britannique) | PST-1234-5678 | Non |
Canada | ca_pst_mb | Numéro PST canadien (Manitoba) | 123456-7 | Non |
Canada | ca_pst_sk | Numéro PST canadien (Saskatchewan) | 1234567 | Non |
Canada | ca_qst | Numéro QST canadien (Québec) | 1234567890TQ1234 | Oui |
Cap-Vert | cv_nif | Numéro fiscal du Cap-Vert (Número de Identificação Fiscal) | 213456789 | Non |
Chili | cl_tin | Numéro TIN chilien | 12.345.678-K | Oui |
Chypre | eu_vat | European VAT number | CY12345678Z | Oui |
Congo-Kinshasa | cd_nif | Numéro fiscal de la République démocratique du Congo (Número de Identificação Fiscal) | A0123456M | Non |
Corée du Sud | kr_brn | Numéro BRN coréen | 123-45-67890 | Oui |
Costa Rica | cr_tin | Numéro fiscal du Costa Rica | 1-234-567890 | Non |
Croatie | eu_vat | European VAT number | HR12345678912 | Oui |
Danemark | eu_vat | European VAT number | DK12345678 | Oui |
Égypte | eg_tin | Numéro d'identification fiscale égyptien | 123456789 | Oui |
Émirats arabes unis | ae_trn | Numéro TRN des Émirats arabes unis | 123456789012345 | Oui |
Équateur | ec_ruc | Numéro RUC équatorien | 1234567890001 | Non |
Espagne | es_cif | Numéro NIF espagnol (auparavant numéro CIF espagnol) | A12345678 | Non |
Espagne | eu_vat | European VAT number | ESA1234567Z | Oui |
Estonie | eu_vat | European VAT number | EE123456789 | Oui |
Éthiopie | et_tin | Numéro fiscal de l’Éthiopie | 1234567890 | Oui |
Finlande | eu_vat | European VAT number | FI12345678 | Oui |
France | eu_vat | European VAT number | FRAB123456789 | Oui |
Géorgie | ge_vat | TVA Géorgie | 123456789 | Oui |
Grèce | eu_vat | European VAT number | EL123456789 | Oui |
Guinée | gn_nif | Numéro fiscal de la Guinée (Número de Identificação Fiscal) | 123456789 | Oui |
Hongrie | eu_vat | European VAT number | HU12345678 | Oui |
Inde | in_gst | Numéro GST indien | 12ABCDE3456FGZH | Oui |
Irlande | eu_vat | European VAT number | IE1234567AB | Oui |
Islande | is_vat | TVA Islande | 123456 | Oui |
Italie | eu_vat | European VAT number | IT12345678912 | Oui |
Kazakhstan | kz_bin | Numéro d'identification de l'entreprise kazakhe | 123456789012 | Oui |
Kenya | ke_pin | Numéro d'identification personnel de la Kenya Revenue Authority | P000111111A | Non |
Kirghizistan | kg_tin | Numéro fiscal du Kirghizistan | 12345678901234 | Non |
Laos | la_tin | Numéro fiscal du Laos | 123456789-000 | Non |
Lettonie | eu_vat | European VAT number | LV12345678912 | Oui |
Liechtenstein | li_vat | Numéro de TVA au Liechtenstein | 12345 | Oui |
Lituanie | eu_vat | European VAT number | LT123456789123 | Oui |
Luxembourg | eu_vat | European VAT number | LU12345678 | Oui |
Macédoine du Nord | mk_vat | Numéro de TVA de la Macédoine du Nord | MK1234567890123 | Oui |
Malte | eu_vat | European VAT number | MT12345678 | Oui |
Maroc | ma_vat | Numéro de TVA du Maroc | 12345678 | Oui |
Mauritanie | mr_nif | Numéro fiscal de la Mauritanie (Número de Identificação Fiscal) | 12345678 | Non |
Mexique | mx_rfc | Numéro RFC mexicain | ABC010203AB9 | Non |
Moldavie | md_vat | Numéro de TVA de la Moldavie | 1234567 | Oui |
Monténégro | me_pib | Numéro PIB du Monténégro | 12345678 | Non |
Népal | np_pan | Numéro PAN du Népal | 123456789 | Oui |
Nigéria | ng_tin | Numéro fiscal nigérian | 12345678-0001 | Non |
Norvège | no_vat | Numéro de TVA norvégien | 123456789MVA | Oui |
Nouvelle-Zélande | nz_gst | Numéro GST Nouvelle-Zélande | 123456789 | Oui |
Oman | om_vat | Numéro de TVA omanais | OM1234567890 | Oui |
Ouganda | ug_tin | Numéro fiscal de l’Ouganda | 1014751879 | Oui |
Ouzbékistan | uz_tin | Numéro d'identification fiscale de l'Ouzbékistan | 123456789 | Non |
Ouzbékistan | uz_vat | Numéro de TVA de l'Ouzbékistan | 123456789012 | Oui |
Pays-Bas | eu_vat | European VAT number | NL123456789B12 | Oui |
Pérou | pe_ruc | Numéro RUC péruvien | 12345678901 | Oui |
Philippines | ph_tin | Numéro d'identification fiscale philippin | 123456789012 | Oui |
Pologne | eu_vat | European VAT number | PL1234567890 | Oui |
Portugal | eu_vat | European VAT number | PT123456789 | Oui |
République tchèque | eu_vat | European VAT number | CZ1234567890 | Oui |
Roumanie | eu_vat | European VAT number | RO1234567891 | Oui |
Royaume-Uni | eu_vat | Northern Ireland VAT number | XI123456789 | Oui |
Royaume-Uni | gb_vat | Numéro de TVA du Royaume-Uni | GB123456789 | Oui |
Russie | ru_inn | Numéro INN russe | 1234567891 | Oui |
Russie | ru_kpp | Numéro KPP russe | 123456789 | Oui |
Sénégal | sn_ninea | Numéro NINEA du Sénégal | 12345672A2 | Non |
Serbie | rs_pib | Numéro PIB de la Serbie | 123456789 | Non |
Singapour | sg_gst | Numéro GST singapourien | M12345678X | Oui |
Slovaquie | eu_vat | European VAT number | SK1234567891 | Oui |
Slovénie | eu_vat | European VAT number | SI12345678 | Oui |
Suède | eu_vat | European VAT number | SE123456789123 | Oui |
Suisse | ch_vat | Numéro de TVA suisse | CHE-123.456.789 MWST | Oui |
Suriname | sr_fin | Numéro FIN du Suriname | 1234567890 | Oui |
Tadjikistan | tj_tin | Numéro fiscal du Tadjikistan | 123456789 | Oui |
Taïwan | tw_vat | TVA Taïwan | 12345678 | Oui |
Tanzanie | tz_vat | Numéro de TVA de la Tanzanie | 12345678A | Oui |
Thaïlande | th_vat | TVA Thaïlande | 1234567891234 | Oui |
Turquie | tr_tin | Numéro d'identification fiscale turc | 0123456789 | Oui |
Ukraine | ua_vat | TVA Ukraine | 123456789 | Oui |
Uruguay | uy_ruc | Numéro RUC uruguayen | 123456789012 | Oui |
Zambie | zm_tin | Numéro fiscal de la Zambie | 1004751879 | Non |
Zimbabwe | zw_tin | Numéro fiscal du Zimbabwe | 1234567890 | Non |