TgPay Crypto
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 dès qu’il s’affiche, puis commencez à appeler l’API. Toute la configuration se trouve sous Plus → API marchand.
Connecter un agent IA
Connectez un agent de développement IA compatible avec les serveurs MCP distants à https://app.tgpaycrypto.com/mcp. Il peut lire la documentation de l’API, demander la création d’une application marchande, configurer les webhooks et vous aider à écrire l’intégration. Vous approuvez la création dans le bot ; l’agent reçoit un token restreint sans que vous ayez à le recopier. Vérifiez et testez l’intégration avant d’accepter des paiements réels.
Accepter des paiements avec des factures
Une facture permet de demander un paiement à un utilisateur Telegram. Vous la créez via l’API, puis envoyez son lien au payeur. Une fois le paiement effectué, le solde de votre application est crédité du montant, déduction faite des frais marchands.
Frais et limites de l’API marchand
Les factures entraînent 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
Cette page décrit les méthodes de paiement sortant. Un transfert envoie des fonds depuis le solde de votre application vers le portefeuille d’un utilisateur Telegram, ou les garde en attente jusqu’à l’arrivée d’un nouveau destinataire ; un chèque est un lien permettant de récupérer un montant que vous bloquez à l’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 après déduction des frais. Les conventions sont sur la page Référence de l’API marchand.
Référence de l’API : webhooks
Les webhooks transmettent les événements à votre serveur après qu’ils se sont produits. Définissez l’URL du webhook (facultatif) 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é.
Conditions d’utilisation de l’API marchand
Ces conditions régissent l’API marchand — les applications, les tokens d’API, les factures, les abonnements, les transferts, les chèques, les webhooks et le connecteur d’agent IA. Elles s’appliquent en complément des conditions générales d’utilisation de l’app et de sa politique AML. En créant une application, vous les acceptez ; en continuant d’utiliser une application créée avant le 7 septembre 2026, vous les acceptez également.
Besoin d’aide ? Contactez l’assistance.
Vous pouvez écrire à l’assistance sur Telegram à tout moment. Personne de l’assistance ne vous demandera jamais votre PIN ni un code reçu par e-mail.