Em resumo
A Blockradar permite que você aceite depósitos de stablecoins gerando endereços blockchain dedicados para cada cliente. Os depósitos são detectados automaticamente, disparam notificações por webhook e podem ser varridos para sua carteira principal — dando a você controle total sobre como os fundos fluem pela sua plataforma.
A Blockradar permite que você aceite depósitos de stablecoins gerando endereços blockchain dedicados para cada cliente. Os depósitos são detectados automaticamente, disparam notificações por webhook e podem ser varridos para sua carteira principal — dando a você controle total sobre como os fundos fluem pela sua plataforma.
Pré-requisitos
Chave API
Obtenha sua chave API no Painel da Blockradar. Navegue até Developers para gerar uma.
Carteira Principal
Crie uma carteira através do painel ou API. Você precisará do
walletId para todas as operações de depósito.Ativos Habilitados
Habilite as stablecoins que deseja aceitar na sua carteira. Sua carteira só detecta depósitos de ativos que você adicionou explicitamente — consulte Gestão de Ativos.
Como Funciona
O fluxo de depósitos da Blockradar é construído em torno de um princípio simples: cada cliente recebe seu próprio endereço, e cada depósito é rastreado automaticamente.Gerar Endereços
Crie um endereço blockchain único para cada cliente ou sessão de pagamento. Depósitos nesse endereço são atribuídos ao cliente automaticamente.
Detectar Depósitos
A Blockradar monitora todos os endereços gerados e dispara um webhook no momento em que um depósito chega — sem necessidade de polling.
Varredura Automática
Os depósitos são consolidados automaticamente na sua carteira principal, mantendo os endereços dos clientes limpos e sua tesouraria centralizada.
Consultar Saldos
Consulte saldos no nível da carteira ou endereço, para um único ativo ou todos os ativos de uma vez, com conversão para USD incluída.
Controle Granular por Design
A maioria da infraestrutura blockchain trata carteiras como contêineres planos e uniformes. A Blockradar é diferente. Cada camada da hierarquia de carteiras — carteira principal, endereço filho e ativo individual — é configurável de forma independente, para que as fintechs possam adaptar a experiência de depósito às necessidades exatas do seu produto. Isso significa que você pode:- Aceitar diferentes stablecoins por carteira — habilite USDC em uma carteira e USDT em outra, ou ambas na mesma carteira. Você decide o que cada carteira monitora.
- Configurar o comportamento de varredura por endereço — varra automaticamente os depósitos para a carteira principal por padrão, mas desative para endereços específicos onde você quer que os fundos permaneçam.
- Anexar metadados a cada endereço — marque endereços com seus próprios IDs de usuário, tokens de sessão ou referências internas para que os depósitos se mapeiem diretamente ao seu sistema.
- Ativar ou desativar endereços sob demanda — pause um endereço sem excluí-lo, e reative quando necessário.
Passo 1: Habilitar Ativos na Sua Carteira
Antes de poder aceitar depósitos, sua carteira precisa saber quais stablecoins monitorar. Obtenha os ativos disponíveis com o endpoint Get Assets e depois adicione os que desejar.Passo 2: Gerar um Endereço de Cliente
Crie um endereço dedicado para cada cliente ou sessão de depósito. Cada depósito neste endereço é automaticamente atribuído ao cliente.Resposta
Parâmetros de Endereço
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Rótulo legível para o endereço |
metadata | object | Não | Pares chave-valor personalizados mapeados ao seu sistema interno |
disableAutoSweep | boolean | Não | Defina true para manter os depósitos no endereço em vez de varrê-los para a carteira principal |
enableGaslessWithdraw | boolean | Não | Habilita saques sem gas deste endereço |
address gerado com seu cliente. Quando eles enviarem stablecoins para ele, a Blockradar detecta o depósito e dispara um webhook.
Passo 3: Escutar Depósitos
Configure seu endpoint de webhook para receber notificações em tempo real quando depósitos chegarem.Eventos de Webhook
| Evento | Descrição |
|---|---|
deposit.success | Um depósito foi confirmado on-chain em um endereço de cliente |
deposit.swept.success | O depósito foi varrido automaticamente para a carteira principal |
Payload do Webhook
Os
metadata que você anexou ao gerar o endereço são incluídos em cada webhook para esse endereço, para que você possa mapear depósitos de volta aos seus usuários sem uma consulta adicional.Consultar Saldos
Consulte saldos em qualquer nível da hierarquia — carteira principal ou endereço individual, um único ativo ou todos os ativos.Saldo de Um Único Ativo (Carteira)
Todos os Saldos de Ativos (Endereço)
Endpoints de Saldo
| Escopo | Único Ativo | Todos os Ativos |
|---|---|---|
| Carteira Principal | GET /v1/wallets/{walletId}/balance?assetId={assetId} | GET /v1/wallets/{walletId}/balances |
| Endereço Filho | GET /v1/wallets/{walletId}/addresses/{addressId}/balance?assetId={assetId} | GET /v1/wallets/{walletId}/addresses/{addressId}/balances |
Gestão de Endereços
Listar Todos os Endereços
Obtenha todos os endereços de uma carteira, com analíticos de contagem de ativos vs. inativos.Obter um Endereço Específico
Recupere todos os detalhes de um endereço, incluindo sua configuração e metadados.Atualizar um Endereço
Modifique o nome, metadados, status ativo ou configuração de varredura de um endereço.Desativar um Endereço
DefinaisActive como false para parar de monitorar um endereço. O endereço e seu histórico são preservados — você pode reativá-lo a qualquer momento.
Varredura Automática
Por padrão, depósitos em endereços filhos são automaticamente varridos para a carteira principal. Isso mantém os endereços dos clientes limpos e consolida fundos para gestão de tesouraria ou pagamentos. Você pode controlar isso no nível do endereço:| Configuração | Comportamento |
|---|---|
| Varredura automática habilitada (padrão) | Depósitos são automaticamente movidos para a carteira principal após confirmação |
| Varredura automática desabilitada | Depósitos permanecem no endereço filho até serem varridos manualmente ou sacados |
Varredura Manual
Se a varredura automática estiver desabilitada, você pode acionar uma varredura sob demanda:Buscador de Depósitos
Se um depósito não aparecer (ex.: webhook perdido), use o buscador de depósitos para re-escanear a blockchain:Exemplo de Fluxo Completo
Aqui está uma implementação completa: habilitar um ativo, gerar um endereço de cliente e lidar com o webhook de depósito.Melhores Práticas
Gestão de Endereços
- Um endereço por cliente — gere um endereço único para cada usuário ou sessão de pagamento para simplificar a atribuição
- Use metadados — anexe seus IDs de usuário internos e referências para que os payloads de webhook se mapeiem diretamente ao seu sistema
- Desative, não exclua — defina
isActive: falseem endereços que você não precisa mais, preservando o histórico
Segurança
- Valide webhooks — verifique que as solicitações de webhook recebidas originam-se da Blockradar
- Habilite verificação AML — a Blockradar pode verificar endereços de depósito automaticamente (consulte Verificação AML)
- Monitore os logs de webhook — use
GET /v1/wallets/{walletId}/webhookspara depurar entregas falhas
Operações
- Habilite apenas os ativos que precisa — uma lista de ativos focada reduz o ruído de webhooks e mantém as consultas de saldo rápidas
- Teste primeiro na testnet — gere endereços, simule depósitos e verifique seu handler de webhook antes de ir para a mainnet
- Use o buscador de depósitos — se um cliente reportar um depósito que você não recebeu, re-escaneie a blockchain antes de investigar mais
Referência API
Carteira
| Endpoint | Descrição |
|---|---|
| Get Wallet | Obter detalhes e configuração da carteira |
| Get Balance | Consultar saldo de um ativo na carteira principal |
| Get Balances | Consultar todos os saldos da carteira principal |
| Trigger Sweep | Varrer depósitos manualmente para a carteira principal |
| Deposit Finder | Re-escanear blockchain para depósitos ausentes |
| Webhook Logs | Ver histórico de entrega de webhooks |
Endereços
| Endpoint | Descrição |
|---|---|
| Generate Address | Criar um novo endereço de depósito de cliente |
| Get Addresses | Listar todos os endereços de uma carteira |
| Get Address | Obter detalhes de um endereço específico |
| Update Address | Atualizar nome, metadados ou configuração de endereço |
| Get Balance | Consultar saldo de um ativo em um endereço |
| Get Balances | Consultar todos os saldos de um endereço |
| Get Transactions | Ver histórico de depósitos de um endereço |
Gestão de Ativos
| Endpoint | Descrição |
|---|---|
| Get Wallet Assets | Listar ativos habilitados em uma carteira |
| Add Asset | Habilitar uma nova stablecoin para depósitos |
| Remove Asset | Parar de monitorar uma stablecoin |
| Update Asset | Atualizar configuração no nível do ativo |

