​

Endpoint de Validación de Direcciones

​

Qué cambió

• GET /addresses/validate: pasa un slug de blockchain y una address, y la respuesta te indica si la dirección es válida para esa cadena. Para blockchains EVM, una dirección válida se devuelve en su forma con checksum EIP-55. El endpoint usa las mismas reglas de validación que los endpoints de retiro y es compatible con todas las blockchains de Blockradar — cadenas EVM, Tron, Solana y Stellar.
• La validación se realiza sin conexión contra el formato de dirección de la cadena — no se realiza ninguna consulta on-chain ni screening AML, por lo que las respuestas son rápidas. Se aplican los límites de tasa estándar de la API, así que valida al enviar el formulario en lugar de hacerlo en cada pulsación de tecla.
• Una dirección inválida devuelve 200 con isValid: false. Un 404 significa que el slug de blockchain es desconocido o no está disponible, y un 400 significa que la solicitud en sí está mal formada — así puedes distinguir “dirección incorrecta” de “solicitud incorrecta”.
• Endurecimiento del lookup AML: enviar un parámetro de consulta blockchain duplicado a /aml/lookup ahora devuelve un 400 en lugar de un 500.

​

Qué necesitas hacer

​

Comisiones de Red en los Payloads de Webhooks

​

Qué cambió

• networkFee: la comisión de red total pagada por tus billeteras administradas por Blockradar en el flujo de la transacción, en el token nativo de la cadena y en USD. Null en eventos donde no asumiste ninguna comisión, como deposit.success, donde el gas lo pagó el depositante.
• networkFees: un desglose por comisión. Cada entrada lleva la operación, la billetera que pagó, el monto en nativo y USD, y su propio hash de transacción para verificación en cadena. Las entradas patrocinadas por Blockradar se marcan PLATFORM o PROVIDER y se excluyen del total networkFee.

​

Qué necesitas hacer

​

Stellar: Destinatarios de Contrato Soroban y Muxed

​

Qué Cambió

• Destinatarios muxed (M...): Los retiros aceptan direcciones muxed para todos los activos. Los fondos se liquidan en la cuenta G... subyacente y no se adjunta ningún memo — el ID de enrutamiento está incorporado en la propia dirección.
• Destinatarios de contrato Soroban (C...): Los retiros de tokens (p. ej. USDC, EURC) pueden enviarse a direcciones de contrato Soroban. La transferencia se ejecuta en el Stellar Asset Contract del token vía Soroban RPC. Los destinatarios de contrato son válidos solo para activos token — enviar XLM nativo a una dirección C... devuelve un error 400.
• Transacciones Soroban en los endpoints de firma: Los endpoints /signing/transaction y /signing/broadcast aceptan transacciones Soroban (transferencias del Stellar Asset Contract o invocaciones de contratos personalizados). Simula y ensambla la transacción antes de enviarla para su firma.

​

Lo que necesitas hacer

​

Actualizaciones de Direcciones de Contrato cNGN

​

Qué Cambió

• Nuevo despliegue de cNGN: Direcciones de contrato actualizadas para cNGN en Ethereum, BNB Chain, Base, Asset Chain y Arc
• Direcciones anteriores reetiquetadas: Las direcciones existentes ahora están marcadas como “Old v2” en el panel de control
• Soporte de nueva red: cNGN ahora está disponible en la red Arc

​

Lo que necesitas hacer

• Ve a tu panel de control y agrega los nuevos activos cNGN (busca los que no tienen la etiqueta “Old”)
• Actualiza tus integraciones para usar las nuevas direcciones de contrato
• Las direcciones anteriores seguirán funcionando durante el período de transición

​

Nuevas Direcciones de Contrato

​

Tokens cNGN de Prueba

​

Cambios Importantes en la API de Cuentas Virtuales

​

Por Qué Este Cambio

​

Qué Cambió

​

Nuevos Endpoints

​

Detalles de Paginación

​

Nuevas Funcionalidades

• Etiquetas de cuentas virtuales: Agrega etiquetas personalizadas para organizar cuentas (ej., “Cliente A”, “Nómina”)
• Regeneración de cuentas: Genera nuevos números de cuenta con seguimiento de razón para auditoría
• Historial de transacciones: Consulta transacciones vinculadas a cuentas virtuales específicas

​

Guía de Migración

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();

// Manejar caso de array vacío
if (data.length === 0) {
  console.log('No se encontraron cuentas virtuales');
  return;
}

