Steuerliche Ticketverkäufe je nach VeranstaltungsortPrivate Vorschau

Die Steuerberechnung für Ereignisse befindet sich in der privaten Vorschau und erfordert ein Update auf die neueste API-Version. Sie können das Änderungsprotokoll einsehen, um sicherzustellen, dass Ihre Änderungen rückwärtskompatibel sind.

Bei Bedarf können Sie auf Private SDK-Parameter zugreifen. Sie können auch benutzerdefinierte Anforderungen in einem der folgenden SDKs verwenden, um private Endpoints aufzurufen, die sich auf diese Funktion beziehen.

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

Wenn Sie Stripe Tax für Tickets einrichten, setzen Sie den Standardproduktsteuercode auf txcd_20030000, General - Services. Sie können keinen der Event-Steuercodes als Standardprodukt-Steuercode festlegen.

Sie können eine Registrierung für Tests über das Dashboard oder die API für Steuerregistrierungen hinzufügen.

Für Stripe Tax-Berechnungen fallen in einer Sandbox-Umgebung keine Gebühren an. Nachdem Sie eine Steuerregistrierung hinzugefügt haben, fällt für die Berechnung der Steuer im Live-Modus eine Gebühr an.

Die Steuerberechnung für den Ticketverkauf unterscheidet sich von der üblichen Steuerberechnung, da sie sich nach dem Leistungsstandort richtet und nicht nach der Rechnungs- oder Versandadresse der Kundin oder des Kunden.

Stripe Tax unterstützt nur Ticketverkäufe über die Tax-Calculation-API direkt oder mit PaymentIntents. Es können keine anderen Integrationen wie Stripe Checkout oder Abonnements verwendet werden.

Wählen Sie den Integrationspfad, der Ihrer bestehenden Integration von Zahlungen entspricht:

Für beide Integrationen müssen Sie einen Leistungsstandort anlegen und eine Steuerberechnung durchführen.

Erstellen Sie einen Steuerstandort vom Typ performance und geben Sie die Adresse des Veranstaltungsortes an.

Sie können jede Adresse verwenden, die für eine TaxCalculation in einem unterstützten Land in Frage kommt und deren Verkaufsart All Sales ist.

Jedes Land erfordert unterschiedliche Adressformate für den Standort.

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"

Die Antwort gibt die id als eindeutige Kennung für den Leistungsstandort zurück. Speichern Sie diesen Wert zur Verwendung in Transaktionen, bei denen Sie für Verkäufe an diesem Standort Steuern berechnen.

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

Ein Datenbankeintrag für dieses Beispiel könnte lauten:

Fehler bei der Validierung der Standortadresse

Wenn die Anfrage zur Erstellung des Leistungsstandorts einen Fehler zurückgibt, prüfen Sie die Eigenschaften param und message auf spezifische Hinweise.

Ungültige Adresse

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

Die Adressvalidierung ist fehlgeschlagen, Informationen zu den Adressanforderungen finden Sie unter unterstützte Adressformate.

Nicht unterstütztes Land oder ausgenommenes Gebiet

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

Das Land wird nicht unterstützt oder die Adresse liegt in einem ausgeschlossenen Gebiet.

Für die Berechnung der Verkaufssteuer benötigen Sie die folgenden Informationen:

• Ihr Unternehmensstandort, der bei der Stripe Tax-Konfiguration angegeben wurde
• Die Leistungsstandort-ID, die in der Antwort Standort erstellen zurückgegeben wird.
• Die Rechnungsadresse der Kundin/des Kunden (für Umkehrung der Steuerschuld bei B2B)
• Der Produktcode (Ticket, Ware usw.), z. B. txcd_50010001–-Admission to Amusement, Entertainment and Recreation Venues--Participant.

Kundenadresse erfassen

1. Integrieren Sie ein Adressformular in Ihren Bezahlvorgang, indem Sie das Adresselement verwenden, um erforderliche Adressangaben von Ihren Kundinnen/Kunden zu erheben.
2. Überprüfen Sie, ob die Abrechnungsadresse gültig für Stripe Tax ist. Führen Sie diese Validierung direkt in Ihrer Integration durch, um zu vermeiden, dass im Live-Modus Transaktionsgebühren für die Validierung der Steuerberechnung anfallen.
3. Deaktivieren Sie die Schaltfläche für den Bezahlvorgang, bis der Einzug und die Validierung abgeschlossen sind.

