Resumen de arquitectura
Cómo encajan los servicios de Core y cómo fluye una petición de extremo a extremo.
Core se compone de cuatro servicios que trabajan juntos para mantener saldos, emitir tarjetas, definir límites y mover dinero: un ledger que lleva la contabilidad, un servicio de emisión de tarjetas que crea y autoriza tarjetas, un servicio de controles de gasto que decide qué pueden hacer las tarjetas y un servicio de dispersiones que saca el dinero. Cada llamada a la API pasa por el mismo pipeline de autenticación, idempotencia y enrutamiento antes de llegar al servicio dueño de la petición.
Esta página describe ese pipeline. Es el punto de partida correcto si quieres entender qué pasa entre la petición de un cliente y el webhook que recibe tu sistema.
Servicios
| Servicio | Responsabilidad |
|---|---|
| Ledger | Contabilidad de partida doble — cuentas, transacciones, holds, settlements, conciliación. |
| Tarjetas | Emisión de tarjetas virtuales y físicas, activación, congelamiento, reposición, provisión a billeteras. |
| Controles de gasto | Decisiones de autorización en tiempo real por tarjeta según límites, categorías y reglas. |
| Dispersiones | Dispersión a cuentas internas de ledger o a destinos externos a través de los rieles de Banking. |
Ciclo de vida de una petición
Cada petición a Core sigue los mismos cinco pasos:
- Autenticar — se valida el API key del header
Authorization. - Verificar idempotencia — si
X-Idempotency-Keyestá presente, se devuelve la respuesta cacheada para claves conocidas. - Enrutar al servicio dueño — según el path de la URL.
- Ejecutar y responder — el servicio escribe en el ledger, devuelve el resultado y hace commit de forma síncrona.
- Disparar webhooks — los eventos async se despachan a tu endpoint registrado.
Modelo multi-tenant
Cada cliente de Mono es un tenant. Todos los recursos de Core — cuentas de ledger, tarjetas, dispersiones — tienen scope de tenant. No hay visibilidad entre tenants.
Siguientes pasos
- Autenticación — credenciales y headers.
- Ledger — la base sobre la que se construye Core.
- Ejemplo de integración — recorrido realista.