Banca Móvil LABORAL Kutxa — Integración de API y servicios OpenFinance

1. APIs de cuentas y movimientos

Envuelve los endpoints XS2A accounts, balances y transactions tras una única superficie REST. Devuelve IBAN, divisa, código de producto, saldo de apertura/cierre y, por línea, nombre del ordenante, información de la remesa, fecha valor e identificador end-to-end. Se utiliza para conciliación bancaria automatizada en herramientas como Holded, Sage 50, Odoo o un módulo ERP a medida.

2. Movimientos de tarjeta y geolocalización

Refleja las pantallas de tarjeta de Banca Móvil que muestran cada compra con la ubicación del comercio en un mapa. Exponemos el mismo payload —PAN enmascarado, código de categoría de comercio (MCC), estado de autorización, geolocalización— para monitorización antifraude, gestión de gastos o backends de fidelización.

3. Conciliación Bizum y LK-Pay

Bizum está integrado de forma nativa en la app de Laboral Kutxa y es uno de los raíles de dinero móvil dominantes en España (cubre cerca del 99 % de los titulares de cuenta corriente). Nuestro adaptador une los eventos de recepción Bizum al libro mayor de la cuenta subyacente, de modo que puedes conciliar abonos P2P contra pedidos de marketplace, donaciones o campañas de ONG.

4. Valores, préstamos DISPON y seguros

Lee la cartera bursátil del usuario (posiciones, órdenes en vigor, última cotización), expone las ofertas de préstamo preconcedido DISPON y proporciona las pólizas de seguro activas con el estado de los siniestros. Útil para cuadros de mando de patrimonio o para integrar los datos de Laboral Kutxa en un PFM multibanco.

5. Localizador de oficinas/cajeros y asistencia

Desde 2024 el localizador de oficinas y cajeros de la app incluye una capa de Realidad Aumentada; nosotros exponemos el mismo conjunto de datos (latitud, longitud, horario, servicios disponibles) como un feed GeoJSON plano, de modo que apps de quiosco, asistentes white-label y chatbots pueden responder a "oficina más cercana de Laboral Kutxa" sin necesidad de scraping.

6. Iniciación de transferencia SEPA Credit Transfer

Implementa la iniciación XS2A payments/sepa-credit-transfers incluyendo flujos SCA por redirección/desacoplados, sondeo de estado y cancelación. Devuelve el paymentId y el identificador end-to-end para sistemas de facturación aguas abajo.

Escenario A — Tesorería multibanco para pymes vascas

Muchas cooperativas del entorno de Mondragón mantienen su cuenta corriente principal en Laboral Kutxa y una secundaria en Kutxabank o BBVA. Extraemos balances y los últimos 90 días de transactions de cada perfil XS2A, los normalizamos a un único esquema de libro mayor y publicamos un informe diario de posición de caja en Slack o Microsoft Teams. La pieza OpenFinance: un consentimiento por banco, una vista de tesorería unificada, sin descargas manuales de CSV.

Escenario B — Conciliación de facturas con Bizum

Una tienda online acepta Bizum sobre una cuenta de comercio en Laboral Kutxa. Cada abono Bizum entrante aterriza en la cuenta corriente con una línea de remesa que incluye el ID de pedido. Nuestro adaptador escucha (mediante short-poll sobre /transactions), extrae el ID de pedido con un contrato regex y marca la factura correspondiente como PAGADA dentro del ERP del comercio. La palanca "OpenData" es el casado automático de extremo a extremo sin pasarela de pago intermedia.

Escenario C — Agregación de patrimonio para asesor independiente

Un asesor patrimonial regulado en Donostia consolida posiciones de clientes entre Laboral Kutxa, Bankinter y Renta 4. Leemos la cartera de valores (posiciones, órdenes en vigor, última cotización) bajo consentimiento AISP explícito, refrescamos por la noche y alimentamos un cuadro de mando de atribución de cartera. Como Laboral Kutxa expone la parte broker bajo el mismo login, un único consentimiento cubre efectivo y valores conjuntamente.

Escenario D — Asistencia embebida para corredor de seguros

La app de Laboral Kutxa ya integra envío de grúa y cerrajero dentro de su sección de seguros. Replicamos ese flujo en el portal propio del corredor: leer la póliza activa vía el protocolo, abrir un siniestro y disparar el número de asistencia, sin devolver al cliente a la app del banco. El enfoque de análisis de protocolo mantiene las credenciales del usuario dentro de la sesión bancaria y solo replica los datos visibles.

Escenario E — Feed de auditoría con grado de cumplimiento para un agregador fintech

Un AISP autorizado en la UE necesita demostrar a su regulador que cada consentimiento, cada refresco y cada versión de dataset es trazable. Entregamos una tabla de log inmutable (ID de consentimiento, alcance, evento SCA, hash de respuesta, marca temporal) sobre el adaptador de Laboral Kutxa, mapeada a la taxonomía de reporte PSD2 de la EBA.

1. Consentimiento y listado de cuentas (PSD2 XS2A, Berlin Group)

# Step 1 — create an AIS consent against the Redsys hub
POST https://psd2-sandbox.redsys.es/api-entrada-xs2a/services/laboralkutxa/v1.1/consents
X-Request-ID: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721
PSU-IP-Address: 203.0.113.10
TPP-Redirect-URI: https://your-app.example/callback
Content-Type: application/json
Authorization: Bearer <TPP_QWAC_BEARER>

{
  "access": {
    "balances": [{"iban": "ES9130350031121234567890"}],
    "transactions": [{"iban": "ES9130350031121234567890"}]
  },
  "recurringIndicator": true,
  "validUntil": "2026-10-30",
  "frequencyPerDay": 4
}

