Variables de entorno

DevOps define estas variables en tiempo de despliegue. Un cambio requiere reiniciar el servicio. Los ajustes de tiempo de ejecución y de negocio están en Configuración. En las tablas de abajo, la columna Predeterminado / Obligatorio muestra el valor predeterminado. Un calificador en negrita (por ejemplo Obligatorio, Obligatorio en producción, Obligatorio si está habilitado) marca una variable que debes definir. — significa que no hay valor predeterminado.

Configuración de infraestructura

Esta sección es para los equipos de DevOps. DevOps define estas variables en tiempo de despliegue. Un cambio se aplica solo después de reiniciar el servicio.

Aplicación

Variable	Predeterminado / Obligatorio	Descripción
`ENVIRONMENT_NAME`	`development`	Entorno: `production`, `staging`, `uat`, `development`, `local` o `test`. El servicio no arranca con otro valor, ni cuando `ENV_NAME`, el nombre obsoleto de esta variable, indica un entorno diferente.
`DEPLOYMENT_MODE`	`byoc`	`byoc` (Bring Your Own Cloud), `saas` o `local`, que funciona como `byoc`. El servicio no arranca con otro valor. Con `saas`, el plugin se niega a arrancar a menos que PostgreSQL, Redis, MongoDB, RabbitMQ y el broker de streaming usen TLS.
`SERVER_ADDRESS`	`:8080`	Dirección y puerto del servidor HTTP
`HTTP_BODY_LIMIT_BYTES`	`1048576`	Tamaño máximo del cuerpo de la solicitud HTTP, en bytes
`ALLOW_PRIVATE_UPSTREAMS`	`false`	⚠️ Permite que los adaptadores salientes (CRM, Fees, JD, Midaz) resuelvan a IPs RFC1918/loopback. El valor predeterminado `false` es fail-closed: producción bloquea el pivoteo por DNS hacia el espacio privado. Habilítalo en desarrollo o en BYOC dentro del clúster, donde los upstreams viven de forma legítima en IPs privadas. Se rechaza en producción. Los endpoints de metadatos de la nube siguen bloqueados sin importar este indicador.
`REQUIRE_UPSTREAM_HTTPS`	`false`	Rechaza las URLs base de CRM y Fees Engine en `http://` simple. Producción ya las rechaza; úsala en despliegues de staging, homologación y BYOC que llevan datos reales de clientes.

TLS

Variable	Predeterminado / Obligatorio	Descripción
`SERVER_TLS_CERT_FILE`	—	Ruta al archivo del certificado TLS. Debe definirse junto con `SERVER_TLS_KEY_FILE`.
`SERVER_TLS_KEY_FILE`	—	Ruta al archivo de la clave privada TLS. Debe definirse junto con `SERVER_TLS_CERT_FILE`.
`TLS_TERMINATED_UPSTREAM`	`false`	Defínela en `true` cuando el TLS termina en un balanceador de carga o proxy inverso.

Encabezados de proxy

Defínelos cuando el servicio corre detrás de un balanceador de carga o un proxy inverso. Permiten que el servicio lea la IP real del cliente para el rate limit y los logs de auditoría.

Variable	Predeterminado / Obligatorio	Descripción
`SERVER_PROXY_HEADER`	—	Encabezado HTTP que lleva la IP real del cliente (p. ej. `X-Forwarded-For`, `X-Real-IP`). Vacío deshabilita la lectura del encabezado de proxy.
`SERVER_TRUSTED_PROXIES`	Obligatorio si se define el encabezado de proxy	Lista separada por comas de IPs/CIDRs de proxies de confianza. Obligatoria cuando `SERVER_PROXY_HEADER` está definida, para evitar la suplantación de IP.

Autenticación

Este plugin delega la autorización a Access Manager. Configura la conexión con las variables de abajo.

Variable	Predeterminado / Obligatorio	Descripción
`PLUGIN_AUTH_ENABLED`	`false` · `true` obligatorio en producción	Habilita la autorización vía Access Manager. El servicio se niega a arrancar en producción con `false`.
`PLUGIN_AUTH_ADDRESS`	Obligatorio si está habilitado	URL del servicio de autenticación de Access Manager. Debe usar HTTPS en producción. Los tokens M2M de CRM y Fees Engine también vienen de esta dirección.

