Sign inGet Started
Jetzt starten
Anleitungen
API-Referenz
SDKs
CLI
Wissensdatenbank
Changelog

Abrechnung & Nutzung

Die Abrechnung ist organisationsbezogen: Ihr Plan, Wallet und Rechnungsstrom gehören zur Organisation. Diese Seite beschreibt, wie die Abrechnung eine Integration beeinflusst: wie Nutzung gemessen wird, wie Sie das aktuelle Bild lesen und wie Ihre Planstufe die operativen Limits setzt, gegen die Ihre Integration arbeitet. Für Kontoverwaltung (Preisdetails, Zahlungsmethoden, Steuern) siehe die Knowledge Base: Pläne & Preise und Nutzung, Ausgaben & Rechnungen.
Billing wird von Personen verwaltet, nicht von Integrationen. Jede Billing-Operation erfordert den Scope org:billing, einen Organisations-Rollen-Scope, der keinem Workspace-API-Key gewährt werden kann – kein bk_*-Key kann also Nutzungsdaten lesen, das Wallet aufladen oder einen Plan ändern. Inhaber und Billing-Admins erledigen das im Abschnitt Billing and payments des Dashboards; unter Users, teams & roles sehen Sie, wer die Rolle hat. Die Plan-, Produkt- und Preiskataloge sind die Ausnahme: Sie benötigen keine Authentifizierung, veröffentlichen die Preise auf dieser Website, und CLI und MCP können den Plankatalog direkt lesen. Diese Anleitung erklärt daher, wie sich Billing auf Ihre Integration auswirkt, und benennt die Dashboard-Seite, die jede Kennzahl zeigt. Diese Seiten (Overview, Usage, Invoices, Spend und Settings) werden in den jeweils verlinkten Knowledge-Base-Artikeln behandelt.

Pläne und Stufen

Ihre Organisation hat genau einen Plan. Ihr aktuelles Abonnement, Upgrades und Kündigungen finden Sie auf der Billing overview. Jeder Plan hat eine Stufe (free, startup, growth oder enterprise), und die Stufe bestimmt, welche operativen Grenzen Ihre Integration spürt:
  • Enthaltenes Sendevolumen. Jeder Plan enthält ein monatliches Kontingent an E-Mail-Versendungen, gemessen pro Empfänger: eine Nachricht an drei Empfänger verbraucht drei. Bei kostenpflichtigen Plänen werden Versendungen über das Kontingent hinaus als Überschreitung bis zu einer festen Obergrenze gemessen; jenseits der Obergrenze werden Versendungen mit einem Limit-Fehler abgelehnt, bis die Periode zurückgesetzt wird. Der Free-Plan hat gar keine Überschreitung: Er stoppt bei seinen monatlichen und täglichen Caps. Kontingente, Caps und die Überschreitungs-Obergrenze finden Sie unter Pläne & Preise.
  • Rate-Limit-Obergrenzen skalieren mit dem Plan. Rate Limits beginnen bei einem Basiswert, Ihr Plan ersetzt ihn durch einen höheren, und ein organisationsspezifischer Override ersetzt beide – höhere Pläne heben also die Sende- und Lese-Obergrenzen an. Das Modell, die Basisrate jeder Gruppe und die Header sind unter Rate Limits beschrieben.
  • Ressourcen-Limits. Obergrenzen wie die Anzahl der Sendedomains, IP-Pools und dedizierten IPs, die Ihre Organisation halten kann, werden pro Plan gesetzt und pro Organisation anpassbar. Wenn Sie an ein Limit stoßen, kontaktieren Sie den Support, statt es zu umgehen.
Upgrades gelten sofort und machen das volle neue Kontingent für den Rest der laufenden Periode verfügbar. Downgrades und Kündigungen werden am Ende der laufenden Abrechnungsperiode wirksam. Siehe Planänderungen & Verlängerungen für die Abfolge bei fehlgeschlagenen Zahlungen und andere Timing-Regeln. Gestalten Sie Integrationen so, dass sie Fehler verarbeiten, wenn ein Konto sein Kontingent überschreitet.

Nutzungsmessung

