Skip to main content

​
Depósitos y Webhooks

Esto suele ser un retraso temporal en la indexación. Usa el Buscador de Depósitos para activar la indexación manualmente:
  • Panel de control: Ve a tu Master Wallet → Resumen → Haz clic en “Deposit Finder”
  • API: POST /v1/wallets/{walletId}/rescan/blocks con el transactionHash
Documentación del Buscador de Depósitos →
Los retrasos en webhooks pueden ocurrir por congestión en la red blockchain, retrasos temporales en la indexación de nodos o porque tu endpoint de webhook está devolviendo errores.Para revisar los registros de webhooks:
  • Panel de control: Master Wallet → Developers → Webhook Logs
  • API: GET /v1/wallets/{walletId}/webhooks
Para que un webhook se entregue de nuevo, usa Resend Webhook.
Blockradar solo indexa stablecoins por diseño. Los depósitos de tokens nativos (ETH, TRX, SOL, etc.) no aparecerán en el historial de transacciones del panel de control. Sin embargo, los fondos siguen en tu wallet y pueden verse en el explorador de blockchain o retirarse vía API o panel de control.

​
Auto-Sweep

Por defecto, disableAutoSweep está configurado en false, lo que significa que el auto-sweep está habilitado. Cuando un depósito llega a una dirección secundaria, se transfiere automáticamente a tu master wallet.Para mantener los fondos en las direcciones secundarias:
  • Configura disableAutoSweep: true al crear la dirección vía API
  • O activa Disable Auto Sweep en la configuración de la dirección en el panel de control
Verifica ambos niveles de configuración:
  • Nivel de master wallet — establece el valor por defecto para todas las direcciones
  • Nivel de dirección — anula la configuración de la master wallet
La configuración a nivel de dirección siempre tiene prioridad. Verifica que la dirección específica tenga disableAutoSweep: true.
Sí. Puedes configurar umbrales de barrido para que los fondos solo se transfieran automáticamente una vez que se alcance un cierto saldo.Configuración de Wallet →

​
Comisiones de Gas y Costos de Red

Las comisiones de gas se pagan directamente a la blockchain en el token nativo de la cadena — por ejemplo, ETH en Ethereum, Base, Arbitrum y Optimism, BNB en BNB Chain, POL (antes MATIC) en Polygon, TRX en Tron, SOL en Solana y XLM en Stellar.Blockradar no añade ningún margen al gas de la red: solo pagas lo que cobra la blockchain. Otros productos pueden tener sus propios cargos — consulta Comisiones y Precios más abajo.
Las comisiones de la red Tron son típicamente de $1–6 por transacción debido a cómo Tron maneja el ancho de banda y la energía. Este es un costo a nivel de blockchain, no un cargo de Blockradar.Alternativas de menor costo:
  • Solana: ~$0.01–0.30 por transacción
  • Base: ~$0.01–0.10 por transacción
  • Polygon: ~$0.01–0.10 por transacción
El endpoint /withdraw/network-fee devuelve una estimación conservadora para asegurar que las transacciones tengan éxito incluso durante alta congestión de red. Solo se te cobra la comisión de red real, que típicamente es menor que la estimación.
No, las comisiones de gas de blockchain deben pagarse en el token nativo de la cadena. Sin embargo, puedes habilitar retiros gasless para que tu master wallet patrocine el gas de las transacciones de direcciones secundarias.

​
Activación de Direcciones (Stellar, Tron, Solana)

Algunas blockchains exigen que una dirección se active o se fondee antes de poder mantener tokens. Es una regla de la red, no un cargo de Blockradar, y tu wallet no se está vaciando:Activación de Direcciones →
Emite la dirección como inactiva con enableIndexing: false. La activación se pospone hasta que actives la indexación en ella, así que solo fondeas la reserva de las direcciones que tus clientes realmente usan.
La causa más común es una master wallet sin fondos suficientes. Recarga tu master wallet de Stellar con XLM — las activaciones pendientes se reintentan automáticamente cuando llegan los fondos. Revisa configurations.stellar.lastError en la dirección para conocer el motivo concreto.

​
Transacciones Gasless

Cuando gasless está habilitado, la master wallet paga las comisiones de gas en nombre de los retiros de las direcciones secundarias.Para habilitarlo:
  • Nivel de master wallet: Panel de control → Configuración de Master Wallet → Habilitar Transacciones Gasless
  • Nivel de dirección: Configura enableGaslessWithdraw: true al crear o actualizar una dirección
También puedes establecer umbrales para que solo se cubran los retiros por encima o por debajo de ciertos montos.Transacciones Gasless → · Parámetros de Dirección →
Depende de la configuración enableGaslessWithdraw:
  • Habilitado (true): La master wallet paga el gas
  • Deshabilitado (false, por defecto): La dirección secundaria necesita su propio gas

