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

# Bénéficiaires

> Enregistrez et gérez des adresses de destination de confiance pour les paiements récurrents

<Note>
  En bref<br />
  Les bénéficiaires sont des destinations de paiement enregistrées — des adresses de portefeuille nommées que vous pouvez référencer par ID plutôt que de saisir des adresses brutes à chaque envoi de fonds. Pensez-y comme à votre liste de contacts pour les paiements en crypto.
</Note>

## Prérequis

<Steps>
  <Step title="Clé API">
    Obtenez votre clé API depuis le [Tableau de bord Blockradar](https://dashboard.blockradar.co).
  </Step>

  <Step title="Portefeuille Créé">
    Vous aurez besoin d'un `walletId` pour associer des bénéficiaires à un portefeuille.
  </Step>
</Steps>

## Comment Ça Fonctionne

Les bénéficiaires vous permettent d'enregistrer une adresse de destination une fois, de lui donner un nom et de la référencer par ID dans tous les paiements futurs, éliminant les erreurs de frappe et créant une piste d'audit claire.

<CardGroup cols={2}>
  <Card title="Enregistrez une fois, utilisez plusieurs fois" icon="floppy-disk">
    Enregistrez une adresse de destination comme bénéficiaire nommé et réutilisez-la pour n'importe quel nombre de retraits.
  </Card>

  <Card title="Réduisez les erreurs humaines" icon="shield-check">
    Éliminez les erreurs de copier-coller en référençant les adresses par ID plutôt qu'en les saisissant manuellement.
  </Card>

  <Card title="Piste d'audit" icon="clock-rotate-left">
    Chaque bénéficiaire a un horodatage de création et un nom, facilitant le suivi de vos destinataires de paiement.
  </Card>

  <Card title="Liste blanche" icon="list-check">
    Utilisez les bénéficiaires comme couche de liste blanche d'adresses pour restreindre les paiements aux destinations pré-approuvées.
  </Card>
</CardGroup>

## Créer un Bénéficiaire

```bash theme={null}
POST /v1/wallets/{walletId}/beneficiaries
```

```javascript theme={null}
const beneficiary = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/beneficiaries`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      name: 'Portefeuille Trésorerie Alice',
      address: '0xabc123...',
      assetId: 'asset_usdc_base_mainnet'
    })
  }
).then(r => r.json());
```

## Gérer les Bénéficiaires

| Action        | Endpoint                                                      |
| ------------- | ------------------------------------------------------------- |
| Créer         | `POST /v1/wallets/{walletId}/beneficiaries`                   |
| Obtenir tous  | `GET /v1/wallets/{walletId}/beneficiaries`                    |
| Obtenir un    | `GET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}`    |
| Mettre à jour | `PATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}`  |
| Supprimer     | `DELETE /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}` |

## Bonnes Pratiques

* **Nommez les bénéficiaires clairement** — utilisez des noms qui identifient la personne, l'équipe ou l'objectif.
* **Révisez régulièrement** — auditez votre liste de bénéficiaires et supprimez les destinations inactives.
* **Combinez avec la liste blanche** — si vos exigences de conformité restreignent les paiements aux adresses approuvées, utilisez les bénéficiaires comme couche de liste blanche.

## Référence API

| Endpoint                                                        | Description                                     |
| --------------------------------------------------------------- | ----------------------------------------------- |
| [Créer un bénéficiaire](/en/api-reference/beneficiaries/create) | Enregistrer une nouvelle adresse de destination |
| [Obtenir tous](/en/api-reference/beneficiaries/get-all)         | Lister tous les bénéficiaires enregistrés       |
| [Obtenir un](/en/api-reference/beneficiaries/get-one)           | Obtenir un bénéficiaire par ID                  |
| [Mettre à jour](/en/api-reference/beneficiaries/update)         | Mettre à jour les détails d'un bénéficiaire     |
| [Supprimer](/en/api-reference/beneficiaries/delete)             | Supprimer un bénéficiaire                       |