Surveillance des adresses USDT et notifications : observation et recharges
La surveillance des adresses USDT suit l’activité sur la chaîne. Les notifications relient un paiement confirmé à votre application. Variation de solde, commande terminée et crédit d’un membre sont trois événements différents.
Observer une adresse existante
Ajoutez une adresse externe du réseau adapté pour observer les encaissements ou servir de destination de regroupement. Aucune clé privée n’est importée ; la plateforme ne peut pas signer de paiements depuis cette adresse. Elle ne remplace pas les adresses dédiées par membre. Voir les types de portefeuille.
USDT utilise TRC20 ou BEP20 ; USDC, BEP20 ou SPL. Vérifiez actif et réseau. Les adresses de recharge des frais appartiennent au compte de frais, pas aux encaissements clients.
Surveiller ne permet pas d’identifier le membre
Plusieurs personnes peuvent payer une même adresse. Une hausse de solde n’identifie ni membre ni facture. Utilisez le parcours de commande ou de liaison et conservez le lien entre objet métier et paiement.
L’observation d’adresses externes ne garantit pas un webhook personnalisé pour toute transaction. Les callbacks proviennent du parcours d’encaissement ou de recharge applicable, selon la documentation.
Lier un membre avec bindKey
Déduisez un bindKey stable du membre authentifié côté serveur et créez ou consultez la liaison par marchand, réseau et actif. Conservez bindingId, addressId, address et bindKey. Une requête répétée peut réutiliser le résultat sans modifier label ni notifyUrl.
L’API ne renvoie pas cashierUrl. Utilisez votre page de recharge ou copiez le lien de la console. Suivez le tutoriel dédié.
Créditer les notifications en sécurité
Après confirmation et traitement, un encaissement dédié produit une commande et son callback. Vérifiez rawBody avec l’API Key d’origine, puis marchand, orderNo, réseau, actif, bindKey, completed et paidAmount.
Créez un enregistrement unique par marchand et orderNo. Dédupliquez et créditez dans la même transaction avant de répondre HTTP 2xx. Dédupliquer seulement par bindKey supprimerait la deuxième recharge valide. Consultez le protocole.
Examiner un versement sans notification
Vérifiez réseau, jeton, destination et confirmations, puis liaison active, commande, notifyUrl, signature et journaux applicatifs. Interrogez la commande d’origine ou les commandes et transactions récentes de la liaison.
Le bouton de callback de la console renvoie activement la notification. Utilisez-le après réparation du récepteur et vérification de l’idempotence ; ce n’est pas un lecteur de journaux. Voir la reprise.
Rapprocher soldes et encaissements
Le RPC réel de la chaîne fait autorité pour le solde. Instantanés et écritures servent au suivi. Un échec signifie solde inconnu, pas zéro. Regroupements, paiements et autres transferts modifient les fonds actuels.
- Conservez heure, réseau, actif, commande et preuves.
- Séparez confirmation, réception du callback et crédit du membre.
- Prévenez avant de désactiver ou changer un portefeuille et conservez son attribution historique.
Voir le rapprochement.
Choisir le bon parcours
Commencez par les types de portefeuille pour observer une adresse, les adresses dédiées pour les recharges ou l’API USDT pour les commandes fixes. Comparez les entrées dans le guide de paiement.