Produkttypen

Steuerkennzeichen können folgende Standortanforderung haben:

• optional: Sie können einen Leistungsstandort übergeben.
• required: Sie müssen einen Leistungsstandort übergeben.
• not supported: Der Steuercode unterstützt keinen Leistungsstandort.

Sie alle Ticketsteuer-Codes auf unserer Produktsteuer-Code-Referenz-Seite finden, einschließlich txcd_50010001, Admission to Amusement, Entertainment and Recreation Venues – Participant.

Leistungsstandorte anwenden

Sie müssen alle erforderlichen Daten innerhalb des API-Aufrufs zur Steuerberechnung übergeben. In diesem Beispiel berechnen Sie die Steuern für eine in Irland niedergelassene Kundin bzw. einen Kunden, der ein Ticket für eine Veranstaltung an Ihrem Leistungsstandort in Greenleaf Park in Boulder, Colorado, kauft.

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

Um einen Artikel zusammen mit Veranstaltungstickets zu verkaufen, beispielsweise ein T-Shirt, fügen Sie bitte eine weitere Position zur Steuerberechnungsanforderung hinzu und wählen Sie den korrekten Produktsteuercode aus.

Das Ergebnis der Berechnung auf eine Zahlung anwenden

Der API-Aufruf zur Berechnung ermittelt die Steuern am Leistungsstandort, in diesem Fall im Greenleaf Park in Boulder, Colorado.

Sie können die Steueraufschlüsselung auf höchster Ebene verwenden, um alle berechneten Steuern anzuzeigen. In diesem Fall sieht die Antwort in etwa wie folgt aus:

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

Das Berechnungsobjekt enthält eine ID. Bei jeder Änderung eines der vier Eingabeparameter (Unternehmensstandort, Kundenadresse, Leistungsstandort oder Produkttyp) ist eine neue Berechnung durchzuführen.

Sie speichern die letzte Berechnungs-ID, um eine Steuertransaktion zu einem späteren Zeitpunkt festzuschreiben. Diese ist für eine konforme Berichterstattung erforderlich.

Ihre Bezahloberfläche kann die Steuern als Vorschau ähnlich wie im folgenden Beispiel basierend auf dem tax_breakdown-Objekt der Antwort des API-Aufrufs zur Steuerberechnung anzeigen.

College Football Rose Bowl Game 2023 am Montag 1. Jan 2025 im Rose Bowl

Fehler bei der Steuerberechnung

Wenn die Anfrage zur Steuerberechnung einen Fehler zurückgibt, prüfen Sie die Eigenschaften param und message für spezifische Hinweise.

Unbekannter steuerlicher Standort

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

Die Leistungsstandort-ID gehört nicht zu einem Standort, auf den das Stripe-Konto zugreifen kann. Leistungsstandorte sind exklusiv für ein Konto und Sie können sie nicht zwischen verbundenen Konten oder mit der Plattform teilen. Wenn Sie als Connect-Plattform im Namen eines verbundenen Kontos API-Aufrufe tätigen, stellen Sie sicher, dass Sie den Leistungsstandort für das verbundene Konto und nicht für Ihre Plattform angelegt haben.

Steuercode erfordert einen steuerlichen Standort

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

Ihrer Steuerberechnung fehlt der Ausführungsort, der für die Verbuchung erforderlich ist. Sie müssen entweder den Produktsteuercode ändern oder den Standort der Ausführung angeben.

Steuercode unterstützt keinen steuerlichen Standort

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

Sie haben in Ihrer Anfrage einen Ausführungsstandort angegeben, aber der von Ihnen angegebene Produkt-Steuercode unterstützt keinen Ausführungsstandort. Sie müssen entweder den Produktsteuercode ändern oder den Ausführungsstandort entfernen.

Die Zahlung wird mit dem amount_total aus der Steuerberechnung erstellt.

Nachdem die Zahlung erfolgreich war, können Sie eine Steuertransaktion erstellen. Verwenden Sie diesen Datensatz für die Berichterstattung und Konformität.

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