Waylet (Repsol): integración API y exportación PSD2

Lista de entregables

• Especificación OpenAPI 3.1 para cada endpoint
• Informe de protocolo y flujo de autenticación (challenge SCA, refresh de token, vinculación de dispositivo)
• Código fuente ejecutable para login, extracto, sesión EV y endpoints de fidelización (Python y Node.js)
• Plantilla de receptor de webhooks para eventos de sesión de carga y de pago
• Colección Postman más suites de pruebas pytest / vitest
• Brief de cumplimiento que cubre PSD2, RGPD y obligaciones de la LOPDGDD española

Modelos de contratación

• Entrega de código fuente desde 300 $ — código ejecutable más documentación; pago solo tras aceptación.
• API gestionada con pago por llamada — invoca nuestros endpoints Waylet gestionados con facturación por uso y sin coste inicial.
• Iguala personalizada — para operadores de flotas, comercializadoras de energía y proveedores de ERP que necesiten actualizaciones continuas del protocolo a medida que la app evoluciona.

1 — Conciliación de tarjetas de combustible para flotas

Un operador logístico da a sus conductores cuentas Waylet en lugar de tarjetas físicas de combustible. Cada noche, nuestro conector recoge las transacciones de repostaje y las sesiones de recarga eléctrica por conductor, las normaliza a un extracto estilo camt.053 y las inserta en el TMS del operador. Resultado: visibilidad el mismo día en lugar de extractos semanales de tarjeta.

2 — Cross-sell de comercializadoras de energía

Una comercializadora que opera la tarifa Waylet Luz quiere atribuir el ahorro doméstico de electricidad al comportamiento en estaciones de servicio. Exponemos un flujo unificado de saldo y ahorros para que el CRM de la comercializadora puntúe a los clientes por valor combinado de cartera energía + movilidad y dispare ofertas dirigidas.

3 — Sincronización con contabilidad y ERP (SAP / Odoo)

Los equipos financieros necesitan cada ticket de Repsol como factura contabilizada. Nuestro adaptador mapea el recibo electrónico de Waylet — IVA, tipo de carburante, NIF de la estación — a apuntes F-43 de SAP S/4HANA o a facturas de proveedor de Odoo, eliminando la entrada manual de tickets para los administrativos contables.

4 — Analítica de movilidad eléctrica y reporte de carbono

Una startup de analítica de movilidad construye cuadros de CO₂ ahorrado para clientes corporativos. Los eventos de sesión de recarga eléctrica de Waylet aportan kWh entregados, tarifa por franja horaria y mix renovable, que la plataforma convierte en desplazamiento de alcance 1 y huella de alcance 2 ponderada por la red.

5 — Monitorización de fraude y auditoría PSD2

Un proveedor de cumplimiento de pagos consume nuestro flujo de eventos de autenticación de Waylet — tipo de challenge SCA, fingerprint de dispositivo, señal geográfica — para detectar intentos de login anómalos casi en tiempo real y para ensamblar la traza de auditoría que los supervisores de PSD2 piden cada vez más a los proveedores regulados.

1. Login SCA PSD2 (por etapas)

// Step 1: initiate
POST /api/v1/waylet/auth/init
Content-Type: application/json
{
  "username": "user@example.es",
  "password": "<hashed>",
  "device_id": "uuid-...",
  "platform": "android"
}
=> 200 { "challenge_id": "ch_...", "factor": "otp_sms" }

// Step 2: respond to SCA challenge
POST /api/v1/waylet/auth/challenge
{ "challenge_id": "ch_...", "code": "482931" }
=> 200 {
  "access_token": "...",
  "refresh_token": "...",
  "expires_in": 1800,
  "scope": "wallet statements ev_sessions"
}

2. Consulta de extracto / transacciones

POST /api/v1/waylet/statement
Authorization: Bearer <ACCESS_TOKEN>
{
  "from_date": "2026-04-01",
  "to_date":   "2026-04-30",
  "types":     ["FUEL", "EV_CHARGE", "PARKING"],
  "page":      1,
  "page_size": 100
}
=> 200 {
  "items": [{
    "tx_id": "wl_3xN...",
    "type": "EV_CHARGE",
    "station_id": "ES-MAD-0142",
    "kwh": 38.4,
    "amount_eur": 16.27,
    "balance_credit_eur": 16.27,
    "occurred_at": "2026-04-12T18:24:11+02:00"
  }],
  "page": 1, "total": 73
}

