Passer au contenu principal

​
Dépôts et Webhooks

Il s’agit généralement d’un délai d’indexation temporaire. Utilisez le Localisateur de Dépôts pour déclencher l’indexation manuellement :
  • Tableau de bord : Accédez à votre Portefeuille Principal → Vue d’ensemble → Cliquez sur “Localisateur de Dépôts”
  • API : POST /v1/wallets/{walletId}/rescan/blocks avec le transactionHash
Documentation du Localisateur de Dépôts →
Les retards de webhook peuvent survenir en raison d’une congestion du réseau blockchain, de retards temporaires d’indexation des nœuds, ou d’erreurs sur votre endpoint webhook.Pour vérifier les journaux de webhooks :
  • Tableau de bord : Portefeuille Principal → Développeurs → Journaux de Webhooks
  • API : GET /v1/wallets/{walletId}/webhooks

​
Balayage Automatique

Par défaut, disableAutoSweep est défini sur false, ce qui signifie que le balayage automatique est activé. Lorsqu’un dépôt arrive sur une adresse secondaire, il est automatiquement balayé vers votre portefeuille principal.Pour conserver les fonds dans les adresses secondaires :
  • Définissez disableAutoSweep: true lors de la création de l’adresse via l’API
  • Ou activez Désactiver le Balayage Automatique dans les paramètres de l’adresse sur le tableau de bord
Vérifiez les deux niveaux de configuration. Le paramètre au niveau de l’adresse est toujours prioritaire.
  • Niveau portefeuille principal — définit la valeur par défaut pour toutes les adresses
  • Niveau adresse — remplace le paramètre du portefeuille principal
Vérifiez que l’adresse spécifique a disableAutoSweep: true.
Oui. Vous pouvez configurer des seuils de balayage pour que les fonds ne soient balayés automatiquement 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 :
RéseauToken Natif
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
Blockradar ne facture pas de frais supplémentaires au-delà des coûts réseau.
Les frais réseau de Tron sont typiquement de 1 à 6 $ par transaction en raison de la façon dont Tron gère la bande passante et l’énergie. Il s’agit d’un coût au niveau de la blockchain, pas d’une facturation de 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 conservatrice pour garantir que les transactions réussissent même en cas de forte congestion. Vous ne payez que les frais réseau réels, qui sont généralement inférieurs à l’estimation.
Non, les frais de gas blockchain doivent être payés dans le token natif du réseau. Cependant, vous pouvez activer les retraits sans gas pour que votre portefeuille principal prenne en charge le gas pour les transactions des adresses secondaires.

​
Transactions Sans Gas

Lorsque le mode sans gas est activé, le portefeuille principal paie les frais de gas au nom des retraits des adresses secondaires.Pour activer :
  • Niveau portefeuille principal : Tableau de bord → Paramètres du Portefeuille Principal → Activer les Transactions Sans Gas
  • Niveau adresse : Définissez enableGaslessWithdraw: true lors de la création ou de la mise à jour d’une adresse
Transactions Sans Gas → · Paramètres d’Adresse →
Cela dépend du paramètre enableGaslessWithdraw :
  • Activé (true) : Le portefeuille principal paie le gas
  • Désactivé (false, par défaut) : L’adresse secondaire a besoin de son propre gas

​
Échanges et Ponts

Blockradar prend en charge uniquement les échanges de stablecoin à stablecoin : USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX.Les échanges de tokens natifs (ex. : USDT → TRX, USDC → ETH) ne sont pas pris en charge.
Cela signifie généralement que la paire d’échange n’est pas prise en charge, ou que le montant est trop petit ou trop grand pour la liquidité disponible.
Cette erreur signifie généralement que vous utilisez le mauvais identifiant d’actif. Vous devez utiliser l’identifiant d’actif spécifique au portefeuille, pas un identifiant d’actif général.
  • Tableau de bord : Accédez à votre portefeuille → Actifs → Copiez l’identifiant d’actif depuis là
  • API : Utilisez les identifiants d’actifs retournés par l’endpoint de 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 échanges entre réseaux via l’API, passez l’identifiant d’actif du portefeuille principal de destination comme toAssetId.Documentation des Échanges →

​
Configuration du Portefeuille

  • Réseaux EVM (Ethereum, Base, Polygon, Arbitrum, Optimism, etc.) : 1 portefeuille couvre tout
  • Tron (TRC20) : Portefeuille séparé requis
  • Solana : Portefeuille séparé requis
Non. Les adresses ne peuvent pas être supprimées en raison des limitations de la blockchain. Vous pouvez seulement 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.
N’utilisez ceci que dans des environnements sécurisés et de confiance.

​
Retraits et Transferts

