Collecter des taxes

Pour commencer à collecter les taxes :

1. Pass automatic_tax[enabled]=true when creating a Checkout Session.
2. Spécifiez un tax_code pour chaque poste de facture, ou définissez un code de taxe prédéfini dans le Dashboard .
3. Spécifiez un tax_behavior pour chaque élément, ou définissez un comportement fiscal par défaut dans le Dashboard .

Ce code permet de calculer automatiquement les taxes en utilisant Stripe Tax, un code de taxe et un comportement fiscal. Stripe Tax s’appuie ensuite sur le code fiscal et le comportement fiscal pour calculer automatiquement les taxes.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][product_data][tax_code]"=txcd_99999999 \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d return_url={{RETURN_URL}} \
  -d "automatic_tax[enabled]"=true

Codes fiscaux

Les codes de taxes associent les produits à des taux de taxe. Choisissez le code de taxe approprié pour votre produit dans la liste des codes fiscaux. Si un produit ne correspond à aucun code de taxe, vous pouvez utiliser l’un des codes General.

Comportement fiscal

Le comportement fiscal détermine la manière de présenter la taxe au client .

• Exclusive : le prix du produit n’inclut pas la taxe, qui est ajoutée comme un montant distinct.
• TTC : le prix du produit comprend le montant des taxes.

Nouveaux clients

Pour activer la collecte du numéro fiscal pour les nouveaux clients, définissez tax_id_collection[enabled] sur true lors de la création d’une session Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Clients existants

Créez une session Checkout avec un client existant pour ajouter les informations de numéro fiscal collectées lors du paiement. La session enregistre le nom de l’entreprise comme nom du client, et ajoute le numéro fiscal collecté à customer.tax_ids .

Lors de la création de la session Checkout, vous pouvez définir le customer_update.name sur auto pour mettre automatiquement à jour le name existant du client en utilisant les paramètres de la session.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Si vous ne disposez pas d’adresses enregistrées pour les clients existants, vous pouvez utiliser l’adresse de facturation ou de livraison saisie lors du paiement pour évaluer leur lieu. Pour utiliser l’adresse de facturation, définissez customer_update.address sur auto. Si vous définissez ce paramètre sur auto, les adresses précédemment enregistrées du client sont remplacées par l’adresse saisie lors du paiement.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[address]"=auto \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Si vous enregistrez les adresses de livraison de clients existants, vous pouvez utiliser l’adresse de livraison saisie lors du paiement pour évaluer leur emplacement. Pour utiliser l’adresse de livraison, définissez customer_update.shipping sur auto. Si vous définissez ce paramètre sur auto, les adresses de livraison précédemment enregistrées pour le client sont remplacées par l’adresse saisie lors du paiement.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=DE \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

Cet exemple crée une session en mode payment avec la collecte du numéro fiscal activé. Pour les abonnements, effectuez les mêmes modifications en réglant le mode sur subscription.

Utilisez le composant Tax ID pour collecter les numéros fiscaux.

import {useMemo} from 'react',
import {loadStripe} from '@stripe/stripe-js';
import {CheckoutProvider, TaxIdElement} from '@stripe/react-stripe-js/checkout';

const stripePromise = loadStripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: [
    'custom_checkout_tax_id_1',
  ],
});

const App = () => {
  const fetchClientSecret = useMemo(() => {
    return fetch('/create-checkout-session', {method: 'POST'})
      .then((res) => res.json())
      .then((data) => data.clientSecret)
  }, []);

  return (
    <CheckoutProvider
      stripe={stripePromise}
      options={{
        clientSecret: fetchClientSecret,
      }}
    >
      <TaxIdElement />
    <CheckoutProvider>
  );
};

Checkout inclut les numéros fiscaux fournis dans l’objet Session correspondant. Lorsqu’une session est finalisée, Checkout génère un événement checkout.session.completed que vous pouvez écouter à l’aide d’un endpoint de webhook. Si vous souhaitez récupérer le numéro fiscal collecté par un objet Session, vous pouvez le trouver dans le tableau customer_details.tax_ids de la session :

{
  "object": {
    "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y",
    "object": "checkout.session",
    ...
    "customer": "cus_id_of_new_customer",
    "customer_details": {
      ...
      "tax_ids": [
        {
          "type": "eu_vat",
          "value": "FRAB123456789"
        }
      ]
    },
    ...
    "tax_id_collection": {
      "enabled": true
    },
    ...
  }
}

Checkout enregistre également les dénominations sociales et numéros fiscaux recueillis dans l’objet Customer associé à la session, le cas échéant. Les numéros fiscaux recueillis lors du règlement sont accessibles dans le tableau customer.tax_ids de l’objet Customer. Vous pouvez également retrouver tous les numéros fiscaux enregistrés d’un objet Customer à l’aide de la ressource Tax IDs en définissant le paramètre owner.type sur customer et le paramètre owner.customer sur l’ID du client. Tout nouveau numéro fiscal comporte une dénomination sociale associée, que Checkout enregistre dans la propriété nom de l’objet Customer. De cette façon, la dénomination sociale recueillie apparaît sur toutes les factures d’abonnement de ce client.

Dans les environnements de test, vous pouvez saisir n’importe quelle chaîne de caractères alphanumériques correspondant au format d’un type de numéro fiscal pris en charge (par exemple, DE123456789 pour eu_vat). Vous trouverez une liste complète d’exemples de numéros fiscaux dans notre guide sur les numéros fiscaux des clients. Vous pouvez également utiliser nos numéros fiscaux de test pour tester différents flux d’état de vérification.