Taxes sur les ventes de billets en fonction du lieu de l’événementVersion bêta privée

La TVA et la taxe de vente s’appliquent généralement là où vous facturez l’entrée (par exemple, des billets pour des concerts, des conférences, des musées ou des événements sportifs) en fonction du lieu de l’événement, et non de l’emplacement du client. Aux États-Unis, des taxes locales spécifiques (telles que les taxes sur les divertissements ou les attractions) peuvent s’appliquer, en plus des taxes de vente locales et d’État.

Mettre à jour le SDK de Stripe

Il s’agit d’une version bêta privée qui nécessite une mise à jour vers la version la plus récente de l’API. Pour mettre à niveau la version de votre SDK et de votre API, suivez le guide de mise à niveau de l’API et obtenez la dernière version de la bibliothèque. Vous pouvez consulter le journal de notifications pour vérifier que vos modifications sont rétrocompatibles.

Si nécessaire, vous pouvez accéder aux paramètres privés du SDK. Vous pouvez également utiliser des requêtes personnalisées dans l’un des SDK suivants pour appeler des endpoints privés liés à cette fonctionnalité.

• Ruby
• Python
• PHP
• Node
• Java
• .NET
• Go

Configurer Stripe Tax

When you set up Stripe Tax for tickets, set the default product tax code to txcd_20030000, General - Services. You can’t set any of the event tax codes as the default product tax code.

Pour ajouter une immatriculation à des fins de test :

1. Sur la page des immatriculations fiscales du Dashboard, cliquez sur Ajouter une immatriculation.
2. Ajoutez les immatriculations recommandées suivantes :
   1. États-Unis - Colorado, Sales Tax (taxes sur les ventes)
   2. États-Unis - Colorado, Boulder Admissions Tax (taxe de Boulder sur le prix des entrées)

Les calculs de Stripe Tax n’entraînent pas de frais dans un environnement de test. Une fois que vous ajoutez une immatriculation fiscale, le calcul de la taxe en mode production entraîne des frais.

Dans la plupart des cas, le calcul des taxes est basé sur la destination de la transaction, qui est généralement l’adresse de livraison ou de facturation du client. Cependant, la taxe sur la vente de billets se calcule en fonction du lieu de l’événement. Les étapes suivantes décrivent comment utiliser le lieu de l’événement pour calculer les taxes.

Concevoir votre flux de paiement

Stripe Tax prend uniquement en charge la vente de billets à l’aide de l’API Stripe Tax Calculation. Cela signifie que vous pouvez intégrer uniquement Payment Elements ou intégrer directement l’API Tax Calculation. Vous ne pouvez pas utiliser d’autres intégrations telles que Stripe Checkout ou Stripe Subscriptions.

En fonction de votre intégration des paiements, vous avez le choix entre deux chemins d’intégration :

Quelle que soit l’intégration choisie, vous devez créer un territoire fiscal et effectuer un calcul de taxe. Cette méthode fonctionne de la même manière pour les deux chemins d’intégration.

Utiliser l’API Tax Location pour créer un lieu d’événement

Chaque vente de billets nécessite un territoire fiscal que vous créez et enregistrez dans votre base de données afin de le spécifier le moment du calcul des taxes. Pour cet exemple, créez un territoire fiscal de type performance, représentant le parc Greenleaf, un parc situé à Boulder, dans le Colorado, aux États-Unis.

curl https://api.stripe.com/v1/tax/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.basil" \
  -d type=performance \
  --data-urlencode "address[line1]"="Folsom and, Pearl St" \
  -d "address[city]"=Boulder \
  -d "address[state]"=CO \
  -d "address[postal_code]"=80302 \
  -d "address[country]"=US \
  -d description="Greenleaf Park"

La réponse comprend un champ id. Il s’agit de l’identifiant du territoire fiscal que vous pouvez enregistrer dans votre propre base de données.

{
  "id": "taxloc_yB7b4tVHRb",
  // ... other fields omitted
}

Par exemple, le schéma de la base de données peut ressembler à ce qui suit :

Calcul de la taxe

Pour calculer la taxe sur les ventes de billets, Stripe Tax a besoin de quatre éléments d’information :

