Passer au contenu principal

​
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
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 en token natif :
ChaîneToken natif
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
Blockradar ne facture aucun frais supplémentaire en plus des coûts réseau.
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.

​
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 uniquement les swaps stablecoin-vers-stablecoin : USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.Les swaps de tokens natifs et le bridging sont disponibles sur toutes les chaînes supportées sauf Tron.
Cela signifie généralement que la paire de swap n’est pas prise en charge (par ex. swap vers un token natif), ou que le montant est trop faible ou trop élevé pour la liquidité disponible.
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

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.
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.
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 :
    GET /v1/wallets/{walletId}/transactions?address={addressId}
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 →

​
Testnet vs. Mainnet

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 Testnet à Live
  3. Créez un nouveau master wallet pour le mainnet
  4. Mettez à jour vos clés API — les clés testnet ne fonctionneront pas sur le mainnet
Les adresses testnet ne peuvent pas recevoir de fonds mainnet et vice versa.
ChaîneFaucet
Ethereum (Sepolia)Sepolia Faucet ou Alchemy
BNB ChainBNB Testnet Faucet
Polygon (Amoy)Polygon Faucet
BaseAlchemy Faucet
Tron (Nile)Nile Testnet
SolanaSolana Faucet
Circle USDCCircle Faucet

​
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é testnet sur le mainnet (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.

​
Comptes virtuels et cNGN

Les comptes virtuels permettent à vos utilisateurs de déposer des NGN (Naira nigérian), qui sont automatiquement convertis en stablecoins on-chain.Prérequis :
  • Vous devez être en mode mainnet/Live (pas en testnet)
  • Vous devez avoir complété la vérification KYB
Documentation des comptes virtuels →
Les comptes virtuels n’apparaissent que si vous êtes en mode Live, que votre compte a complété la vérification KYB et que la fonctionnalité a été activée pour votre compte.
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.

​
Rampes d’accès fiat

Utilisez les comptes virtuels pour le NGN :
  1. Générez un compte virtuel pour l’utilisateur
  2. L’utilisateur dépose des NGN par virement bancaire ou mobile money
  3. Les fonds sont automatiquement convertis en stablecoins et apparaissent on-chain
Documentation des comptes virtuels →
Actuellement, les comptes virtuels ne prennent en charge que le NGN. Pour d’autres devises, vous devrez intégrer des fournisseurs tiers de off-ramp fiat, ce qui vous permettra de faire du off-ramp vers KES, NGN, TZS, UGX, BRL et MWK. Voir Retirer en Fiat.

​
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, Celo, Lisk, Avalanche, Asset Chain, 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.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.Des actifs supplémentaires peuvent être intégrés sur demande.

​
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 mode mainnet/Live 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