​
Swaps y Puentes

Blockradar soporta swaps de stablecoin a stablecoin (por ejemplo USDT ↔ USDC) y swaps entre stablecoins y tokens nativos (por ejemplo SOL → USDC o USDC → TRX), tanto en la misma cadena como entre cadenas.La liquidez varía según el par, la cadena y el monto, así que solicita una cotización para confirmar una ruta concreta antes de ofrecerla a tus usuarios.Documentación de Swap →
Causas comunes:
  • No hay ninguna ruta ni liquidez disponible en este momento para ese par en esa cadena
  • El monto es demasiado pequeño o demasiado grande para la liquidez disponible
  • El activo no está habilitado en tu wallet
Prueba con otro monto, o verifica que ambos activos estén habilitados en las wallets involucradas.
Este error generalmente significa que estás usando el asset ID incorrecto. Necesitas usar el asset ID específico de la wallet, no un asset ID general.Para encontrar el ID correcto:
  • Panel de control: Ve a tu wallet → Assets → Copia el asset ID desde ahí
  • API: Usa los asset IDs devueltos por el endpoint de detalles de tu wallet
Sí. Puedes intercambiar y puentear activos entre diferentes blockchains a través del panel de control o la API. Para swaps cross-chain vía API, pasa el asset ID de la master wallet de destino como el toAssetId.Documentación de Swap →

​
Configuración de Wallet

Sí. Cada red blockchain necesita su propia Master Wallet, y eso incluye cada cadena EVM — una wallet de Base no cubre Ethereum, Polygon ni Arbitrum. Crea una Master Wallet por cada cadena que quieras soportar.Crear una Master Wallet →
Blockradar permite solo una Master Wallet por red blockchain por cuenta. Para soportar una blockchain adicional, debes crear una Master Wallet separada para ella. Dentro de una sola Master Wallet, puedes crear tantas direcciones secundarias como necesites para segmentar fondos por usuario, aplicación o propósito. No se soporta la creación de múltiples Master Wallets para la misma blockchain.
No, las direcciones no pueden eliminarse debido a limitaciones de blockchain. Solo puedes desactivarlas en el panel de control. Las direcciones desactivadas no recibirán nuevos depósitos ni serán monitoreadas.
Sí. La lista blanca de direcciones te permite agregar una dirección externa a tu wallet para que Blockradar monitoree sus depósitos, sin cambiar tu configuración actual.Lista Blanca de Direcciones →
Usa el parámetro showPrivateKey: true al consultar los detalles de wallet o dirección vía API.
Solo usa esto en entornos seguros y de confianza.

​
Retiros y Transferencias

Usa el endpoint de retiro de la API: POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentación de Retiros →
Causas comunes:
  • Gas insuficiente en la master wallet (si usas gasless) o dirección secundaria
  • Procesamiento de cola — las transacciones se procesan secuencialmente debido a los nonces de blockchain
  • Problemas de nodo — retrasos temporales
Si está atascada por más de 30 minutos, contacta a soporte con el ID de la transacción.
Sí:
Sí. El modo sign-only firma la transacción y la devuelve sin enviarla a la blockchain — útil para firma offline, flujos multifirma o para inspeccionar una transacción antes de transmitirla.
  • Master wallet: POST /v1/wallets/{walletId}/withdraw/sign
  • Dirección secundaria: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign
Modo Sign-Only →
Todos los movimientos de fondos on-chain usan el endpoint de retiro. No hay un endpoint separado de “transferencia”.
  • Master a secundaria: POST /v1/wallets/{walletId}/withdraw con la dirección secundaria como destino
  • Secundaria a master: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw con la dirección de la master wallet como destino
  • Secundaria a externa: Mismo endpoint, dirección externa como destino
Documentación de Retiros →
Usa el endpoint de transacciones con el parámetro de consulta de dirección:
Documentación de Transacciones →

​
Recuperación de Activos

Usa la Recuperación de Activos en el panel de control.Recuperación de Activos →

​
Test Mode vs. Live Mode

No, tus fondos no se perdieron. Mainnet y testnet son redes separadas, pero las direcciones están vinculadas criptográficamente. Puedes recuperar fondos usando la Recuperación de Activos.Recuperación de Activos →
Siempre verifica el indicador de entorno en el panel de control (muestra “Test Mode” o “Live Mode”) antes de realizar transacciones.
  1. Usa el selector de entorno en tu panel de control (generalmente arriba a la derecha o en la configuración de wallet)
  2. Cambia de Test Mode a Live Mode
  3. Crea una nueva master wallet para mainnet
  4. Actualiza tus claves API — las claves de Test Mode no funcionan en Live Mode
