Comment accepter les paiements en USDT TRC20

Ce qu'est vraiment l'USDT TRC20

L'USDT est un stablecoin émis par Tether et destiné à suivre le dollar américain. Il existe sur plusieurs blockchains, et le réseau détermine le comportement d'un transfert. TRC20 est le standard de jetons sur TRON. Une adresse USDT TRC20 commence par la lettre T et un transfert est une transaction TRON.

Pourquoi il est si répandu chez les clients :

• les transferts sont peu coûteux comparés à de nombreux autres réseaux, ce qui compte pour les commandes petites et moyennes ;
• la plupart des plateformes d'échange et des portefeuilles prennent en charge les retraits sur ce réseau, c'est donc le choix par défaut de beaucoup d'acheteurs ;
• le montant est en dollars, de sorte que ni vous ni le client ne subissez de variation de prix entre la commande et le paiement.

Pour vous, commerçant, la conséquence pratique est qu'une grande part des clients qui disent « je paie en USDT » veulent dire USDT sur TRON. Ne pas le proposer complique la tâche de ceux qui veulent vous payer.

Le réseau fait partie du paiement

Le même jeton sur un autre réseau est un autre paiement. L'USDT sur TRON, sur Ethereum (ERC20) et sur BNB Smart Chain (BEP20) utilisent des adresses et des rails différents, et les fonds envoyés sur le mauvais n'arrivent pas là où l'expéditeur l'attend. C'est l'erreur la plus coûteuse des paiements en stablecoins, et ce sont les clients qui la commettent, pas les commerçants.

Ce qui aide :

• laisser la page de paiement, et non le texte de votre caisse, définir le réseau : le client y choisit l'actif et le réseau et reçoit l'adresse correspondante ;
• indiquer clairement à la caisse les réseaux que vous acceptez (voir les monnaies prises en charge) ;
• si vous voulez diriger tout le monde vers TRON, transmettez le moyen de paiement USDT TRC20 à la création du paiement, de sorte que la page s'ouvre avec lui déjà sélectionné.

Qvard prend en charge, parmi ses réseaux, TRON (TRC20), Ethereum (ERC20) et BNB Smart Chain (BEP20). Proposer plusieurs réseaux n'est pas mauvais, mais chaque choix supplémentaire est une occasion de plus pour un client de sélectionner par habitude un réseau différent de celui qu'il visait ; la page de paiement affiche le réseau et l'adresse ensemble pour que cela reste visible.

Comment circule un paiement en USDT

Le parcours de la commande au paiement :

1. Le client choisit de payer en crypto et votre serveur crée un paiement pour la commande.
2. La passerelle renvoie une page de paiement hébergée. Votre client choisit USDT et le réseau TRC20 et voit l'adresse et le montant exact.
3. Il envoie le montant depuis son portefeuille ou sa plateforme. Le taux de la page est fixé pendant une heure, le montant ne change donc pas pendant qu'il paie.
4. La passerelle surveille le réseau TRON. Quand le montant complet est arrivé et que le paiement est définitif, elle appelle votre webhook.
5. Votre système marque la commande comme payée.

Vous ne générez jamais d'adresses TRON et n'exploitez aucun nœud. Créer le paiement tient en une requête : un POST vers https://api.qvard.com/api/v1/payment avec l'en-tête x-api-key et un corps contenant l'id de votre commande et le price en dollars américains. La version pas à pas avec du code se trouve dans comment accepter les paiements crypto sur un site web.

Frais : qui paie quoi

Trois coûts différents sont souvent confondus, et il est utile de les séparer.

• Les frais de réseau du transfert. Celui qui envoie des USDT sur TRON paie la transaction avec les ressources propres au réseau (TRX ou énergie). C'est le client qui le supporte lorsqu'il vous paie. Votre prix n'a pas besoin de l'inclure, même si un client qui paie depuis une plateforme peut se voir prélever des frais de retrait sur le montant qu'il envoie.
• La commission de la passerelle. Selon la page des tarifs, elle est individuelle pour votre projet, part de 1 % et, par accord, peut descendre jusqu'à 0,1 %. Il n'y a pas d'abonnement.
• Les frais de réseau lors de votre retrait. Retirer votre solde vers votre propre portefeuille ne coûte que les frais de réseau.

Le point qui compte à la caisse est le premier : si un client envoie moins parce qu'une plateforme a prélevé des frais sur le montant, le paiement est insuffisant, pas terminé.

Paiements insuffisants et autres cas limites

Un paiement se termine par l'un des quatre statuts : wait (créé), partial (un montant inférieur à celui requis est arrivé), completed (le montant complet est arrivé) et rejected. Seul completed déclenche le webhook.

Pour l'USDT TRC20, les problèmes réalistes sont :

• Paiement insuffisant depuis une plateforme. Les frais de retrait ont été soustraits du montant. Le statut est partial. Décidez à l'avance si vous demandez la différence ou remboursez le client, et informez-le sur la page de commande.
• Paiement après la fenêtre de taux. Le taux est fixé pendant une heure. Si le client paie bien plus tard, traitez ce cas comme une demande de support plutôt que de bâtir une automatisation pour lui.
• Mauvais réseau. Le client a payé sur un réseau différent de celui que montrait la page. Cela demande un examen manuel et le code ne peut pas le corriger ; gardez un contact de support clair dans le parcours de paiement.

Rendez le gestionnaire de commande idempotent, car le webhook est renvoyé jusqu'à ce que votre point de terminaison réponde exactement HTTP 200, et comparez l'en-tête x-api-key avec votre clé. Pour en savoir plus, voir comment sécuriser les webhooks de paiement crypto.

Par quoi commencer

Un court plan de mise en route qui mène à une caisse USDT TRC20 fonctionnelle :

1. Créez un compte et un projet, et obtenez votre clé API.
2. Regardez une facture de démonstration pour voir ce que verra votre client.
3. Ajoutez à votre caisse l'appel de création de paiement, avec votre numéro de commande comme id.
4. Ajoutez le point de terminaison du webhook, enregistrez son adresse comme callback URL et ne marquez les commandes comme payées que sur completed.
5. Payez un petit montant réel en USDT sur TRON et vérifiez tout le parcours, y compris un retrait vers votre portefeuille.

Un sandbox séparé figure sur la feuille de route ; utilisez donc pour l'instant de petits montants réels. La documentation développeur donne les formats exacts de requête et de réponse.

Où vous pouvez retirer vos fonds

Les fonds des paiements restent sur votre solde Qvard et vous les retirez vers votre propre portefeuille crypto ; le coût se limite aux frais de réseau. Le retrait vers un compte bancaire en monnaie fiat n'est pas disponible ; prévoyez donc une sortie crypto, par exemple vers une plateforme que vous utilisez déjà, si vous devez convertir en espèces.

FAQ