Cuando PLUGIN_AUTH_ENABLED=true, PLUGIN_AUTH_ADDRESS debe usar HTTPS en los entornos de producción. El servicio rechaza una dirección HTTP al arrancar.

Declaración de permisos

Al arrancar, el servicio puede publicar su declaración de permisos en el Access Manager.

Variable	Predeterminado / Obligatorio	Descripción
`IDP_DECLARATION_ENABLED`	`false`	Define `true` para publicar la declaración de permisos al arrancar.
`IDP_HOST`	—	URL del servicio Identity del Access Manager.
`IDP_M2M_CLIENT_ID`	—	El client ID con el que el servicio publica.
`IDP_M2M_CLIENT_SECRET`	—	El client secret con el que el servicio publica.

Con IDP_DECLARATION_ENABLED=true, el servicio no arranca cuando una de las otras tres variables está vacía, o cuando PLUGIN_AUTH_ENABLED no es true. Cuando el Access Manager rechaza la publicación o no responde, el servicio arranca igualmente.

Alcance de la organización

Variable	Predeterminado / Obligatorio	Descripción
`ORGANIZATION_ID`	Obligatorio con polling de JD	UUID de la organización de Midaz que se inyecta en el contexto de los workers en segundo plano (poller de TED IN, conciliación). Se ignora cuando `MULTI_TENANT_ENABLED=true`. Las solicitudes HTTP siempre llevan la organización en el encabezado `X-Organization-Id` en su lugar.
`ORGANIZATION_IDS`	Obligatorio	Lista separada por comas de UUIDs de organizaciones de Midaz en el ámbito de la licencia. El gateway de licencias valida `LICENSE_KEY` contra ellos al arrancar. También aparece en Licencia.

# Organization injected into background workers (required when JD polling is enabled)
ORGANIZATION_ID=<your-midaz-organization-uuid>
# Licensing scope validated against LICENSE_KEY
ORGANIZATION_IDS=<your-midaz-organization-uuid>

PostgreSQL

Variable	Predeterminado / Obligatorio	Descripción
`POSTGRES_HOST`	`localhost` · Obligatorio	Host principal de PostgreSQL.
`POSTGRES_PORT`	`5432`	Puerto principal de PostgreSQL.
`POSTGRES_USER`	`plugin-br-bank-transfer` · Obligatorio	Usuario de la base de datos.
`POSTGRES_PASSWORD`	Obligatorio en producción	Contraseña de la base de datos.
`POSTGRES_DB`	`plugin-br-bank-transfer` · Obligatorio	Nombre de la base de datos.
`POSTGRES_SSLMODE`	`require`	Modo SSL. En producción, debe ser `require`, `verify-ca` o `verify-full`.
`POSTGRES_MAX_OPEN_CONNS`	`25`	Número máximo de conexiones abiertas.
`POSTGRES_MAX_IDLE_CONNS`	`5`	Número máximo de conexiones inactivas.
`POSTGRES_CONN_MAX_LIFETIME_MINS`	`30`	Vida máxima de una conexión en minutos.
`POSTGRES_CONN_MAX_IDLE_TIME_MINS`	`5`	Tiempo máximo de inactividad de una conexión en minutos.
`POSTGRES_CONNECT_TIMEOUT_SEC`	`10`	Timeout de conexión en segundos.

Réplica de PostgreSQL

Configura una réplica de lectura para descargar consultas. Todos los campos recurren a los valores del principal cuando no se definen.

Variable	Predeterminado / Obligatorio	Descripción
`POSTGRES_REPLICA_HOST`	—	Host de la réplica. Sin definir = sin réplica.
`POSTGRES_REPLICA_PORT`	—	Puerto de la réplica.
`POSTGRES_REPLICA_USER`	—	Usuario de la réplica.
`POSTGRES_REPLICA_PASSWORD`	—	Contraseña de la réplica.
`POSTGRES_REPLICA_DB`	—	Nombre de la base de datos de la réplica.
`POSTGRES_REPLICA_SSLMODE`	—	Modo SSL de la réplica. Misma regla de producción que `POSTGRES_SSLMODE`.

