​

Links de Pagamento: Webhook deposit.incomplete

​

O que mudou

• deposit.incomplete: enviado para cada pagamento que deixa um link de valor fixo abaixo do valor. amountPaid é o total recebido até agora, e metadata traz remainingAmount e uma lista partialPayments com uma entrada por pagamento on-chain.
• deposit.success mais rápido após um pagamento parcial: quando o cliente completa um link pago a menor, o deposit.success é enviado assim que o pagamento final é registrado. Antes ele podia chegar com minutos ou horas de atraso.
• Sem depósitos duplicados: o pagamento final de um link concluído não é mais registrado uma segunda vez como um depósito separado com seu próprio deposit.success.
• Valores esperados compatíveis com o token: o valor de um link convertido para o token pago é arredondado para baixo nas casas decimais desse token, então o cliente sempre consegue enviar o valor exato.

​

O que você precisa fazer

​

Pagamentos de Agentes: x402 e MPP

​

O que Mudou

• Pagar: agentes pagam requisições x402 e MPP (charge EVM) em USDC em cadeias EVM. A Blockradar assina a autorização EIP-3009, então a chave privada fica na Blockradar e a carteira pagadora não precisa de gas. O guia inclui adaptadores para os clientes oficiais @x402/fetch e mppx.
• Receber: pagamentos x402 e MPP para um endereço Blockradar chegam como depósitos comuns, com o webhook deposit.success de sempre e a carteira pagadora como senderAddress. Isso inclui pagamentos x402 na Solana em USDC e charges MPP na Tempo mainnet em OUSD, USDC.e e USDT.
• Em breve: pagar charges MPP na Tempo e sessões MPP.

​

O que você precisa fazer

​

Gateway: Suporte a Solana

​

O que Mudou

• Nova cadeia: Solana (mainnet) e Solana Devnet, como origem e como destino. Os depósitos são creditados após ~2-3 blocos (cerca de 8 segundos).
• Saldos combinados: um saque a partir de uma master wallet pode usar ao mesmo tempo seus saldos de Gateway em EVM e em Solana, e emitir em uma cadeia EVM ou em Solana.
• Destinatários na Solana: use como address um endereço de wallet, não uma conta de token USDC. Contas de token e outros endereços pertencentes a um programa são rejeitados com um 400. Se o destinatário ainda não tiver uma conta de token USDC, o Gateway a cria.

​

O que você precisa fazer

​

Suporte a OpenUSD (OUSD)

​

O que Mudou

• Novo ativo: OUSD na mainnet, com 6 casas decimais em todas as redes:

  Rede	Endereço do contrato / mint
  Tempo	0x20c0000000000000000000006a37DA5C996874BE
  Base	0xB2000000000000000000002fEb517dFeC7415344
  Ethereum	0x9f6F3991D525015a6F8CaF062C83b62fD3AC4436
  Solana	ousd2mJsPEckLHcSCDxyKD7NDGARZcfLbDZkKiatYHB

• Somente mainnet: o OUSD não está disponível em nenhuma testnet.
• A Solana usa Token-2022: o mint na Solana é um token Token-2022, como o PYUSD na Solana, e não um token SPL clássico.

​

O que você precisa fazer

​

Stellar: Suporte a PYUSD

​

O que Mudou

• Novo ativo: PYUSD na Stellar mainnet (código de ativo PYUSD, emissor GDQE7IXJ4HUHV6RQHIUPRJSEZE4DRS5WY577O2FY6YQ5LVWZ7JZTU2V5, emitido pela Paxos). Não está disponível na Stellar testnet.
• Opcional: nada muda nas suas carteiras até que você habilite o PYUSD. Habilitá-lo adiciona uma trustline de PYUSD à carteira mestra e a cada endereço ativado dessa carteira, com 0,5 XLM de reserva cada, e aumenta em 0,5 XLM o custo de ativação dos novos endereços dessa carteira.

​

O que você precisa fazer

​

Stellar: Suporte a USDT

​

O que Mudou

• Novo ativo: USDT na Stellar mainnet (código de ativo on-chain USDT0, emissor GATISXX6BZ6NC7IKQBY37CJD4SOZL3CYZJWXEDG6JVIY4WBS6KXJHN6Q). A API o reporta com o símbolo USDT, como em todas as outras redes. Não está disponível na Stellar testnet.
• Trustlines opcionais: as trustlines da Stellar seguem os ativos habilitados em cada carteira. Carteiras que não habilitam o USDT não são afetadas e nenhum XLM é movimentado.
• Custo de ativação: em uma carteira com USDT habilitado, cada novo endereço recebe uma trustline a mais, então a ativação reserva 0,5 XLM a mais por endereço (2,5 XLM com USDC, EURC e USDT habilitados, em vez de 2 XLM).
• Endereços existentes: quando você habilita o USDT em uma carteira, a carteira mestra e cada endereço ativado dela recebem automaticamente uma trustline de USDT em cerca de 10 minutos. Cada um recebe 0,5 XLM da sua carteira mestra para cobrir a reserva adicional.
• Depósitos via ponte: o USDT transferido para a Stellar via ponte é emitido (mint) diretamente para o destinatário, então o webhook deposit.success de um depósito via ponte tem senderAddress null.

​

O que você precisa fazer

• Para aceitar USDT no Stellar, habilite o ativo na sua carteira. Antes, garanta que a sua carteira mestra tenha pelo menos 0,5 XLM para cada endereço ativado da carteira, mais 0,5 XLM para a carteira mestra.
• Garanta que o seu handler de webhooks aceite um senderAddress null.

​

Saque em Fiat: Fixe o Valor do Pagamento com amountSide

​

O que mudou

• amountSide nos endpoints v2 de cotação e execução (carteira master e endereço filho) e no endpoint v2 de taxas de câmbio: source (padrão) trata amount como o valor em stablecoin a enviar; target o trata como o valor fiat que o destinatário deve receber.
• Com amountSide: "target", o débito em stablecoin é derivado da taxa cotada e arredondado para cima até a precisão decimal do ativo, para que o pagamento nunca fique abaixo do valor fiat solicitado.
• O parâmetro é opcional e o padrão é source, então as integrações existentes não mudam. Os endpoints v1 de saque em fiat não suportam amountSide.

​

O que você precisa fazer

​

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