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

# Beneficiarios

> Guarda y gestiona direcciones de destino de confianza para pagos recurrentes

<Note>
  En resumen<br />
  Los beneficiarios son destinos de pago guardados — direcciones de billetera con nombre que puedes referenciar por ID en lugar de pasar direcciones sin procesar cada vez que envías fondos. Piensa en ellos como tu lista de contactos para pagos en cripto.
</Note>

## Requisitos Previos

<Steps>
  <Step title="Clave API">
    Obtén tu clave API desde el [Dashboard de Blockradar](https://dashboard.blockradar.co).
  </Step>

  <Step title="Billetera Creada">
    Necesitarás un `walletId` para asociar beneficiarios con una billetera.
  </Step>
</Steps>

## Cómo Funciona

Los beneficiarios te permiten registrar una dirección de destino una vez, darle un nombre y referenciarla por ID en todos los pagos futuros, eliminando errores de escritura y creando un registro de auditoría claro.

<CardGroup cols={2}>
  <Card title="Guarda una vez, usa muchas veces" icon="floppy-disk">
    Registra una dirección de destino como beneficiario con nombre y reutilízala en cualquier número de retiros.
  </Card>

  <Card title="Reduce errores humanos" icon="shield-check">
    Elimina errores de copiar y pegar referenciando direcciones por ID en lugar de ingresarlas manualmente.
  </Card>

  <Card title="Registro de auditoría" icon="clock-rotate-left">
    Cada beneficiario tiene una marca de tiempo de creación y nombre, facilitando el seguimiento de a quién pagas.
  </Card>

  <Card title="Lista blanca" icon="list-check">
    Usa beneficiarios como parte de una estrategia de lista blanca de direcciones para restringir pagos a destinos preaprobados.
  </Card>
</CardGroup>

## Crear un Beneficiario

```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: 'Billetera Tesoro Alice',
      address: '0xabc123...',
      assetId: 'asset_usdc_base_mainnet'
    })
  }
).then(r => r.json());
```

## Gestionar Beneficiarios

| Acción        | Endpoint                                                      |
| ------------- | ------------------------------------------------------------- |
| Crear         | `POST /v1/wallets/{walletId}/beneficiaries`                   |
| Obtener todos | `GET /v1/wallets/{walletId}/beneficiaries`                    |
| Obtener uno   | `GET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}`    |
| Actualizar    | `PATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}`  |
| Eliminar      | `DELETE /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}` |

## Mejores Prácticas

* **Nombra los beneficiarios claramente** — usa nombres que identifiquen a la persona, equipo o propósito.
* **Revisa periódicamente** — audita tu lista de beneficiarios y elimina los destinos que ya no estén activos.
* **Combina con lista blanca** — si tus requisitos de cumplimiento restringen pagos a direcciones aprobadas, usa beneficiarios como tu capa de lista blanca.

## Referencia de API

| Endpoint                                                     | Descripción                                |
| ------------------------------------------------------------ | ------------------------------------------ |
| [Crear Beneficiario](/en/api-reference/beneficiaries/create) | Guardar una nueva dirección de destino     |
| [Obtener Todos](/en/api-reference/beneficiaries/get-all)     | Listar todos los beneficiarios guardados   |
| [Obtener Uno](/en/api-reference/beneficiaries/get-one)       | Obtener un beneficiario por ID             |
| [Actualizar](/en/api-reference/beneficiaries/update)         | Actualizar los detalles de un beneficiario |
| [Eliminar](/en/api-reference/beneficiaries/delete)           | Eliminar un beneficiario                   |