MongoDB

El servicio usa MongoDB para guardar los eventos de auditoría de las transferencias. No arranca sin una conexión válida a MongoDB.

Variable	Predeterminado / Obligatorio	Descripción
`MONGO_ENABLED`	`true`	Habilita la conexión a MongoDB. Debe ser `true`.
`MONGO_URI`	Obligatorio	Cadena de conexión de MongoDB (p. ej. `mongodb://user:pass@host:27017`). En producción, debe incluir credenciales y TLS (`tls=true` o `mongodb+srv`).
`MONGO_DATABASE`	Obligatorio	Nombre de la base de datos de MongoDB.
`MONGO_MAX_POOL_SIZE`	`25`	Tamaño máximo del pool de conexiones.
`MONGO_SERVER_SELECTION_TIMEOUT_MS`	`3000`	Timeout de selección de servidor en milisegundos.
`MONGO_HEARTBEAT_INTERVAL_MS`	`10000`	Intervalo de heartbeat en milisegundos.
`MONGO_TLS_CA_CERT`	—	Certificado de CA codificado en base64 para el TLS de MongoDB. Úsalo cuando MongoDB requiere TLS con una CA propia (p. ej. Atlas, instancias privadas con certificados autofirmados).

Redis

Variable	Predeterminado / Obligatorio	Descripción
`REDIS_HOST`	`localhost:6379` · Obligatorio	Host y puerto de Redis.
`REDIS_MASTER_NAME`	—	Nombre del master de Redis Sentinel (si usas Sentinel).
`REDIS_PASSWORD`	—	Contraseña de Redis (si la autenticación está habilitada).
`REDIS_DB`	`0`	Número de la base de datos de Redis.
`REDIS_PROTOCOL`	`3`	Versión del protocolo de Redis (2 o 3).
`REDIS_TLS`	`false`	Habilita TLS para las conexiones a Redis.
`REDIS_CA_CERT`	—	Certificado de CA para el TLS de Redis.
`REDIS_POOL_SIZE`	`10`	Tamaño del pool de conexiones.
`REDIS_MIN_IDLE_CONNS`	`2`	Número mínimo de conexiones inactivas.
`REDIS_READ_TIMEOUT_MS`	`3000`	Timeout de lectura en milisegundos.
`REDIS_WRITE_TIMEOUT_MS`	`3000`	Timeout de escritura en milisegundos.
`REDIS_DIAL_TIMEOUT_MS`	`5000`	Timeout de conexión en milisegundos.

Redis es una dependencia obligatoria. Guarda en caché las claves de idempotencia y detecta duplicados. Si Redis no está disponible al arrancar, o deja de ser alcanzable en tiempo de ejecución, el servicio se reporta como DOWN a la sonda de readiness. Entonces deja de aceptar solicitudes.

Conexión con JD SPB

El plugin valida las variables de JD solo cuando JD_BASE_URL está definida.

