> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Foire aux Questions

> Réponses aux questions les plus fréquentes sur Blockradar.

## Dépôts et Webhooks

<AccordionGroup>
  <Accordion title="Mon dépôt n'apparaît pas sur le tableau de bord">
    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 →](/fr/essentials/wallets)
  </Accordion>

  <Accordion title="Les webhooks sont retardés ou incohérents">
    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`
  </Accordion>

  <Accordion title="J'ai envoyé des tokens natifs (ETH/TRX) — pourquoi n'apparaissent-ils pas ?">
    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.
  </Accordion>
</AccordionGroup>

## Auto-Sweep

<AccordionGroup>
  <Accordion title="Pourquoi mes fonds ont-ils été automatiquement transférés vers le master wallet ?">
    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
  </Accordion>

  <Accordion title="J'ai désactivé l'auto-sweep mais les fonds ont quand même été transférés">
    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`.
  </Accordion>

  <Accordion title="Puis-je définir un seuil pour l'auto-sweep ?">
    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 →](/fr/essentials/wallets)
  </Accordion>
</AccordionGroup>

## Frais de gas et coûts réseau

<AccordionGroup>
  <Accordion title="Comment fonctionnent les frais de gas ?">
    Les frais de gas sont payés directement à la blockchain en token natif :

    | Chaîne                           | Token natif |
    | -------------------------------- | ----------- |
    | Ethereum / Base / Polygon / etc. | ETH         |
    | Tron                             | TRX         |
    | Solana                           | SOL         |

    Blockradar ne facture aucun frais supplémentaire en plus des coûts réseau.
  </Accordion>

  <Accordion title="Pourquoi les frais sur Tron sont-ils plus élevés que sur les autres chaînes ?">
    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
  </Accordion>

  <Accordion title="Les frais réseau estimés étaient plus élevés que les frais réellement facturés">
    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.
  </Accordion>

  <Accordion title="Puis-je payer les frais de gas en USDT/USDC au lieu de tokens natifs ?">
    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.
  </Accordion>
</AccordionGroup>

## Transactions Gasless

<AccordionGroup>
  <Accordion title="Comment activer les retraits 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 →](/fr/essentials/withdrawals) · [Paramètres d'adresse →](/fr/essentials/addresses)
  </Accordion>

  <Accordion title="Quel portefeuille paie le gas — le master ou l'adresse enfant ?">
    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
  </Accordion>
</AccordionGroup>

## Swaps et Bridges

<AccordionGroup>
  <Accordion title="Quels swaps sont pris en charge ?">
    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.
  </Accordion>

  <Accordion title="J'obtiens l'erreur 'No swap quotes available'">
    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.
  </Accordion>

  <Accordion title="J'obtiens l'erreur 'Wallet not found or not active' lors d'un swap">
    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
  </Accordion>

  <Accordion title="Puis-je effectuer des swaps cross-chain ?">
    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 →](/fr/essentials/swap)
  </Accordion>
</AccordionGroup>

## Configuration du portefeuille

<AccordionGroup>
  <Accordion title="Puis-je créer plusieurs Master Wallets pour une même blockchain ?">
    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.
  </Accordion>

  <Accordion title="Puis-je supprimer des adresses ?">
    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.
  </Accordion>

  <Accordion title="Comment exporter les clés privé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.

    <Warning>Utilisez cette fonctionnalité uniquement dans des environnements sécurisés et de confiance.</Warning>
  </Accordion>
</AccordionGroup>

## Retraits et transferts

<AccordionGroup>
  <Accordion title="Comment retirer des fonds d'une adresse enfant vers un portefeuille externe ?">
    Utilisez l'endpoint API de retrait : `POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw`

    [Documentation des retraits →](/fr/essentials/withdrawals)
  </Accordion>

  <Accordion title="Ma transaction est bloquée sur 'pending'">
    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.
  </Accordion>

  <Accordion title="Comment déplacer des fonds entre le master wallet et les adresses enfants ?">
    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 →](/fr/essentials/withdrawals)
  </Accordion>

  <Accordion title="Comment obtenir l'historique des transactions pour une adresse enfant spécifique ?">
    Utilisez l'endpoint des transactions avec le paramètre de requête address :

    ```
        GET /v1/wallets/{walletId}/transactions?address={addressId}
    ```

    [Documentation des transactions →](/fr/api-reference/transactions/get-transactions)
  </Accordion>
</AccordionGroup>

## Récupération d'actifs

