Collecter automatiquement les taxes dans les sessions Checkout

Vous pouvez créer des sessions Checkout 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 :

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.

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

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_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 \
  --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_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 \
  --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_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[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.