Passer au contenu principal
En bref
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.

​
Prérequis

1

Clé API

Obtenez votre clé API depuis le Tableau de bord Blockradar.
2

Portefeuille Créé

Vous aurez besoin d’un walletId pour associer des bénéficiaires à un portefeuille.

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

Enregistrez une fois, utilisez plusieurs fois

Enregistrez une adresse de destination comme bénéficiaire nommé et réutilisez-la pour n’importe quel nombre de retraits.

Réduisez les erreurs humaines

Éliminez les erreurs de copier-coller en référençant les adresses par ID plutôt qu’en les saisissant manuellement.

Piste d'audit

Chaque bénéficiaire a un horodatage de création et un nom, facilitant le suivi de vos destinataires de paiement.

Liste blanche

Utilisez les bénéficiaires comme couche de liste blanche d’adresses pour restreindre les paiements aux destinations pré-approuvées.

​
Créer un Bénéficiaire

POST /v1/wallets/{walletId}/beneficiaries

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

ActionEndpoint
CréerPOST /v1/wallets/{walletId}/beneficiaries
Obtenir tousGET /v1/wallets/{walletId}/beneficiaries
Obtenir unGET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
Mettre à jourPATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
SupprimerDELETE /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

EndpointDescription
Créer un bénéficiaireEnregistrer une nouvelle adresse de destination
Obtenir tousLister tous les bénéficiaires enregistrés
Obtenir unObtenir un bénéficiaire par ID
Mettre à jourMettre à jour les détails d’un bénéficiaire
SupprimerSupprimer un bénéficiaire