Sign inGet Started
Aan de slag
Gidsen
API Reference
SDK's
CLI
Kennisbank
Changelog

Billing & gebruik

Billing is organisatiebreed: je abonnement, wallet en factuurstroom horen bij de organisatie. Deze pagina behandelt hoe billing een integratie beïnvloedt: hoe gebruik wordt gemeten, hoe je het actuele beeld afleest en hoe je abonnementstier de operationele limieten bepaalt waar je integratie tegenaan loopt. Voor accountbeheer (prijsdetails, betaalmethoden, belasting) zie de Knowledge base: Abonnementen & prijzen en Gebruik, uitgaven & facturen.
Billing wordt beheerd door mensen, niet door integraties. Elke billing-operatie vereist de org:billing-scope, een organisatierolscope die niet kan worden toegekend aan een werkruimte-API-key, dus geen enkele bk_*-key kan gebruik uitlezen, de wallet opwaarderen of een plan wijzigen. Eigenaren en billing-admins doen dat in het gedeelte Billing and payments van het dashboard; zie Users, teams & roles voor wie de rol heeft. De plan-, product- en prijscatalogi zijn de uitzondering: ze vereisen geen authenticatie, ze publiceren de prijzen op deze site, en de CLI en MCP kunnen de plancatalogus rechtstreeks uitlezen. Deze gids legt daarom uit wat billing doet met je integratie, en noemt de dashboardpagina die elk getal toont. Die pagina's (Overview, Usage, Invoices, Spend en Settings) worden behandeld in de Knowledge base-artikelen waarnaar verwezen wordt.

Abonnementen en tiers

Je organisatie is geabonneerd op één plan. Je huidige abonnement, upgrades en annulering vind je op de Billing overview. Elk plan heeft een tier (free, startup, growth of enterprise), en de tier bepaalt welke operationele limieten je integratie ervaart:
  • Inbegrepen verzendvolume. Elk abonnement bevat een maandelijkse hoeveelheid e-mailverzendingen, gemeten per ontvanger: een bericht aan drie ontvangers telt als drie. Bij betaalde abonnementen worden verzendingen boven de hoeveelheid gemeten als overschrijding tot een hard plafond; voorbij het plafond worden verzendingen geweigerd met een limietfout totdat de periode wordt gereset. Het Free-abonnement kent geen overschrijding: het stopt bij de maandelijkse en dagelijkse limieten. Hoeveelheden, limieten en het overschrijdingsplafond staan in Abonnementen & prijzen.
  • Rate-limitplafonds schalen mee met het abonnement. Rate limits beginnen bij een basiswaarde, je abonnement vervangt die door een hogere, en een per-organisatie-override vervangt beide, zodat hogere abonnementen de verzend- en leesplafonds verhogen. Het model, de basissnelheid van elke groep en de headers worden beschreven in Rate limits.
  • Resourcelimieten. Limieten zoals het aantal verzenddomeinen, IP-pools en dedicated IP's dat je organisatie kan hebben, worden per abonnement ingesteld en zijn per organisatie aanpasbaar. Loop je tegen een limiet aan, neem dan contact op met support in plaats van eromheen te werken.
Upgrades gaan direct in en maken de volledige nieuwe hoeveelheid beschikbaar voor de rest van de lopende periode. Downgrades en opzeggingen gaan in aan het einde van de lopende factureringsperiode. Zie Abonnementswijzigingen & verlengingen voor de mislukte-betaling-sequentie en andere timingregels. Ontwerp integraties zodat ze fouten afhandelen wanneer een account de hoeveelheid overschrijdt.

Gebruiksmeting

Elke verzending wordt gemeterd tegen de huidige factureringsperiode van je organisatie. De Usage-pagina van het dashboard toont het actuele beeld per product, over het venster waarop dat product wordt gemeten: de planperiode voor gemeterde e-mail, de kalendermaand voor pay-as-you-go. Producten worden op twee manieren gefactureerd, en het verschil is wat je integratie ervaart:
  • Gemeterde producten hebben een inbegrepen tegoed op je plan (e-mailverzendingen). De pagina toont hoeveel van het tegoed je hebt verbruikt en hoever je erboven zit, zodat je een overschrijding ziet oplopen voordat die gefactureerd wordt.
  • Pay-as-you-go-producten worden per gebruik gefactureerd tegen een tarievenkaart (SMS, WhatsApp). Een bericht kan twee keer uit de wallet putten: de eigen vergoeding van Bird wanneer de verzending wordt verwerkt, en een vergoeding van derden (een carrier-toeslag op SMS, Meta's aandeel op WhatsApp) wanneer het bericht wordt afgeleverd. Lees de verdeling per bericht uit cost op het SMS- of WhatsApp-bericht: transaction_amount is de vergoeding van Bird en passthrough_amount de vergoeding van derden.
De pagina behandelt elk product met een abonnement of gebruik in de huidige periode, en toont de uitsplitsing per dag, per land en per verzenddomein voor elk ervan.
De Usage-pagina in het Bird-dashboard: totale uitgaven met prognose, verzendaantallen per kanaal en dagelijkse gebruiksgrafieken

De wallet

Elke organisatie heeft een wallet: een gedeeld prepaid-saldo waar elke afschrijving doorheen loopt. Planverlengingen, overschrijdingen en pay-as-you-go-verzendingen worden allemaal van de wallet afgeschreven; een opgeslagen kaart dient om de wallet aan te vullen (opwaarderingen, automatisch opwaarderen en het dekken van een verlenging die het saldo niet kan dragen). De Spend-pagina van het dashboard is het volledige overzicht van stortingen en afschrijvingen, zodat elke walletbeweging op één plek verantwoord is, en elke verwerkte opwaarderbetaling levert een bon op die je als PDF kunt downloaden vanuit datzelfde gedeelte.
Operationeel is de wallet een afhankelijkheid van pay-as-you-go-verzending: SMS- en WhatsApp-verzendingen worden geweigerd als het saldo ze niet kan dekken. SMS wordt geweigerd bij de API met een 402; een WhatsApp-verzending wordt geaccepteerd en vervolgens geweigerd zodra Bird probeert af te schrijven. Een afleveringsvergoeding die het saldo niet kan dekken wordt overgeslagen in plaats van geweigerd, zodat het bericht de ontvanger alsnog bereikt. Configureer voor transactioneel volume automatisch opwaarderen en een laag-saldowaarschuwing op de Billing overview, of monitor en stel waarschuwingen in aan je eigen kant. Payment methods and wallet behandelt beide dashboardopties. Waarschuwingen voor laag saldo en betalingsfouten gaan naar de organisatie-eigenaren. Factuur-e-mails gaan naar de billing-notificatielijst van de organisatie als die is ingesteld, en vallen anders terug op de organisatie-eigenaar. Stel die lijst in onder Settings > Organization. Gebruik hiervoor een bewaakte teamalias zodat billing-mail niet afhankelijk is van de inbox van één persoon.

Facturen

Facturen worden per organisatie uitgebracht, één per kalendermaand, en staan op de Invoices-pagina van het dashboard, waar je er een kunt openen voor de regelitems of als PDF kunt downloaden. Facturen weerspiegelen dezelfde metering als de Usage-pagina toont: de terugkerende kosten van je plan plus eventuele gemeterde overschrijdingen en pay-as-you-go-uitgaven voor de periode. Zie Usage, spend & invoices in de Knowledge base voor hoe facturen zijn opgebouwd, statussen en betalingstiming.

Volgende stappen

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Ontdek de mogelijkheidBird pricing
Ontvang een implementatieoverzicht