Paiements et solde

GetMyBot dispose de deux circuits de paiement distincts : le solde de requêtes de la plateforme (pour le fonctionnement du bot) et la réception de paiements des utilisateurs du bot via Telegram. La section Facturation (alias « Réception de paiements ») gère les forfaits et le solde.

Comment le bot est facturé

La plateforme comptabilise le travail en requêtes : chaque message délivré par le bot débite une requête du solde du compte. Le solde est un compteur entier ; la source de vérité est un journal immuable de crédits et de débits (bonus à l'inscription, crédits de forfait, rechargements, consommation).

Forfaits et solde

La section Facturation affiche le solde actuel et les forfaits disponibles. Un forfait a un nom, un prix et un volume de requêtes, ainsi que des limites (par exemple, nombre maximum de bots). Le bouton Choisir permet d'activer un forfait.

  • Solde — solde actuel de requêtes (visible également sur les écrans Vue d'ensemble et Statistiques).
  • Prévision, jours sur l'écran Statistiques estime combien de temps le solde durera à la consommation actuelle.

Journal des opérations (ledger)

Le solde de requêtes est un compteur entier, mais sa source de vérité est un journal d'opérations immuable (ledger). Chaque modification du solde y est enregistrée :

  • Bonus à l'inscription — volume de requêtes initial pour un nouveau compte.
  • Crédit de forfait — requêtes accordées lors de l'activation d'un forfait.
  • Rechargement — requêtes achetées en supplément.
  • Consommation — débit d'une requête pour chaque message délivré par le bot.

Le journal ne fait que s'allonger (les anciennes entrées ne sont pas modifiées), ce qui permet de vérifier à tout moment l'historique des dépenses et des crédits. Le solde actuel est la somme du journal.

Rechargement

Un rechargement crée un paiement pour le volume de requêtes souhaité ; après confirmation par le fournisseur, le solde est crédité automatiquement et de façon idempotente (un callback en double ne crédite pas deux fois). Le fournisseur de paiement spécifique dépend de la configuration de l'instance.

Réception de paiements des utilisateurs (Telegram Payments)

Le bot peut recevoir et enregistrer des paiements Telegram :

  • La requête pre_checkout_query est confirmée automatiquement.
  • Un paiement réussi (successful_payment) est enregistré (montant, devise, identifiant de transaction, payload), puis une réaction peut se déclencher — par exemple, accorder un accès, apposer l'étiquette « a payé » et enregistrer la commande dans une collection.

Le montant des paiements réussis est visible dans Analytique (« Paiements »).

L'émission de factures (sendInvoice) et les boutons « Réception de paiement » / « Notification » dans le constructeur de boutons sont pour l'instant marqués comme « bientôt disponibles » : le bot enregistre les paiements entrants, mais il n'est pas encore possible d'initier une facture depuis une réaction dans la version actuelle.

Pour aller plus loin