En las tablas siguientes, la columna Valor por defecto / Requerida muestra el valor por defecto; un calificador en negrita (por ejemplo Requerida) marca las variables que debes definir.
— significa que no hay valor por defecto. 🔒 marca un secreto: inyéctalo en el momento del despliegue desde tu almacén de secretos y nunca lo guardes en el repositorio. Esta página solo enumera los nombres de las variables y su comportamiento; no imprime ningún valor secreto.Servidor y puerto
El servicio escucha en la dirección deSERVER_ADDRESS (por defecto :8080). Las sondas de liveness, readiness y versión se enlazan a este mismo puerto. Consulta Servidor para los ajustes de servidor compartidos y Puertos de red predeterminados.
Integración con JD
Credenciales y endpoints para la API asegurada por OAuth de JD y su superficie Pix (JDPI).Hosting de código QR dinámico
El rail aloja payloads de QR dinámico firmados (JWS) y el conjunto de JWK usado para verificarlos.QRCODE_PUBLIC_BASE_URL es la base accesible desde el exterior bajo la cual se sirven esos documentos.
Vínculo con el ledger Midaz
Qué organización, ledger, activo y cuenta externa de Midaz usa este rail para contabilizar los movimientos Pix, además de los endpoints del servicio del ledger y las credenciales máquina a máquina.Rutas de transacción y operación
Los flujos Pix de cash-in, cash-out, reversa e intra-PSP se mapean a rutas de transacción y operación de Midaz con nombre. Define un valor por flujo para que el plugin contabilice cada evento Pix en la ruta correcta.OPERATION_ROUTE_CASHIN_* y OPERATION_ROUTE_CASHOUT_* representan exactamente doce variables concretas de mapeo de ruta por leg (ocho de cash-in, cuatro de cash-out). Cada una mapea un leg del pipeline a un ID de ruta de operación de Midaz; define cada una de forma explícita:Cash-in (8): OPERATION_ROUTE_CASHIN_CREDIT, OPERATION_ROUTE_CASHIN_CREDIT_QRCODE, OPERATION_ROUTE_CASHIN_CREDIT_REVERSAL, OPERATION_ROUTE_CASHIN_DEBIT, OPERATION_ROUTE_CASHIN_DEBIT_QRCODE_EXTERNAL, OPERATION_ROUTE_CASHIN_DEBIT_REVERSAL_EXTERNAL, OPERATION_ROUTE_CASHIN_REVERSAL_CREDIT, OPERATION_ROUTE_CASHIN_REVERSAL_DEBITCash-out (4): OPERATION_ROUTE_CASHOUT_CREDIT_EXTERNAL, OPERATION_ROUTE_CASHOUT_CREDIT_REVERSAL, OPERATION_ROUTE_CASHOUT_DEBIT, OPERATION_ROUTE_CASHOUT_DEBIT_REVERSAL_EXTERNALTrabajos y límites
Notificaciones
Notificaciones opcionales al cliente final para eventos Pix. Deja los bloques de proveedor sin definir para desactivar ese canal.CRM
Configuración en tiempo de ejecución (systemplane)
Este rail monta la API de administración de systemplane en su puerto principal, controlada porSYSTEMPLANE_ENABLED.
Cuando está habilitada, el servicio expone un plano autenticado para leer y escribir la configuración en tiempo de ejecución. Consulta Systemplane para la API, los espacios de nombres y los permisos requeridos.
Salud y readiness
El rail exponeGET /health (liveness) y GET /readyz (readiness) en el puerto principal, además de /metrics y /version. Cuando la multi-tenancy está habilitada (MULTI_TENANT_ENABLED=true), añade una sonda por tenant protegida por autenticación en GET /readyz/tenant/{id}. Consulta Salud y readiness para la forma de la respuesta y el comportamiento de arranque/drenaje.