API marchand

Acceptez des paiements dans votre bot

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

10 cryptomonnaies · 8 réseaux sur un même solde Un serveur MCP permet à votre agent IA de préparer l’intégration →
Écran de l’API marchand : applications et connexion d’un agent IA
Webhook : facture payée
Réseau 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. Connectez-le dans un client d’agent compatible : l’agent peut lire la documentation, demander la création d’une application, configurer les webhooks et vous aider à écrire l’intégration. Vous approuvez l’application dans Telegram, puis vérifiez et testez le résultat.

  1. Étape 1

    Envoyez la demande à votre agent

  2. Étape 2

    Approuvez l’application dans Telegram

  3. Étape 3

    Terminez et testez l’intégration

Fonctionnement, demandes par client et permissions de l’agent →
Demande à transmettre à votre agent
Connect the MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the 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 réseau de test

Testez le parcours de paiement dans le bot distinct du réseau de test, @tgpaycrypto_testnet_bot, avant de le proposer à vos 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.

10 cryptomonnaies · 8 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
L’écran de confirmation du retrait
Adresse valide
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 Avant de confirmer, vérifiez l’adresse du destinataire, le réseau et le mémo si nécessaire. Un format valide ne prouve pas que l’adresse appartient au destinataire voulu.
  • 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 de retrait Recevez les notifications selon vos paramètres. Les alertes de sécurité critiques restent activées.
Conditions

Des conditions visibles à l’avance

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

Dépôts dans le portefeuille Les fonds sont crédités après les confirmations du réseau. Les montants inférieurs au minimum du réseau ne sont pas crédités. Votre première adresse par réseau est gratuite, chaque adresse supplémentaire coûte 5 USD. 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 Les frais sont inclus dans le taux. Le taux et le montant final figurent sur l’écran d’échange. Affichés avant confirmation
Retrait sur la blockchain Le format de l’adresse est vérifié avant l’envoi. L’adresse, le réseau et le Mémo figurent sur l’écran de confirmation. Frais de retrait indiqués dans l’application

Les frais et les montants minimums en vigueur sont indiqués dans l’application.

USDT GRAM BTC ETH SOL BNB LTC DOGE
10 cryptomonnaies · 8 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 Assistance dans l’application
Mon retrait TRC-20 n’est pas arrivé. Que faire ? Nous examinons la transaction et vous répondrons dans cette conversation.
Ouvrir le portefeuille
Questions fréquentes

Questions fréquentes

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

Non. Le portefeuille est créé à la première ouverture de @tgpaycryptobot, sans identifiant supplémentaire ni phrase de récupération. L’accès est lié à votre compte Telegram. Pour envoyer des fonds, vous devez d’abord définir un PIN.

Dix 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 @username ou son identifiant numérique Telegram. Aucune adresse n’est nécessaire : le transfert reste dans le portefeuille, sans frais de réseau. Si le destinataire n’a encore jamais ouvert TgPay Crypto, le transfert l’attend et sera crédité lorsqu’il ouvrira le bot pour la première fois. S’il ne le récupère pas dans les 30 jours, les fonds vous sont rendus. Vous pouvez aussi envoyer un chèque : un lien que la première personne à l’ouvrir peut récupérer.

Un chèque permet de partager des cryptos par lien ou code QR, avec une 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.

Vous n’avez pas trouvé la réponse ? Écrivez à l’assistance dans l’application

Ouvrez votre portefeuille en quelques étapes

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

Votre profil :