# Response
{ "consentId": "f1c8...c3", "consentStatus": "received",
  "_links": { "scaRedirect": { "href": "https://..." } } }

2. Exportación de extractos (ventana de 90 días, paginada)

# Step 2 — pull booked + pending transactions
GET /api-entrada-xs2a/services/laboralkutxa/v1.1/accounts/{account-id}/transactions
    ?bookingStatus=both&dateFrom=2026-02-06&dateTo=2026-05-06
Consent-ID: f1c8...c3
X-Request-ID: 11d47b...
Authorization: Bearer <TPP_QWAC_BEARER>

# Response (excerpt)
{
  "transactions": {
    "booked": [
      { "transactionId": "TX-2026-04-29-001",
        "bookingDate": "2026-04-29", "valueDate": "2026-04-29",
        "transactionAmount": {"amount": "-42.30", "currency": "EUR"},
        "creditorName": "EROSKI BIDEBARRIETA",
        "remittanceInformationUnstructured": "COMPRA TARJETA 4548**1234"
      }
    ],
    "pending": [],
    "_links": {"next": {"href": "...&page=2"}}
  }
}

3. Iniciación SEPA Credit Transfer + SCA

# Step 3 — initiate a single SEPA payment
POST /api-entrada-xs2a/services/laboralkutxa/v1.1/payments/sepa-credit-transfers
TPP-Redirect-URI: https://your-app.example/sca-return
PSU-IP-Address: 203.0.113.10
Content-Type: application/json

{
  "instructedAmount": {"amount": "150.00", "currency": "EUR"},
  "debtorAccount": {"iban": "ES9130350031121234567890"},
  "creditorAccount": {"iban": "ES7100750000010599999999"},
  "creditorName": "Cooperativa Mondragon SCL",
  "remittanceInformationUnstructured": "Invoice 2026-04-117"
}

# Response
{ "transactionStatus": "RCVD",
  "paymentId": "PMT-2026-05-06-981",
  "_links": { "scaRedirect": {"href": "https://..."},
              "self": {"href": "/payments/sepa-credit-transfers/PMT-2026-05-06-981"} } }

# Error (HTTP 400)
{ "tppMessages": [{"category":"ERROR","code":"FORMAT_ERROR",
  "text":"creditorAccount.iban failed checksum"}] }

Marco regulatorio

El acceso de producción a los datos de Banca Móvil LABORAL Kutxa se rige por la Directiva europea revisada de servicios de pago (PSD2), traspuesta en España mediante el Real Decreto-ley 19/2018 y supervisada por el Banco de España, junto con las RTS de la EBA sobre Autenticación Reforzada de Cliente. Todos los flujos que entregamos circulan sobre el hub NextGenPSD2 XS2A alojado por Redsys y publicado por el Berlin Group, con eIDAS QWAC para el transporte y QSeal allí donde se requiere firma. La información oficial del nodo está publicada en Información APIS de LABORAL Kutxa.

Privacidad y minimización de datos

Los datos personales extraídos de la app —IBANs, nombres, movimientos— quedan bajo el RGPD de la UE y la LOPDGDD española. Nuestro adaptador registra el alcance del consentimiento, la ventana de validez (≤180 días) y los eventos de renovación SCA. Los PAN de tarjeta se tokenizan en la ingesta; solo PAN enmascarados y BINs salen del perímetro del lado del banco.

Quiénes somos

OpenFinance Lab es un estudio independiente especializado en análisis de protocolos de fintech móvil e integración de APIs de tipo OpenBanking. Nuestros ingenieros provienen de entidades de pago de la UE, adquirentes españoles y agregadores TPP, y han entregado adaptadores de calidad XS2A contra el hub de Redsys, la BBVA Open Platform y los bancos sandbox listados por la EBA. Entregamos código ejecutable en Python / Node.js / Go más la especificación OpenAPI, banco de pruebas y un dossier de cumplimiento.

• Integraciones PSD2 XS2A contra Redsys, Treezor y hubs propios de bancos
• Módulos de conciliación Bizum y SEPA Instant
• Adaptadores de datos de valores, seguros y PFM
• Trazabilidad de auditoría extremo a extremo para reporte regulatorio AISP/PISP
• Entrega de código fuente desde 300 $ — código de API ejecutable y documentación completa; pago tras la entrega y satisfacción
• Facturación API por llamada — endpoints alojados, paga solo por llamada; sin coste inicial

Contacto

Para solicitar un presupuesto, compartir un brief de integración o arrancar un adaptador de Banca Móvil LABORAL Kutxa, abre nuestra página de contacto:

Página de contacto

Solemos responder en un día hábil; NDAs disponibles bajo petición.

Flujo de trabajo del proyecto

1. Confirmación de alcance: qué superficies (cuentas, Bizum, tarjetas, valores) y qué canales de salida.
2. Puesta en marcha contra el sandbox XS2A de Redsys (1–2 días hábiles).
3. Construcción del adaptador, reintentos/backoff, ayudantes de renovación de consentimiento (3–8 días hábiles).
4. Especificación OpenAPI, tests de integración, dossier de cumplimiento (1–2 días hábiles).
5. Puesta en producción con el certificado QWAC del cliente; primera entrega en 5–15 días hábiles de extremo a extremo.

Preguntas frecuentes

¿Necesito una licencia de TPP para llamar a los endpoints PSD2 de Laboral Kutxa?

¿Cuánto suele tardar una integración con Laboral Kutxa?

¿Qué pasa con la autenticación reforzada de cliente (SCA) y su renovación bajo PSD2?

¿También podéis integrar la app LK-Pay y Bizum encima?