# Collecter les adresses des clients Comment collecter les données d'adresse de vos clients pour le calcul des montants de taxe. Stripe Tax doit accéder à la localisation de votre client pour calculer automatiquement la taxe. Cette exigence s’applique même si vous n’avez pas d’immatriculation active. Ce guide vous aide à comprendre comment collecter les adresses de vos clients. ## L’adresse du client que nous utilisons Stripe Tax utilise une seule adresse comme localisation de votre client pour calculer la taxe. La façon dont nous choisissons une adresse ne dépend pas du type de produit que vous vendez. Vous pouvez voir à quel emplacement un paiement dont la taxe est automatiquement calculée a été utilisé dans la section **Calcul automatique des taxes** sur la page Détails des transactions de votre Dashboard. Vous pouvez également vérifier le champ [tax.location.source](https://docs.stripe.com/api/customers/object.md#customer_object-tax-location-source) de l’objet API Customer. ### Checkout et Payment Links Checkout et Payment Links utilisent l’adresse collectée au cours de la session. ### Invoicing, Subscriptions et intégrations de paiements personnalisées #### Customer v1 Nous utilisons le premier élément valide de la liste ci-dessous pour déterminer la localisation de votre client : 1. Nous utilisons l’[adresse de livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) de votre client, si elle est fournie. - Si une adresse de livraison est présente mais non valide, nous générons une erreur `customer_tax_location_invalid` au lieu d’essayer l’adresse suivante de cette liste. 1. Nous utilisons l’[adresse de facturation](https://docs.stripe.com/api/customers/object.md#customer_object-address) de votre client, si elle est fournie. - Si une adresse de facturation est présente mais non valide, nous générons une erreur `customer_tax_location_invalid` au lieu d’essayer l’adresse suivante de cette liste. 1. Nous utilisons les [informations de facturation](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-billing_details) du moyen de paiement le plus spécifique, le cas échéant : 1. [Moyen de paiement par défaut](https://docs.stripe.com/api/invoices/object.md#invoice_object-default_payment_method) de la facture, s’il est fourni. 1. [Moyen de paiement par défaut](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) de l’abonnement, s’il est fourni. 1. [Moyen de paiement par défaut](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-default_payment_method) du client, s’il est fourni. 1. Nous utilisons l’[adresse IP](https://docs.stripe.com/api/customers/object.md#customer_object-tax-ip_address) de votre client, si elle est fournie. Affichage de l'ordre de priorité des adresses de clients utilisées par Stripe Tax. (See full diagram at https://docs.stripe.com/tax/customer-locations) Si les détails de facturation associés à un moyen de paiement sont incomplets ou manquants, nous essayons de déduire une adresse de facturation plus complète. Par exemple, si nous connaissons le pays de l’émetteur de la carte, nous le combinons avec le code postal dans les détails de facturation. ### API Tax Pour l’API Tax, la hiérarchie des adresses suit une approche simplifiée : - L’adresse fournie dans la requête API est directement utilisée pour le calcul des taxes. - Il n’est pas possible de revenir à d’autres sources d’adresses telles que l’adresse de livraison, l’adresse de facturation, le moyen de paiement ou les adresses IP. > Lorsque vous utilisez l’API Tax, vous devez fournir une adresse valide et complète dans vos requêtes API, faute de quoi elles renvoient une erreur. Indiquez le pays et, le cas échéant, le code postal et l’État. ## Collecte d’adresses minimale Chaque adresse de facturation et de livraison possède des champs `line1`, `line2`, `city`, `state`, `postal_code` et `country`. Le `country` doit être un [code ISO 3166-1 à deux lettres](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). #### États-Unis | Exemples d’adresse | Explication | Pris en charge | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | - `line1` : 27 Fredrick Ave - `city`: Brothers - `state` : OR - `postal_code` : 97712 - `country`: US | **Adresse complète** Une adresse complète comprend au moins la ligne 1 (adresse de la rue ou boîte postale), la ville, l’état, le code postal et le pays. L’adresse est appariée avec l’adresse ou la rue la plus proche dans la base de données des adresses du Service postal des États-Unis. Si aucune correspondance n’est trouvée, nous utilisons le centre géographique (emplacement moyen des adresses) de la zone couverte par le code postal à cinq chiffres comme solution alternative. | ✓ Pris en charge | | Code postal à 9 chiffres : - `postal_code` : 97712-4918 - `country`: US Code postal à 5 chiffres : - `postal_code` : 97712 - `country`: US | **Pays et code postal** Si vous avez fourni un code postal à cinq ou neuf chiffres, notre système calcule les taxes à l’aide des 5 premiers chiffres seulement. Nous calculons la taxe au centre géographique qui correspond à l’emplacement moyen des adresses au sein de la zone couverte par le code postal à cinq chiffres. Vérifiez que cela [convient à votre entreprise](https://docs.stripe.com/tax/customer-locations.md#us-postal-codes). | ✓ Pris en charge | | - `state` : OR - `country`: US | **Pays et État** Nous ne pouvons pas calculer le montant de taxe dû pour un client installé aux États-Unis avec uniquement le [code pays](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) ISO et un [code d’État](https://en.wikipedia.org/wiki/ISO_3166-2). | ✗ Non pris en charge | | - `country`: US | **Pays** Nous ne pouvons pas calculer le montant de taxe dû pour un client installé aux États-Unis avec uniquement le [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). | ✗ Non pris en charge | #### Canada | Exemples d’adresse | Explication | Pris en charge | | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | - `line1` : 1 Rocky Road - `city` : Vancouver - `province` : BC - `postal_code` : V1X 1X1 - `country`: CA | **Adresse complète** Une adresse complète comprend au moins la ligne 1 (adresse de la rue), la ville, la province, le code postal et le pays. Nous calculons la taxe à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et de la province. Les autres champs d’adresse ne sont pas utilisés pour calculer la taxe. | ✓ Pris en charge | | Code postal à 6 chiffres : - `postal_code` : V1X 1X1 - `country`: CA | **Pays et code postal** Nous calculons la taxe à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et de la province que nous déduisons du code postal. | ✓ Pris en charge | | - `province` : BC - `country`: CA | **Pays et province** Nous calculons la taxe pour les clients au Canada à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et de la province. | ✓ Pris en charge | | - `country`: CA | **Pays** Nous ne pouvons pas calculer le montant de taxe dû pour un client installé au Canada avec uniquement le [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). | ✗ Non pris en charge | #### Ukraine | Exemples d’adresse | Explication | Pris en charge | | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | - `line1` : Vyshneva St, 36 - `city` : Kiev - `province` : UA-32 - `postal_code` : 01001 - `country` : UA | **Adresse complète** Une adresse complète comprend au moins la ligne 1 (adresse de la rue), la ville, la province, le code postal et le pays. Nous calculons les taxes à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et du code postal. Les autres champs d’adresse ne sont pas utilisés pour calculer les taxes. | ✓ Pris en charge | | Code postal à 5 chiffres : - `postal_code` : 01001 - `country` : UA | **Pays et code postal** Nous calculons les taxes à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et du code postal. | ✓ Pris en charge | | - `province` : UA-32 - `country` : UA | **Pays et province** Nous ne pouvons pas calculer les taxes pour les clients résidant en Ukraine à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et de l’[oblast](https://www.iso.org/obp/ui/#iso:code:3166:UA) (province). | ✗ Non pris en charge | | - `country` : UA | **Pays** Nous ne pouvons pas calculer les taxes pour les clients résidant en Ukraine avec uniquement le [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). | ✗ Non pris en charge | #### Inde | Exemples d’adresse | Explication | Pris en charge | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | - `line1` : Rafi Marg, 118 - `city` : Delhi - `province` : Territoire de la capitale nationale (NCT) de Delhi (Territoire de l’Union) - `postal_code` : 110001 - `country` : IN | **Adresse complète** Une adresse complète comprend au moins la ligne 1 (adresse de la rue), la ville, la province, le code postal et le pays. Nous calculons la taxe à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et du code postal ou du nom de la province. | ✓ Pris en charge | | Code postal à 6 chiffres : - `postal_code` : 110001 - `country` : IN | **Pays et code postal** Nous calculons la taxe à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et du code postal ou du nom de la province. | ✓ Pris en charge | | - `province` : Territoire de la capitale nationale (NCT) de Delhi (Territoire de l’Union) - `country` : IN | **Pays et province** Nous calculons la taxe à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) et du code postal ou du nom de la province. | ✓ Pris en charge | | - `country` : IN | **Pays** Nous ne pouvons pas calculer le montant de taxe dû pour un client installé en Inde avec uniquement le [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). | ✗ Non pris en charge | #### Autres pays | Exemples d’adresse | Explication | Pris en charge | | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- | | - `line1` : 1 Grand Canal St - `city`: Dublin - `postal_code` : D02 H210 - `country`: IE | **Adresse complète** Les champs inclus dans une adresse complète diffèrent selon les pays, mais comprennent généralement la ligne 1 (adresse de la rue), la ville, l’état, le code postal et le pays. Nous calculons la taxe à partir du [code pays](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) ISO et du [code d’état](https://en.wikipedia.org/wiki/ISO_3166-2) ou du code postal, s’il est fourni. Les autres champs d’adresse ne sont pas utilisés pour calculer la taxe. | ✓ Pris en charge | | - `postal_code` : 51001 - `country` : ES | **Pays et code postal** Nous calculons la taxe à partir du [code pays](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) ISO et nous utilisons le code postal pour déterminer si votre client est situé sur un [territoire exclu](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories). | ✓ Pris en charge | | - `state` : CE - `country` : ES | **Pays et État** Nous calculons la taxe à partir du [code pays](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) ISO et du [code d’État](https://en.wikipedia.org/wiki/ISO_3166-2). Nous utilisons le code d’État pour déterminer si votre client est situé sur un [territoire exclu](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories). | ✓ Pris en charge | | - `country` : ES | **Pays** Nous calculons la taxe à partir du [code pays ISO](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Si votre client est situé sur un [territoire exclu](https://docs.stripe.com/tax/customer-locations.md#europe-excluded-territories), le taux de taxe du pays s’applique. | ✓ Pris en charge | Utilisez l’un des formats d’adresse pris en charge ci-dessus pour nous permettre de reconnaître les adresses de vos clients de manière systématique. ## Spécificités régionales ### États-Unis Aux États-Unis, les règles et les taux de la taxe sur les ventes varient d’un État à l’autre, certains États comptant des centaines de districts qui fixent leurs propres taux. Nous vous recommandons de collecter l’adresse complète (y compris les champs [line1](https://docs.stripe.com/api/customers/object.md#customer_object-address-line1), [city](https://docs.stripe.com/api/customers/object.md#customer_object-address-city) et [state](https://docs.stripe.com/api/customers/object.md#customer_object-address-state)) de vos clients aux États-Unis. #### Précision de l’adresse IP Dans la plupart des cas, nous pouvons trouver une adresse IP en fonction d’une zone physique, mais sa précision varie et peut ne pas refléter la localisation réelle du client. Étant donné que les États-Unis imposent des taxes locales, nous ne recommandons pas de se fier à l’adresse IP d’un client pour déterminer son adresse. #### Recherche d’adresse précise Stripe Tax prend en charge la recherche d’adresse complète et précise pour les adresses des clients aux États-Unis, ce qui signifie que vous pouvez attribuer la localisation de votre client à une habitation spécifique. Cette fonction offre une plus grande fiabilité aux États-Unis, où deux maisons situées côte à côte dans une même rue peuvent être soumises à des taux de taxe différents du fait de la complexité des frontières juridictionnelles. Pour les adresses en dehors des États-Unis, Stripe utilise les champs relatifs au pays, à l’État et au code postal pour déterminer les obligations fiscales sans les comparer avec une base de données d’adresses complète. Consultez la section [Juridictions spéciales et territoires exclus](https://docs.stripe.com/tax/zero-tax.md#excluded-territories) pour en savoir plus sur les cas où l’État et le code postal sont utilisés. > Stripe Tax utilise le code postal américain à 5 chiffres si l’adresse ne contient pas suffisamment d’informations, si elle présente des incohérences ou si elle ne peut pas être associée à une adresse figurant dans la base de données des adresses des services postaux américains (US Postal Service). #### Adresses militaires et diplomatiques aux États-Unis Stripe Tax ne calcule aucune taxe pour les courriers militaires et diplomatiques américains envoyés à l’étranger. Les adresses militaires et diplomatiques à l’étranger se voient attribuer un code postal APO, FPO ou DPO, et l’USPS traite les colis au même titre que les courriers nationaux avant de les transférer à l’armée. Comme les commandes vers ces codes postaux spéciaux sont envoyées à l’étranger, les taxes sur les ventes ne s’appliquent pas. #### Codes postaux Aux États-Unis, Stripe Tax prend en charge le calcul de la taxe de vente avec seulement un code postal américain de base à 5 chiffres. Nous utilisons le point situé au centre géographique de la zone couverte par le code postal à 5 chiffres comme localisation de votre client. Le taux de taxe à ce point peut différer du taux de taxe à l’adresse complète de votre client. Le fait qu’un code postal seul soit suffisant ou non pour identifier le taux de taxe correct à appliquer dépend de l’État. Nous vous recommandons de ne pas utiliser uniquement le code postal dans les États suivants : - Alabama - Alaska - Arizona - Arkansas - Californie - Colorado - Illinois - Kansas - Louisiane - Missouri - Nebraska - Nouveau-Mexique - Dakota du Nord - Oklahoma - Dakota du Sud - Texas - Utah - Washington - Virginie-Occidentale > Stripe Tax prend également en charge les codes postaux ZIP+4 à 9 chiffres, mais nous n’utilisons pas les quatre chiffres supplémentaires. ### Europe #### Fiabilité des adresses IP Dans les régions qui n’imposent pas de taxes locales, comme l’UE, une adresse IP est davantage susceptible de correspondre à une adresse exacte. #### Territoires exclus En Europe, ce sont les administrations fiscales de chaque pays qui imposent la taxe, et non les autorités au niveau infranational. Le taux de taxe du pays ne s’applique pas dans un petit nombre de régions, même si elles sont physiquement situées dans un pays qui impose la taxe. Par exemple, le code postal italien « 00120 » identifie la Cité du Vatican, où la TVA italienne ne s’applique pas. Collectez le code postal ou l’État de votre client pour permettre à Stripe Tax de déterminer si votre client est situé dans un territoire exclu. Consultez la [liste des territoires exclus](https://docs.stripe.com/tax/zero-tax.md#excluded-territories) pris en charge par Stripe Tax. ## Meilleures pratiques pour la collecte de l’adresse des clients ### Checkout et Payment Links Checkout gère pour vous la collecte des adresses des clients, y compris celles créées par Payment Links. ### Invoicing, Subscriptions et intégrations de paiements personnalisées Si vous n’utilisez ni Payment Links ni Checkout, vous êtes responsable de la collecte des adresses des clients. #### Customer v1 - Renseignez et définissez à la fois les champs [country](https://docs.stripe.com/api/customers/object.md#customer_object-address-country) et [postal_code](https://docs.stripe.com/api/customers/object.md#customer_object-address-postal_code) sur votre `Customer`. - Lors de la création ou de la mise à jour d’un `Customer`, définissez [tax.validate_location](https://docs.stripe.com/api/customers/create.md#create_customer-tax-validate_location) sur `immediately` afin d’éviter des erreurs [customer_tax_location_invalid](https://docs.stripe.com/error-codes.md#customer-tax-location-invalid) ultérieures. - Utilisez des codes de pays à deux lettres [(ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - Écouter les [événements webhook pour les abonnements](https://docs.stripe.com/billing/subscriptions/webhooks.md), car la plupart des activités se déroulent de manière asynchrone. ## Gérer les erreurs de finalisation de la facture La finalisation des factures avec Stripe Tax nécessite une localisation client reconnue. Les informations de localisation peuvent être manquantes ou invalides si vous mettez à jour ou supprimez le moyen de paiement par défaut d’un client, ou si vous n’avez pas défini `tax[validate_location]="immediately"` lors de la création ou de la mise à jour d’un `Customer` . Si aucune localisation client reconnue n’est disponible, les factures d’une `Subscription` continuent à se [finaliser automatiquement](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md), mais sans calcul des taxes. Cela entraîne les conséquences suivantes : - Le paramètre `automatic_tax[enabled]` passe à l’état `false` sur l’[abonnement](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-automatic_tax-enabled) et la [facture](https://docs.stripe.com/api/invoices/object.md#invoice_object-automatic_tax-enabled). - Le paramètre `Invoice[automatic_tax][disabled_reason]` devient `finalization_requires_location_inputs`. - Le paramètre `Subscription[automatic_tax][disabled_reason]` devient `requires_location_inputs`. - Si la `Subscription` dispose d’un [schedule](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), nous définissons `automatic_tax[enabled]` sur `false` pour la phase en cours ainsi que dans `default_settings.` Nous définissons également `disabled_reason` sur `requires_location_inputs` dans les deux cas. - Nous envoyons des [événements](https://docs.stripe.com/billing/subscriptions/webhooks.md#events) `invoice.updated` et `customer.subscription.updated` pour informer votre intégration de ces modifications. - S’il y a une planification, nous envoyons également un webhook `subscription_schedule.updated`. - La `Invoice` se finalise sans calcul ni collecte des taxes. Elle ne contient aucun montant de taxe. - Nous collectons le paiement comme d’habitude, conformément à la [collection method](https://docs.stripe.com/billing/collection-method.md) définie pour la `Invoice`. Pour consulter les abonnements sans calcul automatique de la taxe dans votre Dashboard Stripe, accédez à votre page Abonnements et filtrez l’affichage par l’option **Taxe automatique non activée**. Pour réactiver la taxe automatique pour ces abonnements à l’avenir, assurez-vous d’avoir au moins une localisation client valide, et activez la taxe automatique via le [Dashboard Stripe Tax](https://dashboard.stripe.com/tax/migrations). ### Exceptions à la désactivation automatique de la taxe Stripe renvoie une erreur et laisse la `Invoice` à l’état `draft` lorsque vous la finalisez via l’[API](https://docs.stripe.com/api/invoices/finalize.md) ou le Dashboard sans localisation client valide. Dans l’API, cela renvoie une erreur HTTP 400 avec un `code` égal à `customer_tax_location_invalid`. De même, pour la finalisation automatique des factures autonomes sans `Subscription`, la `Invoice` reste à l’état draft si l’emplacement du client n’est pas valide. Nous envoyons un évènement [invoice.finalization_failed](https://docs.stripe.com/api/events/types.md#event_types-invoice.finalization_failed) avec `Invoice` [last_finalization_error[code]](https://docs.stripe.com/api/invoices/object.md#invoice_object-last_finalization_error-code) défini sur `customer_tax_location_invalid`. La manière de corriger une erreur `customer_tax_location_invalid` dépend du fait que vous disposez déjà d’une adresse de `Customer`, ou que vous puissiez en collecter une. Si vous disposez d’une adresse de `Customer`, ou si vous pouvez en collecter une, mettez à jour le `Customer`, puis finalisez la `Invoice` manuellement. #### Customer v1 1. Mettez à jour [tax.validate_locatio](https://docs.stripe.com/api/customers/create.md#create_customer-tax-validate_location) avec l’état `immediately` pour vous assurer que la nouvelle adresse est valide. 1. [Finalisez](https://docs.stripe.com/api/invoices/finalize.md) la `Invoice`. Si vous ne disposez pas de l’adresse du client ou ne pouvez pas la collecter, désactivez Stripe Tax pour la `Invoice` et sa `Subscription`, puis finalisez la `Invoice` manuellement. 1. [Mettez à jour la `Invoice`](https://docs.stripe.com/api/invoices/update.md#update_invoice-automatic_tax) concernée en indiquant `automatic_tax[enabled]=false`. 1. [Mettez à jour la`Subscription`](https://docs.stripe.com/api/subscriptions/update.md#update_subscription-automatic_tax-enabled) concernée en indiquant `automatic_tax[enabled]=false`. 1. [Finalisez la `Invoice`](https://docs.stripe.com/api/invoices/finalize.md). ## See also - [Comprendre les montants de taxe nuls](https://docs.stripe.com/tax/zero-tax.md) - [Codes de taxes disponibles](https://docs.stripe.com/tax/tax-codes.md) - [Comment s’effectue le calcul des taxes](https://docs.stripe.com/tax/calculating.md)