API marchand (Développeurs)
L’API marchand : applications, factures, transferts et webhooks.
Qu’est-ce que l’API marchand ?
L’API marchand est l’API de paiement de l’app pour les entreprises et les bots. Vous créez une application, obtenez un token d’API et vous en servez pour facturer des utilisateurs Telegram, leur envoyer des paiements et consulter votre solde — le tout depuis votre propre code.
Démarrer en tant que développeur
Créez une application dans la Mini App, copiez son token d’API une bonne fois, et commencez à appeler l’API. Toute la configuration se trouve sous Plus → API marchand.
Connecter un agent IA
Donnez une seule URL à votre agent de développement IA — https://app.tgpaycrypto.com/mcp — et il construit l’intégration de paiement à votre place : il lit la documentation de l’API, crée votre application marchande, configure les webhooks et écrit le code. Vous approuvez la nouvelle application une seule fois, d’une simple touche dans le bot. Aucun terminal, et aucun token d’API à recopier à la main.
Accepter des paiements avec des factures
Une facture est la façon dont vous facturez un utilisateur Telegram. Vous en créez une via l’API, envoyez son lien au payeur, et le solde de votre application est crédité à l’instant où il confirme.
Frais et limites de l’API marchand
Les factures portent des frais de plateforme prélevés sur ce que vous recevez ; les transferts et les chèques sont encadrés par des limites de montant. Les chiffres ci-dessous sont les paramètres actuels, pas des conditions contractuelles — quand ils divergent de ce que vous voyez, c’est l’app qui a raison, et la source fiable reste toujours vos propres factures payées.
Référence de l’API marchand
Les conventions communes à toutes les méthodes, plus les méthodes de catalogue en lecture seule. Les pages méthode par méthode : factures et remboursements, transferts et chèques, abonnements, webhooks.
Référence de l’API : factures et remboursements
Les méthodes de facture : createInvoice, getInvoices, deleteInvoice, refundInvoice. Les conventions (authentification, enveloppe, montants, spend_id) sont sur la page Référence de l’API marchand ; le parcours guidé est Accepter des paiements avec des factures.
Référence de l’API : transferts et chèques
Les méthodes de paiement sortant. Un transfert envoie des fonds depuis le solde de votre application directement vers le portefeuille d’un utilisateur Telegram ; un chèque est un lien à récupérer que vous approvisionnez d’avance. Les conventions (authentification, enveloppe, montants, spend_id) sont sur la page Référence de l’API marchand.
Référence de l’API : abonnements
Facturation récurrente — une extension par rapport à Crypto Bot. Vous créez une formule (montant + période), envoyez aux utilisateurs son lien d’approbation, et la plateforme les prélève sur le solde de leur portefeuille à chaque période, en créditant le solde de votre application net de frais. Les conventions sont sur la page Référence de l’API marchand.
Référence de l’API : webhooks
Les webhooks poussent les événements vers votre serveur à l’instant où ils se produisent. Définissez l’URL du webhook sur votre application dans Plus → API marchand ; la plateforme y envoie ensuite en POST un corps JSON signé pour chaque événement auquel vous êtes abonné.