API marchand

Acceptez des paiements dans votre bot

Obtenez un token, créez des factures depuis votre code et traitez les webhooks de paiement. Un token de test permet de vérifier tout le parcours avant la mise en production.

8 cryptomonnaies · 16 combinaisons d’actifs et de réseaux sur un même solde Un serveur MCP permet à votre agent IA de préparer l’intégration →
L’écran des tokens API et des webhooks
Webhook reçu
Environnement de test
Premiers pas

Connecter l’API marchand

Du token au premier webhook en quatre étapes. En savoir plus sur l’API marchand →

Étape 1

Obtenez un token

Créez une application dans le bot et obtenez votre token d’API marchand.

Étape 2

Créez une facture

Un appel API avec le montant, la crypto et la description. L’URL du webhook se configure dans les paramètres de l’application.

Étape 3

Affichez le lien de paiement

Proposez un lien ou un bouton. Le paiement se déroule dans Telegram.

Étape 4

Traitez le webhook

Vérifiez l’événement de paiement, puis livrez le produit ou accordez l’accès dans votre service.

Agent IA

Votre agent IA peut préparer l’intégration

L’API marchand dispose d’un serveur MCP. Donnez son URL à votre agent : il consulte la documentation, crée l’application avec votre accord, configure le webhook et écrit le code. Aucun token à recopier manuellement.

  1. Étape 1

    Envoyez la demande à votre agent

  2. Étape 2

    Approuvez l’application dans Telegram

  3. Étape 3

    L’agent termine la configuration

Fonctionnement, demandes par client et permissions de l’agent →
Demande à transmettre à votre agent
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Fonctionnalités

Les paiements intégrés à votre produit

Créez les factures par requête et recevez leur statut par webhook. Adaptez le reste à votre produit.

Token et environnement de test

Un token distinct permet de tester le parcours de paiement avant de l’ouvrir aux utilisateurs.

Factures depuis votre code

Créez, annulez et consultez des factures avec de simples requêtes HTTP, sans SDK obligatoire.

Prélèvements récurrents

L’utilisateur accepte l’abonnement une fois, puis l’API marchand effectue les prélèvements aux dates prévues.

Webhooks de paiement

Un événement est envoyé après le paiement, avec de nouvelles tentatives en cas d’échec. Votre intégration doit vérifier la signature et éviter de traiter les doublons.

Documentation et exemples

Référence des méthodes, codes d’erreur et exemples de requêtes dans le centre d’aide.

Retrouvez le fonctionnement détaillé dans le centre d’aide

8 cryptomonnaies · 16 combinaisons d’actifs et de réseaux sur un même solde

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

Vous gérez un canal ou vendez sur Telegram ?

Choisissez votre profil pour découvrir les fonctionnalités qui vous concernent.

Créateurs Vendeurs Développeurs
Earn

Des gains calculés automatiquement sur votre solde

Placez une partie de votre solde dans Earn : les gains sont calculés automatiquement et versés dans votre portefeuille. Vous pouvez ajouter ou retirer des fonds à tout moment.

Taux annuel Calcul des gains chaque heure
USDT 4% premiers 500 USDT 1% au-delà de 500
GRAM 6% premiers 300 GRAM 3% au-delà de 300
Versement quotidien dans le portefeuille à 00:30 UTC Ajout et retrait sans frais
Ajouter des fonds à Earn
L’écran Earn
L’écran de confirmation du retrait
Adresse conforme
Sécurité

Les vérifications avant l’envoi

Un retrait envoie des fonds vers une adresse externe. Voici les vérifications et protections qui accompagnent sa confirmation.

  • Avant la confirmation
  • Adresse, réseau et mémo en entier Vous voyez l’adresse complète et le réseau de destination, sans devoir vous fier à une adresse abrégée comme "4f3a…9c2b".
  • Adresses enregistrées En option, autorisez les retraits uniquement vers les adresses enregistrées au préalable.
  • PIN ou Face ID Chaque retrait nécessite votre PIN ou la biométrie activée avec ce PIN sur votre appareil. Une confirmation par session ne suffit pas.
  • Vous confirmez
  • Après la confirmation
  • Un délai pour les montants élevés Si vous activez cette protection, les retraits concernés attendent avant d’être envoyés. Vous pouvez encore les annuler pendant ce délai.
  • Contrôle AML de la transaction Un contrôle est effectué avant l’envoi des fonds au destinataire.
  • Notifications des opérations Recevez les notifications selon vos paramètres. Les alertes de sécurité critiques restent activées.

