Collecter automatiquement les taxes dans les sessions Checkout
Stripe Tax calcule automatiquement les taxes sur tous les achats et les abonnements accumulés pendant une session Checkout. Si vous n’avez pas intégré Checkout, vous devez effectuer l’intégration en utilisant le Guide pour accepter un paiement.
Note
Connectez-vous ou créez un compte Stripe pour activer Stripe Tax.
Modifiez vos produits et tarifs
Stripe Tax utilise des informations sauvegardées sur les API Products et Prices pour déterminer les taux et les règles appropriés à appliquer pour le calcul des taxes. Modifiez les produits et les tarifs que vous utilisez pour inclure :
Comportement fiscal : le comportement fiscal d’un tarif peut être soit TTC, soit hors taxes. Il détermine la façon dont le client voit la taxe. Lorsque vous configurez le comportement fiscal sur hors taxes, la taxe est ajoutée au montant du sous-total que vous spécifiez à votre tarif. C’est une pratique courante sur les marchés des États-Unis et pour les ventes B2B. Lorsqu’il est configuré sur TTC, le montant que votre client paie ne change jamais, même si le taux de taxe varie. C’est une pratique courante pour les clients B2C sur de nombreux marchés en dehors des États-Unis.
Définir explicitement le comportement fiscal d’un tarif est facultatif si vous définissez le comportement fiscal par défaut dans les paramètres Stripe Tax. Vous pouvez remplacer le paramètre de comportement fiscal par défaut en définissant un comportement fiscal sur un tarif.
(Facultatif) Code de taxe : un code de taxe est une classification de votre produit ou service pour Stripe Tax. Il nous permet d’appliquer le taux de taxe adéquat pour vos transactions. Voici quelques exemples : « Livre audio », « Carte cadeau » ou « Logiciels en tant que service ». Si vous ne configurez pas le code de taxe, Stripe Tax utilise les paramètres fiscaux prédéfinis.
Mise en garde
Vous ne pouvez pas modifier le comportement fiscal tax_behavior
une fois que vous l’avez défini sur « hors taxes » ou « TTC ». Vous pouvez créer un nouveau tarif et archiver le tarif actuel.
Si vous ne voulez pas créer vos produits et vos tarifs dès le début, vous pouvez transmettre price_data.tax_behavior
et product_data.tax_code
lors de la création de l’Checkout sessions.
En savoir plus sur les produits, tarifs, codes de taxe et le comportement fiscal.
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.
Les taux de taxe d’un client sont fonction de sa localisation, que Checkout évalue à partir de son adresse. L’adresse que Checkout utilise pour calculer les taxes dépend du fait que le client est nouveau ou existant, et si vous recueillez les adresses de livraison pendant la session Checkout :
Nouveau client | Client existant | |
---|---|---|
Recueillir uniquement une adresse de facturation | Checkout calcule les taxes en fonction de l’adresse de facturation du client saisie dans la session Checkout | Si le client a préalablement enregistré une adresse de livraison, Checkout calcule les taxes sur la base de cette adresse. Sinon, vous pouvez calculer les taxes sur la base de l’adresse de facturation saisie pendant la session Checkout (en précisant customer_update[address]=auto ) ou l’adresse de facturation enregistrée pour le client (le régime par défaut). |
Collecter une adresse de livraison | Checkout calcule les taxes en fonction de l’adresse de livraison du client saisie dans la session Checkout | Checkout calcule les taxes en fonction de l’adresse de livraison du client saisie dans la session Checkout. Les adresses existantes sur le client ne s’appliqueront pas dans ce cas. |
Note
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 Apple Pay version 12.
Calcul des taxes des nouveaux clients
Si vous ne spécifiez pas le nom d’un client existant lors de la création d’une session Checkout, Checkout crée un nouveau client et enregistre automatiquement l’adresse de facturation et les informations de livraison. Checkout utilise les adresses de facturation et de livraison pour identifier l’emplacement du client pour la collecte des taxes.
Checkout utilise l’adresse de livraison saisie pendant la session pour identifier où est situé le client et calculer les taxes. Si vous ne recueillez pas les informations de livraison, Checkout utilise l’adresse de facturation.
Calcul de la taxe pour les clients existantsFacultatif
Pour calculer les taxes dans des sessions Checkout créées pour des clients existants, vous devez définir le paramètre automatic_tax[enabled]
sur true
lors de la création de la session. Vous pouvez baser les calculs de taxes sur les adresses existantes du client ou sur les nouvelles adresses recueillies lors de la session :
Utiliser les adresses existantes du client pour le calcul des taxes
Si vous avez déjà recueilli les adresses de vos clients, vous pouvez baser les calculs des taxes sur ces adresses plutôt que sur celles saisies lors du paiement :
L’adresse du client que Checkout utilise pour le calcul des taxes : lorsque l’adresse de livraison enregistrée du client est disponible, Checkout l’utilise pour calculer les taxes. Sinon, Checkout utilise l’adresse de facturation enregistrée du client pour ce calcul.
**Exigences relatives à l’adresse du client ** : lors de l’utilisation d’adresses existantes pour les taxes, le client doit avoir une adresse de livraison ou une adresse de facturation valide enregistrée. Vous pouvez vérifier la validité des adresses enregistrées du client en vérifiant la propriété customer.tax.automatic_tax du client. Si la propriété affiche
supported
ounot_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.
Utiliser les adresses recueillies 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. Checkout calculera alors les taxes en utilisant l’adresse saisie lors du paiement.
L’adresse que Checkout utilise pour le calcul des taxes : si vous recueillez les adresses de livraison, Checkout utilise l’adresse de livraison saisie lors de la session pour calculer les taxes. Sinon, Checkout utilise l’adresse de facturation saisie pour ce calcul.
Emplacement de sauvegarde des adresses collectées par Checkout : si vous recueillez les adresses de livraison, Checkout enregistre l’adresse de livraison saisie lors de la session dans la propriété customer.shipping.address du client. Sinon, Checkout enregistre l’adresse de facturation saisie lors de la session dans la propriété customer.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.
Si vous ne recueillez 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.
Vérifier le résultatFacultatif
Si vous souhaitez examiner les résultats du dernier calcul de taxe, vous pouvez lire le montant des taxes calculées par Checkout dans total_details.amount_tax
, dans l’outil de la session Checkout. De plus, les taxes calculées pour chaque paiement sont disponibles lorsque vous consultez un paiement dans le Dashboard.