​

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