Variable	Predeterminado / Obligatorio	Descripción
`JD_BASE_URL`	—	URL base de la API de JD SPB.
`JD_SOAP_PATH`	`/soap`	Ruta del endpoint SOAP de JD.
`JD_LEGACY_CODE`	Obligatorio	Código del sistema heredado de JD (máx. 10 caracteres).
`JD_USER_CODE`	Obligatorio	Código de usuario de JD (máx. 10 caracteres).
`JD_PASSWORD`	Obligatorio	Contraseña de JD.
`JD_PRIVATE_KEY_PEM`	Obligatorio para `local_pem`	Contenido PEM de la clave privada RSA (al menos 3072 bits) para la firma XML, que usa PKCS#1 v1.5 con SHA-256.
`JD_PRIVATE_KEY_PEM_FILE`	—	Ruta a un archivo con el PEM de la clave privada RSA. Alternativa a incluir la clave en `JD_PRIVATE_KEY_PEM`; se lee al arrancar.
`JD_PUBLIC_KEY_PEM`	Obligatorio para `external_provided`	PEM de la clave pública que verifica las firmas que proporciona tu sistema. Obligatorio en modo `external_provided` mientras `jdspb.validate_external_signature` esté activado (predeterminado).
`JD_PRIVATE_KEY_KEYINFO`	Obligatorio al firmar	Identificador de la clave de firma, en hexadecimal: una huella digital de certificado de 40 caracteres o un identificador de clave de 64 caracteres.
`JD_CERT_PEM`	—	Certificado X.509 opcional codificado en PEM, emparejado con la clave de firma de JD. Lo usa solo el gauge de métricas de expiración del certificado, no la ruta de firma; un PEM mal formado es un error de arranque.
`JD_SIGNING_MODE`	`local_pem`	Modo de firma SOAP. `local_pem` firma de forma local con `JD_PRIVATE_KEY_PEM`. `external_provided` toma la firma que tu sistema envía al paso de proceso. El plugin rechaza `disabled` al iniciar mientras `JD_BASE_URL` esté definida.
`JD_EXTERNAL_SIGNER_URL`	—	En modo `external_provided`, el servicio de firma al que llama el plugin cuando una solicitud de proceso no trae firma.
`JD_EXTERNAL_SIGNER_AUTH_TOKEN`	—	Token bearer que se envía en el encabezado `Authorization` de las llamadas al firmante externo.
`JD_EXTERNAL_SIGNER_TIMEOUT_MS`	`5000`	Timeout (en milisegundos) de las llamadas al firmante externo.
`JD_ALLOW_PRIVATE_NETWORK`	`false`	Permite que el adaptador de JD alcance una dirección de red privada. Los endpoints de metadatos de la nube siguen bloqueados.
`JD_SANDBOX_MODE`	`false`	Habilita el modo sandbox de JD. Solo se permite cuando `ENVIRONMENT_NAME` es `local`, `development` o `test`.

Polling de JD

Variable	Predeterminado / Obligatorio	Descripción
`JD_POLLING_ENABLED`	`false`	Habilita el worker de polling de TED IN.
`JD_POLL_INTERVAL_SECONDS`	`60`	Con qué frecuencia (en segundos) el plugin consulta si hay TEDs entrantes.
`JD_POLL_CYCLE_TIMEOUT_SECONDS`	`0`	Plazo de un ciclo de polling, de 30 a 3600 segundos. `0` lo deriva del intervalo.
`RECONCILIATION_CYCLE_TIMEOUT_SECONDS`	`0`	Plazo de un barrido de conciliación, de 30 a 3600 segundos. `0` lo deriva del intervalo del worker.
`DEVOLUTION_SCAN_CYCLE_TIMEOUT_SECONDS`	`0`	Plazo de un escaneo de devoluciones, de 30 a 3600 segundos. `0` lo deriva del intervalo del escaneo.

JD_POLLING_ENABLED tiene el valor predeterminado false para despliegues más seguros. Define ORGANIZATION_ID antes de habilitarlo. Los workers en segundo plano inyectan ese valor en el contexto para las llamadas posteriores a CRM y Midaz.

Servicios externos (Midaz)