3. Webhook de sesión de recarga eléctrica

POST https://your-app.example/webhook/waylet
X-Waylet-Signature: t=...,v1=...
{
  "event": "ev_session.completed",
  "session_id": "evs_91a...",
  "user_ref": "u_77f...",
  "connector": "CCS2",
  "started_at": "2026-04-12T18:02:09Z",
  "ended_at":   "2026-04-12T18:24:11Z",
  "kwh": 38.4,
  "tariff": "REPSOL_PUBLIC_FAST",
  "amount_eur": 16.27,
  "credit_eur": 16.27
}
// On 5xx we retry with exponential backoff up to 24h.

Normativa que aplicamos

Waylet opera bajo la Directiva europea revisada de Servicios de Pago, transpuesta en España mediante el Real Decreto-ley 19/2018 supervisado por el Banco de España, que exige Autenticación Reforzada de Cliente (SCA) en el login y en la mayoría de los eventos de pago. Nuestras integraciones preservan el flujo SCA completo en lugar de eludirlo.

El tratamiento de datos personales se alinea con el RGPD de la UE y con la LOPDGDD española (Ley Orgánica 3/2018). Los datos de tarjeta nunca atraviesan nuestros sistemas en claro: el stack de Repsol adquiere a través de PAYCOMET, procesador certificado PCI-DSS Nivel 1, y nosotros propagamos únicamente referencias tokenizadas.

Cómo mantenemos seguras las integraciones

• Acceso solo con autorización del usuario — captura explícita de consentimiento y API de revocación.
• Minimización de datos: tokens con scope acotado (p. ej. solo statements, sin payments).
• Cifrado en tránsito (TLS 1.2+) y en reposo (AES-256) para cualquier payload cacheado.
• Log de auditoría completo de cada llamada a API, exportable para revisiones del supervisor PSD2.
• Residencia de datos opcional solo en la UE y ventanas de retención configurables.

Sobre nosotros

OpenFinance Lab es un estudio técnico independiente centrado en análisis de protocolo de apps e integración OpenData / OpenFinance. Nuestros ingenieros provienen de adquirencia, banking-as-a-service, plataformas de movilidad y reverse-engineering, y hemos entregado integraciones para apps de pago de España, la UE, Reino Unido, LATAM y Asia.

• Backends de pagos, banca digital, retail de combustible y recarga EV
• Pasarelas de API empresariales, revisiones de seguridad y soporte de auditoría PSD2
• SDKs personalizados en Python, Node.js y Go con harness de pruebas completo
• Pipeline end-to-end: análisis de protocolo → build → validación → brief de cumplimiento
• Entrega de código fuente desde 300 $ — código ejecutable y documentación completa; pago solo tras aceptación
• API gestionada con pago por llamada — facturación por uso, sin coste inicial

Contacto

Para solicitar un presupuesto, compartir documentación de NDA o enviar el alcance de tu integración Waylet, abre nuestra página de contacto:

Página de contacto

Flujo de trabajo del proyecto

1. Confirmación de alcance: escenarios de integración y necesidades de API (login, extractos, sesiones EV, fidelización).
2. Análisis de protocolo y diseño de la API (2–5 días laborables, según número de factores SCA).
3. Build y validación interna (3–8 días laborables), incluidas firma de webhooks y pruebas de replay.
4. Documentación, peticiones de ejemplo y casos de prueba end-to-end (1–2 días laborables).
5. Primera entrega normalmente en 5–15 días laborables; revisiones de terceros pueden ampliar plazos.

FAQ

¿Qué datos de Waylet se pueden extraer realmente mediante una integración por API?

¿Cómo gestionáis la Autenticación Reforzada de Cliente (SCA) de PSD2?

¿Cuál es el plazo típico de entrega?

¿Soportáis casos de uso de flotas, ERP y contabilidad?