Passer au contenu principal
Ce guide vous accompagne à travers tout ce dont vous avez besoin pour accepter des dépôts de stablecoin avec Blockradar, de la configuration du compte à la gestion de votre premier événement webhook. Vous pouvez intégrer et lancer en production avec un seul développeur en moins de 2 heures.
Suivez et construisez au fil de votre lecture. À la fin, vous aurez un flux de paiement en stablecoin fonctionnel.

​
Ce que vous allez construire

À la fin de ce guide, vous aurez :
  • Un compte Blockradar et un portefeuille principal sur le testnet
  • Des adresses secondaires générées et liées à vos utilisateurs
  • Un gestionnaire de webhooks recevant des événements de dépôt en temps réel
  • Un modèle pour mettre à jour les soldes des utilisateurs après un dépôt

​
Étape 1 : Créez votre compte

1

Inscrivez-vous

Visitez dashboard.blockradar.co/signup et complétez le processus d’intégration. Cela prend moins de 60 secondes.
2

Vérifiez le Mode Live

Dans le coin supérieur droit du tableau de bord, vous verrez un bouton Mode Live. Il est désactivé par défaut, ce qui signifie que chaque action s’exécute sur le testnet, un environnement sécurisé sans fonds réels. Laissez-le désactivé pendant ce guide.

​
Étape 2 : Créez un portefeuille principal

​
Qu’est-ce qu’un portefeuille principal ?

Le portefeuille principal est la base de votre infrastructure stablecoin. Considérez-le comme votre trésorerie — il contrôle toutes les adresses secondaires que vous créez pour vos utilisateurs. Chaque portefeuille principal est lié à une blockchain spécifique.

​
Créez votre premier portefeuille

1

Accédez à la page Portefeuilles

Depuis le tableau de bord, cliquez sur Créer un Portefeuille Principal.
2

Sélectionnez un réseau

Choisissez Base Sepolia (Testnet) pour suivre ce guide.
3

Nommez votre portefeuille

Donnez-lui un nom comme base-testnet et cliquez sur Créer.

​
Étape 3 : Générez des adresses pour vos utilisateurs

​
Que sont les adresses secondaires ?

Lorsqu’un utilisateur s’inscrit sur votre application et doit recevoir des stablecoins, il a besoin d’une adresse de portefeuille. Dans Blockradar, celles-ci sont appelées adresses secondaires.
Les adresses générées sur n’importe quelle chaîne compatible EVM fonctionnent sur toutes les chaînes EVM. Une adresse couvre tous vos réseaux EVM.

​
Générez une adresse via l’API

curl -X POST https://api.blockradar.co/v1/wallets/{walletId}/addresses \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Portefeuille Client",
    "disableAutoSweep": false,
    "enableGaslessWithdraw": true,
    "metadata": {
      "user_id": 1234,
      "email": "[email protected]"
    }
  }'

​
Le champ metadata

L’objet metadata est l’une des parties les plus importantes de cette requête. Tout ce que vous y attachez sera inclus dans chaque webhook que Blockradar envoie pour cette adresse. Bonne pratique : Incluez toujours un user_id dans les métadonnées pour mapper chaque dépôt directement à un utilisateur dans votre base de données.

​
Étape 4 : Configurez le balayage automatique et les transactions sans gas

​
Balayage automatique

Lorsque le balayage automatique est activé (disableAutoSweep: false), les fonds déposés sur une adresse secondaire sont automatiquement consolidés dans votre portefeuille principal.
Pour que le balayage automatique fonctionne, votre portefeuille principal doit détenir des tokens natifs pour couvrir les frais de gas.
Faucets testnet pour les tokens de gas :
RéseauTokenFaucet
Base SepoliaETHalchemy.com/faucets/base-sepolia
Ethereum SepoliaETHalchemy.com/faucets/ethereum-sepolia
BNB TestnetBNBbnbchain.org/en/testnet-faucet
Polygon TestnetMATICfaucet.polygon.technology
Tron TestnetTRXnileex.io
Solana DevnetSOLfaucet.solana.com

​
Transactions sans gas

Lorsque enableGaslessWithdraw: true, vos utilisateurs peuvent envoyer des stablecoins depuis leur adresse sans détenir de tokens natifs. Votre portefeuille principal couvre le gas en leur nom.

​
Étape 5 : Configurez les webhooks

Blockradar utilise des webhooks pour notifier votre backend lorsque des événements blockchain se produisent.

​
Enregistrez votre endpoint webhook

  1. Accédez à votre portefeuille principal dans le tableau de bord
  2. Cliquez sur Développeur → Webhook
  3. Entrez l’URL de votre endpoint backend (doit être un endpoint POST)

​
Gérez les webhooks dans votre backend

app.post("/webhook-handler", (req, res) => {
  const event = req.body;
  console.log("Webhook reçu :", event);
  res.sendStatus(200);
});

​
Événements webhook courants

ÉvénementDescription
deposit.successUn dépôt a été reçu sur une adresse secondaire
deposit.swept.successLes fonds ont été balayés vers le portefeuille principal
withdraw.successUn retrait a été envoyé avec succès
swap.successUn échange a été exécuté avec succès

​
Étape 6 : Gérez un événement de dépôt

​
Exemple de payload

{
  "event": "deposit.success",
  "data": {
    "amountPaid": "10.0",
    "currency": "USD",
    "senderAddress": "0xabc...",
    "recipientAddress": "0xdef...",
    "metadata": {
      "user_id": 1234
    }
  }
}

​
Comment le traiter

1

Identifiez l'utilisateur

Extrayez metadata.user_id du payload pour mapper le dépôt à un utilisateur dans votre base de données.
2

Lisez le montant

Utilisez data.amountPaid pour déterminer combien a été déposé.
3

Mettez à jour le solde

Créditez le solde de l’utilisateur dans votre base de données.

​
Ce que vous avez construit

Vous disposez maintenant d’un flux complet de paiement en stablecoin :
  • Un portefeuille principal sur le testnet
  • Des adresses secondaires liées aux utilisateurs via les métadonnées
  • Un balayage automatique consolidant les fonds dans votre trésorerie
  • Des transactions sans gas réduisant les frictions pour vos utilisateurs
  • Un gestionnaire de webhooks mettant à jour les soldes en temps réel

​
Où aller ensuite

Envoyer des paiements

Envoyez des stablecoins à vos utilisateurs ou partenaires de manière programmatique.

Ajouter la vérification AML

Vérifiez les adresses avant d’envoyer ou de recevoir des fonds.

Explorer les échanges

Permettez aux utilisateurs d’échanger entre stablecoins avec un seul appel API.

Lancer en production

Activez le Mode Live dans le tableau de bord et commencez à accepter de vrais fonds.