Skip to main content

​
Dépôts et Webhooks

Il s’agit généralement d’un délai temporaire d’indexation. Utilisez le Deposit Finder pour déclencher manuellement l’indexation :
  • Tableau de bord : Accédez à votre Master Wallet → Vue d’ensemble → Cliquez sur “Deposit Finder”
  • API : POST /v1/wallets/{walletId}/rescan/blocks avec le transactionHash
Documentation du Deposit Finder →
Les retards de webhooks peuvent survenir en raison de la congestion du réseau blockchain, de délais temporaires d’indexation des nœuds ou d’erreurs renvoyées par votre endpoint webhook.Pour vérifier les journaux des webhooks :
  • Tableau de bord : Master Wallet → Developers → Webhook Logs
  • API : GET /v1/wallets/{walletId}/webhooks
Pour qu’un webhook soit à nouveau livré, utilisez Resend Webhook.
Blockradar n’indexe que les stablecoins par conception. Les dépôts de tokens natifs (ETH, TRX, SOL, etc.) n’apparaîtront pas dans l’historique des transactions du tableau de bord. Cependant, les fonds sont toujours dans votre portefeuille et peuvent être consultés sur l’explorateur blockchain ou retirés via l’API ou le tableau de bord.

​
Auto-Sweep

Par défaut, disableAutoSweep est défini sur false, ce qui signifie que l’auto-sweep est activé. Lorsqu’un dépôt arrive sur une adresse enfant, il est automatiquement transféré vers votre master wallet.Pour conserver les fonds dans les adresses enfants :
  • Définissez disableAutoSweep: true lors de la création de l’adresse via l’API
  • Ou activez Disable Auto Sweep dans les paramètres de l’adresse sur le tableau de bord
Vérifiez les deux niveaux de configuration :
  • Niveau master wallet — définit la valeur par défaut pour toutes les adresses
  • Niveau adresse — remplace le paramètre du master wallet
Le paramètre au niveau de l’adresse est toujours prioritaire. Vérifiez que l’adresse spécifique a bien disableAutoSweep: true.
Oui. Vous pouvez configurer des seuils de sweep afin que les fonds ne soient automatiquement transférés qu’une fois un certain solde atteint.Configuration du portefeuille →

​
Frais de gas et coûts réseau

Les frais de gas sont payés directement à la blockchain dans le token natif de la chaîne — par exemple ETH sur Ethereum, Base, Arbitrum et Optimism, BNB sur BNB Chain, POL (anciennement MATIC) sur Polygon, TRX sur Tron, SOL sur Solana et XLM sur Stellar.Blockradar n’applique aucune majoration sur le gas réseau : vous ne payez que ce que la blockchain facture. D’autres produits peuvent comporter leurs propres frais — voir Frais et tarification ci-dessous.
Les frais du réseau Tron sont généralement de 1 à 6 $ par transaction en raison de la manière dont Tron gère la bande passante et l’énergie. Il s’agit d’un coût au niveau de la blockchain, pas d’un frais Blockradar.Alternatives moins coûteuses :
  • Solana : ~0,01–0,30 $ par transaction
  • Base : ~0,01–0,10 $ par transaction
  • Polygon : ~0,01–0,10 $ par transaction
L’endpoint /withdraw/network-fee renvoie une estimation prudente pour garantir que les transactions aboutissent même en période de forte congestion du réseau. Seuls les frais réseau réels vous sont facturés, et ils sont généralement inférieurs à l’estimation.
Non, les frais de gas blockchain doivent être payés dans le token natif de la chaîne. Cependant, vous pouvez activer les retraits gasless pour que votre master wallet prenne en charge les frais de gas pour les transactions des adresses enfants.

​
Activation des adresses (Stellar, Tron, Solana)

Certaines blockchains exigent qu’une adresse soit activée ou financée avant de pouvoir détenir des tokens. Il s’agit d’une règle du réseau, pas de frais Blockradar, et votre portefeuille n’est pas en train d’être vidé :Activation des adresses →
Émettez l’adresse en mode dormant avec enableIndexing: false. L’activation est reportée jusqu’à ce que vous activiez l’indexation sur cette adresse, de sorte que vous ne financez la réserve que pour les adresses que vos clients utilisent réellement.
La cause la plus fréquente est un master wallet insuffisamment approvisionné. Rechargez votre master wallet Stellar en XLM — les activations en attente sont relancées automatiquement dès l’arrivée des fonds. Consultez configurations.stellar.lastError sur l’adresse pour connaître la raison précise.

