​

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