En bref
Blockradar vous permet d’accepter des dépôts de stablecoins en générant des adresses blockchain dédiées pour chaque client. Les dépôts sont détectés automatiquement, déclenchent des notifications par webhook, et peuvent être consolidés (sweep) vers votre portefeuille principal — vous donnant un contrôle total sur la circulation des fonds dans votre plateforme.
Blockradar vous permet d’accepter des dépôts de stablecoins en générant des adresses blockchain dédiées pour chaque client. Les dépôts sont détectés automatiquement, déclenchent des notifications par webhook, et peuvent être consolidés (sweep) vers votre portefeuille principal — vous donnant un contrôle total sur la circulation des fonds dans votre plateforme.
Prérequis
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar. Naviguez vers Developers pour en générer une.
Portefeuille Principal
Créez un portefeuille via le tableau de bord ou l’API. Vous aurez besoin du
walletId pour toutes les opérations de dépôt.Actifs Activés
Activez les stablecoins que vous souhaitez accepter sur votre portefeuille. Votre portefeuille ne détecte que les dépôts d’actifs que vous avez explicitement ajoutés — voir Gestion des Actifs.
Comment Ça Fonctionne
Le flux de dépôt de Blockradar repose sur un principe simple : chaque client obtient sa propre adresse, et chaque dépôt est suivi automatiquement.Générer des Adresses
Créez une adresse blockchain unique pour chaque client ou session de paiement. Les dépôts vers cette adresse sont attribués automatiquement au client.
Détecter les Dépôts
Blockradar surveille toutes les adresses générées et déclenche un webhook dès qu’un dépôt arrive. Aucun polling requis.
Auto-Sweep
Les dépôts sont automatiquement consolidés vers votre portefeuille principal, gardant les adresses clients propres et votre trésorerie centralisée.
Consulter les Soldes
Interrogez les soldes au niveau du portefeuille ou de l’adresse, pour un actif unique ou tous les actifs à la fois, avec la conversion en USD incluse.
Contrôle Granulaire par Conception
La plupart des infrastructures blockchain traitent les portefeuilles comme des conteneurs plats et uniformes. Blockradar est différent. Chaque couche de la hiérarchie du portefeuille — portefeuille principal, adresse secondaire et actif individuel — est configurable indépendamment, afin que les fintechs puissent adapter l’expérience de dépôt à leurs besoins produit exacts. Cela signifie que vous pouvez :- Accepter différents stablecoins par portefeuille — activez USDC sur un portefeuille et USDT sur un autre, ou les deux sur le même portefeuille. Vous décidez de ce que chaque portefeuille surveille.
- Configurer le comportement de sweep par adresse — auto-sweep des dépôts vers le portefeuille principal par défaut, mais désactivez-le pour des adresses spécifiques où vous souhaitez que les fonds restent en place.
- Attacher des métadonnées à chaque adresse — taguez les adresses avec vos propres IDs utilisateurs, tokens de session ou références internes afin que les dépôts se mappent directement à votre système.
- Activer ou désactiver les adresses à la demande — mettez en pause une adresse sans la supprimer, puis réactivez-la au besoin.
Étape 1 : Activer les Actifs sur Votre Portefeuille
Avant de pouvoir accepter des dépôts, votre portefeuille doit savoir quels stablecoins surveiller. Récupérez les actifs disponibles avec le endpoint Get Assets, puis ajoutez ceux que vous voulez.Étape 2 : Générer une Adresse Client
Créez une adresse dédiée pour chaque client ou session de dépôt. Chaque dépôt vers cette adresse est automatiquement attribué au client.Réponse
Paramètres d’Adresse
| Paramètre | Type | Requis | Description |
|---|---|---|---|
name | string | Non | Libellé lisible pour l’adresse |
metadata | object | Non | Paires clé-valeur personnalisées mappées à votre système interne |
disableAutoSweep | boolean | Non | true pour garder les dépôts sur l’adresse au lieu de les consolider vers le portefeuille principal |
enableGaslessWithdraw | boolean | Non | Active les retraits sans gas depuis cette adresse |
address générée avec votre client. Lorsqu’il envoie des stablecoins, Blockradar détecte le dépôt et déclenche un webhook.
Étape 3 : Écouter les Dépôts
Configurez votre endpoint de webhook pour recevoir des notifications en temps réel lorsque les dépôts arrivent.Événements de Webhook
| Événement | Description |
|---|---|
deposit.success | Un dépôt a été confirmé on-chain sur une adresse client |
deposit.swept.success | Le dépôt a été auto-consolidé vers le portefeuille principal |
Payload de Webhook
Les
metadata que vous avez attachées lors de la génération de l’adresse sont incluses dans chaque webhook pour cette adresse, vous permettant de mapper les dépôts à vos utilisateurs sans requête supplémentaire.Vérifier les Soldes
Interrogez les soldes à n’importe quel niveau de la hiérarchie — portefeuille principal ou adresse individuelle, actif unique ou tous les actifs.Solde d’un Actif Unique (Portefeuille)
Soldes de Tous les Actifs (Adresse)
Endpoints de Solde
| Portée | Actif Unique | Tous les Actifs |
|---|---|---|
| Portefeuille Principal | GET /v1/wallets/{walletId}/balance?assetId={assetId} | GET /v1/wallets/{walletId}/balances |
| Adresse Secondaire | GET /v1/wallets/{walletId}/addresses/{addressId}/balance?assetId={assetId} | GET /v1/wallets/{walletId}/addresses/{addressId}/balances |
Gestion des Adresses
Lister Toutes les Adresses
Récupérez toutes les adresses d’un portefeuille, avec des analytics sur les comptes actifs vs. inactifs.Obtenir une Adresse Spécifique
Récupérez les détails complets d’une seule adresse, y compris sa configuration et ses métadonnées.Mettre à Jour une Adresse
Modifiez le nom, les métadonnées, le statut actif ou la configuration de sweep d’une adresse.Désactiver une Adresse
DéfinissezisActive sur false pour cesser de surveiller une adresse. L’adresse et son historique sont préservés — vous pouvez la réactiver à tout moment.
Auto-Sweep
Par défaut, les dépôts vers les adresses secondaires sont automatiquement consolidés vers le portefeuille principal. Cela garde les adresses clients propres et centralise les fonds pour la gestion de trésorerie ou les paiements sortants. Vous pouvez contrôler ce comportement au niveau de l’adresse :| Réglage | Comportement |
|---|---|
| Auto-sweep activé (défaut) | Les dépôts sont automatiquement déplacés vers le portefeuille principal après confirmation |
| Auto-sweep désactivé | Les dépôts restent sur l’adresse secondaire jusqu’à une consolidation manuelle ou un retrait |
Sweep Manuel
Si l’auto-sweep est désactivé, vous pouvez déclencher un sweep à la demande :Deposit Finder
Si un dépôt n’apparaît pas (ex. webhook manqué), utilisez le deposit finder pour rescanner la blockchain :Exemple de Flux Complet
Voici une implémentation complète : activer un actif, générer une adresse client et gérer le webhook de dépôt.Bonnes Pratiques
Gestion des Adresses
- Une adresse par client — générez une adresse unique pour chaque utilisateur ou session de paiement pour simplifier l’attribution
- Utilisez les métadonnées — attachez vos IDs utilisateurs internes et références afin que les payloads de webhook se mappent directement à votre système
- Désactivez, ne supprimez pas — définissez
isActive: falsesur les adresses que vous n’utilisez plus, en préservant l’historique
Sécurité
- Validez les webhooks — vérifiez que les requêtes webhook entrantes proviennent de Blockradar
- Activez le screening AML — Blockradar peut filtrer automatiquement les adresses de dépôt (voir Vérification AML)
- Surveillez les logs de webhook — utilisez
GET /v1/wallets/{walletId}/webhookspour déboguer les livraisons échouées
Opérations
- N’activez que les actifs dont vous avez besoin — une liste d’actifs focalisée réduit le bruit des webhooks et garde les requêtes de solde rapides
- Testez d’abord sur testnet — générez des adresses, simulez des dépôts et vérifiez votre handler de webhook avant de passer en mainnet
- Utilisez le deposit finder — si un client signale un dépôt que vous n’avez pas reçu, rescannez la blockchain avant de dépanner davantage
Référence API
Portefeuille
| Endpoint | Description |
|---|---|
| Get Wallet | Récupère les détails et la configuration du portefeuille |
| Get Balance | Vérifie le solde d’un actif unique sur le portefeuille principal |
| Get Balances | Vérifie les soldes de tous les actifs sur le portefeuille principal |
| Trigger Sweep | Consolide manuellement les dépôts vers le portefeuille principal |
| Deposit Finder | Rescanne la blockchain pour les dépôts manquants |
| Webhook Logs | Affiche l’historique de livraison des webhooks |
Adresses
| Endpoint | Description |
|---|---|
| Generate Address | Crée une nouvelle adresse de dépôt client |
| Get Addresses | Liste toutes les adresses d’un portefeuille |
| Get Address | Récupère les détails d’une adresse spécifique |
| Update Address | Met à jour le nom, les métadonnées ou la configuration d’une adresse |
| Get Balance | Vérifie le solde d’un actif unique sur une adresse |
| Get Balances | Vérifie les soldes de tous les actifs sur une adresse |
| Get Transactions | Affiche l’historique des dépôts pour une adresse |
Gestion des Actifs
| Endpoint | Description |
|---|---|
| Get Wallet Assets | Liste les actifs activés sur un portefeuille |
| Add Asset | Active un nouveau stablecoin pour les dépôts |
| Remove Asset | Arrête la surveillance d’un stablecoin |
| Update Asset | Met à jour la configuration au niveau de l’actif |

