Collecte des numéros fiscaux des clients avec Checkout
Dans de nombreux pays, il est obligatoire d’indiquer le numéro fiscal et la dénomination sociale du client sur les factures. Vous pouvez facilement répondre à cette exigence en activant la collecte du numéro fiscal dans Checkout. Dans ce guide, nous partons du principe que vous avez déjà intégré Checkout. Si ce n’est pas le cas, consultez notre guide.
Types de numéros fiscaux pris en charge
Checkout recueille les types de numéros suivants dans les régions indiquées :
Pays | Enum | Description | Exemple |
---|---|---|---|
Afrique du Sud | za_vat | Numéro de TVA sud-africain | 4123456789 |
Allemagne | eu_vat | European VAT number | DE123456789 |
Arabie saoudite | sa_vat | TVA Arabie Saoudite | 123456789012345 |
Australie | au_abn | Numéro d'identification australien (AU ABN) | 12345678912 |
Autriche | eu_vat | European VAT number | ATU12345678 |
Bahreïn | bh_vat | Numéro de TVA bahreïnien | 123456789012345 |
Belgique | eu_vat | European VAT number | BE0123456789 |
Bulgarie | eu_vat | European VAT number | BG0123456789 |
Canada | ca_bn | Numéro BN canadien | 123456789 |
Canada | ca_gst_hst | Numéro GST/HST canadien | 123456789RT0002 |
Canada | ca_pst_bc | Numéro PST canadien (Colombie-Britannique) | PST-1234-5678 |
Canada | ca_pst_mb | Numéro PST canadien (Manitoba) | 123456-7 |
Canada | ca_pst_sk | Numéro PST canadien (Saskatchewan) | 1234567 |
Canada | ca_qst | Numéro QST canadien (Québec) | 1234567890TQ1234 |
Chili | cl_tin | Numéro TIN chilien | 12.345.678-K |
Chypre | eu_vat | European VAT number | CY12345678Z |
Corée du Sud | kr_brn | Numéro BRN coréen | 123-45-67890 |
Croatie | eu_vat | European VAT number | HR12345678912 |
Danemark | eu_vat | European VAT number | DK12345678 |
Égypte | eg_tin | Numéro d'identification fiscale égyptien | 123456789 |
Émirats arabes unis | ae_trn | Numéro TRN des Émirats arabes unis | 123456789012345 |
Espagne | es_cif | Numéro NIF espagnol (auparavant numéro CIF espagnol) | A12345678 |
Espagne | eu_vat | European VAT number | ESA1234567Z |
Estonie | eu_vat | European VAT number | EE123456789 |
Finlande | eu_vat | European VAT number | FI12345678 |
France | eu_vat | European VAT number | FRAB123456789 |
Géorgie | ge_vat | TVA Géorgie | 123456789 |
Grèce | eu_vat | European VAT number | EL123456789 |
Hongrie | eu_vat | European VAT number | HU12345678 |
Inde | in_gst | Numéro GST indien | 12ABCDE3456FGZH |
Irlande | eu_vat | European VAT number | IE1234567AB |
Islande | is_vat | TVA Islande | 123456 |
Italie | eu_vat | European VAT number | IT12345678912 |
Kazakhstan | kz_bin | Numéro d'identification de l'entreprise kazakhe | 123456789012 |
Kenya | ke_pin | Numéro d'identification personnel de la Kenya Revenue Authority | P000111111A |
Lettonie | eu_vat | European VAT number | LV12345678912 |
Lituanie | eu_vat | European VAT number | LT123456789123 |
Luxembourg | eu_vat | European VAT number | LU12345678 |
Malte | eu_vat | European VAT number | MT12345678 |
Mexique | mx_rfc | Numéro RFC mexicain | ABC010203AB9 |
Nigéria | ng_tin | Numéro fiscal nigérian | 12345678-0001 |
Norvège | no_vat | Numéro de TVA norvégien | 123456789MVA |
Nouvelle-Zélande | nz_gst | Numéro GST Nouvelle-Zélande | 123456789 |
Oman | om_vat | Numéro de TVA omanais | OM1234567890 |
Pays-Bas | eu_vat | European VAT number | NL123456789B12 |
Pologne | eu_vat | European VAT number | PL1234567890 |
Portugal | eu_vat | European VAT number | PT123456789 |
République tchèque | eu_vat | European VAT number | CZ1234567890 |
Roumanie | eu_vat | European VAT number | RO1234567891 |
Royaume-Uni | eu_vat | Northern Ireland VAT number | XI123456789 |
Royaume-Uni | gb_vat | Numéro de TVA du Royaume-Uni | GB123456789 |
Russie | ru_inn | Numéro INN russe | 1234567891 |
Russie | ru_kpp | Numéro KPP russe | 123456789 |
Singapour | sg_gst | Numéro GST singapourien | M12345678X |
Slovaquie | eu_vat | European VAT number | SK1234567891 |
Slovénie | eu_vat | European VAT number | SI12345678 |
Suède | eu_vat | European VAT number | SE123456789123 |
Suisse | ch_vat | Numéro de TVA suisse | CHE-123.456.789 MWST |
Thaïlande | th_vat | TVA Thaïlande | 1234567891234 |
Turquie | tr_tin | Numéro d'identification fiscale turc | 0123456789 |
Activer la collecte du numéro fiscal
Lorsque la collecte des numéros fiscaux est activée, Checkout affiche ou masque le formulaire de recueil du numéro fiscal en fonction de la localisation de votre client. Si la collecte du numéro fiscal est prise en charge dans le pays où se trouve votre client, Checkout affiche une case à cocher permettant au client d’indiquer s’il est une entreprise. Quand la case est cochée, Checkout affiche des champs supplémentaires pour la saisie du numéro fiscal et de la dénomination sociale du client. Checkout détermine la localisation du client à l’aide de son adresse de livraison lorsqu’elle est disponible. Sinon, la localisation est basée sur l’adresse de facturation du client. Chaque client ne peut saisir qu’un seul numéro fiscal.
Nouveaux clients
Pour activer le recueil de numéros fiscaux pour les nouveaux clients, définissez le paramètre tax_id_collection[enabled]
sur true
lors de la création d’une session Checkout.
Note
L’exemple de code ci-dessus crée une session en mode payment
avec collecte des numéros fiscaux activée. Pour activer la collecte des numéros fiscaux en mode subscription
, apportez les modifications surlignées en vert dans votre requête de création de session en mode subscription
.
Vous pouvez également configurer Checkout de sorte à créer automatiquement un nouveau client à l’aide de customer_creation. Dans ce cas, Checkout enregistre les informations fiscales collectées au cours d’une session pour ce nouveau client. Sinon, les informations relatives au numéro fiscal seront toujours disponibles dans customer_details.tax_ids.
Clients existants
Si vous transmettez un objet Customer existant lors de la création d’une session, Checkout met à jour cet objet Customer en remplaçant les informations fiscales existantes par celles qui sont recueillies lors de la session. Checkout enregistre la dénomination sociale recueillie sous la propriété nom et le numéro fiscal recueilli dans la matrice customer.tax_ids de l’objet Customer. Puisque la collecte de la dénomination sociale peut effacer le nom existant de l’objet Customer, vous devez définir le paramètre customer_update[name]
sur auto
lors de la création de la session.
Mise en garde
Checkout ne recueille que les numéros fiscaux des objets Customer qui n’en disposent pas encore. Si un objet Customer est déjà associé à un ou plusieurs numéros fiscaux, Checkout n’affichera pas le formulaire de recueil du numéro fiscal, même si la collecte du numéro fiscal est activée.
Lors du recueil des numéros fiscaux de clients existants, vous pouvez choisir de baser leur localisation sur les adresses existantes de ces clients ou sur les adresses saisies lors du règlement. Checkout recherche par défaut l’adresse existante des clients pour déterminer leur localisation :
Si les adresses de vos clients existants ne sont pas enregistrées, vous pouvez choisir de baser leur localisation sur l’adresse de facturation ou de livraison saisie lors du règlement. Pour indiquer que vous souhaitez déterminer la localisation du client à l’aide de l’adresse de facturation saisie lors du règlement, vous devez définir le paramètre customer_update[address]
sur auto
.
Note
Lorsque le paramètre customer_update[address]
est défini sur auto
, Checkout remplace toutes les adresses précédemment enregistrées pour ce client par l’adresse de livraison saisie lors de la session.
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
.
Note
Lorsque le paramètre customer_update[shipping]
est défini sur auto
, Checkout remplace toutes les adresses de livraison précédemment enregistrées pour ce client par l’adresse de livraison saisie lors de la session.
Note
Les exemples de code ci-dessus créent des sessions en mode payment
avec collecte des numéros fiscaux activée. Pour activer la collecte des numéros fiscaux en mode subscription
, apportez les modifications surlignées en vert dans votre requête de création de session en mode 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 la matrice 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": [ {
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 sous la matrice 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 Numéros fiscaux en spécifiant 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é name de l’objet Customer. De cette façon, la dénomination sociale recueillie apparaît sur toutes les factures d’abonnement de ce client.
Test de votre intégration
En mode test, vous pouvez saisir n’importe quelle chaîne de caractères alphanumériques correspondant au format d’un type de numéro fiscal pris en charge (par exemple DE123456789
pour eu_vat
). Vous trouverez une liste d’exemples de numéros fiscaux dans notre Guide sur les numéros fiscaux des clients. Vous pouvez également utiliser nos numéros fiscaux de test pour tester différents flux d’état de vérification : tester des numéros fiscaux d’entreprises.
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 australien (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.