Saltar para o conteúdo principal
Em resumo
Beneficiários são destinos de pagamento salvos — endereços de carteira com nome que você pode referenciar por ID em vez de passar endereços brutos toda vez que envia fundos. Pense neles como sua lista de contatos para pagamentos em cripto.

​
Pré-requisitos

1

Chave de API

Obtenha sua chave de API no Dashboard do Blockradar.
2

Carteira Criada

Você precisará de um walletId para associar beneficiários a uma carteira.

​
Como Funciona

Beneficiários permitem registrar um endereço de destino uma vez, dar-lhe um nome e referenciá-lo por ID em todos os pagamentos futuros, eliminando erros de digitação e criando um registro de auditoria claro.

Salve uma vez, use muitas vezes

Registre um endereço de destino como beneficiário nomeado e reutilize-o em qualquer número de saques.

Reduza erros humanos

Elimine erros de copiar e colar referenciando endereços por ID em vez de digitá-los manualmente.

Registro de auditoria

Cada beneficiário tem um timestamp de criação e nome, facilitando o rastreamento de para quem você paga.

Lista branca

Use beneficiários como parte de uma estratégia de lista branca de endereços para restringir pagamentos a destinos pré-aprovados.

​
Criando um Beneficiário

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

​
Gerenciando Beneficiários

AçãoEndpoint
CriarPOST /v1/wallets/{walletId}/beneficiaries
Obter todosGET /v1/wallets/{walletId}/beneficiaries
Obter umGET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
AtualizarPATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
ExcluirDELETE /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}

​
Melhores Práticas

  • Nomeie os beneficiários claramente — use nomes que identifiquem a pessoa, equipe ou propósito.
  • Revise periodicamente — audite sua lista de beneficiários e remova destinos que não estão mais ativos.
  • Combine com lista branca — se seus requisitos de conformidade restringem pagamentos a endereços aprovados, use beneficiários como sua camada de lista branca.

​
Referência de API

EndpointDescrição
Criar BeneficiárioSalvar um novo endereço de destino
Obter TodosListar todos os beneficiários salvos
Obter UmObter um beneficiário por ID
AtualizarAtualizar detalhes de um beneficiário
ExcluirRemover um beneficiário