Percevoir les taxes

Stripe Tax utilise les informations stockées sur les produits et les tarifs pour calculer la taxe, par exemple le code de taxe et le régime fiscal. 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.

Pour en savoir plus, voir Spécifier les codes fiscaux des produits et le comportement fiscal.

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 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.

• 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 ou une adresse de facturation valide. Vous pouvez vérifier la validité des adresses enregistrées par le client à l’aide de la propriété customer.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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 \
  --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, 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, 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 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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 \
  --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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 \
  --data-urlencode return_url="https://example.com/return"

Pour consulter les résultats du dernier calcul de taxe, la propriété total_details.amount_tax dans la ressource de la session Checkout affiche le montant de la taxe calculée. De plus, vous pouvez utiliser le Dashboard pour afficher le résultat de la taxe pour chaque paiement.