Las direcciones de testnet no pueden recibir fondos de mainnet y viceversa.
Tokens nativos para gas:Para USDC y EURC de testnet en la mayoría de las cadenas, usa el Circle Faucet. Los faucets de stablecoins de todas las cadenas aparecen en Activos Soportados.

​
Errores de API y Solución de Problemas

Causas comunes:
  • Wallet ID incorrecto
  • Clave API incorrecta (no coincide con la wallet)
  • Usar un asset ID general en lugar de un asset ID específico de la wallet
Generalmente es un problema temporal. Si persiste, contacta a soporte con el endpoint que estás llamando, la blockchain/red, y la respuesta de error completa.
Tu clave API es inválida o no coincide con la wallet a la que intentas acceder. Verifica que:
  • La clave API sea correcta (sin espacios extra)
  • La clave API pertenezca a esta wallet
  • No estés usando una clave de Test Mode en Live Mode (o viceversa)
  • La clave API no haya sido rotada o regenerada
El recurso (wallet, dirección o activo) no existe o estás usando el ID incorrecto. Las causas comunes incluyen un wallet ID o address ID incorrecto, usar un asset ID general en lugar de uno específico de la wallet, o un error tipográfico en la URL del endpoint.
Superaste el límite de solicitudes de la API. Reduce el ritmo y vuelve a intentarlo tras una breve espera, idealmente con backoff exponencial. Evita consultar en bucles cerrados — usa webhooks para las actualizaciones de transacciones y guarda en caché las respuestas de los endpoints de descubrimiento (activos, monedas y blockchains soportados) en lugar de llamarlos en cada solicitud.Errores →

​
Comisiones y Precios

No sobre el gas — Blockradar traslada las comisiones de red sin margen. Algunos productos tienen sus propios cargos:
  • Swaps y conversiones fiat pueden incluir un margen sobre el tipo de cambio
  • Depósitos y pagos fiat pueden tener una comisión de procesamiento
  • La creación de cuentas virtuales puede tener una comisión fija
  • Earn cobra su comisión de las ganancias cuando retiras, nunca de tu depósito
Las tarifas dependen de tu plan y de tus condiciones comerciales. Los endpoints de cotización muestran la tasa y las comisiones de una transacción concreta antes de ejecutarla. Para conocer los precios de tu cuenta, escribe a [email protected].

​
Cuentas Virtuales y Depósitos Fiat

  • Aprobación de cumplimiento: Completa el proceso de debida diligencia en My Wallets → Settings → Compliance en el panel de control
  • Activación de la función: Tras la aprobación de cumplimiento, solicita la activación de cuentas virtuales a [email protected] o por el chat en vivo del panel de control
  • Un plan de pago con acceso a stablecoins: Depositar fiat y convertirlo a stablecoins es una función de pago. Actualiza tu plan en Dashboard → Settings → Subscription
  • El entorno correcto: Las solicitudes en Test Mode usan solo rutas y wallets de testnet; las solicitudes en Live Mode usan solo rutas y wallets de mainnet
Documentación de Cuentas Virtuales →
Las Cuentas Virtuales solo aparecen cuando tu cumplimiento ha sido aprobado, la función se ha activado para tu cuenta y tu plan incluye acceso a stablecoins.
  • Las Cuentas Virtuales reutilizables son cuentas bancarias de larga duración vinculadas a una master wallet o a una dirección secundaria. Cada depósito en ellas se convierte a stablecoins — ideales para depósitos recurrentes de clientes.
  • Las órdenes de pago de Depositar Fiat crean una cuenta virtual de un solo uso para un único pago esperado. La cuenta es válida solo para ese pago.
Los depósitos están disponibles actualmente en ARS, BRL, COP, EUR, KES, MXN y USD.
Las cuentas virtuales en NGN están inactivas actualmente. Los pagos en NGN mediante Retiro a Fiat no se ven afectados.
La disponibilidad varía según el corredor y la wallet, así que verifica qué admite tu wallet antes de presentar una opción: usa el endpoint de descubrimiento de Cuentas Virtuales para las cuentas reutilizables, o Get Supported Currencies para Depositar Fiat.
No. AUD, CAD, GHS, THB, TRY, TZS, UGX, XOF y ZAR son solo de pago: puedes pagar en ellas con Retiro a Fiat, pero los usuarios no pueden depositarlas.
cNGN es una stablecoin vinculada al Naira nigeriano. Blockradar soporta transacciones e intercambios de cNGN con otras stablecoins.

​
Pagos Fiat (Retiro a Fiat)

Usa Retiro a Fiat. Convierte stablecoins compatibles a fiat y paga a cuentas bancarias, dinero móvil y otros rieles locales, desde una master wallet o una dirección secundaria. El flujo descubre los métodos de pago de un corredor, te indica exactamente qué datos del beneficiario necesita cada uno y luego cotiza y ejecuta el pago.
Los pagos están disponibles actualmente en ARS, AUD, BRL, CAD, COP, EUR, GHS, KES, MXN, NGN, THB, TRY, TZS, UGX, USD, XOF y ZAR.La disponibilidad varía según el corredor y la wallet, así que obtén la lista actualizada con Get Supported Currencies en lugar de codificarla de forma fija.

