Rozliczenia i zużycie

Rozliczenia działają na poziomie organizacji: plany produktów, portfel i strumień faktur należą do organizacji. Ta strona opisuje, jak rozliczenia wpływają na integrację: jak mierzone jest zużycie, jak odczytać bieżący stan i jak plany wpływają na limity operacyjne. Informacje o operacjach na koncie (szczegóły cennika, metody płatności, podatki) znajdziesz w Bazie wiedzy: Plany i cennik oraz Zużycie, wydatki i faktury.

Rozliczeniami zarządzają ludzie, nie integracje. Każda operacja rozliczeniowa wymaga zakresu org:billing, który jest powiązany z rolą organizacji i nie może być nadany kluczowi API obszaru roboczego, więc żaden klucz bk_* nie odczyta zużycia, nie doładuje portfela ani nie zmieni planu. Właściciele i administratorzy rozliczeń robią to w sekcji Billing and payments w dashboardzie; role opisuje Users, teams & roles. Wyjątkiem są katalogi planów, produktów i cen: nie wymagają uwierzytelniania, publikują cennik na tej stronie, a CLI i MCP mogą odczytać katalog planów bezpośrednio. Ten przewodnik wyjaśnia więc, jak rozliczenia wpływają na Twoją integrację, i wskazuje stronę dashboardu z każdą liczbą. Strony te (Overview, Usage, Invoices, Spend i Settings) są opisane w artykułach Bazy wiedzy linkowanych w tekście.

Plany i poziomy

Każdy produkt ma własny plan, wybierany niezależnie: organizacja może jednocześnie mieć płatny plan SMS, plan Realtime i plan Email Free, a Voice zostawić w modelu pay-as-you-go. Każdy plan ma poziom (np. free, startup, growth lub scale) i jeden z dwóch modeli finansowych. Plan zasilający dodaje miesięczny depozyt do wspólnego portfela i nalicza zużycie od pierwszej wysyłki; plan pojemnościowy kupuje wliczone zużycie i nic nie dodaje do portfela. Oba modele wyjaśnia Plany i cennik, a strona Billing overview pokazuje bieżące plany Twojej organizacji.

To plan decyduje o tym, co Twoja integracja odczuwa operacyjnie:

• Limity żądań rosną z poziomem. Każdy plan ustala wartości dla polityk swojego produktu, np. sms_send lub whatsapp_send, a wyższe poziomy ustalają wyższe wartości. Bez planu obowiązuje wartość domyślna polityki. Aktywne nadpisanie na poziomie organizacji ma pierwszeństwo przed każdym planem. Zobacz jak ustalany jest Twój limit.
• Limity ilościowe rosną z poziomem. Plany określają liczby takie jak równoczesne połączenia Voice, połączenia Realtime, domeny wysyłkowe, dedykowane adresy IP i endpointy webhooków. Po osiągnięciu limitu ilościowego nowy zasób, połączenie lub sesja są odrzucane z osobnym błędem; nie jest to odpowiedź 429 wynikająca z ograniczania liczby żądań.
• Pakiety kończą się na limitach planu. Plan Email Free zatrzymuje się na swoich limitach miesięcznym i dziennym, a plan Realtime na swoich limitach połączeń i dziennych wiadomości. Płatne plany Email nie mają wliczonego pakietu: każda wysyłka jest naliczana z portfela.

Aby bez uwierzytelniania odczytać opublikowane wartości dowolnego planu, pobierz listę z katalogu planów za pomocą bird billing plans list --commercial-product sms. Każdy plan zwraca swoje financial_behavior, rate_limits i quotas. Tabela porównawcza na stronie cennika każdego produktu pokazuje te wartości obok wartości domyślnych pay-as-you-go, więc porównaj je tam, zanim zmienisz plan na wyższy, by zwiększyć przepustowość.

Podwyższenie planu obowiązuje po udanej płatności, więc nowe limity zaczynają działać w trakcie okresu bez zmiany daty odnowienia. Obniżenie i anulowanie planu wchodzą w życie na koniec bieżącego okresu, a nieopłacone odnowienie przywraca produktowi plan darmowy lub limity pay-as-you-go. Reguły czasowe opisuje Plan changes & renewals. Projektuj integracje tak, aby obsługiwały błędy limitów, gdy plan się zmienia lub pakiet się wyczerpuje.

Pomiar zużycia