Variable	Predeterminado / Obligatorio	Descripción
`MIDAZ_BASE_URL`	Obligatorio	URL del servicio base de Midaz.
`MIDAZ_TRANSACTION_URL`	Obligatorio	URL del servicio de transacciones de Midaz.
`MIDAZ_TIMEOUT_MS`	`3000`	Timeout de las solicitudes a Midaz en milisegundos.
`MIDAZ_MAX_RETRIES`	`3`	Intentos de reintento ante una falla de Midaz.
`MIDAZ_AUTH_ENABLED`	`false`	Habilita la autenticación M2M para Midaz.
`MIDAZ_AUTH_ADDRESS`	`PLUGIN_AUTH_ADDRESS`	URL del servicio de autenticación para los tokens M2M de Midaz.
`MIDAZ_CLIENT_ID`	Obligatorio si está habilitado	ID de cliente OAuth para el M2M de Midaz.
`MIDAZ_CLIENT_SECRET`	Obligatorio si está habilitado	Secreto de cliente OAuth para el M2M de Midaz.
`MIDAZ_FEE_MODE`	`auto`	Quién cobra la comisión de cada transferencia. `legacy`: plugin-fees, configurado por las variables `FEES_*` de abajo, con registros en la API `/v1` de Midaz. `native`: el Fees Engine de Midaz, a partir de los paquetes de comisiones del ledger, con registros en `/v2`. `auto` lee la versión de Midaz, y usa `native` en Midaz 4.1.0 o posterior y `legacy` en una versión anterior o cuando la primera lectura falla. Bank Transfer no arranca con ningún otro valor.
`MIDAZ_FEE_MODE_REFRESH`	`5m`	Cada cuánto `auto` vuelve a leer la versión de Midaz, como duración de Go. La nueva lectura ocurre en la primera transferencia después de ese intervalo, y una lectura fallida conserva el modo actual. Bank Transfer no arranca con un valor igual a cero o menor.

Bank Transfer pide a Midaz que cree un índice de metadatos de transacción para sus lecturas de correlación. Esa llamada necesita el permiso settings post de Midaz, en los dos modos de comisión.

Con el auto predeterminado, Bank Transfer pasa a native por sí solo en cuanto lee Midaz 4.1.0 o posterior. Si tus paquetes de comisiones todavía están en plugin-fees, Midaz no encuentra ningún paquete, y las transferencias nuevas quedan sin comisión. Define MIDAZ_FEE_MODE=legacy antes de actualizar Midaz y luego sigue Migra las comisiones de Bank Transfer a Midaz.

Servicios externos (CRM)

Variable	Predeterminado / Obligatorio	Descripción
`CRM_BASE_URL`	Obligatorio	URL del ledger de Midaz, que incorpora el CRM. Esta URL debe responder a `GET /version`, o toda lectura del CRM falla. Debe usar HTTPS en producción.
`CRM_TIMEOUT_MS`	`2000`	Timeout de las solicitudes al CRM en milisegundos.
`CRM_MAX_RETRIES`	`2`	Intentos de reintento ante una falla del CRM.
`CRM_AUTH_ENABLED`	`false`	Habilita la autenticación M2M para el CRM.
`CRM_CLIENT_ID`	Obligatorio si está habilitado	ID de cliente OAuth para el M2M del CRM. Esta credencial necesita acceso de lectura a Holders e Instruments en el ledger.
`CRM_CLIENT_SECRET`	Obligatorio si está habilitado	Secreto de cliente OAuth para el M2M del CRM.

Servicios externos (Fees)

Estas variables configuran plugin-fees y se aplican solo cuando el modo de comisión es legacy. BTF_FEE_ENABLED activa plugin-fees. Cuando está en false (valor predeterminado), el plugin no construye ningún adaptador de plugin-fees, y cada transferencia legacy sigue con comisión 0 y sin llamadas HTTP. Las demás variables FEES_* se aplican solo cuando BTF_FEE_ENABLED=true. En el modo native, BTF_FEE_ENABLED no activa ni desactiva comisiones: eso lo hace el paquete de comisiones de Midaz del ledger.

Variable	Predeterminado / Obligatorio	Descripción
`BTF_FEE_ENABLED`	`false`	Activa la integración con plugin-fees, solo en el modo `legacy`. Cuando está en `false`, no se construye ningún adaptador de plugin-fees y cada transferencia `legacy` corre con comisión 0 sin llamadas HTTP. Defínelo en `true` para cobrar comisiones con plugin-fees. En el modo `native`, habilita o deshabilita el paquete de comisiones de Midaz en su lugar.
`FEES_BASE_URL`	Obligatorio si está habilitado	URL del servicio plugin-fees. Debe usar HTTPS en producción.
`FEES_TIMEOUT_MS`	`2000`	Timeout de las solicitudes de comisión en milisegundos.
`FEES_MAX_RETRIES`	`2`	Intentos de reintento ante una falla del servicio de comisiones.
`FEES_AUTH_ENABLED`	`false`	Habilita la autenticación M2M para Fees.
`FEES_CLIENT_ID`	Obligatorio si está habilitado	ID de cliente OAuth para el M2M de Fees.
`FEES_CLIENT_SECRET`	Obligatorio si está habilitado	Secreto de cliente OAuth para el M2M de Fees.