La sécurité dans le centre d’aide

Conditions

Des conditions visibles à l’avance

Le montant à débiter s’affiche avant confirmation, frais compris.

Dépôts dans le portefeuille Crédités après les confirmations du réseau
Sans frais
Transferts par nom d’utilisateur dans Telegram Les fonds restent dans le service, sans transaction sur la blockchain ni frais de réseau
Sans frais
Échanger dans le portefeuille Taux de change, frais et montant final sur l’écran d’échange
Affichés avant confirmation
Retrait sur la blockchain Adresse, réseau et mémo si nécessaire vérifiés avant l’envoi
Frais de retrait indiqués dans l’application
Ajout et retrait de fonds dans Earn Aucune durée de blocage imposée
Sans frais

Les frais et minimums en vigueur sont indiqués dans l’application. La liste complète est disponible dans le centre d’aide.

USDT GRAM BTC ETH SOL BNB LTC DOGE
8 cryptomonnaies · 16 combinaisons d’actifs et de réseaux — un même solde

Inutile de créer un portefeuille pour chaque réseau. Choisissez celui qui vous convient pour déposer ou retirer des fonds.

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

en ligne L’assistance dans Telegram
Mon retrait TRC-20 n’est pas arrivé. Que faire ? Nous examinons la transaction et vous répondrons dans cette conversation.
@tgpayhelpbot
Questions fréquentes

Questions fréquentes

L’essentiel sur le portefeuille, les transferts, Earn et les paiements.

Le portefeuille est créé à la première ouverture de @tgpaycryptobot, sans identifiant, mot de passe ni phrase de récupération. L’accès est associé à votre compte Telegram.

Huit cryptomonnaies et seize combinaisons d’actifs et de réseaux : GRAM, BTC, ETH, SOL, BNB, LTC, DOGE et TRX, ainsi que l’USDT sur cinq réseaux et l’USDC sur trois. Choisissez le réseau lors d’un dépôt ou d’un retrait et utilisez l’adresse correspondante.

Saisissez son nom d’utilisateur. Le transfert reste dans le service : aucune adresse nécessaire ni aucuns frais de réseau. Vous pouvez aussi envoyer un chèque à une personne qui n’a pas encore de portefeuille ; elle le récupérera elle-même.

Placez une partie de votre solde dans Earn pour recevoir des gains automatiquement. Le taux annuel est de 4 % sur les premiers 500 USDT, puis de 1 % au-delà, et de 6 % sur les premiers 300 GRAM, puis de 3 % au-delà. Les gains sont calculés chaque heure et versés dans votre portefeuille tous les jours à 00:30 UTC. Ajout et retrait de fonds possibles à tout moment, sans frais.

Un chèque permet de partager des cryptos par lien ou code QR, avec un ou plusieurs récupérations. Vous pouvez définir un mot de passe, une date d’expiration ou réserver l’accès aux abonnés de vos canaux ou aux utilisateurs de Telegram Premium. Après sa création, vous pouvez le suspendre, modifier le montant et le nombre de récupérations ou le supprimer. Le montant restant revient sur votre solde.

Les transferts par nom d’utilisateur sont sans frais de réseau. Les retraits comportent les frais indiqués dans l’application. Les frais d’échange et le montant final s’affichent avant confirmation. Les valeurs et minimums en vigueur figurent dans l’application et le centre d’aide.

Créez des factures dans le bot ou automatisez-les avec l’API marchand. Une requête crée la facture et un webhook signale son paiement. La documentation des méthodes est disponible dans le centre d’aide.

Toutes les réponses sont disponibles dans le centre d’aide Pour toute autre question, contactez @tgpayhelpbot

Ouvrez votre portefeuille en quelques étapes

Lancez @tgpaycryptobot dans Telegram. Votre portefeuille est prêt à recevoir des cryptos.

Ouvrir dans Telegram
Votre profil :
Particuliers Créateurs Vendeurs Développeurs