​
Transactions Gasless

Lorsque le mode gasless est activé, le master wallet paie les frais de gas pour les retraits des adresses enfants.Pour activer :
  • Niveau master wallet : Tableau de bord → Paramètres du Master Wallet → Activer les transactions gasless
  • Niveau adresse : Définissez enableGaslessWithdraw: true lors de la création ou de la mise à jour d’une adresse
Vous pouvez également définir des seuils pour que seuls les retraits au-dessus ou en dessous de certains montants soient couverts.Transactions Gasless → · Paramètres d’adresse →
Cela dépend du paramètre enableGaslessWithdraw :
  • Activé (true) : Le master wallet paie le gas
  • Désactivé (false, par défaut) : L’adresse enfant a besoin de son propre gas

​
Swaps et Bridges

Blockradar prend en charge les swaps de stablecoin à stablecoin (par exemple USDT ↔ USDC) et les swaps entre stablecoins et tokens natifs (par exemple SOL → USDC ou USDC → TRX), aussi bien sur la même chaîne qu’entre chaînes.La liquidité varie selon la paire, la chaîne et le montant ; demandez donc un devis pour confirmer une route précise avant de la proposer à vos utilisateurs.Documentation des Swaps →
Causes courantes :
  • Aucune route ni liquidité n’est actuellement disponible pour cette paire sur cette chaîne
  • Le montant est trop faible ou trop élevé pour la liquidité disponible
  • L’actif n’est pas activé sur votre portefeuille
Essayez un autre montant, ou vérifiez que les deux actifs sont activés sur les portefeuilles concernés.
Cette erreur signifie généralement que vous utilisez le mauvais asset ID. Vous devez utiliser l’asset ID spécifique au portefeuille, pas un asset ID général.Pour trouver l’ID correct :
  • Tableau de bord : Accédez à votre portefeuille → Assets → Copiez l’asset ID depuis là
  • API : Utilisez les asset ID renvoyés par l’endpoint des détails de votre portefeuille
Oui. Vous pouvez échanger et transférer des actifs entre différentes blockchains via le tableau de bord ou l’API. Pour les swaps cross-chain via l’API, passez l’asset ID du master wallet de destination comme toAssetId.Documentation des Swaps →

​
Configuration du portefeuille

Oui. Chaque réseau blockchain nécessite son propre Master Wallet, y compris chaque chaîne EVM — un portefeuille Base ne couvre pas Ethereum, Polygon ou Arbitrum. Créez un Master Wallet par chaîne que vous souhaitez prendre en charge.Créer un Master Wallet →
Blockradar n’autorise qu’un seul Master Wallet par réseau blockchain par compte. Pour prendre en charge une blockchain supplémentaire, vous devez créer un Master Wallet distinct. Au sein d’un même Master Wallet, vous pouvez créer autant d’adresses enfants que nécessaire pour segmenter les fonds par utilisateur, application ou objectif. La création de plusieurs Master Wallets pour la même blockchain n’est pas prise en charge.
Non, les adresses ne peuvent pas être supprimées en raison des limitations de la blockchain. Vous pouvez uniquement les désactiver dans le tableau de bord. Les adresses désactivées ne recevront plus de nouveaux dépôts et ne seront plus surveillées.
Oui. La liste blanche d’adresses vous permet d’ajouter une adresse externe à votre portefeuille afin que Blockradar surveille ses dépôts, sans modifier votre configuration existante.Liste blanche d’adresses →
Utilisez le paramètre showPrivateKey: true lors de la récupération des détails du portefeuille ou de l’adresse via l’API.
Utilisez cette fonctionnalité uniquement dans des environnements sécurisés et de confiance.

​
Retraits et transferts

Utilisez l’endpoint API de retrait : POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentation des retraits →
Causes courantes :
  • Gas insuffisant dans le master wallet (si vous utilisez le mode gasless) ou dans l’adresse enfant
  • Traitement de la file d’attente — les transactions sont traitées séquentiellement en raison des nonces blockchain
  • Problèmes de nœud — retards temporaires