JD Courier

Estas variables conectan el plugin con JD Courier, que hace el relay de las transferencias entre cores al otro core de tu institución. En el modo multi-tenant, el plugin no usa COURIER_BASE_URL, COURIER_CLIENT_ID ni COURIER_CLIENT_SECRET.

Variable	Predeterminado / Obligatorio	Descripción
`COURIER_BASE_URL`	—	URL de JD Courier. Debe usar HTTPS en producción.
`COURIER_CLIENT_ID`, `COURIER_CLIENT_SECRET`	Obligatorios en producción cuando `COURIER_BASE_URL` está definida	Credenciales de cliente OAuth para JD Courier. Define ambas o ninguna. Necesitan `PLUGIN_AUTH_ADDRESS`.
`COURIER_ACCOUNT_CLAIMS_ENABLED`	`false`	Reclama las cuentas de este motor en el mapa de titularidad de JD Courier. Necesita `CRM_BASE_URL` y `PLUGIN_AUTH_ADDRESS`. En el modo single-tenant, también necesita `COURIER_BASE_URL`, `COURIER_CLIENT_ID`, `COURIER_CLIENT_SECRET` y `ORGANIZATION_ID`.

RabbitMQ

Cuando el streaming está habilitado, el plugin puede hacer fan-out de los eventos del ciclo de vida de las transferencias a RabbitMQ para los consumidores posteriores.

Variable	Predeterminado / Obligatorio	Descripción
`RABBITMQ_ENABLED`	`false`	Agrega RabbitMQ como destino de fan-out del ciclo de vida de las transferencias. La publicación requiere `STREAMING_ENABLED=true`.
`RABBITMQ_URL`	Obligatorio si está habilitado	URL de conexión AMQP. `amqp://` solo se permite cuando `ENVIRONMENT_NAME` es `development`, `test` o `local`, o para un host de loopback.
`RABBITMQ_HEALTH_CHECK_URL`	—	URL HTTP(S) del endpoint de health de la administración de RabbitMQ. El hostname debe coincidir con `RABBITMQ_URL`; debe usar `https://` en producción.
`RABBITMQ_EXCHANGE`	`bank_transfer.lifecycle`	Nombre del exchange para los eventos del ciclo de vida.
`RABBITMQ_EVENT_SIGNING_SECRET`	—	Secreto HMAC para firmar los eventos publicados. Recurre a `WEBHOOK_BROKER_EVENT_SIGNING_SECRET` y luego a `WEBHOOK_SIGNING_SECRET`. El secreto vigente debe tener al menos 32 caracteres.

Outbox de streaming

El subsistema de streaming publica los eventos de transferencia en el único tema de la aplicación, lerian.streaming.plugin-br-bank-transfer, en un broker de Redpanda/Kafka a través de un outbox transaccional. Debes habilitarlo para la entrega saliente de webhooks (WEBHOOK_ENABLED=true requiere STREAMING_ENABLED=true). Mientras el streaming está desactivado, el plugin descarta los eventos: activarlo después publica solo los eventos nuevos.

