Guide d’intégration

Pourquoi un paiement USDT / USDC peut rester en attente après le paiement du client

Une transaction blockchain réussie ne signifie pas toujours qu'une commande marchande doit être exécutée. Les commandes USDT / USDC en attente proviennent généralement d'une inadéquation entre le transfert et les règles de commande, ou d'un problème de livraison du webhook une fois la commande déjà payée.

Étapes

Une transaction blockchain réussie ne signifie pas toujours qu'une commande marchande doit être exécutée. Les commandes USDT / USDC en attente proviennent généralement d'une inadéquation entre le transfert et les règles de commande, ou d'un problème de livraison du webhook une fois la commande déjà payée.

Pourquoi un paiement USDT / USDC peut rester en attente après le paiement du client

  1. 01

    Créez la commande depuis votre serveur avec le montant, le réseau et votre identifiant externe.

  2. 02

    Affichez au client l’URL de paiement, le réseau, l’adresse, le QR code et le montant USDT / USDC exact.

  3. 03

    BoltUtil vérifie le réseau, le contrat du token, l’adresse, le montant, l’expiration et les confirmations.

  4. 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

Règlement non dépositaire

Les USDT / USDC vont directement au portefeuille marchand ; BoltUtil ne conserve ni fonds ni clés privées.

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.

Confirmez que la transmission contient un événement de transfert USDT / USDC réussi.
PENDING     No matched payment recorded
PAID        Payment recorded, awaiting confirmation
CONFIRMED   Payment confirmed, inspect callbacks
COMPLETED   Callback received a successful response

Check your own fulfillment records separately.

Exemples 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'API

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.