API de paiement USDT / USDC : frais et résultats inconnus
Le paiement est terminé lorsque confirmation en chaîne et règlement métier concordent. Vérifiez fonds, frais, destination et référence avant création, puis conservez les statuts.
Choisir le réseau et le modèle
L’API publique propose le paiement unitaire ; les lots passent par le tableau de bord. Routes : TRON-USDT, BSC-USDT, BSC-USDC et SOL-USDC. La destination correspond au réseau et ne peut être un portefeuille propre au marchand. Un portefeuille en observation ne signe pas.
Paramètres et étapes d’intégration
POST /openapi/payout/orders reçoit réseau, actif, amount, toAddress, merchantOrderNo et notifyUrl. fromAddress est facultatif : le système peut choisir une source suffisante. Remplacez la destination illustrative par une adresse vérifiée. Gardez la suppression de la source désactivée par défaut.
Ce corps est illustratif : aucune requête n’est envoyée et aucune donnée réelle n’est incluse. L’appel complet exige UID, API Key, timestamp, nonce et signature côté serveur. Transmettez les montants en chaînes et utilisez un calcul exact pour la comptabilité.
{
"chainCode": "TRON",
"tokenSymbol": "USDT",
"toAddress": "REPLACE_WITH_VERIFIED_TRON_ADDRESS",
"amount": "35.50",
"merchantOrderNo": "DEMO_PAYOUT_001",
"notifyUrl": "https://merchant.example.com/payouts/notify"
}Statuts, callbacks et exceptions
Conservez orderNo PO et consultez GET /openapi/payout/orders/{orderNo}. confirmed est un succès ; failed un échec. submitted, broadcasted ou inconnu ne sont pas un règlement. Ne changez pas de référence pour repayer ; vérifiez la transaction signée originale si le résultat est incertain.
Le principal du portefeuille et le compte de frais sont séparés. Vérifiez le solde réel de la source et les frais réseau disponibles avant paiement. Un solde de frais négatif bloque les opérations critiques. Consultez les tarifs et quotas actuels ; une estimation de gas n’est pas la facturation UUGate.
Utilisez l’API Key de l’ordre original et le rawBody inchangé. Vérifiez HMAC-SHA256(timestamp + "." + nonce + "." + rawBody) avec x-callback-signature. Contrôlez ensuite identité, ordre, actif, réseau et montant. Transaction de base de données et contrainte unique évitent les crédits doubles. Répondez HTTP 2xx après persistance fiable ; une redirection ne confirme pas le paiement.
Exemple illustratif d’intégration
Exemple : règlement de 35.50 USDT à un partenaire. Sauvegardez orderNo ; après une coupure, consultez l’ordre original et enregistrez un règlement lorsque confirmed. Un résultat inconnu reste en cours pendant la vérification de txHash. Analysez les échecs avant la reprise documentée. Aucun fonds n’a été envoyé.
Vérifications avant lancement
- La signature valide passe ; modifier le corps original invalide la vérification.
- Un callback répété crédite une seule fois ; un traitement interrompu peut reprendre.
- Requêtes, callbacks, écritures et transactions en chaîne concordent.
- Mauvais réseau, montant anormal, expiration et résultat inconnu nécessitent une enquête.
Intégration et références techniques
- Paramètres API
- Signature des requêtes
- Vérification des callbacks
- Offres et frais réseau
- Tutoriel associé
- API de paiement USDT
- API de paiement USDC
- Encaissement par adresse dédiée
- SDK Node.js
- SDK PHP / Laravel
- Node.js: HMAC and timing-safe comparison
Ces sources expliquent les standards et méthodes techniques ; elles ne constituent pas une approbation d’UUGate. Les paramètres applicables sont dans la documentation UUGate actuelle.
Paiements USDT par lot : console, frais et résultats individuels
L’API publique propose uniquement des paiements unitaires. Les lots USDT s’utilisent dans la console marchand. Répéter des requêtes unitaires n’est pas une API de lot atomique et ne garantit pas un succès ou un retour arrière global.
Suivez le tutoriel, vérifiez chaque destination et réseau, les fonds sources et un solde de frais suffisant pour tout le lot. Effectuez la 2FA requise. Fonds du portefeuille et compte de frais sont contrôlés séparément.
Rapprochez chaque dossier, statut et hash. En cas d’échec partiel ou de résultat inconnu, conservez et interrogez les dossiers d’origine. Si signé, vérifiez ou retransmettez la signature d’origine ; ne signez pas un second paiement.