Cuándo lo necesitas
Necesitas el Courier cuando tu institución opera más de un motor en el mismo ISPB y en el mismo canal JD. El caso más común es una migración. Mueves cuentas de tu core actual al stack de Lerian en olas, y los dos motores operan al mismo tiempo. El Courier cubre dos rieles:
- SPB (TED). El Courier lee los mensajes SPB que JD guarda para tu institución y entrega cada uno a su motor. Los motores envían sus propios mensajes SPB a JD a través del Courier.
- Pix. JD envía al Courier las llamadas Pix entrantes de tu institución. El Courier entrega cada llamada a su motor y reenvía a JD la respuesta del motor. El Courier no envía solicitudes Pix a JD.
Qué garantiza el Courier
- Un dueño para cada cuenta. Un mapa de titularidad explícito le dice al Courier qué motor es dueño de cada cuenta. El mapa acepta un dueño para cada clave. El Courier entrega cada mensaje financiero a un motor.
- Los mensajes no enrutados quedan retenidos. Cuando el Courier no puede enrutar o entregar un mensaje que guardó, retiene el mensaje. El Courier no acredita un mensaje retenido y no lo devuelve a BACEN. Tu operador ve cada mensaje retenido con su motivo y su antigüedad.
- Un mensaje retenido por una causa de enrutamiento o de entrega sale por la decisión de enrutamiento. Cuando una causa de enrutamiento o de entrega desaparece, el Courier enruta el mensaje de nuevo por su cuenta. Un operador también puede pedir una nueva decisión de enrutamiento, con un motivo. El operador nunca elige el motor.
- Una validación de cuenta que el Courier no puede enrutar se rechaza en la misma llamada. JD recibe
AC03oAB09. Una validación ocurre antes de la liquidación, así que no se mueve dinero. - Mover una cuenta es un cambio de configuración. Un operador mueve una cuenta de un motor a otro a través de la API. El movimiento exige un motivo, y el Courier lo registra en un historial de auditoría.
Qué no hace el Courier
- El Courier no crea mensajes de pago. Cada mensaje SPB que el Courier envía a JD viene de un motor.
- El Courier no accede a un ledger y no guarda saldos. Cada motor lleva sus propios libros.
- El Courier no decide si un motor acepta o rechaza un pago. Reenvía la respuesta del motor.
Cómo se ejecuta
El Courier se ejecuta en tu propia nube (BYOC) o en Lerian Cloud, donde Lerian lo opera. Usa su propia base de datos PostgreSQL. Un binario se ejecuta en cuatro roles, y el chart de Helm ejecuta cada rol como un despliegue propio:
La configuración está en Despliegue y configuración.
Por dónde empezar
- Cómo funciona el enrutamiento: el mapa de titularidad, las reglas de enrutamiento de cada riel y qué pasa con un mensaje que el Courier no puede enrutar.
- Conectar un motor: qué cambia e implementa el equipo de cada motor para trabajar detrás del Courier.
- Despliegue y configuración: el chart de Helm, los cuatro roles y las variables de entorno.
- Operación diaria: el trabajo de tu operador, desde los mensajes retenidos hasta los movimientos de cuentas.
- La referencia de la API y la lista de errores de JD Courier.

