En resumen
La API de Retiro Fiat de Blockradar te permite convertir stablecoins compatibles en moneda fiat y transferir fondos a cuentas bancarias. Puedes consultar activos compatibles, validar cuentas bancarias, obtener cotizaciones y ejecutar retiros desde billeteras principales y direcciones hijas.
La API de Retiro Fiat de Blockradar te permite convertir stablecoins compatibles en moneda fiat y transferir fondos a cuentas bancarias. Puedes consultar activos compatibles, validar cuentas bancarias, obtener cotizaciones y ejecutar retiros desde billeteras principales y direcciones hijas.

Requisitos previos
Antes de usar Retiro Fiat, asegúrate de contar con lo siguiente:Requisito de cumplimiento
Completa el onboarding de socios antes de solicitar acceso a Retiro Fiat (consulta
Requisitos de cumplimiento más abajo).
Clave API
Obtén tu clave API desde el Panel de Blockradar.
Ve a Developers para generar una.
Billetera creada
Crea una billetera desde el panel. Necesitarás el
walletId para las
operaciones de retiro.ID del activo
Consulta los activos fiat compatibles usando Obtener activos compatibles.
Cómo funciona
Retiro Fiat sigue una secuencia simple:Descubrir activos
Consulta los activos compatibles para retiros.
Obtener monedas fiat
Recupera todas las monedas compatibles.
Obtener tasas
Consulta el tipo de cambio actual para el activo seleccionado.
Verificar cuenta
Valida los datos de la cuenta bancaria antes de iniciar el retiro.
Obtener cotización
Estima comisiones y tipo de cambio para el monto solicitado.
Ejecutar
Envía el retiro para su procesamiento.
Requisitos de cumplimiento
Antes de acceder a Retiro Fiat, completa el proceso de onboarding de cumplimiento correspondiente a la cobertura de la moneda de pago que necesitas.Elige tu ruta de onboarding
- Solo NGN (Naira): Completa el formulario de onboarding solo para Naira.
- Otras monedas africanas: Completa el onboarding para socios de monedas africanas.
Si necesitas acceso tanto a NGN como a otras monedas africanas compatibles, completa ambos procesos de onboarding.
Requisito de aprobación
El acceso a Retiro Fiat se habilita después de la revisión de cumplimiento y la aprobación para la ruta de onboarding que hayas elegido.Billetera principal vs dirección hija
Retiro Fiat está disponible en dos niveles:Billetera principal
Retira desde la billetera principal. Ideal para operaciones de tesorería.
Dirección hija
Retira desde una dirección hija específica. Útil para flujos por usuario.
Endpoints
| Operación | Billetera principal | Dirección hija |
|---|---|---|
| Obtener activos compatibles | GET /v1/wallets/{walletId}/withdraw/fiat/assets | — |
| Obtener instituciones | GET /v1/wallets/{walletId}/withdraw/fiat/institutions | — |
| Obtener tasas de cambio | GET /v1/wallets/{walletId}/withdraw/fiat/rates | — |
| Obtener monedas | GET /v1/wallets/{walletId}/withdraw/fiat/currencies | — |
| Verificar cuenta institucional | POST /v1/wallets/{walletId}/withdraw/fiat/institution-account-verification | — |
| Obtener cotización | POST /v1/wallets/{walletId}/withdraw/fiat/quote | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/quote |
| Ejecutar | POST /v1/wallets/{walletId}/withdraw/fiat/execute | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute |
Flujo típico
- Consulta los activos compatibles para elegir la stablecoin a retirar.
- Lista instituciones y selecciona un identificador de banco/institución.
- Verifica la cuenta para confirmar nombre y datos de la cuenta.
- Obtén una cotización para mostrar comisiones y tasa antes de ejecutar.
- Ejecuta el retiro y da seguimiento al estado en tu sistema.
Paso 1: Obtener una cotización
Solicita siempre una cotización antes de ejecutar un retiro para poder mostrar la tasa y las comisiones al usuario.Parámetros de la solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
assetId | string | Sí | ID del activo stablecoin que deseas retirar |
amount | number | Sí | Monto a retirar en las unidades del activo |
currency | string | Sí | Moneda fiat de destino (por ejemplo, NGN) |
accountIdentifier | string | Sí | Número de cuenta bancaria o identificador |
institutionIdentifier | string | Sí | Código del banco/institución |
Ejemplo de cotización
Paso 2: Ejecutar el retiro
Una vez aceptada la cotización, ejecuta el retiro con los mismos datos (y cualquier código/OTP requerido).Parámetros de la solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
assetId | string | Sí | ID del activo stablecoin que deseas retirar |
amount | number | Sí | Monto a retirar en las unidades del activo |
currency | string | Sí | Moneda fiat de destino (por ejemplo, NGN) |
accountIdentifier | string | Sí | Número de cuenta bancaria o identificador |
institutionIdentifier | string | Sí | Código del banco/institución |
code | string | No | Código de verificación si el proveedor lo requiere |
Ejemplo de ejecución
Respuesta de ejecución
Webhooks
Haz seguimiento del estado del retiro con los siguientes eventos webhook:| Evento | Descripción |
|---|---|
offramp.processing | El retiro está siendo procesado |
offramp.success | El retiro se completó correctamente |
offramp.failed | El retiro falló |
Ejemplo de payload webhook
Ejemplo de flujo completo
A continuación se muestra una implementación completa del flujo verificar → cotizar → ejecutar:Respuestas de error
Datos bancarios inválidos
Datos bancarios inválidos
Moneda no compatible
Moneda no compatible
Activo no compatible
Activo no compatible
Función no habilitada
Función no habilitada
Saldo insuficiente
Saldo insuficiente
Saldo nativo insuficiente
Saldo nativo insuficiente
Saldo insuficiente en la billetera principal
Saldo insuficiente en la billetera principal
Buenas prácticas
Experiencia de usuario
- Verifica cuentas primero: Confirma siempre el nombre de la cuenta antes de mostrar una cotización
- Muestra el costo total: Presenta tipo de cambio, comisión de red y monto total
- Muestra el estado de procesamiento: Usa webhooks para actualizar a los usuarios en tiempo real
Seguridad
- Valida entradas: Asegúrate de que moneda, institución e identificadores de cuenta tengan un formato correcto
- Usa referencias: Rastrea retiros con una
referenceúnica - Confirma vía webhooks: Trata
offramp.successcomo la fuente final de verdad
Rendimiento
- Cachea listas de instituciones: Actualízalas periódicamente en lugar de hacerlo en cada solicitud
- Reutiliza metadatos de activos: Cachea activos y monedas compatibles
- Reintenta errores transitorios: Usa backoff exponencial para respuestas 5xx
Referencia de API
| Endpoint | Descripción |
|---|---|
| Obtener activos compatibles | Lista los activos stablecoin compatibles |
| Obtener instituciones | Lista instituciones por moneda |
| Obtener tasas de cambio | Consulta el tipo de cambio para una cotización |
| Obtener monedas | Lista monedas fiat compatibles |
| Verificar cuenta institucional | Verifica los datos de una cuenta bancaria |
| Cotización de billetera principal | Obtiene una cotización desde la billetera principal |
| Ejecución de billetera principal | Ejecuta un retiro desde la billetera principal |
| Cotización de dirección hija | Obtiene una cotización desde una dirección hija |
| Ejecución de dirección hija | Ejecuta un retiro desde una dirección hija |
Soporte
- Email: [email protected]
- Documentación: Referencia de API

