Règlement non dépositaire
Les USDT / USDC vont directement au portefeuille marchand ; BoltUtil ne conserve ni fonds ni clés privées.
Guide d’intégration
Comment vérifier un paiement USDT / USDC avant d'exécuter une commande
Lorsqu'un client dit avoir payé mais que la commande est toujours en attente, vous avez besoin d'un moyen reproductible pour comparer les faits de la blockchain avec les faits de la commande. Ce guide explique les contrôles que les commerçants doivent effectuer sur TRC20, ERC20, BEP20, Polygon et Solana.
Étapes
Lorsqu'un client dit avoir payé mais que la commande est toujours en attente, vous avez besoin d'un moyen reproductible pour comparer les faits de la blockchain avec les faits de la commande. Ce guide explique les contrôles que les commerçants doivent effectuer sur TRC20, ERC20, BEP20, Polygon et Solana.
Comment vérifier un paiement USDT / USDC avant d'exécuter une commande
01 Créez la commande depuis votre serveur avec le montant, le réseau et votre identifiant externe.
02 Affichez au client l’URL de paiement, le réseau, l’adresse, le QR code et le montant USDT / USDC exact.
03 BoltUtil vérifie le réseau, le contrat du token, l’adresse, le montant, l’expiration et les confirmations.
04 Après confirmation, vérifiez la signature du webhook et exécutez la commande de façon idempotente.
BoltUtil vérifie les paiements et envoie des callbacks signés. Votre serveur vérifie la signature et le statut, évite les doublons puis livre, active ou crédite.
Notes d'intégration
Ce qui compte avant la production
Six réseaux de paiement
TRON, Ethereum, BNB Smart Chain, Polygon, Solana et Base. TRON accepte uniquement USDT / USDC ; les autres canaux USDT / USDC nécessitent un actif activé et un portefeuille valide.
Webhooks signés
La signature HMAC, l’horodatage et les journaux de renvoi sécurisent l’automatisation après paiement.
Network matches the order
Configured token contract / mint matches
Destination matches the order wallet
Full payable amount matches
Payment time and order window checked
Required confirmations reached
Transaction association and fulfillment checkedExemples d’intégration et de diagnostic. Aucune requête n’est envoyée. Consultez vos commandes, la configuration réseau et la documentation API.
Lire la documentation sur l'APIQue vérifier ensuite ?
Conservez la commande initiale et le hash. Transfert réussi, paiement confirmé et webhook livré sont trois faits distincts.
Avec A = 1.000, B = 1.010 et C = 1.020, un paiement de 1.020 correspond à C seulement si les autres conditions sont respectées. Aucun montant exact pour 1.030.
Exemple uniquement. Un écart n’est pas accepté automatiquement : vérifiez règles, délai et rattachement. Le compte gratuit consulte ses vérifications ; accepter ou refuser un lien exige Pro actif.
- Montant exact
- Comparez montant complet, réseau, jeton, portefeuille et délai. Une correspondance exacte valide est prioritaire sur les candidats présentant un écart.
- Paiement insuffisant ou excédentaire
- Un transfert manuel admissible peut créer une vérification. Contrôlez les limites et le rattachement ; ne choisissez pas simplement le montant le plus proche.
- Confirmation en cours
- PAID indique un paiement enregistré dont la confirmation continue. Vérifiez réseau et suivi de chaîne sans demander un second paiement.
- Paiement confirmé, boutique non mise à jour
- Vérifiez livraison du webhook, réponse HTTP, signature du corps brut et enregistrement de la commande. Corrigez le récepteur, renvoyez selon vos droits et livrez une seule fois.
- Réseau ou jeton incorrect
- Vérifiez réseau et contrat ou mint. Un même symbole ou format d’adresse ne rattache pas un transfert sur une autre route à cette commande.
Créez les commandes côté serveur
N’exposez jamais la clé API dans le navigateur et enregistrez l’identifiant externe avant le checkout.
Affichez clairement le réseau
Indiquez TRC20, ERC20, BEP20, Polygon ou Solana avec l’adresse afin d’éviter les erreurs de réseau.
Exécutez après vérification
L’URL de retour ne prouve pas le paiement ; utilisez le webhook signé ou une requête de statut serveur.
Guide d’intégration
Questions posées par les commerçants avant de lancer une mise en ligne
BoltUtil conserve-t-il les fonds du marchand ?
Non. Les fonds vont directement au portefeuille marchand et BoltUtil surveille les transferts.
Comment un paiement USDT / USDC est-il rapproché ?
Le système vérifie le réseau, le token, l’adresse, le montant exact, l’état et l’expiration de la commande.
Quels réseaux prennent en charge USDT et USDC ?
TRON prend uniquement en charge USDT. Ethereum, BNB Smart Chain, Polygon, Solana et Base utilisent les versions configurées de USDT / USDC. La disponibilité dépend des canaux actifs et des portefeuilles du marchand.
Lancez un flux de paiement USDT / USDC plus propre
Créez des commandes, surveillez les transferts et informez votre backend sans demander aux clients d'envoyer des captures d'écran.