Collecter automatiquement les taxes dans les sessions Checkout

Cette courte vidéo montre comment activer la collecte automatique des taxes avec une intégration hébergée comme Stripe Checkout.

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 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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

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.

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

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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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[address]"=auto \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

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.