Integración de API de tbi bank y exportación OpenBanking
Entregamos integraciones autorizadas y analizadas por protocolo para OpenData/OpenFinance: transacciones, balances, BNPL de shopping limit, recompensas y obligaciones de préstamo.
Convierte los flujos de tbi bank en APIs con contrato de datos y auditoría.
Nuestro estudio combina análisis de interfaces de la app y refactorización para construir una capa de integración. El objetivo es que tu backend obtenga saldos y transacciones (estilo PSD2 AIS), soporte de modelado para BNPL (shopping limit con 3/6/12), un diario de recompensas (cashback) y un timeline de obligaciones de préstamo, todo como salidas normalizadas.
- Ledger de transacciones: pagos con tarjeta, transferencias y movimientos asociados al shopping limit.
- Snapshots de balance: ayudan a explicar ventanas de conciliación y contexto de moneda.
- Crédito e incentivos: installment BNPL 3/6/12, estados de pago holiday y recompensas de hasta 10% según la oferta del comercio.
Módulos de función basados en tbi bank
1) Exportación de balances estilo AIS
Diseñamos el modelo para que puedas re-ejecutar el sync sin perder el contexto de cuándo el balance era válido.
Uso: conciliación, cashflow forecasting y auditoría de cambios por período y moneda.
2) Exportación de transacciones OpenBanking (normalización)
Tu salida se convierte en un ledger utilizable: `occurred_at`, `booking_date`, `direction`, `product_type`, `currency` y un `reference_id` apto para idempotencia.
Uso: importación a ERP y consultas BI con filtros por ventana de tiempo.
3) Conciliación BNPL shopping limit (3/6/12)
Convertimos la intención de compra en un conjunto de `installments` con due_month y amount_due, permitiendo reportes mes a mes y seguimiento de estado.
Uso: conciliación de cuotas, generación de calendario de pagos y preparación de flujos de soporte.
4) Clase de evento: cash-out desde shopping limit
Tratarlo como clase diferenciada permite que el sistema sepa si el usuario está “comprando en cuotas” o “retirando efectivo” y ajuste pronósticos y libros.
Uso: modelos de exposición al crédito y analíticas de flujo de caja.
5) Diario de recompensas/cashback (hasta 10%)
Normalizamos cada evento a un formato “rewards journal” listo para provisiones, reportes y conciliación con el flujo financiero del usuario.
Uso: analítica de fidelización y seguimiento de liability de cashback.
6) Timeline de obligaciones del préstamo + payment holiday
Entregamos un timeline API para que tu producto no dependa de pasos de UI; basta con consumir el modelo normalizado.
Uso: presupuestos, riesgo y automatización de soporte al cliente.
Beneficios centrales para equipos de integración
En lugar de tratar tbi bank como una caja negra, construimos una capa de integración para que la información financiera sea consistente y audit-able dentro de tu backend. Cada módulo se entrega con mapeos de campos, ejemplos de request/response y un plan de pruebas orientado a cambios reales de protocolo.
Para sistemas que necesitan “OpenBanking transaction export” y “OpenFinance payment initiation” a nivel operativo, la consistencia importa: IDs estables para dedupe, manejo correcto de moneda y timestamps que facilitan la reconciliación.
- Normalización OpenData: campos coherentes para montos, referencias, fechas y tipos de producto.
- Seguridad de ejecución: retries, idempotency keys y mapeo de errores para ingestión robusta.
- Auditoría y minimización: logs de consent + ventanas de retención al estilo GDPR.
- Entrega de código fuente: implementación utilizable y documentación de integración.
Instrucciones de integración API
Tú defines el objetivo (por ejemplo: “exportación de transacciones OpenBanking” o “conciliación BNPL de shopping limit”). Nosotros traducimos los pasos autorizados de acceso de tbi bank a un flujo de integración consciente del consent y delimitado por responsabilidades claras.
Proceso típico: consent + establecimiento de sesión → recuperación autorizada (AIS: balances/transactions) → normalización basada en protocolo → salida API. El primer “vertical slice” suele enfocarse en ledger + balances para validar calidad antes de ampliar a rewards y loan obligations.
Tu backend gestiona identidad y datos mínimos necesarios. Nuestro módulo se centra en recuperar datos autorizados y devolver payloads normalizados con comportamiento determinista de dedupe.
Screenshots
Haz clic en cualquier miniatura para ver la imagen ampliada. Esto ayuda a alinear el análisis de protocolo con las pantallas reales donde aparecen shopping limit, cuotas 3/6/12, estados de rewards y el área de obligaciones del préstamo.
Inventario de datos (perspectiva OpenData)
Esta lista te ayuda a decidir qué datasets integrar primero. La derivamos de módulos reales del app: exportación de saldos y transacciones, acciones BNPL del shopping limit (3/6/12), cash-out desde shopping limit, el programa de recompensas y la gestión de obligaciones de préstamos. Todos los entregables se diseñan para acceso autorizado.
| Tipo de dato | Fuente (pantalla/función) | Granularidad | Uso típico |
|---|---|---|---|
| Saldos | Resumen de cuenta, widgets de liquidez | Snapshots con timestamps | Cashflow, conciliación y contexto de moneda |
| Ledger de transacciones | Actividad de tarjeta, transferencias y movimientos del shopping limit | Detalle por transacción + rango de fechas | OpenBanking transaction export y analítica |
| Calendario BNPL del shopping limit | shopping limit → split en cuotas (3/6/12) | Compra → cuotas con due dates | Conciliación, reporte de débito diferido |
| Cash withdrawal desde shopping limit | ATM cash-out desde shopping limit | Clase de evento + efecto en timeline | Exposición crediticia, monitoreo y reporting |
| Recompensas/cashback | Rewards section: ofertas y estado | Eventos por compra + lifecycle | Provisión contable, CRM y dashboards |
| Obligaciones del préstamo | Loans: cuotas e installment + payment holiday | Próximo vencimiento + montos + holiday flags | Presupuesto, scoring y soporte automatizado |
En BNPL y rewards, el dato correcto no es solo “un número”, sino una transición de estado. Si guardas texto suelto, aparecen errores. El inventario se centra en campos estables y transiciones para que el sync sea repetible y el resultado coincida con auditoría.
Escenarios de integración típicos
Estos ejemplos end-to-end muestran el mapeo hacia OpenData/OpenFinance y el tipo de salida que podrás consumir en tu producto.
Contexto: cierre mensual y match entre facturas internas y movimientos bancarios.
Datos/APIs: ledger de transacciones (tarjeta, transferencias y shopping-limit movements) en ventanas temporales.
OpenData/OpenFinance: ledger normalizado (`ledger.items[]`) con `occurred_at`, `booking_date`, `amount` y un `reference_id` para dedupe.
Contexto: modelos de crédito y presupuestos que necesitan representar débito diferido con claridad.
Datos/APIs: split purchase (3/6/12) + opción de retirar efectivo desde shopping limit hacia neon (marzo 2024).
OpenData/OpenFinance: `bnpl.installments[]` con `due_month`, `amount_due` y `event_class` para distinguir cuotas de cash-out.
Contexto: analítica de fidelización y forecast de liability por cashback.
Datos/APIs: lifecycle de recompensas y reglas de porcentaje del programa shopping.
OpenData/OpenFinance: `rewards.journal[]` con `merchant_id`, `reward_rate`, `reward_amount`, `status` y `available_until`.
Contexto: asistencia de finanzas personales que ajusta pronósticos cuando el usuario activa payment holiday.
Datos/APIs: obligaciones del préstamo con flags y montos por período.
OpenData/OpenFinance: `loans.obligations[]` con `next_due_date`, `installment_amount` y `holiday_flag`.
Contexto: e-commerce que inicia un pago y reduce tickets cuando hay confirmaciones tardías.
Datos/APIs: Payment Initiation (PIS) con endpoints de creación/consulta de status basados en consentimiento.
OpenData/OpenFinance: `payments.initiations[]` con `payment_id`, `status` y `instructed_amount` para reconciliación automática.
Implementación técnica (fragmentos)
Los ejemplos siguientes ilustran el nivel de profundidad que entregamos. No declaran que tbi bank publique exactamente estos endpoints; muestran cómo tu backend consumiría una capa autorizada de integración y recibiría payloads OpenData/OpenFinance normalizados.
// 1) Consent-aware AIS: balances + transacciones
POST /integration/tbi-bank/ais:consent
Content-Type: application/json
Authorization: Bearer <CLIENT_ACCESS_TOKEN>
{
"provider": "tbi-bank",
"scopes": ["AIS:readAccounts", "AIS:readBalances", "AIS:readTransactions"],
"psu_context": {"psu_id": "user_123"},
"valid_until": "2026-12-31"
}
// Ejemplo de respuesta:
{ "consent_id": "cns_9f2a...", "status": "AwaitingSCA", "redirect_url": "https://.../sca" }
// Después de SCA:
GET /integration/tbi-bank/ais/{consent_id}/{account_id}/balances
GET /integration/tbi-bank/ais/{consent_id}/{account_id}/transactions?from=2026-02-01&to=2026-02-29&cursor=...
// Errores:
// - RATE_LIMIT: backoff + continuar con cursor
// - CONSENT_EXPIRED: re-hacer el consent y reanudar desde checkpoint
// 2) Normalizar BNPL (shopping limit 3/6/12) y cash-out
function buildBnplLedger(purchaseActions, installmentOptions){
const items = []
for (action of purchaseActions){
const plan = installmentOptions[action.installment_months]
if(action.event_class === "SHOPPING_LIMIT_PURCHASE"){
items.push(...expandIntoInstallments(action, plan, "PURCHASE"))
}
if(action.event_class === "SHOPPING_LIMIT_CASH_WITHDRAWAL"){
items.push(...expandIntoInstallments(action, plan, "CASH_OUT"))
}
}
return { "bnpl.installments": items }
}
// Ejemplo de forma de salida:
// {
// "bnpl_installment_id": "...",
// "purchase_reference": "...",
// "event_class": "PURCHASE|CASH_OUT",
// "due_month": "2026-03",
// "amount_due": {"value":"...","currency":"EUR"}
// }
// 3) OpenFinance PIS: iniciación + polling de estado
POST /integration/tbi-bank/pis:payments
Content-Type: application/json
{
"consent_id": "cns_9f2a...",
"instructed_amount": {"value": 120.50, "currency": "EUR"},
"creditor": {"name": "Merchant / Payee", "account_hint": "IBAN-or-alias"},
"remittance_information": "Invoice #INV-2026-001"
}
// Respuesta:
{ "payment_id": "pay_1a2b...", "status": "Pending", "status_updated_at": "..." }
// Consulta del estado:
GET /integration/tbi-bank/pis:payments/{payment_id}/status
// Al completarse:
// POST https://yourapp.com/webhooks/tbi-bank/payment-status
// { "payment_id":"pay_1a2b...", "status":"Completed", "settled_at":"..." }
Nota de ingeniería: hacemos énfasis en mapeos deterministas, validación estricta de campos e idempotency keys. Ese enfoque es lo que hace que un “export de transacciones OpenBanking” sea usable para conciliación, no solo para dashboards.
Cumplimiento y privacidad
En integraciones con acceso autorizado estilo PSD2, el flujo debe respetar consentimiento (consent scopes) y expectativas de seguridad. Nuestro enfoque no deja la compliance para “el final”: se implementa en el diseño de scopes, el tipo de logs y la retención de datos para normalización.
Referencias regulatorias relevantes: PSD2 (Directive (EU) 2015/2366) y GDPR (Regulation (EU) 2016/679). También alineamos el estilo de acceso Open Banking con el ciclo de consent y la expectativa de SCA.
- Scopes ligados a datasets: balances, transacciones, payment initiation y objetos BNPL/préstamos.
- Audit trail: contexto de consent, timestamps de extracción y hashes de transformación.
- Ventanas de retención: conservar raw solo el tiempo necesario para normalizar.
Flujo de datos / arquitectura
App Cliente → establecimiento de consent/sesión → módulo de ingestión (retrieval autorizado) → normalización y validación → almacenamiento (raw mínimo + modelo estructurado) → salida API para analítica/contabilidad.
- Checkpoint de cursor para exports incrementales seguros.
- Dedupe e idempotencia para evitar doble conteo.
- Máquina de estados BNPL y recompensas para reconstruir lifecycle.
Posicionamiento de mercado y perfil de usuario
tbi bank es una entidad challenger en Europa del Este y del Sudeste, con presencia activa en Bulgaria, Rumanía y Grecia. Su experiencia de compra y pago se centra en usuarios diarios que administran balances en EUR/lev, dividen compras en cuotas BNPL (3/6/12) y usan la sección Shopping para obtener cashback en ofertas de comercios (hasta 10% según la oferta).
La relevancia para integración es alta: la app de compras superó 300,000 usuarios en 2024, llegó a ~2,000 comercios asociados y casi dos tercios de transacciones se realizaron bajo el modelo BNPL. Para un producto OpenData/OpenFinance, esto significa muchos “eventos” útiles para validar tu API en escenarios reales de frecuencia y variación.
En cuanto a plataforma, la app está orientada a Android e iOS, por lo que los outputs suelen alimentar paneles web, jobs de reconciliación en backend y flujos de riesgo o soporte.
Entregables y qué recibes
Entregamos un paquete de integración usable: tu meta es poder publicar una API o una implementación de protocolo que tu equipo pueda mantener y re-ejecutar de forma segura.
- Especificación API (estilo OpenAPI/Swagger) para los endpoints solicitados.
- Reporte de protocolo y autorización (consent/session, mapeo de scopes, comportamiento de token).
- Código fuente funcional para AIS/Balances/Transactions y normalización BNPL/rewards/loans.
- Plan de pruebas automatizadas para rutas clave y smoke tests re-ejecutables.
- Notas de compliance sobre logging, scoping y retención.
- Documentación de interfaces para desarrollo y QA.
Sobre nuestro estudio y contacto
Somos un estudio de servicios técnicos enfocado en integración de interfaces de apps y en integración de API autorizada. Combinamos análisis de protocolo, refactorización de interfaz, mapeo OpenData/OpenFinance y entrega de código fuente listo para desarrolladores con documentación de integración.
Precio transparente: servicios desde $300. También ofrecemos opción de “deliver first, pay upon satisfaction” para iniciar con un vertical slice de bajo riesgo.
- Nombre de la app objetivo: tbi bank.
- Requisitos: OpenBanking transaction export, conciliación BNPL, sync del rewards ledger, y/o timeline de loan obligations.
- Formato de salida preferido: JSON API y sincronización programada con reporting.
Workflow y pasos de propuesta
- Alineación de requisitos: confirmar scopes (balances, transacciones, BNPL, rewards, loans) y criterios de éxito.
- Análisis de protocolo y diseño: producir mapeo de endpoints y reglas de normalización (2–5 días laborables).
- Implementación y verificación interna: construir ingestión, dedupe y salidas API normalizadas (3–8 días laborables).
- Entrega del paquete: API spec, código fuente, documentación de integración y pruebas (1–2 días laborables).
- Soporte de regresión opcional si cambia el protocolo tras tu primer despliegue.
Un primer “vertical slice” suele caer entre 5–15 días laborables según complejidad y requisitos de acceso regulado.
FAQ
¿Puedo iniciar con un dataset solamente?
Sí. Muchos equipos empiezan con ledger de transacciones + balances para validar calidad del mapeo; después amplían a shopping-limit BNPL y rewards lifecycle una vez confirmadas las reglas de conciliación.
¿Cómo evitan duplicados?
Usamos idempotency keys y dedupe keys estables (purchase/reference/event_class). Además guardamos cursor checkpoints para sincronización incremental.
¿La entrega incluye código ejecutable?
Sí. Nuestro enfoque es entregar implementación funcional para AIS/PIS (cuando aplique) y normalización BNPL/rewards/loans, junto con pruebas y documentación para QA.
Aplicación original (colapsada): tbi bank + información legal
tbi bank es una experiencia de banca móvil pensada para ayudarte a comprar, pagar y gestionar tu dinero de forma inteligente. Puedes abrir una cuenta gratuita en EUR, realizar transferencias y retirar en cajeros con condiciones favorables según los términos del producto. En la app puedes activar tu shopping limit para tener fondos extra disponibles en el momento y dividir tus compras en 3, 6 o 12 cuotas desde el teléfono.
- Activa el shopping limit desde la neon card y controla si el pago sale de fondos personales o del propio shopping limit.
- Divide cada compra en 3, 6 o 12 cuotas para ajustar el flujo del mes.
- En 2024 se añadió la opción de retirar efectivo desde el shopping limit (cash-out), con período de hasta 50 días sin intereses.
- Solicita un préstamo personal desde la app.
- Gestiona tus obligaciones, paga cuotas e incluso solicita un payment holiday.
- Incluye herramientas para controlar tu presupuesto con foco en tus pagos y fechas.
- Explora cientos de tiendas online dentro de la sección Shopping y encuentra ofertas por categoría.
- Obtén devolución en forma de rewards: hasta un 10% en compras elegibles según ofertas de comercio.
- Modelamos rewards como un ciclo de estado (pendiente → disponible → transferible a tu cuenta neon) para usar en reporting.
Nota: la versión griega de la app aún no ofrece todos los servicios mencionados arriba, pero se espera que estén disponibles pronto. Para integración esto significa diseñar feature flags y comportamientos de fallback por región.
TBI Bank EAD, headquarters y dirección para correspondencia: Sofia 1421, Lozenets district, 52 - 54 Dimitar Hadjikotsev Street, e-mail: office@tbibank.bg, website: www.tbibank.bg. Registrada en el Commercial Register en la Registry Agency at the Ministry of Justice con UIC 131134023, autorizada como banco y realizando actividad bancaria según License No B 30 y órdenes RD 22 - 1067 / 13.08.2003, No RD 22 - 1067 / 12.06.2007, RD 22 - 1560 / 20.07.2007, RD 22 - 2270 / 16.11.2009, RD 22 - 0451 / 28.02.2012 y RD 22 - 0451 / 22.10.2012 del BNB.