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 la face développeur du même produit que voient les utilisateurs : une facture que vous créez via l’API est la facture qu’ils paient depuis leur solde en une touche.
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 ouvert choisi par le payeur), envoyez son lien au payeur et recevez un rappel signé dès qu’elle est payé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 — émettez des liens à récupérer par n’importe qui, depuis le solde de votre application.
- 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.
- Chaque événement qui compte peut être poussé vers votre serveur sous forme de webhook signé.
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 — son dépôt arrive sur son propre portefeuille et la facture s’en règle automatiquement ; de votre côté, cela ressemble exactement à n’importe quelle autre facture payée.
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. Vous pouvez pointer une intégration
Crypto Bot existante vers nous en changeant l’URL de base et le token — la
forme des requêtes et des réponses ne change pas.
L’en-tête de token canonique est TgPayCrypto-API-Token, 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
Quiconque le détient peut transférer le solde de votre 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.