<AccordionGroup>
  <Accordion title="J'ai envoyé des fonds sur la mauvaise chaîne ou vers un actif non pris en charge">
    Utilisez la récupération d'actifs dans le tableau de bord.

    [Récupération d'actifs →](/fr/essentials/asset-recovery)
  </Accordion>
</AccordionGroup>

## Testnet vs. Mainnet

<AccordionGroup>
  <Accordion title="J'ai envoyé des fonds mainnet vers une adresse testnet — mes fonds sont-ils perdus ?">
    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 →](/fr/essentials/asset-recovery)

    <Tip>Vérifiez toujours l'indicateur d'environnement dans le tableau de bord (affiche "Test Mode" ou "Live Mode") avant d'effectuer une transaction.</Tip>
  </Accordion>

  <Accordion title="Comment passer du testnet au mainnet ?">
    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

    <Warning>Les adresses testnet ne peuvent pas recevoir de fonds mainnet et vice versa.</Warning>
  </Accordion>

  <Accordion title="Où puis-je obtenir des tokens testnet ?">
    | Chaîne             | Faucet                                                                              |
    | ------------------ | ----------------------------------------------------------------------------------- |
    | Ethereum (Sepolia) | [Sepolia Faucet](https://sepoliafaucet.com) ou [Alchemy](https://sepoliafaucet.com) |
    | BNB Chain          | [BNB Testnet Faucet](https://testnet.bnbchain.org/faucet-smart)                     |
    | Polygon (Amoy)     | [Polygon Faucet](https://faucet.polygon.technology)                                 |
    | Base               | [Alchemy Faucet](https://www.alchemy.com/faucets/base-sepolia)                      |
    | Tron (Nile)        | [Nile Testnet](https://nileex.io/join/getJoinPage)                                  |
    | Solana             | [Solana Faucet](https://faucet.solana.com)                                          |
    | Circle USDC        | [Circle Faucet](https://faucet.circle.com)                                          |
  </Accordion>
</AccordionGroup>

## Erreurs API et dépannage

<AccordionGroup>
  <Accordion title="&#x22;Wallet not found or not active&#x22;">
    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
  </Accordion>

  <Accordion title="&#x22;Internal Server Error&#x22; / erreurs 500">
    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.
  </Accordion>

  <Accordion title="401 Unauthorized">
    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
  </Accordion>

  <Accordion title="404 Not Found">
    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.
  </Accordion>
</AccordionGroup>

## Comptes virtuels et cNGN

<AccordionGroup>
  <Accordion title="Comment configurer les comptes virtuels pour les dépôts en NGN ?">
    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 →](/fr/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="Les comptes virtuels n'apparaissent pas dans mon tableau de bord">
    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.
  </Accordion>

  <Accordion title="Qu'est-ce que le cNGN ?">
    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.
  </Accordion>
</AccordionGroup>

## Rampes d'accès fiat

<AccordionGroup>
  <Accordion title="Comment les utilisateurs déposent-ils du fiat (NGN) et reçoivent-ils de la crypto ?">
    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 →](/fr/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="Prenez-vous en charge d'autres devises fiat que le NGN ?">
    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](/fr/use-cases/withdraw-fiat).
  </Accordion>
</AccordionGroup>

## Demandes de fonctionnalités

<AccordionGroup>
  <Accordion title="Prenez-vous en charge le Bitcoin (BTC) ?">
    Non. Blockradar se concentre sur les stablecoins. Le Bitcoin n'est actuellement pas pris en charge.
  </Accordion>

  <Accordion title="Allez-vous ajouter le support d'une nouvelle blockchain ou d'un nouveau token ?">
    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](mailto:info@blockradar.co) pour discuter de vos besoins.
  </Accordion>
</AccordionGroup>

## Facturation et abonnements

<AccordionGroup>
  <Accordion title="Puis-je payer mon abonnement en stablecoins ?">
    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.
  </Accordion>

  <Accordion title="Puis-je payer par carte de crédit ?">
    Actuellement, nous n'acceptons que les paiements en stablecoins pour les abonnements.
  </Accordion>
</AccordionGroup>

## Blockchains et actifs pris en charge

<AccordionGroup>
  <Accordion title="Quelles blockchains Blockradar prend-il 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.
  </Accordion>

  <Accordion title="Quels stablecoins Blockradar prend-il en charge ?">
    USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.

    Des actifs supplémentaires peuvent être intégrés sur demande.
  </Accordion>
</AccordionGroup>

## Conseils pour les développeurs

<AccordionGroup>
  <Accordion title="Quelle est la différence entre wallet ID, address ID et asset ID ?">
    * **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

    <Warning>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.</Warning>
  </Accordion>

  <Accordion title="Bonnes pratiques pour la production">
    * 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
  </Accordion>
</AccordionGroup>

## Besoin d'aide ?

<CardGroup cols={3}>
  <Card title="Documentation" icon="book" href="https://docs.blockradar.co">
    docs.blockradar.co
  </Card>

  <Card title="Tableau de bord" icon="gauge" href="https://dashboard.blockradar.co">
    dashboard.blockradar.co
  </Card>

  <Card title="Réserver un appel support" icon="calendar" href="https://calendly.com/daniel-blockradar/blockradar-tech-support">
    Planifier ici
  </Card>
</CardGroup>