Integración API de KEKS Pay y OpenData/OpenFinance

1) API del libro de transacciones (OpenData)

Convertimos señales sueltas en un contrato de ledger: `occurred_at`, `direction`, `amount`, `currency`, `reference_id` y `category` para evitar discrepancias de contabilidad.

Caso de uso: reportes diarios de actividad y alertas operativas cuando el estado de pago cambie.

2) Feed de conciliación QR y estado de pedidos

Mapeamos las entidades del ecommerce (como out_trade_no) contra los eventos normalizados para que el “paid → reconciled” sea verificable.

Caso de uso: backoffice que cierra automáticamente pedidos y genera archivos para finanzas.

3) Sincronización de parking por GPS

Exportamos sesiones como registros estructurados para reembolso corporativo, con vínculos a identificadores de vehículos y comprobantes.

Caso de uso: control de gastos de flota con auditoría y trazabilidad.

4) Integración de recargas ENC

Modelamos cada recarga como asiento contable: además de total y moneda, preservamos el contexto temporal para conciliación entre periodos.

Caso de uso: agregación de costes de viaje con “importe neto” y explicación de diferencias.

5) Facturas y donaciones con exportación por proveedor

Separar “factura vs donación” reduce errores de reporte y mejora el cumplimiento de privacidad/retención al conservar sólo lo necesario para normalizar.

Caso de uso: reporting de proveedores y auditoría por categorías.

6) Eventos de tarjeta KEKSICA

Emitimos eventos ligados al instrumento de pago para KPIs por tarjeta y soporte operativo cuando un usuario bloquea/desbloquea la tarjeta en la app.

Caso de uso: tableros de gasto y trazabilidad operativa.

Beneficios principales para equipos de integración

En lugar de tratar KEKS Pay como una caja negra, construimos una capa de interfaz que vuelve predecibles los datos financieros. Cada módulo se documenta con ejemplos de solicitud/respuesta y un plan de pruebas para mantener la estabilidad cuando cambie el protocolo o la UI.

• Normalización OpenData: campos consistentes para importes, referencias, comisiones y tipo de producto.
• Seguridad operativa: claves de idempotencia y estrategia de reintentos para evitar doble conteo.
• Auditoría: registros mínimos y trazabilidad para soporte y control de cambios.
• Entrega real: especificación de API + código fuente ejecutable + documentación.

Instrucciones de integración (cómo lo conectamos)

Tú defines el caso de uso (por ejemplo: exportación OpenData de transacciones, feed de conciliación QR, sincronización de parking GPS o importación diaria de CSV). Luego traducimos el flujo autorizado de la app a un contrato claro para tu backend.

Proceso típico: consentimiento/sesión → ingestión autorizada → normalización y validación → salida por API. Incluimos checklist de regresión para que tu equipo verifique la consistencia tras actualizaciones.

Inventario de datos (perspectiva OpenData)

Estos objetos financieros se observan en los flujos de usuario y en los flujos de comercio/merchant. Nuestro objetivo es transformarlos a un contrato de OpenData/OpenFinance para conciliación, reporting y auditoría.

Escenarios típicos de integración

Cada escenario incluye contexto de negocio, qué datos/API expones y cómo se traduce a OpenData/OpenFinance.

Implementación técnica (ejemplos)

Los siguientes fragmentos muestran cómo trabajamos el contrato de integración. Sirven como referencia de implementación; la meta es que tu backend reciba payloads normalizados y errores manejables.

// 1) Merchant QR: creación de orden (ejemplo de adaptador)
POST https://devwebpayment.kesspay.io/api/mch/v1/gateway
Content-Type: application/json
Authorization: Basic <base64(username:password)>

{
  "service": "webpay.acquire.createorder",
  "sign": "<generated signature>",
  "sign_type": "HMAC-SHA256",
  "seller_id": "<your_seller_id>",
  "out_trade_no": "KEXS-2026-000123",
  "body": "Order payment",
  "total_amount": "39.90",
  "currency": "EUR"
}

// 2) Importación CSV diario: mapeo de campos y reversos (STORNO)
DATUM_TRANSAKCIJE, INTERVAL_IZVJESTAJA, DATUM_ISPLATE, IZNOS, PROVIZIJA,
TID, PNB_ISPLATE, OPIS_TRANSAKCIJE, KEKS_ID, REFERENCA

is_reversal = row.OPIS_TRANSAKCIJE contains "STORNO"
type = is_reversal ? "REVERSAL" : "SALE"
emit {"transaction_id": row.KEKS_ID, "tid": row.TID, "settlement_date": parse(row.DATUM_ISPLATE), "commission": to_decimal(row.PROVIZIJA), "type": type}

