Collecter des taxes

Utilisez les API Stripe Tax pour implémenter le calcul des taxes dans votre intégration personnalisée.

Use Stripe Tax to automatically calculate the tax on your transactions without requiring you to define the rates and rules. Fees only apply after you add at least one location where you’re registered to calculate and remit tax.

Configure your Checkout Session to collect tax

To start collecting tax:

Pass automatic_tax[enabled]=true when creating a Checkout Session.
Specify a tax_code for each line item, or set a preset tax code in the Dashboard.
Specify a tax_behavior for each line item, or set a default tax behavior in the Dashboard.

This code enables automatic tax calculation using Stripe Tax, a tax code, and a tax behavior. Stripe Tax then uses the tax code and tax behavior to automatically calculate taxes.

Tax codes

The tax codes associate products with tax rates. Choose the appropriate tax code for your product from the list of tax codes. If a product doesn’t match with any of the tax codes, you can use one of the General codes.

Tax behavior

The tax behavior determines how to present tax to the customer:

Exclusive: The product price doesn’t include tax, which is added as a separate amount.
Inclusive: The product price includes any tax amount.

FacultatifCollecter la taxe via le composant Element paiement

Vous pouvez collecter les informations de l’adresse fiscale directement dans le composant Element paiement. La collecte des informations de l’adresse fiscale via le composant Element paiement convient aux cas d’usage suivants :

Vous n’avez pas besoin de collecte complète de l’adresse.
Vous n’avez besoin de collecter les adresses qu’à des fins fiscales.

Cette fonctionnalité intègre des champs de saisie pour le pays et le code postal dans chaque formulaire de moyen de paiement dans le composant Payment Element. Elle ne collecte que les champs d’adresse minimum requis pour le calcul des taxes conformément aux exigences de Stripe Tax.

Il existe certaines considérations régionales pour lesquelles le taux d’imposition utilisant les champs d’adresse minimum requis peut différer du taux d’imposition applicable à l’adresse complète de votre client. Nous vous recommandons d’utiliser le composant Address Element pour collecter l’adresse complète de votre client à des fins de calcul de la taxe si ces considérations régionales s’appliquent à votre entreprise.

Lorsque vous créez la Session Checkout, définissez le paramètre billing_address_collection=auto pour collecter automatiquement l’adresse de facturation.

N’incluez pas le paramètre shipping_address_collection. Si vous fournissez ce paramètre, les informations de l’adresse fiscale sont collectées en fonction de l’adresse de livraison au lieu de l’adresse de facturation.

Lorsque vous collectez des informations d’adresse fiscale via le composant Element paiement, le calcul de la taxe se comporte de la manière suivante pour les scénarios suivants :

Si vous transmettez le paramètre fields.billingDetails.address=auto | if_required, Payment Element collecte les champs d’adresse minimum requis pour le calcul des taxes.
Si vous transmettez le paramètre fields.billingDetails.address=never, vous devez collecter les informations relatives à l’adresse fiscale par une autre méthode, car les champs de saisie de facturation n’apparaîtront pas dans le Payment Element.
Si vous transmettez le paramètre fields.billingDetails.address.country=never, le pays détecté du client est utilisé pour le calcul des taxes.
Si vous transmettez le paramètre fields.billingDetails.address.postalCode=never, la méthode renvoie une erreur, car le code postal peut être obligatoire pour certains pays.
Si vous appelez le paramètre checkout.update BillingAddress, la méthode renvoie une erreur, car l’adresse de facturation pourrait potentiellement entrer en conflit.

FacultatifCheck the response

You can view the calculated tax amount for each payment as follows:

In the Checkout Session resource, review the total_details.amount_tax property.
In the Dashboard, review the tax outcome for each payment.

Render the tax amount

Use the useCheckout hook to display the tax amount in your payment form.

import React from 'react';
import {useCheckout} from '@stripe/react-stripe-js';

const CheckoutForm = () => {
  const checkoutState = useCheckout();
  if (checkoutState.type === 'loading') {
    return (
      <div>Loading...</div>
    );
  } else if (checkoutState.type === 'error') {
    return (
      <div>Error: {checkoutState.error.message}</div>
    );
  }
  const {checkout} = checkoutState;
  return (
    <div>
      <h2>Checkout Summary</h2>
      <pre>
        {JSON.stringify(checkout.lineItems, null, 2)}
      </pre>
      <h3>Totals</h3>
      <pre>
        Subtotal: {checkout.total.subtotal.amount}
        {/* Make sure you use the appropriate tax amount type (taxInclusive and/or taxExclusive) for your integration */}
        Tax: {checkout.total.taxExclusive.amount}
        Total: {checkout.total.total.amount}
      </pre>
    </div>
  )
};