Idempotencia en cada orden
Un reintento nunca genera un segundo cobro.
Núcleos propios
Plataforma de cobros QR vía API
Una sola API para cobrar con QR, sin importar el banco.
.NETPostgreSQLAngularPrimeNG
El desafío
Varias aplicaciones necesitaban cobrar con QR interbancario. Cada banco expone una API distinta, las confirmaciones llegan de forma asíncrona y la conciliación se hacía revisando movimientos a mano. Integrar cada sistema directamente con cada banco multiplicaba el trabajo y el riesgo.
Cómo lo resolvimos
Construimos una plataforma multiempresa que ofrece un contrato de API estable. Detrás, un adaptador por banco traduce ese contrato. Los sistemas cliente solo crean órdenes y reciben avisos firmados; nunca hablan con el banco.
Arquitectura
Cómo está construido.
Vista simplificada de los componentes y del recorrido de la información.
01
Sistemas del cliente
ERP o tienda en línea
App móvil
02
API pública
Órdenes idempotentes
API keys por aplicación
03
Núcleo
Worker y conciliación
Webhooks firmados
04
Bancos
Adaptador banco A
Adaptador banco B
.NETPostgreSQLAngularPrimeNGWebhooksDockerCaddyOpenAPI
Decisiones técnicas
Por qué lo hicimos así.
Adaptador por banco
Agregar o cambiar de banco no afecta a los sistemas que ya integraron.
Servicios separados
API pública, panel, recepción de avisos bancarios y worker escalan y fallan de forma independiente.
Webhooks firmados con reintentos
Los sistemas cliente pueden verificar el origen y no pierden confirmaciones.
Credenciales bancarias cifradas
Los secretos de cada empresa se guardan cifrados y cada acción queda auditada.
Resultado
Lo que cambió.
- Integrar un sistema nuevo es consumir una API documentada con colección de pruebas.
- Cada cobro tiene trazabilidad completa: orden, QR, confirmación y aviso.
- Respaldos automáticos, health checks y guía de despliegue en VPS.
¿Listo para construir lo que sigue?
Encontremos la solución correcta para tu empresa.
Cuéntanos tus objetivos y un ingeniero del equipo te responderá personalmente.