// Obtener la primera cuenta (equivalente al comportamiento anterior)
const account = data[0];
console.log(account.accountNumber);
console.log(account.bankName);

// O iterar a través de todas las cuentas
for (const account of data) {
  console.log(account.accountNumber);
}

// Información de paginación disponible en meta
console.log(`Página ${meta.currentPage} de ${meta.totalPages}`);

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

if (!response.ok) {
  console.log('Cuenta virtual no encontrada');
  return;
}

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

​

Ejemplo de Respuesta de 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"
  }
}

​

¿Necesitas Ayuda?

• Documentación: Guía de Cuentas Virtuales
• Referencia de API: Endpoints de Cuentas Virtuales
• Soporte por email: [email protected]

​

API de Cuentas Virtuales

• Nueva funcionalidad: La API de Cuentas Virtuales permite a las empresas crear y administrar cuentas bancarias virtuales vinculadas a billeteras maestras o direcciones secundarias
• Conversión de fiat a stablecoin: Los clientes pueden recibir pagos en NGN a través de transferencias bancarias tradicionales, convertidos automáticamente a stablecoins cNGN
• Soporte de financiamiento automático: Las cuentas de tipo AUTO_FUNDING automáticamente acuñan cNGN cuando se reciben pagos en fiat y se transfieren a billeteras vinculadas
• Integración de billetera maestra: Crea cuentas virtuales directamente vinculadas a billeteras maestras
• Integración de dirección secundaria: Crea cuentas virtuales vinculadas a direcciones secundarias específicas para un control granular
• Gestión de cuentas: Activa o desactiva cuentas virtuales para controlar el comportamiento de financiamiento automático

​

Lo que necesitas hacer

• Habilitar la funcionalidad: Contacta a [email protected] para habilitar las cuentas virtuales para tu negocio
• Asegurar soporte de cNGN: Asegúrate de que tu billetera maestra soporte el activo stablecoin cNGN
• Solo mainnet: Ten en cuenta que las cuentas virtuales solo están disponibles en el entorno MAINNET
• Revisar los endpoints de la API: Consulta la documentación de la API de Cuentas Virtuales para detalles de implementación

​

Endpoints de la API

​

Endpoints de Billetera Maestra

• POST /wallets//virtual-accounts – Crear una cuenta virtual para una billetera maestra
• GET /wallets//virtual-accounts – Recuperar detalles de cuenta virtual
• PATCH /wallets//virtual-accounts/ – Actualizar estado de cuenta virtual

​

Endpoints de Dirección Secundaria

• POST /wallets//addresses//virtual-accounts – Crear una cuenta virtual para una dirección secundaria
• GET /wallets//addresses//virtual-accounts – Recuperar detalles de cuenta virtual
• PATCH /wallets//addresses//virtual-accounts/ – Actualizar estado de cuenta virtual

​

Características Clave

• Moneda soportada: NGN (Naira Nigeriana) para pagos en fiat, cNGN para conversión a stablecoin
• Flujo de financiamiento automático: Acuñación y transferencia automática de cNGN cuando se reciben pagos (tipo AUTO_FUNDING)
• Activación de cuenta: Controla el comportamiento de financiamiento automático activando o desactivando cuentas
• Gestión de clientes: Crea cuentas con información del cliente (nombre, apellido, correo electrónico, teléfono)

​

Actualizaciones de Direcciones cNGN en Testnet

• Direcciones de testnet cNGN actualizadas: El equipo de cNGN ha actualizado sus direcciones de testnet en múltiples redes
• Nuevo soporte de activos: Se agregó soporte para el stablecoin cNGN actualizado en el panel de control
• Gestión de activos: Las direcciones de testnet anteriores ahora están etiquetadas como “antiguas” y se eliminarán en 30 días
• Soporte de USDT de Tron: Se agregó dirección actualizada de USDT de Tron soportada con la dirección anterior etiquetada como “antigua”

​

Lo que necesitas hacer

• Ve a tu panel de control y agrega los nuevos activos cNGN (busca los que no tienen la etiqueta “antiguo”)
• Actualiza tus integraciones para usar las nuevas direcciones de testnet
• Las direcciones de testnet antiguas se eliminarán automáticamente después de 30 días
• Nota: Estos cambios solo se aplican a entornos de testnet - las direcciones de mainnet permanecen sin cambios

​

Direcciones de Testnet Actualizadas

​

Dirección de USDT de Tron Actualizada