Si la transaction est bloquée depuis plus de 30 minutes, contactez le support avec l’ID de transaction.
Oui :
Oui. Le mode Sign-Only signe la transaction et la renvoie sans la soumettre à la blockchain — utile pour la signature hors ligne, les flux multi-signatures ou l’inspection d’une transaction avant sa diffusion.
  • Master wallet : POST /v1/wallets/{walletId}/withdraw/sign
  • Adresse enfant : POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign
Mode Sign-Only →
Tous les mouvements de fonds on-chain utilisent l’endpoint de retrait. Il n’existe pas d’endpoint “transfert” distinct.
  • Master vers enfant : POST /v1/wallets/{walletId}/withdraw avec l’adresse enfant comme destination
  • Enfant vers master : POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw avec l’adresse du master wallet comme destination
  • Enfant vers externe : Même endpoint, adresse externe comme destination
Documentation des retraits →
Utilisez l’endpoint des transactions avec le paramètre de requête address :
Documentation des transactions →

​
Récupération d’actifs

Utilisez la récupération d’actifs dans le tableau de bord.Récupération d’actifs →

​
Test Mode vs. Live Mode

Non, vos fonds ne sont pas perdus. Le mainnet et le testnet sont des réseaux distincts, mais les adresses sont liées cryptographiquement. Vous pouvez récupérer vos fonds grâce à la récupération d’actifs.Récupération d’actifs →
Vérifiez toujours l’indicateur d’environnement dans le tableau de bord (affiche “Test Mode” ou “Live Mode”) avant d’effectuer une transaction.
  1. Utilisez le sélecteur d’environnement dans votre tableau de bord (généralement en haut à droite ou dans les paramètres du portefeuille)
  2. Passez de Test Mode à Live Mode
  3. Créez un nouveau master wallet pour le mainnet
  4. Mettez à jour vos clés API — les clés du Test Mode ne fonctionneront pas en Live Mode
Les adresses testnet ne peuvent pas recevoir de fonds mainnet et vice versa.
Tokens natifs pour le gas :Pour obtenir des USDC et EURC testnet sur la plupart des chaînes, utilisez le Circle Faucet. Les faucets de stablecoins pour chaque chaîne sont répertoriés sur la page Actifs Supportés.

​
Erreurs API et dépannage

Causes courantes :
  • Mauvais wallet ID
  • Mauvaise clé API (ne correspond pas au portefeuille)
  • Utilisation d’un asset ID général au lieu d’un asset ID spécifique au portefeuille
Il s’agit généralement d’un problème temporaire. Si cela persiste, contactez le support en indiquant l’endpoint que vous appelez, la blockchain/le réseau et la réponse d’erreur complète.
Votre clé API est invalide ou ne correspond pas au portefeuille auquel vous essayez d’accéder. Vérifiez que :
  • La clé API est correcte (pas d’espaces supplémentaires)
  • La clé API appartient à ce portefeuille
  • Vous n’utilisez pas une clé du Test Mode en Live Mode (ou vice versa)
  • La clé API n’a pas été renouvelée ou régénérée
La ressource (portefeuille, adresse ou actif) n’existe pas ou vous utilisez le mauvais ID. Les causes courantes incluent un mauvais wallet ID ou address ID, l’utilisation d’un asset ID général au lieu d’un ID spécifique au portefeuille, ou une faute de frappe dans l’URL de l’endpoint.
Vous avez dépassé la limite de débit de l’API. Ralentissez et réessayez après une courte attente, idéalement avec un backoff exponentiel. Évitez les interrogations en boucle serrée — utilisez les webhooks pour les mises à jour de transactions, et mettez en cache les réponses des endpoints de découverte (actifs, devises et blockchains pris en charge) au lieu de les appeler à chaque requête.Erreurs →

​
Frais et tarification

Pas sur le gas — Blockradar répercute les frais réseau sans majoration. Certains produits comportent leurs propres frais :
  • Les swaps et conversions fiat peuvent inclure une marge sur le taux de change
  • Les dépôts et paiements fiat peuvent entraîner des frais de traitement
  • La création d’un compte virtuel peut entraîner des frais fixes
  • Earn prélève ses frais sur les gains lors du retrait, jamais sur votre dépôt
