Billing & gebruik

Billing is organisatiebreed: je productabonnementen, 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 abonnementen de operationele limieten beïnvloeden. Voor accountbeheer (prijsdetails, betaalmethoden, belasting) zie de Knowledge base: Plans & pricing en Usage, spend & invoices.

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

Elk product heeft een eigen abonnement, dat je los kiest: een organisatie kan tegelijk een betaald SMS-abonnement, een Realtime-abonnement en het Email Free-abonnement hebben, en Voice op pay-as-you-go laten. Elk abonnement heeft een tier (zoals free, startup, growth of scale) en een van twee financiële werkwijzen. Een funding-abonnement voegt elke maand een storting toe aan de gedeelde wallet en rekent gebruik af vanaf de eerste verzending. Een capacity-abonnement koopt inbegrepen gebruik en voegt niets toe aan de wallet. Plans & pricing legt beide uit, en de Billing overview toont de huidige abonnementen van je organisatie.

Operationeel merkt je integratie het abonnement op deze punten:

• Rate limits stijgen met de tier. Elk abonnement stelt waarden in voor de beleidsregels van zijn product, zoals sms_send of whatsapp_send, en hogere tiers stellen hogere waarden in. Zonder abonnement geldt de standaardwaarde van het beleid. Een actieve organisatie-override heeft voorrang op elk abonnement. Zie hoe je limiet wordt bepaald.
• Quota stijgen met de tier. Abonnementen stellen aantallen in, zoals gelijktijdige Voice-gesprekken, Realtime-verbindingen, verzenddomeinen, dedicated IP's en webhook-endpoints. Bereik je een quotum, dan wordt de nieuwe resource, het gesprek of de verbinding geweigerd met een eigen foutmelding. Dat staat los van een 429-rate-limitrespons.
• Tegoeden stoppen bij de limieten van het abonnement. Het Email Free-abonnement stopt bij zijn maandelijkse en dagelijkse limieten, en een Realtime-abonnement stopt bij zijn limieten voor verbindingen en dagelijkse berichten. Betaalde Email-abonnementen hebben geen inbegrepen tegoed: elke verzending wordt van de wallet afgeschreven.

Wil je de gepubliceerde waarden van een abonnement zonder authenticatie uitlezen, vraag dan de abonnementscatalogus op met bird billing plans list --commercial-product sms. Elk abonnement retourneert zijn financial_behavior, rate_limits en quotas. De vergelijkingstabel op de prijspagina van elk product toont die waarden naast de pay-as-you-go-standaardwaarden. Vergelijk ze daar voordat je upgradet voor capaciteit.

Upgrades gaan in zodra de betaling slaagt, dus de nieuwe limieten gelden midden in de periode zonder dat de verlengingsdatum verandert. Downgrades en opzeggingen gaan in aan het einde van de lopende periode. Wordt een verlenging niet betaald, dan valt dat product terug op zijn gratis abonnement of op de pay-as-you-go-limieten. Zie Plan changes & renewals voor de timingregels. Ontwerp integraties zodat ze limietfouten afhandelen wanneer een abonnement wijzigt of een tegoed op is.

Gebruiksmeting

Elke verzending wordt gemeten 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 tellen gebruik af van het inbegrepen tegoed van een abonnement (e-mailverzendingen op het Email Free-abonnement of een verouderd Email-abonnement). De pagina toont hoeveel van het tegoed je hebt verbruikt en, bij een verouderd abonnement met overschrijding, hoever je erboven zit.
• Pay-as-you-go-producten worden per gebruik gefactureerd volgens een tarievenkaart (SMS, WhatsApp, Voice en e-mail op een betaald Email-abonnement), tegen het tarief van het abonnement als dat er een heeft. 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 wallet

Elke organisatie heeft een wallet: een gedeeld prepaid-saldo waar gebruikskosten doorheen lopen. Pay-as-you-go-verzendingen, add-on-abonnementen en verlengingen van verouderde Email-abonnementen worden van de wallet afgeschreven. Funding-abonnementen vullen de wallet aan: elke betaalde maandelijkse storting wordt volledig toegevoegd en kan voor elk product betalen. Een opgeslagen kaart vult de wallet ook aan via opwaarderingen en automatisch opwaarderen, en betaalt abonnementsverlengingen rechtstreeks. De Spend-pagina van het dashboard is het volledige overzicht van stortingen en afschrijvingen, zodat elke walletbeweging op één plek verantwoord is. Elke verwerkte opwaarderingsbetaling levert een blijvende 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 om de regelitems te bekijken of als PDF kunt downloaden. Facturen weerspiegelen dezelfde metering als de Usage-pagina toont: kosten van capaciteitsplannen, kosten en overschrijdingen van legacy-plannen en pay-as-you-go-uitgaven voor de periode. De storting van een fundingplan is een opwaardering van de wallet met een eigen bon; het gebruik dat ermee wordt betaald, staat op de factuur. Zie Usage, spend & invoices in de Knowledge base voor de opbouw van facturen, statussen en betalingstiming.

Volgende stappen

• Rate limits: beleidsstandaarden, planwaarden, organisatie-overrides en response headers
• Plans & pricing: funding- en capaciteitsplannen, wat elke tier verhoogt en pay-as-you-go-tarieven
• Plan changes & renewals: timing van upgrades en annuleringen en de procedure bij mislukte betalingen
• Users, teams & roles: wie billing kan beheren (org:billing)