​
Earn

Earn te permite poner a trabajar tus stablecoins inactivas en protocolos DeFi que generan intereses (Aave y Compound). Es no custodial: los fondos salen de tu propia wallet, Blockradar nunca los agrupa ni los custodia, y no hay período de bloqueo.Earn →
Aave está disponible en Ethereum, Base, Arbitrum, Optimism, Polygon y BNB Smart Chain. Compound está disponible en Ethereum, Base y Arbitrum. El panel de control solo muestra las redes donde Earn está disponible para tu wallet.
Depositar es gratis. Cuando retiras, recibes exactamente el monto que solicitas — la comisión se descuenta de tus ganancias, nunca de tu capital. Puedes retirar parte o la totalidad de una posición en cualquier momento. Las tasas son variables y DeFi conlleva riesgo de smart contracts, por lo que los rendimientos no están garantizados.

​
Cumplimiento y Seguridad

Sí. La API de AML verifica cualquier dirección de wallet contra las listas de bloqueo de OFAC, FBI, Tether y Circle, para que puedas señalar contrapartes de alto riesgo antes de enviar o recibir fondos.Verificación AML →
Sí. La lista blanca de IPs restringe las solicitudes a la API a las direcciones IP que permitas, añadiendo otra capa de protección a tu integración.Lista Blanca de IPs →
Algunos corredores fiat exigen que tus clientes estén verificados. Crea clientes con la Customer API y luego envía sus datos y documentos mediante solicitudes de incorporación de clientes. Recopila solo los campos que pide el esquema de requisitos — consulta Formularios dinámicos.

​
Otros Productos

Sí. Checkout te permite aceptar pagos en stablecoins mediante enlaces compartibles — sin cuentas de cliente ni integraciones complejas.
Sí. Gateway te ofrece un saldo de USDC unificado y abstraído de la cadena: deposita desde cualquier cadena soportada y retira a cualquier cadena soportada, sin bridging manual.
Sí. Las Liquidaciones Automáticas convierten los depósitos entrantes a tu activo preferido y los envían a tu cadena de destino, según reglas que defines una sola vez.
El Liquidity Pool permite a los Liquidity Providers aprobados fijar tipos de cambio para pares de activos. Esas tasas alimentan el motor de swaps de Blockradar, que elige la mejor tasa disponible entre los proveedores activos.
Sí. La Smart Contract API te permite leer y escribir en cualquier smart contract directamente desde tu wallet, sin gestionar endpoints RPC ni flujos de firma por tu cuenta.

​
Solicitudes de Funcionalidades

No. Blockradar se enfoca en stablecoins. Bitcoin no está soportado actualmente.
Blockradar es agnóstico de blockchain y stablecoin — redes y activos adicionales pueden integrarse bajo solicitud. Contáctanos para discutir tus requerimientos.

​
Facturación y Suscripciones

Sí. Puedes pagar a través del enlace de pago enviado a tu correo, o retirar de tu master wallet a la dirección del enlace de pago.
Actualmente, solo soportamos pagos con stablecoins para suscripciones.

​
Blockchains y Activos Soportados

Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Stellar, Celo, Lisk, Avalanche, Asset Chain, Arc, Plasma y TempoBlockradar es agnóstico de blockchain y stablecoin — redes adicionales pueden integrarse bajo solicitud.Redes Soportadas →
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, ZARP, JPYC, MXNB, PYUSD, AlphaUSDActivos adicionales pueden integrarse bajo solicitud.Activos Soportados →

​
Consejos para Desarrolladores

  • Wallet ID: Identifica tu master wallet
  • Address ID: Identifica una dirección secundaria específica dentro de una wallet
  • Asset ID: Identifica un activo específico (USDT, USDC, etc.) dentro de tu wallet
Siempre usa el asset ID específico de la wallet de tu lista de activos de wallet, no un asset ID general.
  • Siempre usa Live Mode para transacciones reales
  • Almacena los wallet IDs y address IDs en tu base de datos
  • Implementa manejadores de webhooks para actualizaciones de transacciones en tiempo real
  • Usa el Buscador de Depósitos como respaldo para transacciones no detectadas
  • Monitorea el saldo de la master wallet para gas (tokens nativos)
  • Habilita retiros gasless si tus usuarios no deberían necesitar tokens nativos

​
¿Necesitas Ayuda?

Documentación

docs.blockradar.co

Panel de Control

dashboard.blockradar.co

Agendar una Llamada de Soporte

Agenda aquí