​

Endpoint de Validação de Endereços

​

O que mudou

• GET /addresses/validate: passe um slug de blockchain e um address, e a resposta informa se o endereço é válido para aquela cadeia. Para blockchains EVM, um endereço válido é retornado em sua forma com checksum EIP-55. O endpoint usa as mesmas regras de validação dos endpoints de saque e suporta todas as blockchains da Blockradar — cadeias EVM, Tron, Solana e Stellar.
• A validação acontece offline contra o formato de endereço da cadeia — nenhuma consulta on-chain ou triagem AML é realizada, então as respostas são rápidas. Os limites de taxa padrão da API se aplicam, então valide no envio do formulário em vez de a cada digitação.
• Um endereço inválido retorna 200 com isValid: false. Um 404 significa que o slug da blockchain é desconhecido ou indisponível, e um 400 significa que a própria solicitação está malformada — assim você pode distinguir “endereço ruim” de “solicitação ruim”.
• Endurecimento do lookup AML: enviar um parâmetro de consulta blockchain duplicado para /aml/lookup agora retorna um 400 em vez de um 500.

​

O que você precisa fazer

​

Taxas de Rede nos Payloads de Webhooks

​

O que mudou

• networkFee: a taxa de rede total paga pelas suas carteiras gerenciadas pela Blockradar no fluxo da transação, no token nativo da cadeia e em USD. Null em eventos onde você não assumiu nenhuma taxa, como deposit.success, onde o gas foi pago pelo depositante.
• networkFees: um detalhamento por taxa. Cada entrada carrega a operação, a carteira que pagou, o valor em nativo e USD, e seu próprio hash de transação para verificação on chain. Entradas patrocinadas pela Blockradar são marcadas PLATFORM ou PROVIDER e ficam fora do total networkFee.

​

O que você precisa fazer

​

Stellar: Contrato Soroban e Destinatários Muxed

​

O que Mudou

• Destinatários muxed (M...): Os saques aceitam endereços muxed para todos os ativos. Os fundos são liquidados na conta G... subjacente, e nenhum memo é anexado — o ID de roteamento está incorporado no próprio endereço.
• Destinatários de contrato Soroban (C...): Saques de token (ex.: USDC, EURC) podem ser enviados para endereços de contrato Soroban. A transferência é executada no Stellar Asset Contract do token via Soroban RPC. Destinatários de contrato são válidos apenas para ativos token — enviar XLM nativo para um endereço C... retorna um erro 400.
• Transações Soroban nos endpoints de assinatura: Os endpoints /signing/transaction e /signing/broadcast aceitam transações Soroban (transferências de Stellar Asset Contract ou invocações de contrato personalizadas). Simule e monte a transação antes de submetê-la para assinatura.

​

O que você precisa fazer

​

Atualizações de Endereços de Contrato cNGN

​

O que Mudou

• Novo deploy de cNGN: Endereços de contrato atualizados para cNGN em Ethereum, BNB Chain, Base, Asset Chain e Arc
• Endereços anteriores rerotulados: Os endereços existentes agora estão marcados como “Old v2” no painel
• Suporte a nova rede: cNGN agora está disponível na rede Arc

​

O que você precisa fazer

• Vá ao seu painel e adicione os novos ativos cNGN (procure pelos que não têm o rótulo “Old”)
• Atualize suas integrações para usar os novos endereços de contrato
• Os endereços anteriores continuarão funcionando durante o período de transição

​

Novos Endereços de Contrato

​

Tokens cNGN de Teste

​

Mudanças Importantes na API de Contas Virtuais

​

Por Que Esta Mudança

​

O Que Mudou

​

Novos Endpoints

​

Detalhes de Paginação

​

Novos Recursos

• Rótulos de contas virtuais: Adicione rótulos personalizados para organizar contas (ex., “Cliente A”, “Folha de Pagamento”)
• Regeneração de contas: Gere novos números de conta com rastreamento de motivo para auditoria
• Histórico de transações: Consulte transações vinculadas a contas virtuais específicas

​

Guia de Migração

const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
const account = await response.json();

console.log(account.accountNumber);
console.log(account.bankName);

const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
const { data, meta } = await response.json();

// Tratar caso de array vazio
if (data.length === 0) {
  console.log('Nenhuma conta virtual encontrada');
  return;
}

// Obter a primeira conta (equivalente ao comportamento anterior)
const account = data[0];
console.log(account.accountNumber);
console.log(account.bankName);

// Ou iterar através de todas as contas
for (const account of data) {
  console.log(account.accountNumber);
}

// Informações de paginação disponíveis em meta
console.log(`Página ${meta.currentPage} de ${meta.totalPages}`);

const response = await fetch(`/wallets/${walletId}/virtual-accounts/${virtualAccountId}`);