• La localisation de votre entreprise (adresse du siège social), fournie avec les paramètres fiscaux, que vous avez configurés précédemment
• Le lieu de l’événement (territoire fiscal de type performance), créé dans la section précédente
• La localisation du client (adresse de facturation) – ce point est important en raison des autoliquidations interentreprises
• Le type de produit (billet, marchandise, etc.), par exemple txcd_50010001 – Entrée dans le parc d’attractions, de divertissement et de loisirs – Participant.

Collecte de l’adresse du client

Pour collecter l’adresse du client, nous vous recommandons d’intégrer un formulaire d’adresse dans votre processus de paiement qui demande aux clients de fournir leur adresse avec l’Address Element. Consultez la page consacrée aux informations d’adresse requises.

Vous devez vérifier que l’adresse de facturation est une adresse valide pour Stripe Tax. Pour valider l’adresse avec Stripe Tax, vous pouvez créer un calcul de taxe. Cependant, chaque calcul effectué en mode production entraîne des frais. Nous vous recommandons donc d’effectuer autant de validations que possible directement dans votre intégration.

Avant de collecter et de valider l’adresse, désactivez le bouton de paiement. Après avoir saisi l’adresse et l’avoir validée, vous pouvez activer le bouton de paiement et effectuer un calcul de taxe. Le calcul d’une taxe est un « aperçu » des taxes qui s’appliquent.

Types de produits

You can find all ticket tax codes on our product tax code reference page, including txcd_50010001, Admission to Amusement, Entertainment and Recreation Venues – Participant.

Calcul des taxes avec les territoires fiscaux

Vous devez transmettre toutes les données requises dans l’appel à l’API Tax Calculation. Dans cet exemple, vous calculez les taxes pour un client basé en Irlande. Ce client se rend aux États-Unis et achète un billet pour un événement au parc Greenleaf à Boulder (Colorado).

curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.basil" \
  -d currency=usd \
  -d "line_items[0][amount]"=2500 \
  -d "line_items[0][reference]"="Outdoor concert - L1" \
  -d "line_items[0][tax_behavior]"=exclusive \
  -d "line_items[0][tax_code]"=txcd_50010001 \
  -d "line_items[0][performance_location]"=taxloc_yB7b4tVHRb \
  -d "customer_details[address][country]"=IE \
  -d "customer_details[address_source]"=billing

Si l’endpoint du calcul renvoie un code d’erreur customer_tax_location_invalid, demandez à votre client de vérifier l’exactitude et l’exhaustivité de l’adresse qu’il a saisie.

Comprendre le résultat du calcul et le relier à un paiement

L’appel à l’API Calculations calcule les taxes au territoire fiscal de l’événement. En l’occurrence, le parc Greenleaf à Boulder, dans le Colorado.

Vous pouvez utiliser la répartition des taxes de niveau supérieur pour afficher toutes les taxes facturées. Dans ce cas, la réponse ressemble à ce qui suit :

{
  "id": "taxcalc_fQSaHNaU",
  "amount_total": 2697,
  // ... other fields omitted
  "tax_breakdown": [
    // ... other entries omitted
    {
      "amount": 125,
      "inclusive": false,
      "tax_rate_details": {
        // ... other entries omitted
        "country": "US",
        "state": "CO",
        "percentage_decimal": "5.0", // This is just an example. The Stripe Tax calculation API returns the correct tax rate.
        "tax_type": "admissions_tax"
      },
      "taxability_reason": "standard_rated",
      "taxable_amount": 2500
    }
  ]
}

L’objet calculation contient un ID. Chaque fois que l’un des quatre paramètres saisis (lieu de l’entreprise, adresse du client, lieu de l’événement ou type de produit) change, vous devez effectuer un nouveau calcul.

Vous enregistrez l’ID du calcul le plus récent pour valider une transaction fiscale ultérieurement. Vous en avez besoin pour produire des rapports conformes.

Votre interface de paiement peut afficher les taxes en tant qu’aperçu similaire à l’exemple suivant, en fonction de l’objet tax_breakdown de la réponse de l’appel de l’API Tax Calculation.

Match de football universitaire 2023 au Rose Bowl le lundi 1er janvier 2025 au Rose Bowl

Créer un paiement

Le paiement est créé avec le amount_total issu du calcul des taxes.

Une fois que le paiement aboutit, vous pouvez créer une transaction fiscale. Utilisez cet enregistrement à des fins de création de rapports et de conformité.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.preview" \
  -d amount=2697 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d "hooks[inputs][tax][calculation]"=
{{CALCULATION_ID}}