Variable	Predeterminado / Obligatorio	Descripción
`STREAMING_ENABLED`	`false`	Habilita el subsistema de outbox de streaming. Obligatorio para la entrega de webhooks.
`STREAMING_BROKERS`	Obligatorio si está habilitado	Lista separada por comas de direcciones de brokers de Kafka/Redpanda.
`STREAMING_CLIENT_ID`	—	ID de cliente que se presenta al broker.
`STREAMING_CLOUDEVENTS_SOURCE`	`plugin-br-bank-transfer`	Reemplazo opcional del `source` de CloudEvents. Déjalo sin definir para usar `plugin-br-bank-transfer`; si lo defines, debe coincidir con ese valor exactamente, incluso con el streaming deshabilitado.
`STREAMING_OUTBOX_DISPATCH_INTERVAL_SECONDS`	`30`	Intervalo (en segundos) entre los ciclos de envío del outbox. Debe ser > 0.
`STREAMING_CB_FAILURE_RATIO`	`0.5`	Proporción de fallas del circuit breaker que lo dispara (debe ser > 0 y ≤ 1).
`STREAMING_CB_MIN_REQUESTS`	`10`	Número mínimo de solicitudes en una ventana antes de que el circuit breaker pueda dispararse.
`STREAMING_CB_TIMEOUT_S`	`30`	Timeout de recuperación del circuit breaker en segundos.
`STREAMING_CLOSE_TIMEOUT_S`	`30`	Timeout de apagado ordenado (en segundos) del productor de streaming.
`STREAMING_TLS_ENABLED`	`false`	Usa TLS en la conexión con el broker. Debe ser `true` cuando `DEPLOYMENT_MODE=saas`.
`STREAMING_TLS_CA_CERT`	—	Certificado de CA para la conexión TLS con el broker.
`STREAMING_SASL_MECHANISM`, `STREAMING_SASL_USERNAME`, `STREAMING_SASL_PASSWORD`	—	Autenticación SASL con el broker.
`STREAMING_SASL_ALLOW_PLAINTEXT`	`false`	Permite SASL sin TLS.

Entrega de webhooks

La entrega saliente de webhooks requiere tanto RabbitMQ como el outbox de streaming. El worker de webhooks consume los eventos de una cola de RabbitMQ y los entrega a los endpoints suscritos.

Variable	Predeterminado / Obligatorio	Descripción
`WEBHOOK_ENABLED`	`false`	Habilita la entrega saliente de webhooks. Requiere `RABBITMQ_ENABLED=true` y `STREAMING_ENABLED=true`.
`WEBHOOK_SIGNING_SECRET`	—	Último recurso para el secreto de los eventos del broker. No firma las entregas: cada registro de webhook firma con su propio `signingSecret`.
`WEBHOOK_BROKER_EVENT_SIGNING_SECRET`	Obligatorio en producción si está habilitado	Secreto HMAC para verificar los eventos del broker. Recurre a `WEBHOOK_SIGNING_SECRET`.
`WEBHOOK_QUEUE_NAME`	`transfer.webhook.delivery`	Nombre de la cola de RabbitMQ para los eventos de webhook.
`WEBHOOK_DLQ_NAME`	`transfer.webhook.dlq`	Cola dead-letter para las entregas de webhook fallidas.
`WEBHOOK_DLX_EXCHANGE_NAME`	—	Nombre del exchange dead-letter. Cuando está vacío, el worker deriva `<WEBHOOK_DLQ_NAME>.exchange`. Reemplázalo para centralizar el DLX entre plugins.
`WEBHOOK_DLQ_MESSAGE_TTL_MS`	`0`	`x-message-ttl` de la DLQ en milisegundos. `0` deja el valor predeterminado de la librería (7 días). Los cambios de topología requieren borrar la DLQ existente antes de volver a desplegar.
`WEBHOOK_DLQ_MAX_LENGTH`	`0`	Número máximo de mensajes en la DLQ. `0` deja el valor predeterminado de la librería (10000).
`WEBHOOK_PREFETCH_COUNT`	`20`	Conteo de prefetch de RabbitMQ.
`WEBHOOK_DELIVERY_CONCURRENCY`	`8`	Número máximo de entregas de webhook en paralelo por worker.

Telemetría (OpenTelemetry)

