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èrent des calculs des taxes habituels, car ils sont basés sur le lieu de l’événement 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 emplacement fiscal et que vous effectuiez un calcul des taxes.

Appelez 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 l’emplacement fiscal. Conservez cette valeur pour l’utiliser dans les transactions où vous calculez les taxes les ventes dans cet emplacement.

{
  "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 emplacement fiscal 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’identifiant de l’emplacement de l’événement, renvoyé dans la réponse de création de l’emplacement
• 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 Venus – 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 emplacements fiscaux

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 emplacement fiscal à 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 article en même temps que des billets d’événement, par exemple un t-shirt, ajoutez un autre article à la demande de calcul fiscal et sélectionnez le code fiscal correct. Nous calculons les taxes pour ces articles en fonction de l’adresse de facturation ou de livraison, et non du lieu de représentation de l’événement. Les lieux de représentation ne s’appliquent pas à ces articles supplémentaires.

Appliquer le résultat du calcul à 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

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

Lieu fiscal transmis inconnu Veuillez utiliser un lieu fiscal valide.

L’ID de localisation fiscale n’appartient pas à une localisation fiscale accessible par le compte Stripe. Les localisations fiscales sont exclusives à 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éé la localisation fiscale pour le compte connecté plutôt que pour votre plateforme.

Le code fiscal nécessite un lieu fiscal

Le code fiscal txcd_50010001 nécessite de transmettre un emplacement fiscal du 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

Le code fiscal txcd_99999999 ne prend pas en charge un lieu fiscal avec le 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}}