Volver a proyectos
Flujo de pago SINPEIngeniero de Software

SINPE Bridge — Sistema de Pagos

Módulos que coordinan captura de mensajes, tokens, validación y conciliación de pagos SINPE para comercios. Backend central + app móvil + gateway de seguridad.

Desafío

Hacer que pagar con SINPE sea un flujo claro, trazable y confiable para comercios. El problema no es técnico en abstracto: es operativo. Los pagos llegan por SMS, necesitan capturarse, correlacionarse con órdenes, deduplicarse y registrarse con auditoría, todo sin perder consistencia.

Solución

Se diseñó una arquitectura por módulos con responsabilidades claras: sinpe-bridge-api como backend central, proxy-apy-bridgesimpe como gateway de seguridad, simpe-bridge-appmovil como colector Android de SMS, sinpe-bridge-kiosk como interfaz de comercio y simpe-bridge-bruno como colección de pruebas de integración.

Arquitectura y decisiones

Separación entre captura, seguridad, lógica de negocio y persistencia. Interfaz explícita entre frontends, workers y backend central. Enfoque en trazabilidad, idempotencia y manejo consistente de errores. Adaptadores pequeños alrededor de una lógica central de negocio.

Testing y calidad

Se validaron flujos críticos: creación de órdenes, recepción de pagos, conciliación, seguridad del proxy y respuestas de error. Pruebas manuales de integración con colección Bruno para confirmar que el flujo completo se mantuviera estable entre módulos.

Impacto

La solución centralizó un flujo que normalmente estaría repartido entre procesos manuales o herramientas aisladas. Menos fricción operativa, mejor seguimiento de pagos y mayor claridad para soporte y auditoría.

Puntos clave

  • Diseñé arquitectura por módulos con responsabilidades separadas: captura, seguridad, lógica de negocio y persistencia
  • Desarrollé backend central con FastAPI + PostgreSQL para validar, correlacionar y conciliar pagos
  • Implementé gateway de seguridad con Cloudflare Workers como proxy hacia la API
  • Construí app Android en Kotlin para captura y trazabilidad de SMS de pago