Pagamenti e saldo

In GetMyBot esistono due «circuiti di pagamento» distinti: il saldo delle richieste della piattaforma (per il funzionamento del bot) e la ricezione di pagamenti dagli utenti del bot tramite Telegram. La sezione Fatturazione (nota anche come «Ricezione pagamenti») gestisce i piani e il saldo.

Come viene tariffato il bot

La piattaforma conteggia il lavoro in richieste: ogni messaggio consegnato dal bot sottrae una richiesta dal saldo dell'account. Il saldo è un contatore intero; la fonte di verità è il registro immutabile delle accrediti e addebitamenti (bonus alla registrazione, accrediti del piano, ricariche, consumo).

Piani e saldo

Nella sezione Fatturazione vengono mostrati il saldo attuale e i piani disponibili. Un piano ha nome, prezzo e volume di richieste, oltre a limiti (ad esempio, numero massimo di bot). Con il pulsante Scegli si attiva il piano.

  • Saldo — saldo attuale delle richieste (visibile anche nelle schermate Panoramica e Statistiche).
  • Previsione, giorni nella schermata Statistiche stima per quanti giorni durerà il saldo con il consumo attuale.

Registro degli accrediti (ledger)

Il saldo delle richieste è un contatore intero, ma la sua fonte di verità è il registro immutabile delle operazioni (ledger). In esso viene registrata ogni variazione del saldo:

  • Bonus alla registrazione — volume iniziale di richieste per un nuovo account.
  • Accredito del piano — richieste assegnate all'attivazione del piano.
  • Ricarica — richieste acquistate in aggiunta.
  • Consumo — addebito di una richiesta per ogni messaggio consegnato dal bot.

Il registro è solo in append (i record precedenti non vengono modificati), quindi la cronologia di consumo e accrediti può sempre essere verificata. Il saldo corrente è la somma del registro.

Ricarica

La ricarica crea un pagamento per il volume di richieste desiderato; dopo la conferma da parte del provider, il saldo viene accreditato automaticamente e in modo idempotente (un callback duplicato non raddoppia l'accredito). Il provider di pagamento specifico dipende dalla configurazione dell'istanza.

Ricezione di pagamenti dagli utenti (Telegram Payments)

Il bot può ricevere e registrare i pagamenti Telegram:

  • La richiesta pre_checkout_query viene confermata automaticamente.
  • Il pagamento riuscito (successful_payment) viene registrato (importo, valuta, identificatore dell'operazione, payload), e poi può scattare una reazione — ad esempio, concedere l'accesso, aggiungere l'etichetta «ha pagato» e registrare l'ordine nella raccolta.

L'importo dei pagamenti riusciti è visibile in Analisi («Pagamenti»).

La creazione di fatture (sendInvoice) e i pulsanti «Ricezione pagamento» / «Notifica» nel costruttore di pulsanti sono attualmente contrassegnati come «prossimamente»: il bot registra i pagamenti in entrata, ma nella versione attuale non è possibile avviare una fattura da una reazione.

Passo successivo