Les tarifs dépendent de votre plan et de vos conditions commerciales. Les endpoints de devis affichent le taux et les frais d’une transaction donnée avant que vous ne l’exécutiez. Pour connaître la tarification de votre compte, contactez [email protected].

​
Comptes virtuels et dépôts fiat

  • Approbation de conformité : Complétez le processus de due diligence sous My Wallets → Settings → Compliance dans le tableau de bord
  • Activation de la fonctionnalité : Après l’approbation de conformité, demandez l’activation des comptes virtuels à [email protected] ou via le chat en direct du tableau de bord
  • Un plan payant avec accès aux stablecoins : Le dépôt de fiat et sa conversion en stablecoins est une fonctionnalité payante. Passez à un plan supérieur depuis Dashboard → Settings → Subscription
  • Le bon environnement : Les requêtes en Test Mode utilisent uniquement les routes et portefeuilles testnet ; les requêtes en Live Mode utilisent uniquement les routes et portefeuilles mainnet
Documentation des comptes virtuels →
Les comptes virtuels n’apparaissent qu’une fois votre conformité approuvée, la fonctionnalité activée pour votre compte et votre plan incluant l’accès aux stablecoins.
  • Les comptes virtuels réutilisables sont des comptes bancaires durables liés à un master wallet ou à une adresse enfant. Chaque dépôt sur ces comptes est converti en stablecoins — idéal pour les dépôts récurrents de vos clients.
  • Les ordres de paiement Deposit Fiat créent un compte virtuel à usage unique pour un paiement attendu. Le compte n’est valable que pour ce seul paiement.
Les dépôts sont actuellement disponibles en ARS, BRL, COP, EUR, KES, MXN et USD.
Les comptes virtuels NGN sont actuellement inactifs. Les paiements en NGN via le Retrait en Fiat ne sont pas affectés.
La disponibilité varie selon le corridor et le portefeuille ; vérifiez donc ce que votre portefeuille prend en charge avant de proposer une option : utilisez l’endpoint de découverte des comptes virtuels pour les comptes réutilisables, ou Get Supported Currencies pour Deposit Fiat.
Non. AUD, CAD, GHS, THB, TRY, TZS, UGX, XOF et ZAR sont disponibles uniquement en paiement : vous pouvez effectuer des paiements dans ces devises avec le Retrait en Fiat, mais les utilisateurs ne peuvent pas y déposer.
Le cNGN est un stablecoin indexé sur le Naira nigérian. Blockradar prend en charge les transactions et les swaps de cNGN avec d’autres stablecoins.

​
Paiements fiat (Retrait en Fiat)

Utilisez le Retrait en Fiat. Il convertit les stablecoins pris en charge en fiat et effectue le paiement vers des comptes bancaires, du mobile money et d’autres rails locaux, depuis un master wallet ou une adresse enfant. Le flux découvre les moyens de paiement d’un corridor, vous indique exactement les informations du bénéficiaire requises pour chacun, puis établit un devis et exécute le paiement.
Les paiements sont actuellement disponibles en ARS, AUD, BRL, CAD, COP, EUR, GHS, KES, MXN, NGN, THB, TRY, TZS, UGX, USD, XOF et ZAR.La disponibilité varie selon le corridor et le portefeuille ; récupérez donc la liste à jour avec Get Supported Currencies plutôt que de la coder en dur.

​
Earn

Earn vous permet de faire fructifier vos stablecoins inactifs dans des protocoles DeFi générant des intérêts (Aave et Compound). Le service est non custodial : les fonds partent de votre propre portefeuille, Blockradar ne les mutualise ni ne les détient jamais, et il n’y a aucune période de blocage.Earn →
Aave est disponible sur Ethereum, Base, Arbitrum, Optimism, Polygon et BNB Smart Chain. Compound est disponible sur Ethereum, Base et Arbitrum. Le tableau de bord n’affiche que les réseaux sur lesquels Earn est disponible pour votre portefeuille.
Le dépôt est gratuit. Lors d’un retrait, vous recevez exactement le montant demandé — les frais sont prélevés sur vos gains, jamais sur votre capital. Vous pouvez retirer tout ou partie d’une position à tout moment. Les taux sont variables et la DeFi comporte un risque lié aux smart contracts ; les rendements ne sont donc pas garantis.

