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.

Od strony operacyjnej wysyłki pay-as-you-go zależą od portfela: wysyłki SMS i WhatsApp są odrzucane, gdy saldo nie pokrywa ich 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ć. E-mail w płatnym planie Email jest naliczany krótko po wysłaniu, więc saldo może na chwilę spaść poniżej zera; gdy w portfelu nie zostanie saldo ani kredyt, nowe e-maile są odrzucane z błędem 402, dopóki nie dodasz środków. Opłata naliczana przy dostarczeniu, której saldo nie pokrywa, jest pomijana, a nie odrzucana, więc wiadomość nadal dociera do odbiorcy. Przy wolumenie transakcyjnym skonfiguruj automatyczne doładowanie i alert o niskim saldzie na stronie Billing overview lub monitoruj saldo i wysyłaj alerty po swojej stronie. Oba ustawienia w dashboardzie opisuje Payment methods and wallet.

Ostrzeżenia o niskim saldzie, powiadomienia o nieudanych płatnościach i e-maile z fakturami trafiają na listę powiadomień rozliczeniowych organizacji, jeśli jest ustawiona, a w przeciwnym razie do wszystkich właścicieli organizacji. W organizacji z jednym obszarem roboczym ustaw tę listę w Settings > Notifications > Billing; w organizacji z kilkoma obszarami roboczymi dashboard jeszcze jej nie pokazuje. Kontakt rozliczeniowy w Billing and payments > Settings to osobne ustawienie; zobacz Billing details. Jako listę powiadomień ustaw monitorowany alias zespołowy, 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)