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 Steuerberechnungen für Ticketverkäufe unterscheiden sich von den typischen Steuerberechnungen, da sie auf dem Standort der Veranstaltung und nicht auf der Abrechnungs- oder Versandadresse der Kundin oder des Kunden basieren.

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 Steuerstandort 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 versteuernden Standort 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 Steuerstandorts 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 Standort-ID des Ereignisses, 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.

Steuerstandorte 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 Steuerstandort 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 Posten zusammen mit Veranstaltungstickets zu verkaufen, z. B. ein T-Shirt, fügen Sie der Anfrage zur Berechnung der Steuer einen weiteren Posten hinzu und wählen Sie den richtigen Steuercode für das Produkt aus. Wir berechnen die Steuern für diese Artikel auf der Grundlage der Rechnungs- oder Versandadresse und nicht des Standorts der Veranstaltung. Leistungsorte gelten nicht für diese zusätzlichen Artikel.

Das Ergebnis der Berechnung auf eine Zahlung anwenden

Der Aufruf der Calculation API berechnet die Steuern am Steuerstandort des Ereignisses. In diesem Fall der 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 calculation-Objekt enthält eine ID. Jedes Mal, wenn sich einer der vier Eingabeparameter (Unternehmensstandort, Kundenadresse, Ereignisort oder Produkttyp) ändert, müssen Sie eine neue Berechnung durchfü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

Unbekannter steuerlicher Standort wurde angegeben. Bitte verwenden Sie einen gültigen Standort.

Die Steuerstandort-ID gehört nicht zu einem Standort, auf den das Stripe-Konto zugreifen kann. Steuerstandorte 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 Steuerstandort für das verbundene Konto und nicht für Ihre Plattform angelegt haben.

Steuercode erfordert einen steuerlichen Standort

Der Steuercode txcd_50010001 erfordert die Angabe eines steuerlichen Standorts vom Typ 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

Der Steuercode txcd_99999999 unterstützt keinen steuerlichen Standort mit dem Typ 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}}