Jeder Versand wird gegen die aktuelle Abrechnungsperiode Ihrer Organisation gemessen. Die Usage-Seite des Dashboards zeigt das Echtzeitbild für jedes Produkt, über das Zeitfenster, in dem das Produkt gemessen wird: die Planperiode für volumenbasierte E-Mails, der Kalendermonat für Pay-as-you-go. Produkte werden auf eine von zwei Arten abgerechnet, und der Unterschied wirkt sich auf Ihre Integration aus:
  • Volumenbasierte Produkte haben ein in Ihrem Plan enthaltenes Kontingent (E-Mail-Versand). Die Seite zeigt, wie viel des Kontingents Sie verbraucht haben und wie weit Sie darüber hinaus sind, sodass Sie eine entstehende Überschreitung erkennen, bevor sie abgerechnet wird.
  • Pay-as-you-go-Produkte werden pro Nutzung nach einer Preisliste abgerechnet (SMS, WhatsApp). Eine Nachricht kann das Wallet zweimal belasten: die eigene Gebühr von Bird bei der Verarbeitung des Versands und eine Drittanbietergebühr (ein Carrier-Zuschlag bei SMS, Metas Anteil bei WhatsApp) bei der Zustellung. Lesen Sie die Aufteilung pro Nachricht aus cost der SMS- oder WhatsApp-Nachricht: transaction_amount ist die Gebühr von Bird und passthrough_amount die Drittanbietergebühr.
Die Seite deckt jedes Produkt mit einem Abonnement oder Nutzung in der aktuellen Periode ab und zeigt die Aufschlüsselung pro Tag, pro Land und pro Sendedomain für jedes einzelne davon.
Die Usage-Seite im Bird-Dashboard: Gesamtausgaben mit Hochrechnung, Versandzahlen pro Kanal und tägliche Nutzungsdiagramme

Das Wallet

Jede Organisation hat ein Wallet: ein gemeinsames Prepaid-Guthaben, über das alle Belastungen laufen. Planverlängerungen, Überschreitungen und Pay-as-you-go-Versand belasten das Wallet; eine hinterlegte Karte dient zum Aufladen (manuelle Aufladungen, automatische Aufladung und Deckung einer Verlängerung, die das Guthaben nicht abdeckt). Die Spend-Seite des Dashboards ist das vollständige Hauptbuch aller Gutschriften und Belastungen, sodass jede Wallet-Bewegung an einem Ort erfasst ist. Jede abgeschlossene Aufladungszahlung erzeugt einen dauerhaften Beleg, den Sie im selben Bereich als PDF herunterladen können.
Operativ ist das Wallet eine Voraussetzung für Pay-as-you-go-Versand: SMS- und WhatsApp-Versand wird abgelehnt, wenn das Guthaben nicht ausreicht. SMS wird an der API mit einem 402 abgewiesen; ein WhatsApp-Versand wird zunächst angenommen und dann abgelehnt, sobald Bird versucht, ihn zu belasten. Eine Zustellgebühr, die das Guthaben nicht decken kann, wird übersprungen statt abgelehnt – die Nachricht erreicht den Empfänger trotzdem. Konfigurieren Sie für transaktionales Volumen die automatische Aufladung und einen Niedrigstand-Alarm auf der Billing overview, oder überwachen und alarmieren Sie auf Ihrer Seite. Payment methods and wallet behandelt beide Dashboard-Steuerungen. Warnungen bei niedrigem Guthaben und Zahlungsausfallbenachrichtigungen gehen an die Organisationsinhaber. Rechnungs-E-Mails gehen an die Billing-Benachrichtigungsliste der Organisation, sofern eine eingerichtet ist, andernfalls an den Organisationsinhaber. Legen Sie diese Liste unter Settings > Organization fest. Verwenden Sie dafür einen überwachten Team-Alias, damit Billing-E-Mails nicht vom Postfach einer einzelnen Person abhängen.

Rechnungen

Rechnungen werden pro Organisation ausgestellt, eine pro Kalendermonat, und auf der Invoices-Seite des Dashboards aufgelistet, wo Sie eine Rechnung öffnen können, um die Einzelposten einzusehen, oder sie als PDF herunterladen. Rechnungen spiegeln dieselbe Messung wider, die die Usage-Seite zeigt: die wiederkehrende Gebühr Ihres Plans plus etwaige Überschreitungen und Pay-as-you-go-Ausgaben für die Periode. Informationen zum Aufbau, zu Statuswerten und zum Zahlungszeitpunkt finden Sie unter Usage, spend & invoices in der Knowledge Base.

Nächste Schritte

Verwandte Ressourcen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.

Die Funktion erkundenBird pricing
Implementierungs-Briefing erhalten