Intégration API
API d’encaissement USDT / USDC : créer et consulter les ordres
Utilisez une association exclusive pour les dépôts et une commande d’encaissement pour les montants fixes. Inspectez signatures, requêtes et réponses.
Guide pas à pas
Suivez les étapes dans votre tableau de bord. Cliquez sur une image pour l’agrandir.
Ouvrez le débogueur API dans le centre développeur. Pour les dépôts des membres, choisissez Créer un wallet exclusif et suivez son guide. Les étapes suivantes concernent les montants fixes. LIVE · Production signifie que la création écrit des données réelles ; vous pouvez commencer par consulter une commande existante.
Étape 1 · Cliquez pour agrandir Saisissez votre Merchant UID à six chiffres et votre API Key commençant par mch_ dans l’outil officiel. Ils restent dans la mémoire de cette page et doivent être saisis à nouveau après actualisation. Ne partagez pas de captures ou d’en-têtes contenant la clé.
Choisissez la création d’une commande d’encaissement et vérifiez devise, merchantOrderNo, amount et notifyUrl. Le montant est une chaîne ; merchantOrderNo relie la commande à votre système. notifyUrl doit utiliser HTTPS. Utilisez l’adresse de débogage pour observer les callbacks et l’adresse déployée de votre service pour votre activité.
Validez la création en production uniquement si vous souhaitez créer une vraie commande. L’outil génère timestamp, nonce et signature, puis affiche requête et réponse. Vérifiez le code HTTP, orderNo, merchantOrderNo, cashierUrl et status. Un lien de paiement confirme la création, pas l’encaissement.
Passez à la consultation d’état et saisissez l’orderNo de la plateforme : PI pour les encaissements, PO pour les paiements sortants. N’utilisez pas merchantOrderNo. Un encaissement réussit à completed ; un paiement sortant réussit à confirmed ou échoue à failed. Si le résultat est incertain, consultez la commande d’origine avant d’en créer une autre.
Comparez en-têtes, message signé, body et réponse brute. 20005 : clé ; 20011 : chemin, tri et normalisation ; 20012 : horloge ; 20016 : nouveau nonce ; 40105 : commandes non expirées du même montant ; 51004 : solde de frais. Conservez requestId et partagez l’erreur sans données sensibles. Prenez les exemples Node.js ou PHP comme référence et chargez les identifiants depuis les variables d’environnement.
L’outil utilise la production. Créer des commandes ou des wallets enregistre des données réelles ; créer un paiement sortant tente d’envoyer des fonds. Après un timeout ou un résultat inconnu, consultez la commande initiale avant de réessayer.