Steuern für Rechnungen automatisch einziehen

Um Kundinnen/Kunden mit der API zu erstellen, senden Sie Stripe eine Beschreibung und so viele Informationen wie möglich, um den Standort und die Steueranforderungen für Ihre Kundinnen/Kunden zu ermitteln. Wir empfehlen, das Feld customer.address mit der vollständigen Rechnungsadresse Ihrer Kundin/Ihres Kunden auszufüllen. Validieren Sie die Kundenadresse bei der Erstellung, indem Sie tax[validate_location]=“immediately” übergeben. Sie können auch das Feld Steuer erweitern, um den Standort zu bestätigen, den Stripe Tax für Ihren Kunden/Ihre Kundin identifiziert hat.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d description="a new user" \
  -d "address[line1]"="510 Townsend St" \
  -d "address[city]"="San Francisco" \
  -d "address[state]"=CA \
  -d "address[country]"=US \
  -d "address[postal_code]"=94103 \
  -d "tax[validate_location]"=immediately \
  -d "expand[]"=tax

Sie können auch das Land und die Postleitzahl für Ihre Kund/innen hinzufügen:

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d description="a new user" \
  -d "address[country]"=US \
  -d "address[postal_code]"=94103 \
  -d "tax[validate_location]"=immediately \
  -d "expand[]"=tax

Oder nur ihre IP-Adresse:

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d description="a new user" \
  -d "tax[ip_address]"="203.0.113.0" \
  -d "tax[validate_location]"=immediately \
  -d "expand[]"=tax

Das erweiterte Feld tax gibt den ermittelten Steuerstandort an und ob der/die Kund/in mit der automatischen Steuerberechnung kompatibel ist:

{
  "id": 
"{{CUSTOMER_ID}}",
  "object": "customer",
  // ... other fields omitted
  "tax": {
    "location": {
      "country": "US",
      "state": "CA",
      "source": "billing_address"
    },
    "ip_address": null,
    "automatic_tax": "supported",
  }
}

Der Wert des Parameters tax[automatic_tax] hat vier mögliche Status:

Stripe Tax verwendet die in den Objekten Products und Prices gespeicherten Informationen, um die bei der Steuerberechnung anzuwendenden Sätze und Regeln zu bestimmen. Aktualisieren Sie die Produkte und Preise, die Sie mit Invoices verwenden, sodass sie Folgendes enthalten:

• Steuerverhalten: entweder inklusiv oder exklusiv. Dies bestimmt, ob die Steuer bereits in Ihren Preisen enthalten ist oder nicht. Beispiel: Ein inklusiver Posten mit einem Betrag von 10 USD ergibt insgesamt 10 USD, während ein exklusiver Posten mit einem Betrag von 10 USD insgesamt 10 USD zuzüglich Steuern ergibt. Exklusive Preise sind auf US-Märkten und für B2B-Verkäufe üblich, während inklusive Preise für B2C-Käufer in vielen Märkten außerhalb der USA anzutreffen sind. Das explizite Festlegen des Steuerverhaltens für einen Preis ist optional, wenn Sie das Standard-Steuerverhalten einrichten in den Stripe Tax-Einstellungen. Sie können die Standardeinstellung für das Steuerverhalten außer Kraft setzen, indem Sie ein Steuerverhalten für einen Preis festlegen.

• Steuercode: (Optional) – eine Auswahl aus einer Liste von Optionen, die bestimmen, um welche Art von Produkt es sich handelt. Beispiele sind „Hörbuch“, „Geschenkkarte“ oder „Software as a Service“. Wenn Sie dies nicht explizit festlegen, gilt Ihr voreingestellter Steuercode.

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d unit_amount=5000 \
  -d currency=usd \
  -d tax_behavior=exclusive \
  -d "product_data[name]"="A new product"

Nachdem Sie ein Steuerverhalten und einen Steuercode angegeben haben, können Sie dem/der Kund/in den Preis als Rechnungsposten hinzufügen:

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "pricing[price]"=
{{PRICE_ID}}

Stellen Sie den Umschalter im Rechnungs-Editor ein. In der API müssen Sie das Feld automatic_tax übergeben, um die automatische Steuerberechnung zu aktivieren oder zu deaktivieren. Beide Schritte sind erforderlich, um die automatische Steuerberechnung zu starten.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "automatic_tax[enabled]"=true

Um die automatische Steuerberechnung bei der Aktualisierung einer Rechnung zu aktivieren, fügen Sie den Parameter invoice neben automatic_tax hinzu:

curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_tax[enabled]"=true