// 3) Idempotencia + reintentos / manejo de errores
POST /api/v1/keks-pay/orders/query
{
  "order_reference": "<order_reference>",
  "idempotency_key": "query:KEXS-2026-000123",
  "max_retries": 5
}

{ "status":"partial", "retry_after_seconds":120, "errors":[{"code":"RATE_LIMITED","message":"Too many queries"}] }

Detalle clave: idempotencia por `out_trade_no`/`KEKS_ID`, validación estricta de campos y mapeo determinista desde descripciones reales (incluyendo `STORNO`) hacia tipos contables OpenData para evitar doble contabilización.

Cumplimiento y privacidad (alineado a la UE)

KEKS Pay se desarrolla en un entorno regulatorio afectado por PSD2 (Payment Services Directive 2) y por obligaciones de privacidad alineadas con GDPR. Para la integración, la regla práctica es: acceso autorizado, minimización de datos y trazabilidad de auditoría para reconciliación y operación segura.

La seguridad de la app incluye comunicación cifrada (HTTPS/SSL) y autenticación del usuario mediante PIN o biometría. Nosotros lo reflejamos con sesiones de alcance, registros con identificadores necesarios y ventanas de retención que cubren normalización y reporting, evitando mantener raw data indefinidamente.

Flujo de datos / arquitectura

App/merchant → adaptador de ingestión (recuperación autorizada por protocolo) → almacenamiento seguro (encriptado + tablas OpenData) → salidas por API para analítica y contabilidad (eventos y endpoints de conciliación).

Posicionamiento de mercado y perfil de usuario

KEKS Pay está orientado a usuarios móviles en Croacia/EMEA: combina transferencias por teléfono, pagos QR en tiendas y webshops, y “servicios de la vida” como parking GPS y recargas ENC. Además, es apto para integraciones B2B porque el comercio opera en ecosistemas de plugins (WooCommerce y Magento 2), donde tu sistema necesita datos normalizados para reconciliación y cierres.

Entregables y qué recibes

Entregamos un paquete de integración utilizable, no sólo un informe. Empezamos con un “vertical slice” (por ejemplo ledger + conciliación QR) para que puedas validar rápido, y después expandimos módulos OpenData/OpenFinance.

• Especificación de API (estilo OpenAPI/Swagger).
• Informe de protocolo y autorización.
• Código fuente ejecutable (Python/Node.js/Go según tu backend).
• Plan de pruebas automatizadas (ledger, QR settlement, import CSV).
• Notas de compliance (alcance, logs, minimización).
• Documentación de integración para dev y QA.

Sobre nuestro estudio

Somos un estudio técnico especializado en integración de interfaces de apps e integración API autorizada. Combinamos análisis de protocolo, refactorización de interfaces, mapeo OpenData/OpenFinance y documentación profesional para llevar tu proyecto de comprensión a producción.

El equipo reúne experiencia práctica en apps móviles y fintech, incluyendo workflows de análisis, normalización de datos de pagos y estrategias de test que mantienen la salida estable con el tiempo.

Entregamos interfaces verificables: contrato de campos, errores/“partial failures” y reglas de no duplicación (idempotencia) para que la conciliación no sufra divergencias.

• Entrega “compliant-by-design” con privacidad y retención claras.
• Foco Android/iOS con código listo para integración y planes de prueba.
• Soporte integral: análisis → implementación → validación → documentación.
• Precio transparente: desde $300, opción de entregar primero y pagar tras satisfacción.

Información de contacto

Comparte el nombre del app objetivo (KEKS Pay ya está configurado) y tus necesidades (exportación OpenData, feed de conciliación QR, sincronización de parking GPS, conciliación de ENC, o import de CSV diario). Para los siguientes pasos, visita:

Ver contacto

Flujo de trabajo y pasos de propuesta

1. Alineación de requisitos: confirma los alcances (ledger, QR settlement, parking GPS, ENC, facturas, import de CSV de merchant) y métricas de éxito.
2. Análisis de protocolo y diseño: entregamos plan de mapeo y contrato de endpoints (2–5 días hábiles según complejidad).
3. Implementación y verificación interna: módulo de ingestión y salida API normalizada (3–8 días hábiles).
4. Entrega final: especificación, código, documentación y tests (1–2 días hábiles).
5. Soporte de regresión (opcional): parches si KEKS Pay actualiza protocolo o flujos.

Un primer “vertical slice” suele requerir 5–15 días hábiles; los flujos regulados o aprobaciones adicionales pueden ampliarlo.

FAQ

¿Qué necesito aportar?

¿Cómo aseguran el cumplimiento?