# Collecter des taxes Découvrez comment collecter les taxes pour les paiements ponctuels dans Stripe Checkout. # Page hébergée > This is a Page hébergée for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/taxes?payment-ui=stripe-hosted. Stripe Tax vous permet de calculer la taxe sur vos paiements ponctuels et récurrents lorsque vous utilisez Checkout. Vous pouvez activer Stripe Tax pour calculer automatiquement les taxes sur tous vos achats et abonnements créés par Checkout. ## Créer une session Checkout Vous pouvez créer des sessions Checkout pour des achats ponctuels et récurrents. Afin de calculer les taxes pour de nouveaux clients, Checkout valide et utilise l’adresse de livraison ou de facturation fournie. Pour les clients existants, Checkout calcule les taxes en validant et en utilisant l’adresse de livraison ou de facturation associée au client. Si vous capturez une nouvelle adresse de facturation ou de livraison pour un client existant, Checkout ne remplacera pas automatiquement les informations de facturation ou de livraison précédentes. Vous devez explicitement demander à modifier l’adresse du client. ### Apple Pay et Google Pay Si vous utilisez Stripe Tax dans Checkout, vous devez collecter l’adresse de livraison pour que Google Pay figure dans les moyens de paiement proposés. Apple Pay avec Stripe Tax s’affiche uniquement lorsque le navigateur du client prend en charge la version 12 ou supérieure d’Apple Pay. ## Calculer les taxes pour les nouveaux clients Si vous ne transmettez pas un client existant lorsque vous créez une session Checkout, Checkout crée un client et enregistre automatiquement l’adresse de facturation et les informations de livraison. Checkout utilise l’adresse de livraison saisie pendant la session pour localiser le client et calculer les taxes. Si vous ne collectez pas les informations de livraison, Checkout utilise l’adresse de facturation. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Optional: Modifiez vos produits et tarifs Stripe Tax utilise les informations stockées sur les *produits* (Products represent what your business sells—whether that's a good or a service) et les *tarifs* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) pour calculer la taxe, par exemple le *code fiscal* (A tax code is the category of your product for tax purposes) et le *régime fiscal* (Tax behavior determines whether you want to include taxes in the price ("inclusive") or add them on top ("exclusive")). Si vous ne spécifiez pas explicitement ces configurations, Stripe Tax utilisera le code de taxe par défaut sélectionné dans les [paramètres fiscaux](https://dashboard.stripe.com/settings/tax). Pour plus d’informations, consultez la page [Spécifier les codes fiscaux du produit et le comportement fiscal](https://docs.stripe.com/taxer/products-prices-taxer-codes-taxer-behavior.md). ## Optional: Calculer les taxes pour les clients existants Afin de calculer les taxes d’une session Checkout pour un client existant, définissez le paramètre `automatic_tax[enabled]` sur `true` lorsque vous créez la session. Vous pouvez baser les calculs des taxes sur les adresses existantes du client ou sur les nouvelles adresses collectées au moment du paiement : ### Utiliser les adresses existantes du client pour le calcul des taxes Si vous avez déjà collecté les adresses de vos clients existants, vous pouvez baser les calculs des taxes sur ces adresses plutôt que sur les adresses collectées lors du paiement : - Quelle est l’adresse client utilisée par Checkout pour le calcul des taxes ? Lorsque l’[adresse de livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) enregistrée du client est disponible, Checkout l’utilise pour calculer les taxes. Sinon, Checkout utilise l’[adresse de facturation](https://docs.stripe.com/api/customers/object.md#customer_object-address) enregistrée du client pour ce calcul. - Les adresses du client doivent-elles respecter certaines exigences ? Si vous souhaitez utiliser des adresses existantes pour le calcul des taxes, le client doit avoir enregistré une [adresse de livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) ou une [adresse de facturation](https://docs.stripe.com/api/customers/object.md#customer_object-address) valide. Vous pouvez vérifier la validité des adresses enregistrées par le client à l’aide de la propriété [customer.tax.automatic_tax](https://docs.stripe.com/api/customers/object.md#customer_object-tax-automatic_tax). Si la valeur `customer.tax.automatic_tax` est `supported` ou `not_collecting`, cela signifie que les adresses enregistrées du client sont valides. Vous pouvez alors activer Stripe Tax dans les sessions Checkout pour ce client. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ### Utiliser les adresses collectées dans Checkout pour le calcul des taxes Vous pouvez configurer Checkout de manière à enregistrer les nouvelles adresses de facturation ou de livraison d’un client. Dans ce cas, Checkout calcule les taxes en utilisant l’adresse saisie lors du paiement. - Quelle est l’adresse utilisée par Checkout pour le calcul des taxes ? Si vous [collectez les adresses de livraison](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), Checkout utilise l’adresse de livraison saisie lors de la session pour calculer les taxes. Sinon, Checkout utilise l’adresse de facturation saisie. - Où sont enregistrées les adresses collectées dans Checkout ? Si vous [collectez les adresses de livraison](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), Checkout enregistre l’adresse de livraison saisie lors de la session dans la propriété [customer.shipping.address](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) du client. Sinon, Checkout enregistre l’adresse de facturation dans la propriété [customer.address](https://docs.stripe.com/api/customers/object.md#customer_object-address) du client. L’adresse utilisée pour les taxes remplacera toute adresse existante dans les deux cas. Si vous collectez les adresses de livraison via Checkout, définissez la propriété `customer_update[shipping]` sur `auto`. Cela permet de copier les informations de livraison de Checkout sur le client. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[shipping]=auto" \ -d "shipping_address_collection[allowed_countries][0]=US" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` Si vous ne collectez pas les adresses de livraison avec Checkout, et que vous voulez utiliser les adresses de facturation saisies pendant le paiement pour le calcul des taxes, vous devez enregistrer l’adresse de facturation du client. Définissez la propriété `customer_update[address]` sur `auto` afin de copier l’adresse saisie sur le client fourni. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[shipping]=auto" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Optional: Vérifier le résultat Pour consulter les résultats du dernier calcul de taxe, la propriété [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) dans la ressource de la session Checkout affiche le montant de la taxe calculée. De plus, vous pouvez utiliser le [Dashboard](https://dashboard.stripe.com/) pour afficher le résultat de la taxe pour chaque paiement. # Page intégrée > This is a Page intégrée for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/taxes?payment-ui=embedded-form. Stripe Tax vous permet de calculer la taxe sur vos paiements ponctuels et récurrents lorsque vous utilisez Checkout. Vous pouvez activer Stripe Tax pour calculer automatiquement les taxes sur tous vos achats et abonnements créés par Checkout. ## Créer une session Checkout Après avoir mis à jour vos produits et tarifs, vous pouvez commencer à calculer des taxes dans vos sessions Checkout. Vous pouvez créer des sessions pour des achats ponctuels et récurrents. Afin de calculer les taxes pour de nouveaux clients, Checkout valide et utilise l’adresse de livraison ou de facturation fournie. Pour les clients existants, Checkout calcule les taxes en validant et en utilisant l’adresse de livraison ou de facturation associée au client. Si vous capturez une nouvelle adresse de facturation ou de livraison pour un client existant, Checkout ne remplacera pas automatiquement les informations de facturation ou de livraison précédentes. Vous devez explicitement demander à modifier l’adresse du client. ### Apple Pay et Google Pay Si vous utilisez Stripe Tax dans Checkout, vous devez collecter l’adresse de livraison pour que Google Pay figure dans les moyens de paiement proposés. Apple Pay avec Stripe Tax s’affiche uniquement lorsque le navigateur du client prend en charge la version 12 ou supérieure d’Apple Pay. ## Calculer les taxes pour les nouveaux clients Si vous ne transmettez pas un client existant lorsque vous créez une session Checkout, Checkout crée un client et enregistre automatiquement l’adresse de facturation et les informations de livraison. Checkout utilise l’adresse de livraison saisie pendant la session pour localiser le client et calculer les taxes. Si vous ne collectez pas les informations de livraison, Checkout utilise l’adresse de facturation. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Optional: Modifiez vos produits et tarifs Stripe Tax utilise les informations stockées sur les *produits* (Products represent what your business sells—whether that's a good or a service) et les *tarifs* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) pour calculer la taxe, par exemple le *code fiscal* (A tax code is the category of your product for tax purposes) et le *régime fiscal* (Tax behavior determines whether you want to include taxes in the price ("inclusive") or add them on top ("exclusive")). Si vous ne spécifiez pas explicitement ces configurations, Stripe Tax utilisera le code de taxe par défaut sélectionné dans les [paramètres fiscaux](https://dashboard.stripe.com/settings/tax). Pour plus d’informations, consultez la page [Spécifier les codes fiscaux du produit et le comportement fiscal](https://docs.stripe.com/taxer/products-prices-taxer-codes-taxer-behavior.md). ## Optional: Calculer les taxes pour les clients existants Afin de calculer les taxes d’une session Checkout pour un client existant, définissez le paramètre `automatic_tax[enabled]` sur `true` lorsque vous créez la session. Vous pouvez baser les calculs des taxes sur les adresses existantes du client ou sur les nouvelles adresses collectées au moment du paiement : ### Utiliser les adresses existantes du client pour le calcul des taxes Si vous avez déjà collecté les adresses de vos clients existants, vous pouvez baser les calculs des taxes sur ces adresses plutôt que sur les adresses collectées lors du paiement : - Quelle est l’adresse client utilisée par Checkout pour le calcul des taxes ? Lorsque l’[adresse de livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) enregistrée du client est disponible, Checkout l’utilise pour calculer les taxes. Sinon, Checkout utilise l’[adresse de facturation](https://docs.stripe.com/api/customers/object.md#customer_object-address) enregistrée du client pour ce calcul. - Les adresses du client doivent-elles respecter certaines exigences ? Si vous souhaitez utiliser des adresses existantes pour le calcul des taxes, le client doit avoir enregistré une [adresse de livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) ou une [adresse de facturation](https://docs.stripe.com/api/customers/object.md#customer_object-address) valide. Vous pouvez vérifier la validité des adresses enregistrées par le client à l’aide de la propriété [customer.tax.automatic_tax](https://docs.stripe.com/api/customers/object.md#customer_object-tax-automatic_tax). Si la valeur `customer.tax.automatic_tax` est `supported` ou `not_collecting`, cela signifie que les adresses enregistrées du client sont valides. Vous pouvez alors activer Stripe Tax dans les sessions Checkout pour ce client. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ### Utiliser les adresses collectées dans Checkout pour le calcul des taxes Vous pouvez configurer Checkout de manière à enregistrer les nouvelles adresses de facturation ou de livraison d’un client. Dans ce cas, Checkout calcule les taxes en utilisant l’adresse saisie lors du paiement. - Quelle est l’adresse utilisée par Checkout pour le calcul des taxes ? Si vous [collectez les adresses de livraison](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), Checkout utilise l’adresse de livraison saisie lors de la session pour calculer les taxes. Sinon, Checkout utilise l’adresse de facturation saisie. - Où sont enregistrées les adresses collectées dans Checkout ? Si vous [collectez les adresses de livraison](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), Checkout enregistre l’adresse de livraison saisie lors de la session dans la propriété [customer.shipping.address](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) du client. Sinon, Checkout enregistre l’adresse de facturation dans la propriété [customer.address](https://docs.stripe.com/api/customers/object.md#customer_object-address) du client. L’adresse utilisée pour les taxes remplacera toute adresse existante dans les deux cas. Si vous collectez les adresses de livraison via Checkout, définissez la propriété `customer_update[shipping]` sur `auto`. Cela permet de copier les informations de livraison de Checkout sur le client. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[shipping]=auto" \ -d "shipping_address_collection[allowed_countries][0]=US" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Si vous ne collectez pas les adresses de livraison avec Checkout, et que vous voulez utiliser les adresses de facturation saisies pendant le paiement pour le calcul des taxes, vous devez enregistrer l’adresse de facturation du client. Définissez la propriété `customer_update[address]` sur `auto` afin de copier l’adresse saisie sur le client fourni. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d "customer={{CUSTOMER_ID}}" \ -d "customer_update[shipping]=auto" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Optional: Vérifier le résultat Pour consulter les résultats du dernier calcul de taxe, la propriété [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) dans la ressource de la session Checkout affiche le montant de la taxe calculée. De plus, vous pouvez utiliser le [Dashboard](https://dashboard.stripe.com/) pour afficher le résultat de la taxe pour chaque paiement.