Variable	Predeterminado / Obligatorio	Descripción
`ENABLE_TELEMETRY`	`false`	Habilita el tracing y las métricas de OpenTelemetry.
`OTEL_EXPORTER_OTLP_ENDPOINT`	`localhost:4317`	Endpoint gRPC del colector de OTel.
`OTEL_TRACES_SAMPLER_ARG`	—	Proporción de muestreo de trazas. Un valor en (0,1] se aplica tal como se define. Sin definir, o con un valor de 0 o menor, usa `0.1` en producción y `1.0` en el resto. Un valor mayor que 1 cuenta como `1.0`.
`BTF_METRICS_PROMETHEUS_ENABLED`	`false`	Expone un endpoint de scrape de Prometheus dedicado para las métricas `btf.*`. Cuando está en `true`, arranca el listener en `BTF_METRICS_PROMETHEUS_ADDRESS`.
`BTF_METRICS_PROMETHEUS_ADDRESS`	`127.0.0.1:9090`	Dirección de escucha del endpoint `/metrics` de Prometheus. El valor predeterminado se asocia a loopback, para que un pod mal configurado no exponga métricas sin autenticación a la red del clúster. Reemplázalo (p. ej. `0.0.0.0:9090`) solo detrás de una NetworkPolicy o un sidecar.

Licencia

Variable	Predeterminado / Obligatorio	Descripción
`LICENSE_KEY`	Obligatorio	Clave de licencia. El servicio no arranca sin ella, en ningún entorno.
`IS_DEVELOPMENT`	—	Define `true` para validar una clave de licencia de desarrollo en el servicio de licencias de desarrollo. Consulta License Manager.
`ORGANIZATION_IDS`	Obligatorio	La misma variable que en Alcance de la organización. Lista separada por comas de UUIDs de organizaciones de Midaz en el ámbito de la licencia; el gateway de licencias valida `LICENSE_KEY` contra ellos al arrancar.

Cifrado

Cifrado en el nivel de campo para los datos sensibles en reposo. Cada clave debe ser una clave AES-256 de 32 bytes codificada en hexadecimal (64 caracteres hexadecimales). Las dos claves son obligatorias en producción. Fuera de producción, una clave vacía deshabilita el cifrado de ese campo.

Variable	Predeterminado / Obligatorio	Descripción
`JD_INCOMING_RAW_XML_ENCRYPTION_KEY`	—	Clave AES-256 para cifrar los payloads XML entrantes de JD. Usa una clave de 32 bytes en hexadecimal. Mantenla estable entre actualizaciones: una clave cambiada vuelve ilegibles los registros que cifró la clave anterior.
`RECIPIENT_DETAILS_ENCRYPTION_KEY`	—	Clave AES-256 para cifrar los datos del receptor en reposo. Usa una clave de 32 bytes en hexadecimal. Mantenla estable entre actualizaciones: una clave cambiada vuelve ilegibles los registros que cifró la clave anterior.

Introducción

TED Lerian

TED JD

Pix Lerian

Pix JD

JD Courier

Pix BTG

Payments BTG

Variables de entorno

Configuración de infraestructura

Aplicación

TLS

Encabezados de proxy

Autenticación

Declaración de permisos

Alcance de la organización

PostgreSQL

Réplica de PostgreSQL

MongoDB

Redis

Conexión con JD SPB

Polling de JD

Servicios externos (Midaz)

Servicios externos (CRM)

Servicios externos (Fees)

JD Courier

RabbitMQ

Outbox de streaming

Entrega de webhooks

Telemetría (OpenTelemetry)

Licencia

Cifrado

​Configuración de infraestructura

​Aplicación

​TLS

​Encabezados de proxy

​Autenticación

​Declaración de permisos

​Alcance de la organización

​PostgreSQL

​Réplica de PostgreSQL

​MongoDB

​Redis

​Conexión con JD SPB

​Polling de JD

​Servicios externos (Midaz)

​Servicios externos (CRM)

​Servicios externos (Fees)

​JD Courier

​RabbitMQ

​Outbox de streaming

​Entrega de webhooks

​Telemetría (OpenTelemetry)

​Licencia

​Cifrado

Configuración de infraestructura

Aplicación

TLS

Encabezados de proxy

Autenticación

Declaración de permisos

Alcance de la organización

PostgreSQL

Réplica de PostgreSQL

MongoDB

Redis

Conexión con JD SPB

Polling de JD

Servicios externos (Midaz)

Servicios externos (CRM)

Servicios externos (Fees)

JD Courier

RabbitMQ

Outbox de streaming

Entrega de webhooks

Telemetría (OpenTelemetry)

Licencia

Cifrado