> ## 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.

# De 0 à l'Intégration

> Passez de zéro à une intégration stablecoin en production en moins de 2 heures.

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.

<Info>
  Suivez et construisez au fil de votre lecture. À la fin, vous aurez un flux de paiement en stablecoin fonctionnel.
</Info>

## 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

<Steps>
  <Step title="Inscrivez-vous">
    Visitez [dashboard.blockradar.co/signup](https://dashboard.blockradar.co/signup) et complétez le processus d'intégration. Cela prend moins de 60 secondes.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## É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

<Steps>
  <Step title="Accédez à la page Portefeuilles">
    Depuis le tableau de bord, cliquez sur **Créer un Portefeuille Principal**.
  </Step>

  <Step title="Sélectionnez un réseau">
    Choisissez **Base Sepolia (Testnet)** pour suivre ce guide.
  </Step>

  <Step title="Nommez votre portefeuille">
    Donnez-lui un nom comme `base-testnet` et cliquez sur **Créer**.
  </Step>
</Steps>

***

## É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**.

<Note>
  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.
</Note>

### Générez une adresse via l'API

```bash theme={null}
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": "utilisateur@exemple.com"
    }
  }'
```

### 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.

<Warning>
  Pour que le balayage automatique fonctionne, votre portefeuille principal doit détenir des tokens natifs pour couvrir les frais de gas.
</Warning>

**Faucets testnet pour les tokens de gas :**

| Réseau           | Token | Faucet                                                                                   |
| ---------------- | ----- | ---------------------------------------------------------------------------------------- |
| Base Sepolia     | ETH   | [alchemy.com/faucets/base-sepolia](https://www.alchemy.com/faucets/base-sepolia)         |
| Ethereum Sepolia | ETH   | [alchemy.com/faucets/ethereum-sepolia](https://www.alchemy.com/faucets/ethereum-sepolia) |
| BNB Testnet      | BNB   | [bnbchain.org/en/testnet-faucet](https://www.bnbchain.org/en/testnet-faucet)             |
| Polygon Testnet  | MATIC | [faucet.polygon.technology](https://faucet.polygon.technology/)                          |
| Tron Testnet     | TRX   | [nileex.io](https://nileex.io/join/getJoinPage)                                          |
| Solana Devnet    | SOL   | [faucet.solana.com](https://faucet.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

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

### Événements webhook courants

| Événement               | Description                                              |
| ----------------------- | -------------------------------------------------------- |
| `deposit.success`       | Un dépôt a été reçu sur une adresse secondaire           |
| `deposit.swept.success` | Les fonds ont été balayés vers le portefeuille principal |
| `withdraw.success`      | Un retrait a été envoyé avec succès                      |
| `swap.success`          | Un échange a été exécuté avec succès                     |

***

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

### Exemple de payload

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

### Comment le traiter

<Steps>
  <Step title="Identifiez l'utilisateur">
    Extrayez `metadata.user_id` du payload pour mapper le dépôt à un utilisateur dans votre base de données.
  </Step>

  <Step title="Lisez le montant">
    Utilisez `data.amountPaid` pour déterminer combien a été déposé.
  </Step>

  <Step title="Mettez à jour le solde">
    Créditez le solde de l'utilisateur dans votre base de données.
  </Step>
</Steps>

***

## 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

<CardGroup cols={2}>
  <Card title="Envoyer des paiements" icon="arrow-up-from-bracket" href="/fr/use-cases/pay-outs">
    Envoyez des stablecoins à vos utilisateurs ou partenaires de manière programmatique.
  </Card>

  <Card title="Ajouter la vérification AML" icon="shield-halved" href="/fr/use-cases/aml-screening">
    Vérifiez les adresses avant d'envoyer ou de recevoir des fonds.
  </Card>

  <Card title="Explorer les échanges" icon="arrows-rotate" href="/fr/use-cases/swap">
    Permettez aux utilisateurs d'échanger entre stablecoins avec un seul appel API.
  </Card>

  <Card title="Lancer en production" icon="rocket" href="https://dashboard.blockradar.co">
    Activez le Mode Live dans le tableau de bord et commencez à accepter de vrais fonds.
  </Card>
</CardGroup>