Saltar al contenido principal
En resumen
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.

​
Requisitos Previos

1

Clave API

Obtén tu clave API desde el Dashboard de Blockradar.
2

Billetera Creada

Necesitarás un walletId para asociar beneficiarios con una billetera.

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

Guarda una vez, usa muchas veces

Registra una dirección de destino como beneficiario con nombre y reutilízala en cualquier número de retiros.

Reduce errores humanos

Elimina errores de copiar y pegar referenciando direcciones por ID en lugar de ingresarlas manualmente.

Registro de auditoría

Cada beneficiario tiene una marca de tiempo de creación y nombre, facilitando el seguimiento de a quién pagas.

Lista blanca

Usa beneficiarios como parte de una estrategia de lista blanca de direcciones para restringir pagos a destinos preaprobados.

​
Crear un Beneficiario

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

​
Gestionar Beneficiarios

AcciónEndpoint
CrearPOST /v1/wallets/{walletId}/beneficiaries
Obtener todosGET /v1/wallets/{walletId}/beneficiaries
Obtener unoGET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
ActualizarPATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
EliminarDELETE /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

EndpointDescripción
Crear BeneficiarioGuardar una nueva dirección de destino
Obtener TodosListar todos los beneficiarios guardados
Obtener UnoObtener un beneficiario por ID
ActualizarActualizar los detalles de un beneficiario
EliminarEliminar un beneficiario