if (!response.ok) {
  console.log('Conta virtual não encontrada');
  return;
}

const { data } = await response.json();
console.log(data.accountNumber);

​

Exemplo de Resposta da API

{
  "message": "Virtual accounts retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "accountNumber": "8012345678",
      "accountName": "Blockradar/John Doe",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "isActive": true,
      "type": "AUTO_FUNDING",
      "label": "Customer Deposits",
      "createdAt": "2026-01-22T10:30:00.000Z",
      "updatedAt": "2026-01-22T10:30:00.000Z"
    }
  ],
  "meta": {
    "itemCount": 1,
    "totalItems": 1,
    "itemsPerPage": 10,
    "totalPages": 1,
    "currentPage": 1
  }
}

{
  "message": "Virtual account retrieved successfully",
  "statusCode": 200,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "accountNumber": "8012345678",
    "accountName": "Blockradar/John Doe",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "isActive": true,
    "type": "AUTO_FUNDING",
    "label": "Customer Deposits",
    "createdAt": "2026-01-22T10:30:00.000Z",
    "updatedAt": "2026-01-22T10:30:00.000Z"
  }
}

​

Precisa de Ajuda?

• Documentação: Guia de Contas Virtuais
• Referência da API: Endpoints de Contas Virtuais
• Suporte por email: [email protected]

​

API de Contas Virtuais

• Novo recurso: A API de Contas Virtuais permite que empresas criem e gerenciem contas bancárias virtuais vinculadas a carteiras principais ou endereços filhos
• Conversão fiat para stablecoin: Os clientes podem receber pagamentos em NGN por meio de transferências bancárias tradicionais, convertidos automaticamente em stablecoins cNGN
• Suporte a financiamento automático: Contas do tipo AUTO_FUNDING criam automaticamente cNGN quando pagamentos em fiat são recebidos e transferem para carteiras vinculadas
• Integração com carteira principal: Crie contas virtuais diretamente vinculadas a carteiras principais
• Integração com endereço filho: Crie contas virtuais vinculadas a endereços filhos específicos para controle granular
• Gerenciamento de contas: Ative ou desative contas virtuais para controlar o comportamento de financiamento automático

​

O que você precisa fazer

• Ative o recurso: Entre em contato com [email protected] para habilitar contas virtuais para sua empresa
• Certifique-se do suporte a cNGN: Verifique se sua carteira principal suporta o ativo stablecoin cNGN
• Somente mainnet: Observe que as contas virtuais estão disponíveis apenas no ambiente MAINNET
• Revise os endpoints da API: Consulte a documentação da API de Contas Virtuais para detalhes de implementação

​

Endpoints da API

​

Endpoints de Carteira Principal

• POST /wallets//virtual-accounts – Criar uma conta virtual para uma carteira principal
• GET /wallets//virtual-accounts – Recuperar detalhes da conta virtual
• PATCH /wallets//virtual-accounts/ – Atualizar status da conta virtual

​

Endpoints de Endereço Filho

• POST /wallets//addresses//virtual-accounts – Criar uma conta virtual para um endereço filho
• GET /wallets//addresses//virtual-accounts – Recuperar detalhes da conta virtual
• PATCH /wallets//addresses//virtual-accounts/ – Atualizar status da conta virtual

​

Recursos Principais

• Moeda suportada: NGN (Naira Nigeriana) para pagamentos em fiat, cNGN para conversão de stablecoin
• Fluxo de financiamento automático: Criação e transferência automática de cNGN quando pagamentos são recebidos (tipo AUTO_FUNDING)
• Ativação de conta: Controle o comportamento de financiamento automático ativando ou desativando contas
• Gerenciamento de clientes: Crie contas com informações do cliente (nome, sobrenome, email, telefone)

​

Atualizações de Endereço cNGN na Testnet

• Endereços testnet cNGN atualizados: A equipe do cNGN atualizou seus endereços testnet em várias redes
• Novo suporte a ativos: Adicionado suporte ao stablecoin cNGN atualizado no painel
• Gerenciamento de ativos: Os endereços testnet anteriores agora estão rotulados como “antigos” e serão removidos em 30 dias
• Suporte a USDT Tron: Adicionado endereço USDT Tron suportado atualizado com endereço anterior rotulado como “antigo”

​

O que você precisa fazer

• Vá ao seu painel e adicione os novos ativos cNGN (procure pelos que não têm o rótulo “antigo”)
• Atualize suas integrações para usar os novos endereços testnet
• Os endereços testnet antigos serão removidos automaticamente após 30 dias
• Observação: Essas mudanças se aplicam apenas aos ambientes testnet - os endereços mainnet permanecem inalterados

​

Endereços Testnet Atualizados

​

Endereço USDT Tron Atualizado