# Percevoir les taxes Découvrez comment percevoir 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 qu’il calcule automatiquement les taxes sur tous vos achats et abonnements Checkout. ## Créer une session Checkout Vous pouvez créer des sessions Checkout pour les achats ponctuels et récurrents. Pour calculer la taxe pour de nouveaux clients, Checkout valide et utilise l’adresse de livraison ou de facturation fournie. Pour les clients existants, Checkout calcule la taxe 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 Pour que Google Pay soit proposé comme mode de paiement lors de l’utilisation de Stripe Tax dans Checkout, vous devez soit exiger de collecter une adresse de livraison, soit fournir à un client existant une adresse de livraison enregistrée. Apple Pay avec Stripe Tax s’affiche uniquement lorsque le navigateur du client supporte la version 12 ou supérieure d’Apple Pay. ## Calculer la taxe 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: Mettre à jour vos produits et prix 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 de taxe* (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 précisez pas explicitement ces configurations, Stripe Tax utilisera le code de taxe par défaut sélectionné dans vos [paramètres fiscaux](https://dashboard.stripe.com/settings/tax). Pour en savoir plus, voir [Spécifier les codes fiscaux des produits et le comportement fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md). ## Optional: Calculer la taxe pour les clients existants Pour calculer la taxe 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 de la taxe 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 du 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 des clients doivent-elles répondre à des exigences particulières? 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 pendant le paiement 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 la taxe 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 lors du paiement? 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 la réponse 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 qu’il calcule automatiquement les taxes sur tous vos achats et abonnements 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. Pour calculer la taxe pour de nouveaux clients, Checkout valide et utilise l’adresse de livraison ou de facturation fournie. Pour les clients existants, Checkout calcule la taxe 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 Pour que Google Pay soit proposé comme mode de paiement lors de l’utilisation de Stripe Tax dans Checkout, vous devez soit exiger de collecter une adresse de livraison, soit fournir à un client existant une adresse de livraison enregistrée. Apple Pay avec Stripe Tax s’affiche uniquement lorsque le navigateur du client supporte la version 12 ou supérieure d’Apple Pay. ## Calculer la taxe 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: Mettre à jour vos produits et prix 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 de taxe* (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 précisez pas explicitement ces configurations, Stripe Tax utilisera le code de taxe par défaut sélectionné dans vos [paramètres fiscaux](https://dashboard.stripe.com/settings/tax). Pour en savoir plus, voir [Spécifier les codes fiscaux des produits et le comportement fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md). ## Optional: Calculer la taxe pour les clients existants Pour calculer la taxe 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 de la taxe 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 du 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 des clients doivent-elles répondre à des exigences particulières? 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 pendant le paiement 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 la taxe 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 lors du paiement? 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 la réponse 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.