​
Conformité et sécurité

Oui. L’API AML vérifie n’importe quelle adresse de portefeuille par rapport aux listes noires de l’OFAC, du FBI, de Tether et de Circle, afin que vous puissiez signaler les contreparties à haut risque avant d’envoyer ou de recevoir des fonds.Vérification AML →
Oui. La liste blanche IP limite les requêtes API aux adresses IP que vous autorisez, ajoutant une couche de protection supplémentaire à votre intégration.Liste Blanche IP →
Certains corridors fiat exigent que vos clients soient vérifiés. Créez des clients avec la Customer API, puis soumettez leurs informations et documents via les demandes d’onboarding client. Ne collectez que les champs demandés par le schéma d’exigences — voir Formulaires dynamiques.

​
Autres produits

Oui. Checkout vous permet d’accepter des paiements en stablecoins via des liens partageables — sans compte client ni intégration complexe.
Oui. Gateway vous offre un solde USDC unifié et abstrait de la chaîne : déposez depuis n’importe quelle chaîne prise en charge et retirez vers n’importe quelle chaîne prise en charge, sans bridging manuel.
Oui. Les règlements automatiques convertissent les dépôts entrants dans l’actif de votre choix et les acheminent vers votre chaîne de destination, selon des règles que vous définissez une seule fois.
Le Liquidity Pool permet aux fournisseurs de liquidité approuvés de fixer des taux de change pour des paires d’actifs. Ces taux alimentent le moteur de swap de Blockradar, qui sélectionne le meilleur taux disponible parmi les fournisseurs actifs.
Oui. La Smart Contract API vous permet de lire et d’écrire sur n’importe quel smart contract directement depuis votre portefeuille, sans gérer vous-même les endpoints RPC ni les flux de signature.

​
Demandes de fonctionnalités

Non. Blockradar se concentre sur les stablecoins. Le Bitcoin n’est actuellement pas pris en charge.
Blockradar est agnostique en matière de blockchain et de stablecoin — des réseaux et actifs supplémentaires peuvent être intégrés sur demande. Contactez-nous pour discuter de vos besoins.

​
Facturation et abonnements

Oui. Vous pouvez payer via le lien de paiement envoyé à votre adresse e-mail, ou effectuer un retrait depuis votre master wallet vers l’adresse du lien de paiement.
Actuellement, nous n’acceptons que les paiements en stablecoins pour les abonnements.

​
Blockchains et actifs pris en charge

Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Stellar, Celo, Lisk, Avalanche, Asset Chain, Arc, Plasma, et Tempo.Blockradar est agnostique en matière de blockchain et de stablecoin — des réseaux supplémentaires peuvent être intégrés sur demande.Blockchains Supportées →
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, ZARP, JPYC, MXNB, PYUSD, AlphaUSD, OUSD.Des actifs supplémentaires peuvent être intégrés sur demande.Actifs Supportés →

​
Conseils pour les développeurs

  • Wallet ID : Identifie votre master wallet
  • Address ID : Identifie une adresse enfant spécifique au sein d’un portefeuille
  • Asset ID : Identifie un actif spécifique (USDT, USDC, etc.) au sein de votre portefeuille
Utilisez toujours l’asset ID spécifique au portefeuille provenant de la liste d’actifs de votre portefeuille, et non un asset ID général.
  • Utilisez toujours le Live Mode pour les transactions réelles
  • Stockez les wallet ID et address ID dans votre base de données
  • Implémentez des gestionnaires de webhooks pour les mises à jour de transactions en temps réel
  • Utilisez le Deposit Finder comme solution de secours pour les transactions manquées
  • Surveillez le solde du master wallet pour le gas (tokens natifs)
  • Activez les retraits gasless si vos utilisateurs ne doivent pas détenir de tokens natifs

​
Besoin d’aide ?

Documentation

docs.blockradar.co

Tableau de bord

dashboard.blockradar.co

Réserver un appel support

Planifier ici