Płatności i saldo

W GetMyBot działają dwa odrębne obiegi płatności: saldo zapytań platformy (za działanie bota) i przyjmowanie płatności od użytkowników bota przez Telegram. Sekcja Płatności (zwana też „Przyjmowanie płatności") zarządza planami i saldem.

Jak rozliczany jest bot

Platforma mierzy pracę w zapytaniach: każda wiadomość dostarczona przez bota odejmuje jedno zapytanie od salda konta. Saldo to licznik całkowity; źródłem prawdy jest niezmienialne ewidencja naliczeń i odliczeń (bonus rejestracyjny, naliczenia planu, doładowania, zużycie).

Plany i saldo

W sekcji Płatności widoczne jest bieżące saldo i dostępne plany. Plan ma nazwę, cenę i liczbę zapytań, a także limity (np. maksimum botów). Przyciskiem Wybierz aktywuje się plan.

  • Saldo — bieżąca liczba pozostałych zapytań (widoczna też na ekranach Przegląd i Statystyki).
  • Prognoza, dni na ekranie Statystyk szacuje, na ile starczy salda przy bieżącym zużyciu.

Ewidencja naliczeń (ledger)

Saldo zapytań to licznik całkowity, ale jego źródłem prawdy jest niezmienialny dziennik operacji (ledger). Każda zmiana salda jest w nim rejestrowana:

  • Bonus rejestracyjny — startowa pula zapytań dla nowego konta.
  • Naliczenie planu — zapytania przyznane przy aktywacji planu.
  • Doładowanie — dokupione zapytania.
  • Zużycie — odjęcie jednego zapytania za każdą wiadomość dostarczoną przez bota.

Dziennik jest wyłącznie dopisywalny (stare rekordy się nie zmieniają), więc historię zużycia i naliczeń zawsze można zweryfikować. Bieżące saldo to suma z dziennika.

Doładowywanie

Doładowanie tworzy płatność na wybraną liczbę zapytań; po potwierdzeniu przez dostawcę saldo jest naliczane automatycznie i idempotentnie (ponowne wywołanie callbacku nie zduplikuje naliczenia). Konkretny dostawca płatności zależy od konfiguracji instancji.

Przyjmowanie płatności od użytkowników (Telegram Payments)

Bot może przyjmować i rejestrować płatności Telegram:

  • Żądanie pre_checkout_query jest potwierdzane automatycznie.
  • Udana płatność (successful_payment) jest zapisywana (kwota, waluta, identyfikator operacji, payload), po czym może wyzwolić reakcję — np. nadać dostęp, ustawić etykietę „zapłacił" i zapisać zamówienie do kolekcji.

Sumę udanych płatności widać w Analityce („Płatności").

Wystawianie faktury (sendInvoice) i przyciski „Przyjmij płatność" / „Powiadomienie" w konstruktorze przycisków są na razie oznaczone jako „wkrótce": bot rejestruje przychodzące płatności, ale inicjowanie faktury z reakcji w bieżącej wersji nie jest możliwe.

Co dalej