​

Enlaces de Pago: Webhook deposit.incomplete

​

Qué cambió

• deposit.incomplete: se envía por cada pago que deja un enlace de monto fijo por debajo de su monto. amountPaid es el total recibido hasta ahora, y metadata incluye remainingAmount y una lista partialPayments con una entrada por cada pago on-chain.
• deposit.success más rápido tras un pago parcial: cuando el cliente completa un enlace con pago insuficiente, deposit.success se envía en cuanto se registra el pago final. Antes podía llegar con minutos u horas de retraso.
• Sin depósitos duplicados: el pago final de un enlace completado ya no se registra una segunda vez como un depósito independiente con su propio deposit.success.
• Montos esperados acordes al token: el monto de un enlace convertido al token pagado se redondea hacia abajo a los decimales de ese token, así que el cliente siempre puede enviar el monto exacto.

​

Qué necesitas hacer

​

Pagos de Agentes: x402 y MPP

​

Qué Cambió

• Pagar: los agentes pagan solicitudes x402 y MPP (cargo EVM) en USDC en cadenas EVM. Blockradar firma la autorización EIP-3009, así que la clave privada se queda en Blockradar y la billetera que paga no necesita gas. La guía incluye adaptadores para los clientes oficiales @x402/fetch y mppx.
• Recibir: los pagos x402 y MPP a una dirección de Blockradar llegan como depósitos normales, con el webhook deposit.success habitual y la billetera que paga como senderAddress. Esto incluye los pagos x402 en Solana en USDC y los cargos MPP en Tempo mainnet en OUSD, USDC.e y USDT.
• Próximamente: pagar cargos MPP en Tempo y las sesiones de MPP.

​

Qué necesitas hacer

​

Gateway: Soporte para Solana

​

Qué Cambió

• Nueva cadena: Solana (mainnet) y Solana Devnet, como origen y como destino. Los depósitos se acreditan tras ~2-3 bloques (unos 8 segundos).
• Saldos combinados: un retiro desde una master wallet puede usar a la vez tus saldos de Gateway en EVM y en Solana, y acuñar en una cadena EVM o en Solana.
• Destinatarios en Solana: usa como address una dirección de wallet, no una cuenta de token USDC. Las cuentas de token y otras direcciones que pertenecen a un programa se rechazan con un 400. Si el destinatario todavía no tiene una cuenta de token USDC, Gateway la crea.

​

Qué necesitas hacer

​

Soporte para OpenUSD (OUSD)

​

Qué Cambió

• Nuevo activo: OUSD en mainnet, con 6 decimales en todas las redes:

  Red	Dirección del contrato / mint
  Tempo	0x20c0000000000000000000006a37DA5C996874BE
  Base	0xB2000000000000000000002fEb517dFeC7415344
  Ethereum	0x9f6F3991D525015a6F8CaF062C83b62fD3AC4436
  Solana	ousd2mJsPEckLHcSCDxyKD7NDGARZcfLbDZkKiatYHB

• Solo mainnet: OUSD no está disponible en ninguna testnet.
• Solana usa Token-2022: el mint de Solana es un token Token-2022, como PYUSD en Solana, no un token SPL clásico.

​

Lo que necesitas hacer

​

Stellar: Soporte para PYUSD

​

Qué Cambió

• Nuevo activo: PYUSD en Stellar mainnet (código de activo PYUSD, emisor GDQE7IXJ4HUHV6RQHIUPRJSEZE4DRS5WY577O2FY6YQ5LVWZ7JZTU2V5, emitido por Paxos). No está disponible en Stellar testnet.
• Opcional: nada cambia en tus billeteras hasta que habilites PYUSD. Habilitarlo agrega una trustline de PYUSD a la billetera principal y a cada dirección activada de esa billetera, con 0.5 XLM de reserva cada una, y aumenta en 0.5 XLM el costo de activación de las nuevas direcciones de esa billetera.

​

Lo que necesitas hacer

​

Stellar: Soporte para USDT

​

Qué Cambió

• Nuevo activo: USDT en Stellar mainnet (código de activo on-chain USDT0, emisor GATISXX6BZ6NC7IKQBY37CJD4SOZL3CYZJWXEDG6JVIY4WBS6KXJHN6Q). La API lo reporta con el símbolo USDT, como en todas las demás cadenas. No está disponible en Stellar testnet.
• Trustlines opcionales: las trustlines de Stellar siguen los activos habilitados en cada billetera. Las billeteras que no habilitan USDT no se ven afectadas y no se mueve XLM.
• Costo de activación: en una billetera con USDT habilitado, cada nueva dirección recibe una trustline más, por lo que la activación reserva 0.5 XLM más por dirección (2.5 XLM con USDC, EURC y USDT habilitados, en lugar de 2 XLM).
• Direcciones existentes: cuando habilitas USDT en una billetera, su billetera principal y cada dirección activada reciben automáticamente una trustline de USDT en unos 10 minutos. Cada una recibe 0.5 XLM de tu billetera principal para cubrir la reserva adicional.
• Depósitos puenteados: el USDT puenteado a Stellar se emite (mint) directamente al destinatario, por lo que el webhook deposit.success de un depósito puenteado tiene senderAddress en null.

​

Lo que necesitas hacer

• Para aceptar USDT en Stellar, habilita el activo en tu billetera. Antes, asegúrate de que tu billetera principal tenga al menos 0.5 XLM por cada dirección activada de la billetera, más 0.5 XLM para la billetera principal.
• Asegúrate de que tu manejador de webhooks acepte un senderAddress en null.

​

Retiro a Fiat: Fija el Monto del Pago con amountSide

​

Qué cambió

• amountSide en los endpoints v2 de cotización y ejecución (billetera maestra y dirección hija) y en el endpoint v2 de tasas de cambio: source (predeterminado) trata amount como el monto en stablecoin a enviar; target lo trata como el monto fiat que el destinatario debe recibir.
• Con amountSide: "target", el débito en stablecoin se deriva de la tasa cotizada y se redondea hacia arriba a la precisión decimal del activo, para que el pago nunca quede por debajo del monto fiat solicitado.
• El parámetro es opcional y su valor predeterminado es source, así que las integraciones existentes no cambian. Los endpoints v1 de retiro a fiat no admiten amountSide.

​

Qué necesitas hacer

​

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