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.
C’est l’accès destiné aux développeurs du même produit que celui des utilisateurs : une facture que vous créez via l’API est la facture qu’ils paient depuis leur solde après confirmation du paiement.
Ce que vous pouvez en faire
- Factures — créez une demande de paiement (un montant crypto fixe, un montant libellé en monnaie fiduciaire, ou un montant libre choisi par le payeur), envoyez son lien au payeur et recevez un webhook signé après paiement si une URL de webhook est configurée.
- Remboursements — rendez tout ou partie du montant d’une facture payée à celui qui l’a payée — payeurs anonymes compris.
- Transferts — envoyez des cryptos depuis le solde de votre application vers un utilisateur Telegram, un par un ou jusqu’à 100 par lot.
- Chèques — financez depuis le solde de votre application des liens permettant de récupérer des fonds, accessibles à tous ou à des destinataires désignés selon vos paramètres de paiement sortant.
- Abonnements — facturation récurrente : les utilisateurs approuvent une formule une fois et sont prélevés automatiquement à chaque période.
- Soldes, devises, taux de change et statistiques — des points d’accès en lecture seule pour votre propre comptabilité.
Comment tout s’articule
- Votre application détient un solde, distinct de votre portefeuille personnel.
- Les factures payées par les utilisateurs créditent ce solde d’application.
- Les transferts et les chèques le débitent.
- Les événements de paiement pris en charge peuvent être envoyés à votre serveur sous forme de webhook signé lorsque vous configurez l’URL et les abonnements aux événements.
Les paiements se règlent à l’intérieur de l’app, pas sur la chaîne : pas
de frais de réseau, pas de confirmations à attendre, et les fonds sont
utilisables à l’instant où ils arrivent. Un payeur peut tout de même
alimenter une facture depuis un portefeuille externe lorsque cette option est disponible. Le dépôt crédite son propre portefeuille ; le paiement automatique nécessite aussi un solde suffisant, aucune restriction sur les paiements sortants et une échéance de paiement non dépassée. De votre côté, vérifiez que la facture est paid avant d’honorer la commande.
Compatible avec Crypto Bot
L’API reproduit délibérément celle de Crypto Bot : mêmes noms de méthodes,
même enveloppe {ok, result}, mêmes montants en chaînes décimales, même
schéma de signature des webhooks. Pour adapter une intégration Crypto Bot existante, changez l’URL de base et le token, puis testez les méthodes utilisées à l’aide de notre référence. Comme Crypto Bot, nous
exploitons un testnet avec un bot et une
URL de base distincts.
L’en-tête de token canonique est TgPayCrypto-API-Token ;
TgCryptoPay-API-Token, le nom d’avant le 2026-09-07, fonctionne
toujours, et Crypto-Pay-API-Token est accepté comme alias pour que les
bibliothèques clientes existantes continuent de fonctionner sans
modification.
⚠️ Votre token d’API est une clé de dépense
Un token principal autorise les paiements sortants dans les limites et le mode de paiement de l’application. Gardez-le côté serveur, hors des applications clientes et des dépôts de code, et renouvelez-le dès que vous soupçonnez une fuite. Pour les serveurs qui n’ont pas besoin d’un accès complet, émettez un token restreint limité aux permissions qu’ils utilisent vraiment — voir la référence de l’API.
Et ensuite
Cet article vous a-t-il été utile ?
Merci pour votre retour.