Utilisez l’endpoint de retrait : POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentation des Retraits →
Causes courantes :
  • Gas insuffisant dans le portefeuille principal (si vous utilisez le mode sans gas) ou dans l’adresse secondaire
  • File de traitement — les transactions sont traitées séquentiellement en raison des nonces de la blockchain
  • Problèmes de nœud — retards temporaires
Si elle est bloquée depuis plus de 30 minutes, contactez le support avec l’identifiant de transaction.
Tous les mouvements de fonds on-chain utilisent l’endpoint de retrait. Il n’existe pas d’endpoint de “transfert” séparé.
  • Principal vers secondaire : POST /v1/wallets/{walletId}/withdraw avec l’adresse secondaire comme destination
  • Secondaire vers principal : POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw avec l’adresse du portefeuille principal comme destination
  • Secondaire vers externe : Même endpoint, adresse externe comme destination
Documentation des Retraits →
Utilisez l’endpoint de transactions avec le paramètre de requête d’adresse :
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. Actuellement disponible uniquement pour les portefeuilles principaux.Récupération d’Actifs →
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.

​
Testnet vs. Mainnet

Non, vos fonds ne sont pas perdus. Les adresses sont liées cryptographiquement. Vous pouvez récupérer les fonds en utilisant la Récupération d’Actifs.Récupération d’Actifs →
Vérifiez toujours l’indicateur d’environnement dans le tableau de bord (affiche “Testnet” ou “Live”) avant d’effectuer des transactions.
  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 portefeuille principal 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 des fonds mainnet et vice versa.
RéseauFaucet
Ethereum (Sepolia)Sepolia Faucet
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 :
  • Identifiant de portefeuille incorrect
  • Clé API incorrecte (ne correspond pas au portefeuille)
  • Utilisation d’un identifiant d’actif général au lieu d’un identifiant spécifique au portefeuille
Il s’agit généralement d’un problème temporaire. S’il persiste, contactez le support avec l’endpoint que vous appelez, la blockchain/réseau et la réponse d’erreur complète.
Votre clé API est invalide ou ne correspond pas au portefeuille. Vérifiez que :
  • La clé API est correcte (sans 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 n’existe pas ou vous utilisez le mauvais identifiant. Causes courantes : identifiant de portefeuille ou d’adresse incorrect, utilisation d’un identifiant d’actif général au lieu d’un spécifique au portefeuille, ou 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 :
  • Doit être en mode mainnet/Live (pas testnet)
  • Doit compléter 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 échanges de cNGN avec d’autres stablecoins.

​
Rampes Fiat d’Entrée/Sortie

Utilisez les Comptes Virtuels pour NGN :
  1. Générez un Compte Virtuel pour l’utilisateur
  2. L’utilisateur dépose des NGN par virement bancaire
  3. Les fonds sont automatiquement convertis en stablecoins et apparaissent on-chain
Documentation des Comptes Virtuels →
Actuellement, les Comptes Virtuels prennent en charge uniquement le NGN. Pour d’autres devises, vous devrez intégrer des fournisseurs tiers de rampes fiat.

​
Demandes de Fonctionnalités

Non. Blockradar se concentre sur les stablecoins. Bitcoin n’est pas actuellement pris en charge.
Blockradar est agnostique en matière de blockchains et de stablecoins — 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 e-mail, ou retirer depuis votre portefeuille principal vers l’adresse du lien de paiement.
Actuellement, nous ne prenons en charge 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.Blockradar est agnostique en matière de blockchains et de stablecoins — des réseaux supplémentaires peuvent être intégrés sur demande.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX. Des actifs supplémentaires peuvent être intégrés sur demande.

​
Conseils pour les Développeurs

  • Identifiant de portefeuille : Identifie votre portefeuille principal
  • Identifiant d’adresse : Identifie une adresse secondaire spécifique au sein d’un portefeuille
  • Identifiant d’actif : Identifie un actif spécifique (USDT, USDC, etc.) au sein de votre portefeuille
Utilisez toujours l’identifiant d’actif spécifique au portefeuille depuis la liste d’actifs de votre portefeuille, pas un identifiant d’actif général.
  • Utilisez toujours le mode mainnet/Live pour les transactions réelles
  • Stockez les identifiants de portefeuille et d’adresse dans votre base de données
  • Implémentez des gestionnaires de webhooks pour les mises à jour de transactions en temps réel
  • Utilisez le Localisateur de Dépôts comme sauvegarde pour les transactions manquées
  • Surveillez le solde du portefeuille principal pour le gas (tokens natifs)
  • Activez les retraits sans gas si vos utilisateurs ne doivent pas avoir besoin de tokens natifs

​
Besoin d’Aide ?

Documentation

docs.blockradar.co

Tableau de Bord

dashboard.blockradar.co

Réserver un Appel de Support

Planifier ici