Comment surveiller les transferts à partir d’un montant minimum
Définir un montant minimum pour un actif dans la surveillance : unités de base, seuil inclusif et vérification avec des données artificielles.
Mis à jour:
Dans la surveillance, vous pouvez suivre les transferts à partir d’un montant défini : réglez « Montant minimum » dans « Filtres avancés » pour une adresse du projet sélectionné. Le seuil est un entier exprimé dans les plus petites unités de l’actif choisi. La comparaison est inclusive : un transfert égal au seuil est retenu, un transfert inférieur ne l’est pas.
Commencez avec un seul actif sur un seul réseau. Vous pouvez, par exemple, vouloir surveiller les transferts entrants d’un jeton précis vers votre adresse. Il s’agit d’une règle portant sur le montant d’un transfert, pas sur sa valeur en dollars, le total reçu dans une journée ou les messages d’un fournisseur externe.
Préparez l’actif et les unités
Choisissez un projet disposant du service « Surveillance », une adresse publique et le droit de modifier ses paramètres. Assurez-vous que le réseau nécessaire est disponible pour une surveillance opérationnelle. L’ajout d’une adresse publique ne nécessite ni clé privée ni phrase de récupération.
Identifiez exactement l’actif et son nombre de décimales. Le nom du jeton ne suffit pas : le réseau et l’identifiant doivent correspondre au mode de surveillance choisi. Si vous recevez de l’USDT, ne considérez pas des réseaux différents ou des jetons ressemblants comme un seul actif. Ce choix est expliqué dans « Quelle différence entre un réseau et un jeton ? ».
Convertissez le montant lisible par une personne en unités de base en le multipliant par dix à la puissance du nombre de décimales de l’actif. N’utilisez pas un équivalent arrondi en dollars. Pour un actif à six décimales, un seuil de 10 unités s’écrit 10000000. C’est un exemple d’échelle, pas un seuil universel pour toutes les cryptomonnaies.
Étape 1. Ouvrez le formulaire d’ajout d’adresse
Ouvrez « Surveillance », sélectionnez le projet et la section « Adresses ». Cliquez sur « Ajouter des adresses ». Dans l’onglet « Manuellement », choisissez le réseau et saisissez l’adresse publique. Attendez le résultat de la vérification du format ; vérifiez séparément à qui appartient l’adresse et si la connexion est prête.
Dans le bloc d’utilisation de l’adresse, choisissez « Un actif ». Laissez le champ « Actif » vide pour la monnaie native du réseau ; pour un jeton, renseignez l’identifiant pris en charge sur le réseau choisi. Pour cet exemple, laissez « Entrant » activé. Si vous avez besoin des transferts sortants, vérifiez séparément leur prise en charge et le réglage de direction.
Ne choisissez pas tous les actifs dès la première règle : un même seuil numérique exprimé dans des plus petites unités différentes ne représente pas la même valeur économique. Une paire précise de réseau et d’actif permet de vérifier le calcul sans mélanger les échelles.
Étape 2. Définissez le montant minimum
Dépliez « Filtres avancés ». Dans « Montant minimum », avec l’indication « Unités du réseau de base », saisissez l’entier calculé, par exemple 10000000 pour l’échelle décrite ci-dessus. Cette valeur correspond au paramètre min_amount.
Ne saisissez ici ni nombre décimal, ni symbole de cryptomonnaie ou de devise, ni séparateurs de milliers. Une valeur vide signifie qu’aucun minimum de montant distinct n’est défini. Le nombre n’est pas automatiquement converti depuis des dollars ni ajusté au cours.
« Confirmations minimales » est une autre condition. Ne la modifiez pas pour compenser une erreur de montant. Le seuil est vérifié pour chaque transfert pris en compte : plusieurs petits versements ne sont pas automatiquement additionnés pour former un paiement admissible.
Étape 3. Enregistrez et vérifiez la règle
Cliquez sur « Ajouter une adresse » et effectuez le contrôle de sécurité affiché si le compte le demande. Après l’enregistrement, ouvrez l’adresse, trouvez la règle du bon projet et vérifiez l’actif, la direction et le minimum enregistré. Assurez-vous que la connexion est active ; la saisie réussie d’un nombre ne le prouve pas à elle seule.
Si une adresse est utilisée dans plusieurs projets, vérifiez bien la règle sélectionnée. Un autre projet peut avoir un seuil différent et recevoir d’autres événements. La présence d’un transfert dans un autre projet ne signifie pas que votre minimum a été ignoré.
Étape 4. Vérifiez la limite sans transfert réel
Pour un seuil de 10000000, les résultats attendus en plus petites unités sont les suivants :
| Montant du transfert | Vérification du montant |
|---|---|
| 9999999 | Inférieur au seuil, non retenu |
| 10000000 | Égal au seuil, retenu |
| 10000001 | Supérieur au seuil, retenu |
Vérifiez ces cas avec des données artificielles préparées lors d’un test local de votre intégration. Tous les exemples doivent utiliser le même réseau, le même actif, la même adresse et la même direction ; sinon, vous testez une autre condition. Il n’est pas nécessaire d’envoyer des cryptomonnaies pour vérifier l’arithmétique du filtre. Ce contrôle de limite ne confirme pas la livraison d’une notification au destinataire choisi : vérifiez séparément son acheminement.
Si le résultat diffère de vos attentes
Comparez d’abord les plus petites unités et l’échelle, puis l’actif, la direction, le projet et l’activation de la règle. Vérifiez le montant réel du transfert plutôt que son estimation actuelle dans la devise d’affichage. Le TXID sera utile pour examiner l’enregistrement. Un événement de surveillance ne confirme pas à lui seul le paiement d’une commande : il faut pour cela un lien avec une facture et une vérification de son état.