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

Le calcul des taxes des événements est en version bêta privée et nécessite une mise à jour vers la dernière version de l’API. Vous pouvez inspecter le journal des modifications pour vous assurer 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

Lorsque vous configurez Stripe Tax pour les tickets, définissez le code de taxe par défaut sur le produit à txcd_20030000, General - Services. Vous ne pouvez pas définir l’un des codes fiscaux des événements comme code fiscal par défaut du produit.

Vous pouvez ajouter une inscription pour test via le Dashboard ou l’API d’enregistrement fiscal.

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.

Le calcul des taxes pour la vente de billets diffère des calculs des taxes habituels, car ils sont basés sur le lieu de représentation plutôt que sur l’adresse de facturation ou de livraison du client.

Stripe Tax prend uniquement en charge la vente de billets à l’aide de l’API Tax Calculation directement ou avec PaymentIntents. Vous ne pouvez pas utiliser d’autres intégrations comme Stripe Checkout ou des abonnements.

Choisissez le chemin d’intégration correspondant à votre intégration de paiement existante :

Les deux intégrations nécessitent que vous créiez un lieu de représentation et que vous effectuiez un calcul des taxes.

Créer un lieu fiscal de type performance, en précisant l’adresse du lieu de l’événement.

Vous pouvez utiliser n’importe quelle adresse admissible à un TaxCalculation dans un pays pris en charge où le type de vente est All Sales.

Chaque pays exige différents formats d’adresse pour l’emplacement.

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 renvoie l’id comme identifiant unique pour le lieu de représentation. Conservez cette valeur pour l’utiliser dans les transactions où vous calculez les taxes des ventes dans ce lieu.

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

Une entrée de base de données pour cet exemple peut être :

Erreurs de validation de l’adresse de localisation

Si la demande de création d’un lieu de représentation renvoie une erreur, vérifiez les propriétés param et message pour obtenir des indications spécifiques.

Adresse non valide

The address is not supported by Stripe Tax for a tax location. Please use a valid address.

La validation de l’adresse a échoué. Consultez les formats d’adresse pris en charge pour connaître les exigences en matière d’adresse.

Pays non pris en charge ou territoire exclu

The address is not supported by Stripe Tax for a tax location. Please use a location that is supported by Stripe Tax.

Le pays n’est pas pris en charge ou l’adresse se trouve dans un territoire exclu.

Le calcul des taxes des ventes de billets nécessitent les informations suivantes :

• Emplacement de votre entreprise, fourni lors de la configuration de Stripe Tax
• L’ID du lieu de représentation, renvoyé dans la réponse create location
• L’adresse de facturation du client (pour les autoliquidations de la TVA B2B)
• Le code produit (billet, marchandise, etc.), par exemple txcd_50010001–-Admission to Amusement, Entertainment and Recreation Venues--Participant…

Collecter l’adresse du client

1. Intégrez un formulaire d’adresse à votre paiement à l’aide de l’Address Element pour collecter les informations d’adresse requises auprès de votre client.
2. Vérifiez que l’adresse de facturation est valide pour Stripe Tax. Effectuez cette validation directement sur votre intégration pour éviter d’avoir à payer des frais de calcul de taxes en mode production pour la validation.
3. Désactiver le bouton de paiement jusqu’à la collecte et à la validation.

Types de produits

Les codes fiscaux peuvent avoir une exigence d’emplacement :

• optional : Vous pouvez transmettre un lieu de performance.
• required : Vous devez transmettre un lieu de performance.
• not supported : Le code de taxe ne prend pas en charge le lieu de performance.

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.

Appliquer des lieux de représentation

Vous devez transmettre toutes les données requises dans l’appel à l’API de calculs des taxes. Dans cet exemple, vous calculez les taxes pour un client basé en Irlande qui achète un billet pour un événement dans votre lieu de représentation à Greenleaf Park à 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

Pour vendre un élément en même temps que tickets d’événement, par exemple un t-shirt, ajoutez un autre poste à la requête de calcul de taxe et sélectionnez le bon code de taxe produit.

Appliquer le résultat du calcul à un paiement

L’appel à l’API de calcul calcule les taxes sur le lieu de représentation de l’événement. Ici, le Greenleaf Park à 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 d’entrée (adresse de l’entreprise, adresse client, lieu de représentation 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

Erreurs d’estimation fiscale

Si la demande de création d’un emplacement fiscal renvoie une erreur, vérifiez les propriétés param et message pour obtenir des indications spécifiques.

Lieu fiscal inconnu

Unknown tax location being passed. Please use a valid tax location.

L’ID de lieu de représentation n’appartient pas à un lieu de représentation accessible par le compte Stripe. Les lieux de représentation sont exclusifs à un compte et vous ne pouvez pas les partager entre comptes connectés ou avec la plateforme. Si vous effectuez des appels à l’API en tant que plateforme Connect au nom d’un compte connecté, assurez-vous d’avoir créé le lieu de représentation pour le compte connecté plutôt que pour votre plateforme.

Le code fiscal nécessite un lieu fiscal

Tax code txcd_50010001 requires a tax location to be passed of the type performance.

il manque à votre calcul fiscal le lieu de représentation requis pour la billetterie. vous devez soit modifier le code fiscal produit, soit inclure le lieu de représentation.

Le code fiscal ne prend pas en charge un lieu fiscal

Tax code txcd_99999999 does not support a tax location with the type performance.

Vous avez inclus un lieu de performance dans votre requête, mais le code fiscal du produit que vous avez transmis ne prend pas en charge un lieu de performance. Vous devez soit modifier le code fiscal du produit, soit supprimer le lieu de performance.

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}}"