Każde wysłanie jest rozliczane w ramach bieżącego okresu rozliczeniowego organizacji. Strona Usage w dashboardzie pokazuje aktualny obraz dla każdego produktu, w oknie pomiarowym właściwym dla danego produktu: okres planu dla e-maili z limitem, miesiąc kalendarzowy dla pay-as-you-go. Produkty rozlicza się na jeden z dwóch sposobów, a różnica wpływa na Twoją integrację:

• Produkty z limitem zliczają zużycie względem pakietu wliczonego w plan (wysyłki e-mail w planie Email Free lub starszym planie Email). Strona pokazuje, ile pakietu wykorzystałeś, a w starszym planie z nadwyżką także to, jak bardzo go przekroczyłeś.
• Produkty pay-as-you-go są rozliczane za każde użycie według cennika (SMS, WhatsApp, Voice i e-mail w płatnym planie Email), po stawce planu, jeśli plan ją określa. Wiadomość może obciążyć portfel dwukrotnie: opłatą Bird przy przetwarzaniu wysyłki i opłatą strony trzeciej (dopłata operatora za SMS, udział Meta za WhatsApp) przy dostarczeniu wiadomości. Podział kosztów na wiadomość odczytasz z cost w wiadomości SMS lub WhatsApp: transaction_amount to opłata Bird, a passthrough_amount to opłata strony trzeciej.

Strona obejmuje każdy produkt z subskrypcją lub zużyciem w bieżącym okresie i przedstawia wykresy podziału dziennego, według kraju i domeny wysyłkowej dla dowolnego z nich.

Portfel

Każda organizacja ma portfel: wspólne saldo przedpłacone, przez które przechodzą opłaty za zużycie. Portfel obciążają wysyłki pay-as-you-go, subskrypcje dodatków i odnowienia starszych planów Email. Plany zasilające go uzupełniają: każdy opłacony miesięczny depozyt jest dodawany w całości i może pokryć dowolny produkt. Zapisana karta również go uzupełnia przez doładowania i automatyczne doładowanie oraz bezpośrednio opłaca odnowienia planów. Strona Spend w dashboardzie to pełny rejestr wpłat i obciążeń, więc każdy ruch na portfelu jest rozliczony w jednym miejscu, a każde rozliczone doładowanie generuje trwałe potwierdzenie, które możesz pobrać jako PDF z tej samej sekcji.

Operacyjnie portfel jest zależnością wysyłek pay-as-you-go: wysyłki SMS i WhatsApp są odrzucane, gdy saldo nie pokrywa kosztu. SMS jest odrzucany na poziomie API z błędem 402; wysyłka WhatsApp jest przyjmowana, a potem odrzucana, gdy Bird próbuje ją naliczyć. Opłata naliczana przy dostarczeniu, której saldo nie pokrywa, jest pomijana zamiast odrzucana, więc wiadomość wciąż dociera do odbiorcy. Przy wolumenie transakcyjnym skonfiguruj automatyczne doładowanie i alert o niskim saldzie na stronie Billing overview lub monitoruj i alertuj po swojej stronie. Payment methods and wallet opisuje oba elementy sterowania w dashboardzie. Ostrzeżenia o niskim saldzie i powiadomienia o nieudanych płatnościach trafiają do właścicieli organizacji. E-maile z fakturami trafiają na listę powiadomień rozliczeniowych organizacji, jeśli jest ustawiona, a w przeciwnym razie do właściciela organizacji. Ustaw tę listę w Settings > Organization. Użyj monitorowanego aliasu zespołowego, aby poczta rozliczeniowa nie zależała od skrzynki jednej osoby.

Faktury

Faktury są wystawiane na organizację, jedna na miesiąc kalendarzowy, i widoczne na stronie Invoices w dashboardzie, gdzie możesz otworzyć fakturę, by zobaczyć jej pozycje, lub pobrać ją jako PDF. Faktury odzwierciedlają te same pomiary co strona Usage: opłaty za plany pojemnościowe, opłaty i nadwyżki w starszych planach oraz wydatki pay-as-you-go za dany okres. Depozyt planu zasilającego jest doładowaniem portfela z osobnym potwierdzeniem; zużycie, które opłaca, pojawia się na fakturze. Strukturę faktur, statusy i terminy płatności opisuje Zużycie, wydatki i faktury w Bazie wiedzy.

Następne kroki

• Limity żądań: wartości domyślne polityk, wartości planu, nadpisania na poziomie organizacji i nagłówki odpowiedzi
• Plany i cennik: plany zasilające i pojemnościowe, co podnosi każdy poziom oraz cennik pay-as-you-go
• Plan changes & renewals: czas podwyższenia/anulowania i sekwencja nieudanej płatności
• Users, teams & roles: kto może zarządzać rozliczeniami (org:billing)