Pagamentos e saldo

No GetMyBot existem dois "circuitos de pagamento" diferentes: o saldo de requisições da plataforma (pelo funcionamento do bot) e o recebimento de pagamentos dos usuários do bot via Telegram. A seção Faturamento (também chamada "Recebimento de pagamentos") gerencia planos e saldo.

Como o bot é tarifado

A plataforma conta o trabalho em requisições: cada mensagem entregue pelo bot desconta uma requisição do saldo da conta. O saldo é um contador inteiro; a fonte de verdade é um journal imutável de créditos e débitos (bônus de registro, créditos do plano, recargas, consumo).

Planos e saldo

Na seção Faturamento são exibidos o saldo atual e os planos disponíveis. Um plano tem nome, preço e volume de requisições, além de limites (por exemplo, máximo de bots). O botão Selecionar ativa o plano.

  • Saldo — saldo atual de requisições (também visível nas telas Visão geral e Estatísticas).
  • Previsão, dias na tela Estatísticas estima por quantos dias o saldo será suficiente com o consumo atual.

Journal de créditos (ledger)

O saldo de requisições é um contador inteiro, mas sua fonte de verdade é um journal imutável de operações (ledger). Nele é registrada cada alteração de saldo:

  • Bônus de registro — volume inicial de requisições para nova conta.
  • Crédito do plano — requisições concedidas ao ativar um plano.
  • Recarga — requisições adquiridas adicionalmente.
  • Consumo — desconto de uma requisição por cada mensagem entregue pelo bot.

O journal só é adicionado (registros antigos não são alterados), portanto o histórico de consumos e créditos pode sempre ser verificado. O saldo atual é a soma do journal.

Recarga

A recarga cria um pagamento para o volume de requisições desejado; após confirmação do provedor, o saldo é creditado automaticamente e de forma idempotente (um callback repetido não duplicará o crédito). O provedor de pagamento específico depende da configuração da instância.

Recebimento de pagamentos dos usuários (Telegram Payments)

O bot pode receber e registrar pagamentos Telegram:

  • A requisição pre_checkout_query é confirmada automaticamente.
  • O pagamento bem-sucedido (successful_payment) é registrado (valor, moeda, identificador da operação, payload), e depois pode acionar uma reação — por exemplo, conceder acesso, adicionar a marcação "pagou" e registrar o pedido em uma coleção.

O total de pagamentos bem-sucedidos pode ser visto em Análises ("Pagamentos").

A emissão de fatura (sendInvoice) e os botões "Receber pagamento" / "Notificação" no construtor de botões estão marcados como "em breve" por enquanto: o bot registra pagamentos recebidos, mas não é possível iniciar uma fatura a partir de uma reação na versão atual.

Próximos passos