Deblock: Integración API de OpenData/OpenFinance
Análisis de protocolo autorizado y adaptadores con mentalidad OpenBanking para transformar datos fiat/cripto en APIs mantenibles.
Conecta el “libro contable” de Deblock con tu plataforma de datos financiera.
Deblock une una cuenta bancaria con IBAN propio, transferencias SEPA instantáneas, tarjetas Visa de débito (físicas y virtuales) y una cartera cripto no custodial. Para un equipo de integración, el valor es convertir los viajes reales del usuario en registros estructurados: transacciones, estados de pago, tenencias y evidencias de reporte cuando el flujo lo requiere.
- Transacciones y líneas de reporte — exportables por rangos de tiempo para reconciliar euros y conversiones cripto con el mismo marco temporal.
- Balances y tenencias — snapshots coherentes para dashboards y reglas de “disponible” que no se rompen con refrescos parciales.
- Eventos SEPA y ledger de tarjeta — estados, referencias y movimientos para construir objetos OpenFinance.
Módulos de función para integrar
1) API de historial de transacciones + exportación para contabilidad
Convertimos el historial en eventos de ledger estables: eventId, postedAt, amount/currency, referencias y notas normalizadas. Así evitas atarte a labels de UI y puedes mantener un contrato de datos consistente.
2) Sincronización de balances y tenencias (snapshot + timestamp)
Modelamos el estado EUR y las tenencias cripto en instantáneas. El timestamp de valoración permite que el “disponible” y los indicadores de riesgo no cambien por desincronización entre refreshs parciales.
3) Estado SEPA + referencias (incluye patrón instant)
Normalizamos crédito SEPA, instant y direct debit según el flujo. El objetivo es producir objetos OpenFinance con transiciones de estado y claves de conciliación basadas en referencias.
4) Ledger de tarjetas Visa (agregación física + virtual)
Como existen identidades de tarjeta, los gastos se reparten. Unificamos pagos en un ledger: cardId, paymentId, tiempos de autorización/postedAt, merchant label y amount/currency.
5) Ledger cripto: compras/ventas/cambios con mapeo de fees
Deblock soporta buy/sell/swap y operaciones de depósito/retiro con activos como Bitcoin, Solana y USDC. Para integración, lo esencial es un trade ledger con legs: assetIn, assetOut, rate y líneas de fee.
6) Exportación orientada a impuestos (bundles repetibles)
Implementamos la descarga como export por rango: validación de completitud, deduplicación por eventId y generación de bundles deterministas en CSV/JSON con checksums.
Screenshots
Todas las capturas de Deblock están aquí. Haz clic en una miniatura para ampliar.
Estas pantallas nos ayudan a mapear viajes reales hacia módulos: IBAN/SEPA, tarjetas, operaciones cripto y descargas para reporting.
Instrucciones de integración API (OpenData / OpenFinance)
Flujo paso a paso
- Alineación del alcance: define módulos (ledger de transacciones, estados SEPA, actividad de tarjetas, trade ledger cripto y bundles de impuestos) y cadencia.
- Análisis autorizado de protocolo: documenta sesiones, rutas de exportación y transiciones de estado, con límites de consentimiento.
- Ingesta + normalización: implementa ventanas de tiempo, paginación y mapping estable a contratos OpenData/OpenFinance.
- Publicación de APIs: endpoints estables con errores estructurados e instrucciones de reintento e idempotencia.
Entregables típicos
- Contrato tipo OpenAPI para export ledger/statement.
- Informe de protocolo: supuestos de sesión, token y alcance de consentimiento.
- Fuente ejecutable (adaptadores + SDK) con retries y paginación.
- Plan de pruebas con ejemplos de requests/responses.
- Guía de cumplimiento: minimización, seguridad y retención.
Datos disponibles para integración (OpenData)
Esta tabla resume datos que aparecen en flujos principales (balances, transferencias, tarjetas, operaciones cripto y descargas de transacciones). Nosotros los normalizamos para que tu capa OpenFinance pueda reconciliar y reportar.
| Tipo de dato | Fuente (pantalla/función) | Granularidad | Uso típico |
|---|---|---|---|
| Balances en EUR | Vista de balance principal | Instantáneas con timestamp de disponibilidad | Cashflow, alertas por umbral, analítica de “disponible” |
| Historial de transacciones | Lista de transacciones + filtros | Por operación: postedAt, cantidad, referencias y notas | Reconciliación, analítica de gasto y evidencia para auditoría |
| Export para impuestos | Descarga orientada a reporting | Lotes por rangos de tiempo | Pipeline de impuestos con bundles deterministas |
| Estado SEPA + referencias | Flujos de transferencia | Eventos de transferencia con transiciones de estado | Posting en ERP, seguimiento de nómina/renta y conciliación |
| Pagos con Visa | Historial de tarjetas | Por pago: merchant label, cardId, auth/postedAt | Captura de gastos y reglas fiscales |
| Tenencias cripto + trade ledger | Cartera + swaps/compra/venta | Por activo (holding) y por trade legs | Contabilidad de cartera, revisiones de cumplimiento y reportes |
Escenarios típicos de integración
Escenario 1: Reconciliación diaria en ERP
Un portal de contabilidad necesita reconciliar EUR y conversiones cripto. La integración debe producir un ledger consistente con referencias y memos normalizados.
Escenario 2: Nómina/renta con estados SEPA instant
Un equipo operativo quiere actualizar el estado del pago cuando Deblock reporta confirmaciones. Se requiere preservar el reference para que la conciliación no dependa del texto del usuario.
Escenario 3: Dashboard unificado “EUR + cripto”
Un dashboard de portfolio necesita sincronizar efectivo y holdings. El sistema debe tener timestamps de valoración para que los gráficos sean coherentes.
Escenario 4: Export de trade ledger para revisión
Operaciones necesita un trade ledger que identifique asset pairs y fees, con salida útil para auditoría y reporting.
Escenario 5: Pipeline de export tax con paquetes deterministas
Un asistente fiscal requiere bundles por rango (mes/trimestre). La re-ejecución no debe duplicar entradas y debe detectar faltantes antes de entregar el reporte.
Implementación técnica (pseudo-código y API)
1) Inicialización de sesión autorizada (consent + token)
Diseñamos el conector para que no ejecute fuera del consentimiento. El servicio devuelve un accessToken con expiración corta y un consentId para auditoría.
2) Export de transacciones con paginación + normalización
Las exportaciones se hacen por ventanas de tiempo, se normalizan y se deduplican por eventId. Esto evita “doble posting” si hay reintentos.
3) Ingesta tipo webhook + idempotencia
Si tu downstream necesita “push”, traducimos exportaciones (polling) en eventos estilo webhook. Se usa un watermark por consentId para emitir solo lo nuevo.
Cumplimiento y privacidad
Marco regulatorio para el que diseñamos
Como Deblock opera en el marco francés y tiene aprobación PSAN en AMF, los proyectos de integración deben tratar la información financiera y personal con alta exigencia. Nuestro enfoque considera:
- GDPR (Regulation (EU) 2016/679) para base legal, minimización de datos y derechos del usuario.
- PSD2 (Directive (EU) 2015/2366) como referencia para acceso basado en consentimiento, estilo OpenBanking.
- AMLD5 (Directive (EU) 2018/843) por expectativas de trazabilidad y controles sobre datos relacionados con transacciones.
La entrega incluye guías de almacenamiento seguro de tokens, límites de retención y documentación para que el equipo de ingeniería pueda justificar decisiones en auditoría interna.
Flujo de datos / arquitectura
Pipeline simple y auditable:
- Cliente solicita consentimiento y define scopes/rangos.
- Adaptador Deblock ejecuta exportaciones autorizadas y produce OpenData crudo.
- Normalización convierte registros en objetos OpenFinance (ledger/trades/estados SEPA).
- Storage + APIs de salida publica bundles JSON/CSV y eventos estilo webhook con idempotencia.
Posicionamiento y perfil de usuario
Deblock se posiciona como un fintech orientado a consumidores en Europa: combina experiencia bancaria (salario, IBAN, SEPA, Visa débito) con una cartera cripto no custodial (BTC, Solana, USDC y swaps). En las fuentes públicas se describe disponibilidad en Europa y experiencia mobile-first para iOS y Android.
Los compradores típicos son equipos B2B que construyen portales de contabilidad, asistentes fiscales, dashboards de portfolio y herramientas de conciliación. Su diseño suele apoyarse en patrones de acceso con consentimiento de estilo OpenBanking, y a menudo toman como referencia ecosistemas como flujos de consentimiento AIS (por ejemplo, enfoque tipo Tink) para implementar controles seguros.
En el mismo ecosistema de “fiat + cripto”, los usuarios mencionan productos como Revolut y Lydia. Nuestro trabajo se centra en Deblock y en los outputs que tu negocio necesita.
Sobre nosotros, entregables y FAQ
Somos un estudio de servicios técnicos enfocado en integración autorizada de interfaces de apps y en integración API con enfoque de cumplimiento. Combinamos experiencia práctica en mobile/fintech con análisis de protocolo pensado para el handoff de ingeniería: te entregamos código funcional, documentación de interfaces y plan de pruebas.
- Primero OpenData (adaptador) y luego contratos OpenFinance (API).
- Mapeamos journeys reales a esquemas de campos estables: cuentas, transferencias, tarjetas, operaciones cripto y export de statements.
- Documentamos consentimiento/token y fallos esperados (token expirado, export no listo, revocación de consentimiento).
- Precio desde $300 y opción de “entrega primero, pago al estar satisfecho”.
FAQ
P: ¿Qué información necesitan?
R: El alcance para Deblock (módulos) y los requisitos de salida (JSON/CSV/PDF referencias), además de idioma y restricciones de entorno.
P: ¿Cómo protegen privacidad y cumplimiento?
R: Diseñamos con consent scopes, minimización de datos, retención documentada y seguridad de tokens, alineados a GDPR y a patrones de acceso basados en consentimiento inspirados en PSD2.
Información de contacto
Si quieres una integración autorizada OpenData/OpenFinance para Deblock, envíanos tus módulos objetivo y requisitos. Respondemos con propuesta concreta y plan de entrega.
Checklist de entregables
- Especificación de integración (endpoints OpenAPI para ledger/transferencias/trades/statements).
- Notas de protocolo y supuestos de sesión/consent.
- Código fuente del adaptador + SDK con paginación, retries e idempotencia.
- Pruebas automatizadas y scripts de ejemplo.
- Documentación operativa: logs, retención y hooks de monitoreo.
Flujo de trabajo
- Alineación: elegir módulos Deblock (export de transacciones, estado SEPA, ledger de tarjetas, trades cripto).
- Análisis de protocolo autorizado: definir límites de extracción y mapping a OpenData.
- Desarrollo + validación: endpoints, token handling, paginación y reintentos.
- Paquete de entrega: documentación, ejemplos y plan de pruebas.
- Primer prototipo utilizable suele entregarse en 5–15 días hábiles según alcance y complejidad del consentimiento.
Por qué OpenData / OpenFinance
Las plataformas financieras necesitan un modelo consistente de “eventos contables” para presupuestar, conciliar y reportar con evidencia. Al publicar exports como OpenData y proyectarlos en OpenFinance, tu cadena se mantiene auditable y más fácil de mantener tras cambios del App.
Además, estructuramos el acceso con un enfoque basado en consentimiento para reducir el “gap” entre viajes del usuario y contratos de ingeniería downstream.
Aplicación original: Deblock - Banking app (colapsada por defecto)
Deblock se presenta como “la cuenta bancaria que también acepta tus cripto”. Integra una cuenta bancaria con una cartera cripto para depositar, retirar y cambiar cripto y euros sin fricción. También se describe como una forma de recibir salario, pagar el alquiler, depositar Bitcoin, retirar algo de efectivo, transferir Solana y cambiar USDC.
Únete: descarga Deblock hoy.