Acción requerida
Clave de licencia, calendario de informes y períodos de presentación en Reporter v4.6.0
Las páginas y la referencia de la API de Reporter pasaron a Reporter v4.6.0. Reporter no inicia sin una clave de licencia de Lerian enLICENSE_KEY. Cuando REPORT_TIMEZONE no está definida, los días de los informes y los períodos de presentación siguen America/Sao_Paulo. Cada presentación regulatoria registra su período y su tipo de remesa, original o sustitución. Un mapeo puede hacer join y calcular en cualquier lectura, leer listas y campos anidados de MongoDB y leer un conjunto de varias fuentes de datos. Puedes previsualizar una consulta de un mapeo y leer las filas de una presentación. Los filtros de informe aceptan startsWith, notStartsWith, isNull y notNull. Un filtro nin en PostgreSQL también devuelve las filas sin valor. El rol de reporter-contributor-group ahora es operator, con el mismo acceso.Antes de actualizar, define LICENSE_KEY para cada proceso de Reporter. Si tus libros cierran en UTC, define REPORT_TIMEZONE=UTC. Revisa los informes que filtran con nin en PostgreSQL. Reescribe cada mapeo guardado que usa sign, statedIn o accumulate, porque Reporter v4.6.0 no lo carga.Actualización a Midaz 4.4.0: valores de configuración y alias duplicados
En Midaz 4.4.0, el Ledger no arranca cuando una variable de entorno tiene un valor que no puede leer, y el error nombra la variable. Un booleano acepta solotrue o false, un número debe ser entero y una duración necesita una unidad, como 12s. La migración de onboarding se detiene si un ledger tiene dos cuentas con el mismo alias o dos activos con el mismo código. Las cuentas y los activos eliminados no cuentan. La migración lista los duplicados, y Midaz no los fusiona ni los elimina.Antes de actualizar, revisa tus valores de entorno. Si la migración se detiene, contacta a Lerian antes de ejecutar de nuevo la actualización.Tracer en Midaz 4.4.0 verifica los valores de configuración al iniciar
En Midaz 4.4.0, Tracer no inicia cuando una variable de entorno tiene un valor que no puede leer, y el error indica el nombre de la variable. Por ejemplo,API_KEY_ENABLED=1 y AUTH_CACHE_TTL=60 impiden el inicio. Tracer también verifica los valores de STREAMING_* cuando el streaming está desactivado.Antes de actualizar, escribe cada variable booleana como true o false, y cada AUTH_TIMEOUT y AUTH_CACHE_TTL con unidad, como 60s. Variables de entorno enumera las verificaciones.Relay entre cores, reclamación de cuentas y tránsito Pix en JD Courier v1.2.0
Las páginas y la referencia de la API de JD Courier pasaron a v1.2.0. El Courier reenvía un crédito o una devolución de TED, o un cash-in o una devolución de Pix, entre dos motores de tu institución. Relay entre cores da el contrato que sigue cada motor, incluido el otro core. Un motor puede reclamar sus cuentas, los CNPJ de sus cobradores de Pix Automático y el lado del cobrador de sus recurrencias. Con el tránsito Pix, los motores también envían sus llamadas Pix a JD a través del Courier. Un motor puede tener varias aplicaciones de Access Manager, una para cada producto que llama al Courier.JD llama a la dirección Pix del Courier como un socio de Access Manager de tu instalación. Configura el socio como describe Access Manager. Los operadores ya no declaran un bypass en el SPB. Variables de entorno de JD Courier lista las variables del Courier.Custodia de claves en AWS KMS, registros de orden y roles del executor en Lerian SISBAJUD v1.1.0
Las páginas y la referencia de la API de Lerian SISBAJUD pasaron a la Mensageria v1.1.0 y al executor v1.1.0. Con AWS KMS,KMS_AWS_KEY_MODE define la custodia de las claves de cada componente. En el modo managed, el componente crea sus claves para cada institución. En el modo provided, tú creas las claves, y el componente registra cada rotación que hace el custodio de tus claves. AWS KMS en la Mensageria enumera los requisitos de la clave y los permisos de AWS.La Mensageria registra el aviso de una transferencia judicial por recibir (registro 08). Un archivo de respuesta de bloqueo lo responde con el código 01. La Mensageria estaciona las solicitudes de aclaración (registro 09) y las interrupciones de un bloqueo permanente (registro 10). Responde manualmente a una solicitud de aclaración estacionada. Después de una interrupción estacionada, nuevos créditos pueden seguir bloqueados hasta que detengas el bloqueo manualmente.El executor declara los roles viewer, operator, investigator, cross-org-reader, admin y platform-admin. Roles enumera los permisos de cada rol. Una rotación de clave puede devolver los nuevos códigos SBJ-0012, SBJ-0013 y SBJ-0014. La lista de errores los describe.Cierre de la grilla y caídas del gestor de colas en Lerian SPB
Lerian SPB reenvía un mensaje que no salió, sin límite de intentos. Tras el cierre de su grilla del STR en su día de movimiento, el riel cierra ese mensaje comoFAILED sin enviarlo. Una transferencia o un movimiento informa entonces settlement.failed. El riel no cierra un mensaje LDL o LTR de esta forma. El riel marca como SENT una transferencia que un envío pudo haber entregado. Esa transferencia espera la respuesta de BACEN o que los operadores la cierren como fallida. DISPATCH_MAX_AUTO_ATTEMPTS ya no existe.Mientras la conexión al gestor de colas está caída, el riel sigue atendiendo lecturas. Rechaza cada solicitud que enviaría un nuevo mensaje STR con 503 y SPB-1001, y no almacena nada para esa solicitud. Maneja SPB-1001 en tu integración: envía la solicitud de nuevo con la misma clave X-Idempotency cuando la conexión vuelva.Solicitudes como participante directo y archivo regulatorio en Lerian SPI
Lerian SPI envía la prueba de conectividad, la solicitud de reporte de la Conta PI, el reporte de liquidación de MED 2.0 y el registro de los responsáveis como tu participante directo. Hace lo mismo con las solicitudes de mandato y de programación de Pix Automático, sus respuestas de aceptación o rechazo y sus cancelaciones. Los cuerpos de esas solicitudes no recibenparticipantIspb, y un cuerpo que lo lleva recibe 422. La cancelación de programación tampoco recibe counterpartyIspb ni requestedBy. GET /api/v1/spi/responsibles devuelve los responsáveis de tu participante directo. El riel archiva cada sobre ICOM y cada solicitud y respuesta del DICT. Un usuario con el recurso br-spi-regulatory-archive lee un elemento archivado mediante GET /api/v1/spi/regulatory-archive/{itemId}. Para un Pix enviado que BACEN no respondió, la resolución manual lo declara SETTLED o REJECTED, con una aprobación que nombra ese resultado.Quita participantIspb, counterpartyIspb y requestedBy de los cuerpos de esas solicitudes. Configura las variables del archivo regulatorio para los binarios spi y dict: fuera de un entorno de desarrollo, no inician sin un bucket.Claves de idempotencia en Lerian STA v1.2.0
Las páginas y la referencia de la API de Lerian STA pasaron a Lerian STA v1.2.0. La creación de transferencias y la consulta manual entrante necesitan un headerX-Idempotency. Una solicitud sin él devuelve 400 con STA-0001. Durante 7 días, una repetición con la misma clave y la misma solicitud devuelve la primera respuesta exitosa, y Lerian STA no crea la transferencia ni ejecuta la consulta de nuevo. La misma clave con una solicitud diferente devuelve 422. Lerian STA no tiene modo multi-tenant: una instalación atiende a un cliente, y Lerian STA ya no lee DEFAULT_TENANT_ID. Los eventos de Lerian STA llevan el tenant default en ce-tenantid.Antes de actualizar, envía una clave X-Idempotency con cada creación de transferencia y cada consulta manual. Mantén la misma clave cuando reintentes la misma solicitud. Si tus consumidores de eventos filtran por ce-tenantid, ajusta el filtro a default. Lerian CCS v1.0.0 envía sus lotes ACCS001 sin el header X-Idempotency, y Lerian STA v1.2.0 los rechaza. Si ejecutas Lerian CCS v1.0.0, mantén Lerian STA en v1.1.0.Cierre del LBTR y caídas de Núclea en Lerian SILOC
Lerian SILOC rechaza una decisiónLTR0002 o LTR0008 enviada por la API a las 17h30 de Brasilia o después con 422 y SILOC-0025, y no almacena nada. Una solicitud no enviada termina en FAILED cuando se le acaba el plazo: LTR0002, LTR0008 y SLC0004 a las 17h30 de su día de movimiento, y los otros códigos cuando termina su día de movimiento. Cada solicitud FAILED publica studio.lerian.br-siloc.siloc_outbound.failed. REDIS_DB, CERT_READINESS_MIN_DAYS, SFN_CUSTODY_CACHE_ENTRIES y XSD_VALIDATOR_TIMEOUT_SEC deben contener un entero, o el servicio no arranca.Mientras el queue manager de SILOC de Núclea no es accesible, el servicio sigue en rotación. Rechaza cada nueva solicitud saliente con 503 y SILOC-0024, y no almacena nada. Maneja SILOC-0025 y el resultado FAILED en tu integración. Envía de nuevo una solicitud rechazada con SILOC-0024 con la misma clave X-Idempotency cuando la conexión vuelva.Etiquetas de comisión, rechazos de Tracer y hosts de QR en Pix JD v1.5.0
Las páginas y la referencia de API de Pix JD pasaron a la v1.5.0. Una orden de pago puede llevar una etiqueta de comisión enfeeContext, y el paquete de comisiones de Midaz que selecciona por la etiqueta fija el precio del Pix. Una etiqueta por la que ningún paquete de comisiones del ledger del pagador selecciona responde 422 PIX-0162, y no se retiene nada. Cuando tu Tracer rechaza el crédito de un Pix recibido, el Pix espera como PENDING, con pendingReason TRACER_DENIED. Un operador de tu institución puede devolverlo a su pagador, o acreditarlo cuando tu Tracer deje pasar el crédito. Cada participante directo puede publicar sus QR codes dinámicos en un host propio.Asegúrate de que tu integración acepta TRACER_DENIED en pendingReason. Para fijar el precio de Pix por etiqueta, consulta Fija el precio de un TED o Pix con un contexto de comisión. Para cambiar el host de QR de un participante, sigue Alojamiento de QR codes dinámicos.Comisiones de TED Lerian con tus paquetes de comisiones de Midaz
TED Lerian cobra comisiones solo a través de los paquetes de comisiones de Midaz de tu ledger. TED Lerian marca cada asiento contedOperation (ted_sent, ted_internal, ted_received o ted_refund) y tedPurposeCode, para que un paquete pueda seleccionar por ellos. Un paquete que no selecciona por tedOperation también puede cobrar comisión a las TED recibidas y a los reembolsos. La cotización de comisión es una estimación, y el feeAmount de una transferencia muestra la comisión que Midaz cobró al remitente.Antes de retener cualquier importe, TED Lerian verifica la finalidad en el dominio FinlddCli del BACEN (TED-0003) y los dígitos verificadores del CPF o CNPJ del destinatario (TED-0007). Un año de feriados cargado cubre todas sus fechas, y una fecha cuyo año no está cargado recibe 503 TED-0022. Limita tus paquetes de comisiones con estas etiquetas y carga el calendario de feriados de cada año antes de que empiece.Reglas del DICT y eventos de negocio en Pix BTG v1.12.0
Las páginas y la referencia de la API de Pix BTG pasaron a la v1.12.0. La creación de clave y la creación de reclamación rechazan una cuenta de nómina (SLRY) con PIX-0129. Un número de cuenta puede tener de 1 a 20 letras mayúsculas o dígitos. Cuando el dígito verificador es una letra, el DICT recibe ese dígito como 0. El donante puede cancelar una reclamación con el motivo COURT_ORDER.Los informes de infracción y las transacciones del grafo de rastreo llevan transactionDepth. Una recuperación de fondos acepta un maxHops de 1 a 2, y el grafo de rastreo no usa sus parámetros de consulta.Pix BTG puede publicar eventos de negocio en despliegues BYOC. Están desactivados por defecto. Para activarlos, define las variables en Eventos de negocio.Antes de actualizar, deja de enviar un maxHops mayor que 2 y no registres claves Pix para cuentas de nómina. Mantén el número de cuenta original en el CRM.Devoluciones y créditos al cliente en Bank Transfer v3.3.0
Las páginas y la referencia de la API de TED JD pasaron a Bank Transfer v3.3.0. Return a Transfer devuelve una TED IN completada al banco pagador, o revierte un P2P completado. La solicitud necesita el permisotransfers:return. Una devolución envía solo sus propios eventos de webhook.El plugin también acredita al destinatario en siete créditos al cliente que el banco pagador envía como otros mensajes STR. Cada uno tiene su propio tipo de transferencia, de TED_IN_STR0005 a TED_IN_STR0051, y su propio vínculo en el enrutamiento del ledger. Una TED OUT que JD todavía responde como pendiente después de 24 horas en conciliación espera a un operador, con la retención mantenida. Con la política de tenant fees.refund_on_devolucao en true, el reembolso de una devolución total de una TED OUT completada también devuelve la comisión al remitente. Antes de actualizar, agrega un vínculo en el enrutamiento del ledger para cada tipo de crédito al cliente que recibes, y acepta los nuevos tipos de transferencia y eventos de devolución en tu integración.Créditos en espera y clientes de indirectos en Pix JD v1.4.0
Las páginas y la referencia de la API de Pix JD pasaron a la v1.4.0. Cuando el ledger rechaza el crédito de un Pix recibido porque el saldo de destino no acepta créditos, el Pix espera comoPENDING, con pendingReason BALANCE_NOT_RECEIVING. Un operador puede acreditar ese Pix o devolverlo a su pagador. Una lista muestra los débitos de Pix Automático que esperan, con su pendingReason. Para rechazar una reclamación de posesión, envía fraudDeclared como true. Con JOBS_CLAIM_RECEIVED_POLL_ENABLED, OUTBOX_ENABLED y STREAMING_ENABLED en true, Pix JD emite key.claim-received cuando otro participante reclama una clave que tienes.Una solicitud a través de un participante indirecto declara al cliente y no nombra ninguna cuenta tuya: payer en un pago, X-Payer-Document en la consulta de clave y en la decodificación de QR, y recipient en un código QR dinámico. La devolución de un Pix que llegó a la posición de un participante indirecto necesita su indirectId, o responde 422 PIX-0135. Una devolución que nombra a un participante indirecto que no recibió el Pix original responde 404 PIX-0147. Un ISPB tiene 8 letras mayúsculas o dígitos, y la lista de errores añadió los códigos de PIX-0151 a PIX-0160.Antes de actualizar, sigue los pasos para la 1.4.0 en la página de variables de entorno. En un despliegue self-hosted donde Pix JD no publica su declaración de permisos, dale a los roles de Pix el permiso parked-credits (acción post). Actualiza fuera del intervalo de 00:00 a 08:00, hora de Brasilia. Una aplicación existente de JD con el origen jd-consultores sigue funcionando. Para una nueva integración directa, dale a JD su credencial.Credenciales de servicio y roles declarados en Access Manager v3.13.1
Las páginas de Access Manager y las referencias de las API de Auth e Identity pasaron a Access Manager v3.13.1. En un despliegue single-tenant, una persona emite la aplicación con la que un servicio de Lerian inicia sesión mediante Emitir una credencial de servicio. Crear una aplicación rechazasource con 400.Un producto de Lerian puede declarar sus propios roles y permisos. Identity rechaza con 422 agregar o quitar un rol en un permiso declarado, o un grupo en un rol declarado. La Console lista un rol declarado como Custom. Para cambiar quién tiene ese acceso, agrega o quita personas en el rol del producto o en un grupo que tiene el rol.Identity responde a un token ausente con 401 AUT-0006, a un token inválido con 401 AUT-0007 y a un permiso denegado con 403 AUT-1020. Cuando la verificación de autorización no responde a tiempo, Identity responde 504 AUT-1021. Quita source de tus solicitudes de Crear una aplicación y actualiza el manejo de errores de tu integración.Certificado SFN y estados de liquidación en Lerian SPB
Lerian SPB usa un certificado SFN, enPROCESS_CERT_PATH. Su clave privada firma cada mensaje STR saliente y descifra los mensajes entrantes que BACEN cifra para este certificado. SPB_SIGNER_KIND define la custodia de esa clave. Las variables CERT_PATH, KEY_PATH, OUTBOX_POSTGRES_MAX_OPEN_CONNS y OUTBOX_POSTGRES_MAX_IDLE_CONNS dejaron de existir, igual que el archivo metadata.json. El valor predeterminado de STR_MQ_CIPHER_SPEC es ECDHE_RSA_AES_256_CBC_SHA384.Después de que el STR liquida una devolución, el crédito devuelto termina en RETURNED. Un redescuento convertido termina en CONVERTED, y un movimiento de dinero electrónico puede terminar en CANCELLED. La conversión de un redescuento informa dos hechos settlement.*, y el hecho del pago tiene un settlementId que termina en -PGTO. El hecho settlement.failed también informa una transferencia que un operador cierra como fallida. Los avisos LTR0003R2 y LTR0006R2 no tienen hecho settlement.*.Antes de actualizar, define PROCESS_CERT_PATH y la custodia de su clave. En un HSM, permite la firma y el descifrado en esta clave. Define STR_MQ_CIPHER_SPEC con la CipherSpec de tu canal STR_MQ_CHANNEL. Haz que tu consumidor del ledger registre los avisos LTR0003R2 y LTR0006R2 a partir de los hechos spb.ldl.* y maneje los nuevos estados finales.Operaciones atascadas y catálogo 5.13.2 en Lerian SPI
La referencia de la API de SPI quitó las operaciones de evaluación, de solicitud y de ejecución de la recuperación de una operación. Una operación que necesita atención aparece en la lista de operaciones atascadas con las acciones que acepta, y la resolución manual necesita una aprobaciónAPPROVED. Cuando BACEN no responde a un Pix enviado dentro de su plazo, la acción RECONCILE_WITH_BACEN le pide a BACEN el movimiento del pago. Cuando la respuesta camt.054 de BACEN informa el pago como liquidado o rechazado, el riel completa o rechaza el pago.El valor predeterminado de BACEN_SPI_CATALOGUE_VERSION es 5.13.2. Un BACEN_SPI_XSD_DIR que defines debe contener los schemas de esa versión. Un valor de variable que no es válido para su tipo, como yes en un interruptor, detiene el arranque. Mueve tus llamadas de recuperación a las acciones de operaciones atascadas. Si defines BACEN_SPI_XSD_DIR, pon en él los schemas de la 5.13.2.Frames aparcados y TLS de MQ en Lerian SILOC
Lerian SILOC aparca en su base de datos un frame que rechazó más deMQ_BACKOUT_THRESHOLD veces, y MQ_BACKOUT_QUEUE dejó de existir. El feed de cuarentena devuelve los bytes del frame en frame y deja de devolver un frame después de que lo resuelves. El servicio no arranca cuando PostgreSQL no responde en un plazo de 10 segundos.La nueva variable MQ_CIPHER_SPEC define el cipher spec del canal MQ, con el valor predeterminado ECDHE_RSA_AES_256_CBC_SHA384. La nueva variable MQ_CERT_LABEL nombra el certificado que el servicio presenta en el canal.Antes de actualizar, quita MQ_BACKOUT_QUEUE y define MQ_CIPHER_SPEC con el cipher spec de tu canal de conexión de servidor. Con REDIS_TLS=true, asegúrate de que tu servidor Redis acepta TLS. Si el sistema operativo no confía en la autoridad certificadora de tu servidor Redis, define esa autoridad en REDIS_CA_CERT.Credenciales de socio y resultados de renegociación en Lerian Consignado 4.0.0
Las páginas y la referencia de la API de Consignado pasaron a Lerian Consignado 4.0.0. Un fondo o un originador puede llamar a sus propias rutas con una credencial de socio de Access Manager, y la referencia de la API añadió esas operaciones. Puedes reactivar un fondo o un originador. Una carga completa de un nuevo certificado y de un nuevo cliente OAuth mediantePUT /v1/credentials/dataprev termina una revocación de las credenciales de Dataprev. La lectura del estado de la portabilidad es POST /v1/consignado/portabilidade/efetivacoes, con los filtros en el cuerpo, y la referencia de la API quitó la lectura de uso.El resultado de una renegociación publica consignado.renegociacao.efetivada o consignado.renegociacao.recusada. El hecho consignado.exclusao.rejected tiene la versión de schema 1.1.0. Una exclusión de portabilidad del lado de origen que no tuvo respuesta publica consignado.portabilidade.rejeitada con reason_code GW-M005-NAO-EXECUTADO. Una averbação con el bloque de booking responde RATE_OUTSIDE_PRODUCT_RANGE cuando su monthly_rate por 12 queda fuera del rango de tasa anual de la versión de producto de Lender que nombra. Una averbação con un número de contrato que ya es un contrato en el gateway responde CONTRACT_ALREADY_REGISTERED.La publicación de permisos en el arranque exige Access Manager 3.13.0 o posterior. Esto reemplaza la indicación de Access Manager 3.12.0 en la entrada del 26 de octubre de 2026 sobre Consignado. Actualiza Access Manager antes de actualizar el gateway. Lee el estado de la portabilidad con POST y deja de llamar a la lectura de uso. Lee ce-schemaversion antes de decodificar consignado.exclusao.rejected. Después de GW-M005-NAO-EXECUTADO, envía la exclusión de nuevo con una nueva clave.Los productos de Lerian son de código cerrado
Desde el 21 de octubre de 2026, todo producto de Lerian es de código cerrado. El modelo Community de Midaz dejó de existir. Midaz y Tracer se instalan desde sus imágenes públicas en Docker Hub. Si instalas Midaz o Tracer desde su código fuente, pasa a las imágenes de Docker Hub. Para soporte, usa el Lerian Support Portal.Rechazos de autenticación y de tenant en Midaz 4.3.0
En Midaz 4.3.0, un token ausente o inválido respondeAUT-0006 o AUT-0007, no 0042. Un permiso denegado responde AUT-1020, no 0043. Cuando el Access Manager no decide, la respuesta es AUT-0033, no 0525. En modo multi-tenant, la resolución del tenant rechaza con códigos como TENANT_SUSPENDED y TENANT_MANAGER_UNAVAILABLE.Midaz mantiene 0042, 0043 y 0525 solo para un rechazo que no lleva código. Si tu integración decide según esos tres códigos, decide según el status HTTP o según los códigos nuevos.Actualización y eliminación de cuentas en Midaz 4.3.0
En Midaz 4.3.0, el Ledger publica los mensajes de auditoría de transacción solo cuandoAUDIT_LOG_ENABLED es true. El /readyz del Ledger verifica RabbitMQ a través de su API de administración con las credenciales de RABBITMQ_DEFAULT_USER y responde 503 cuando esa verificación falla. Cada clave de comisión que agregas a un paquete debe seguir ^[a-z][a-zA-Z0-9]*$.Antes de actualizar, define AUDIT_LOG_ENABLED=true si consumes los mensajes de auditoría. Dale también al usuario RABBITMQ_DEFAULT_USER acceso a la API de administración. Actualiza Tracer y después todos los Ledgers antes de que tu integración envíe scheme u optionalOperationRoutes. Mientras corre un Ledger 4.3.0, no hagas el rollback de Tracer a una versión anterior a 4.3.0.Cada reserva que el Ledger envía a Tracer lleva el segmento y el portafolio de la cuenta de origen, y el esquema de la transacción. Los límites y las reglas de Tracer con alcance por segmento, portafolio o esquema se aplican a estas reservas. En modo enforce, pueden denegar la transacción. Antes de actualizar, revisa esos límites y reglas.Cuando eliminas una cuenta, Midaz también archiva sus Cuentas Alias y quita su alias de los paquetes de comisiones y de facturación. Midaz quita cada comisión que acredita el alias. Desactiva un paquete de comisiones que queda sin comisiones y un paquete de facturación que debita o acredita el alias. Antes de eliminar una cuenta, registra su fecha de cierre en su Cuenta Alias. Para mantener una comisión que asienta en el alias, apúntala antes a otra cuenta.Licencia y conclusión de TED OUT en Bank Transfer v3.2.0
Las páginas y la referencia de la API de TED JD pasaron a Bank Transfer v3.2.0. En v3.2.0, cada entorno necesitaLICENSE_KEY y ORGANIZATION_IDS. IS_DEVELOPMENT selecciona el servicio de licencias de desarrollo, y LICENSE_SERVICE_ADDRESS dejó de existir.TED OUT envía transfer.completed cuando se liquida y también envía transfer.rejected cuando el STR rechaza la liquidación. A partir de v3.2.0, usa transfer.completed como la señal de conclusión de TED OUT, en lugar de la indicación de la entrada del 24 de agosto de 2026. Antes de actualizar, define las dos variables de licencia en cada entorno. Confirma también que ENVIRONMENT_NAME o ENV_NAME es production, staging, uat, development, local o test.Solo nombres de campo en inglés en Pix JD v1.3.0
Las páginas y la referencia de la API de Pix JD pasaron a v1.3.0. En v1.3.0, un campo que tenía un nombre en inglés y un nombre obsoleto en portugués mantiene solo su nombre en inglés. Un cuerpo de solicitud con el nombre en portugués responde400 PIX-0061, y la API ignora un parámetro de consulta con ese nombre. El registro de una clave aleatoria necesita X-Idempotency. Antes de actualizar, sigue los pasos para la 1.3.0 en la página de variables de entorno.ID end-to-end en Pix Lerian v1.1.0
Las páginas y la referencia de la API de Pix Lerian pasaron a v1.1.0. Pix Lerian es la interfaz que conecta Midaz con Lerian SPI a través de su adaptador de conectividad Lerian.En un pago por clave o por QR Code, Pix Lerian fija el ID end-to-end cuando inicias la transferencia, y el procesamiento lo reutiliza. El procesamiento rechazaX-End-To-End-Id en estos pagos con 400 PIX-0300. Un endToEndId que envías debe contener tu ISPB en los caracteres 2 a 9. X-Idempotency es la clave de idempotencia. Antes de actualizar, deja de enviar X-End-To-End-Id al procesar un pago por clave o por QR Code.Eventos y depósitos LDL0022 de Lerian SPB
Lerian SPB publica todas las familias de eventos en el backbone de streaming y no envía webhooks. Una devolución (STR0010) devuelve un crédito TED que recibiste y termina en su propiosettlement.settled o settlement.failed. El evento settlement.returned dejó de existir. Las liquidaciones LDL, los depósitos LDL0022, el pago LTR0004 y los avisos LDL y LTR0005R2 no solicitados no tienen hecho settlement.*. Una solicitud de depósito LDL0022 indica solo advisoryId. El riel toma el monto, el lado y el período del aviso, y rechaza un cuerpo con cualquier otro miembro.Antes de actualizar, mueve cada consumidor de webhook al backbone de streaming. Haz que tu consumidor del ledger registre esas operaciones a partir de los hechos spb.ldl.*. Envía solo advisoryId en una solicitud de depósito LDL0022. Define LDL_ADVISORY_CONSUMER_ENABLED como true o false, porque el servicio no inicia cuando la variable no está definida.Devoluciones entrantes y campos obligatorios en Lerian SPI
Lerian SPI retiene una devolución entrante y la anuncia enspi.payment.return_received, con su returnId. Tu cliente autoriza o rechaza la devolución por ese returnId. Una devolución autorizada se liquida solo cuando el SPI la confirma, y el riel rechaza una devolución que ninguna decisión concluye dentro de su ventana.Un rechazo FRAD de un Pix entrante sale como FRAD solo cuando tu cliente lo marca como la decisión de su sistema antifraude. De lo contrario, sale como DS04. Una orden de pago necesita acceptedAt, el instante en que tu sistema recibió la confirmación del pagador. Una recuperación de fondos necesita userComplaintAt, el instante en que tu canal de atención registró la reclamación del pagador. Un perfil de recebedor de BR Code necesita ispbParticipante, el ISPB de un participante para el que el riel liquida. Sin estos campos, el riel responde 422.Con un endpoint BACEN SPI https, define BACEN_SPI_SIGNING_CERT_FILE. Con el backend file, el predeterminado de BACEN_SPI_SIGNER_KIND, define también BACEN_SPI_SIGNING_KEY_FILE. La referencia de la API de DICT eliminó el bloqueo judicial y el desbloqueo de una clave, la limpieza de claves huérfanas y la conciliación bajo demanda. Esta entrada reemplaza la entrada del 6 de octubre de 2026 sobre SPI. Envía estos campos, decide cada devolución entrante y actualiza el manejo de errores de tu integración.Interruptores y liquidación de ciclo en Lerian SILOC
Lerian SILOC no arranca a menos queOT_REPLAY_ENABLED, STATUS_REPLAY_ENABLED, RECONCILE_ENABLED, LDL_FACT_CONSUMER_ENABLED y CARD_COMMAND_CONSUMER_ENABLED sean cada uno true o false. Con RECONCILE_ENABLED=true, liquida un ciclo OT solo cuando el resultado multilateral GEN0015 de la câmara coincide con la obligación. La obligación también necesita su prueba del STR, y su período de depósito necesita su PAG0103. La referencia de la API eliminó la recepción de ROC y añadió la lectura de los resultados multilaterales de la câmara. Define los cinco interruptores antes de actualizar.Instalación e idempotencia en Lerian SCR
Una instalación de Lerian SCR atiende a una institución. Un reintento mientras la primera solicitud todavía se ejecuta responde409 SCR-0006, así que envíala de nuevo después de Retry-After. Una respuesta con X-Idempotency-Fenced: true retiene su clave, y un reintento con esa clave responde 422 SCR-0005 sin ejecutarse. SCR-1003, SCR-1004 y SCR-9001 indican si la solicitud llegó a BACEN. Ejecuta una instalación para cada institución y actualiza el manejo de errores de tu integración.Rechazos y plazo de la documentación en Consignado
Un número de contrato tiene de 2 a 15 letras o dígitos en la averbação, el refinanciamiento, la renegociación y la portabilidad entrante. Cuando Dataprev rechaza la documentación, el anexo de CCB responde422 con los códigos de Dataprev en upstream, y el contrato vuelve a esperar su documentación. Envía la documentación corregida con una nueva clave X-Idempotency o excluye el contrato. La lectura de la averbação muestra documentation_due_at y documentation_overdue. DEFAULT_TENANT_ID y DATAPREV_RECONCILIATION_TENANT_ID dejaron de existir, y solo un despliegue multi-tenant lee LEILAO_TENANT_ID. Actualizar un gateway single-tenant (MULTI_TENANT_ENABLED=false) exige una limpieza en la versión actual y una base de datos nueva. Contacta al soporte de Lerian antes de actualizarlo.Con la configuración predeterminada, el gateway publica su manifiesto de permisos en Access Manager durante el arranque, y una publicación fallida detiene el arranque. La publicación exige Access Manager 3.12.0 o posterior, así que actualiza Access Manager antes de actualizar el gateway. Con un servicio de identidad multi-tenant, define IDP_DECLARATION_ENABLED como false, porque rechaza la publicación.Streaming Hub verifica los tipos de evento en el catálogo
Toma cada clave deevent_types del campo eventKey de GET /v1/catalog: el hub puede rechazar una clave que el catálogo no lista en la schema major de la suscripción, con 422 unknown_event_type. Una suscripción nueva también acepta un mapa opcional event_majors, que define la schema major por tipo de evento.Un job de entrega tiene como máximo ocho intentos, y un intento que empieza 24 horas o más después de que el hub recibió el evento es el último. El dashboard rechaza un período que empieza antes del historial que el hub todavía guarda y devuelve coverage_start. Los conteos de salud de la suscripción cubren el intervalo de window_start a snapshot_at.Averbação en dos pasos en Consignado
En Lerian Consignado, la averbação ejecuta solo el Manual 003 de Dataprev, requierenome_trabalhador y no lleva ningún documento. Cuando Dataprev la acepta, la operación responde attachment_pending y el gateway publica consignado.averbacao.accepted. Envía la CCB firmada y la evidencia de firma al anexo de CCB, bajo su propia clave X-Idempotency, dentro de los 7 días que permite el Manual 004.El anexo de CCB ya no ejecuta una averbação. Antes de que Dataprev acepte la averbação, el anexo responde 409 AVERBACAO_NOT_ACCEPTED. Un contrato recibe una sola documentación aceptada. Un paquete distinto responde 409 AVERBACAO_DOCUMENTATION_CONFLICT mientras el primero está aceptado o en camino a Dataprev. La documentación lleva el data_hora_assinatura, el instante en que el trabajador firmó, y la averbação rechaza ese campo.El evento consignado.averbacao.confirmed ahora sigue a la aceptación de la documentación por Dataprev. El saldo devedor que el gateway informa a Dataprev por el Manual 015 ahora empieza cuando Dataprev acepta la averbação, ya no cuando acepta la documentación. La referencia de la API añadió GET y PATCH /v1/consignado/contracts/{numero_contrato}/registro-b3 para el código de instrumento B3 de un contrato con averbação confirmada, y el PATCH publica consignado.registro_b3.registered.Para desistir de un contrato que espera documentos, envía su exclusión. Los documentos enviados después responden 409 AVERBACAO_EXCLUDED, salvo que Dataprev rechace la exclusión. Si la documentación ya está registrada o en camino a Dataprev, la exclusión responde 409 EXCLUSION_DOCUMENTATION_UNDERWAY. Mientras la averbação esté en attachment_pending, envía de nuevo la misma documentación al anexo de CCB y excluye el contrato cuando la averbação esté en confirmed.Las fallas de Dataprev responden 503 DATAPREV_UNAVAILABLE o 504 DATAPREV_TIMEOUT en lugar de CLT-0008, y una lectura de Dataprev con datos inutilizables responde 502 DATAPREV_INVALID_RESPONSE. Las fallas de Tenant Manager, Access Manager y Streaming Hub también responden 503 o 504 con códigos propios, como TENANT_MANAGER_UNAVAILABLE, AUT-0033 y STREAMING_HUB_TIMEOUT. Después de 504 DATAPREV_TIMEOUT, reintenta un comando con la misma clave y nunca con una clave nueva, porque puede haber llegado a Dataprev. La respuesta a la subasta de portabilidad es la excepción, como explica su referencia.Una clave reutilizada en otra solicitud responde 422 IDEMPOTENCY_KEY_REUSE, así que envía una clave nueva. Una respuesta del riel que el gateway no pudo registrar responde 503 OUTCOME_UNKNOWN, así que reintenta con la misma clave. La averbação rechaza fechas y condiciones de contabilización inconsistentes con 422 antes de llamar a Dataprev.Tres códigos 409 reemplazan RAIL_COMMAND_CLAIM_CONFLICT en algunos casos. Un comando distinto con la misma clave responde RAIL_COMMAND_PAYLOAD_MISMATCH, y un reintento de un comando rechazado responde RAIL_COMMAND_ALREADY_REFUSED. Un reintento sin resultado conocido responde RAIL_COMMAND_OUTCOME_UNRESOLVED, así que consulta los comandos del riel y no envíes el comando con una clave nueva.Los rechazos de fondo, de oferta y de plazo de portabilidad responden códigos 422 propios en lugar de CLT-0006, como FUNDO_NOT_REGISTERED, BID_NO_PROPOSTA_LEFT y PORTABILIDADE_WINDOW_EXPIRED.La cesión de un crédito que Dataprev todavía no respondió responde 409 CESSAO_CREDIT_PENDING, y CESSAO_CREDIT_NOT_ACCEPTED ahora significa que Dataprev rechazó el crédito. La lectura de créditos cedidos lista cada crédito con numero_contrato y omite credit_key y id_solicitacao para un contrato sin oferta.Las variables de entorno añadieron IDP_DECLARATION_ENABLED, y OUTBOX_RETENTION_PUBLISHED_HOURS ahora tiene 1 como valor predeterminado. DATAPREV_RECONCILIATION_CNPJS dejó de existir, porque la conciliación del repasse ahora lee todos los empleadores. Envía la averbação sin documentos y los documentos por el anexo de CCB, no contabilices ni desembolses un contrato a partir de consignado.averbacao.accepted y actualiza el manejo de errores de tu integración. Haz este cambio junto con la actualización, porque v3.7.1 todavía exige la CCB firmada en la averbação.Consulta del pagador de Payments BTG v1.0.2
Las páginas de Payments BTG pasaron a v1.0.2. Los pagos de facturas y DARF ahora leen el pagador desde endpoints de CRM que atiendeMIDAZ_LEDGER_URL en /v2, y MIDAZ_CRM_URL ya no configura esa consulta. Antes de actualizar, confirma que la URL del ledger de Midaz atiende endpoints de CRM en /v2.Lerian STA v1.1.0
Las páginas de Lerian STA pasaron a Lerian STA v1.1.0. Lerian STA v1.1.0 puede leer su licencia de un archivo de licencia firmado que emite Lerian. Configura la ruta del archivo enLICENSE_FILE_PATH. Con un archivo de licencia, Lerian STA verifica la licencia localmente y no llama al servicio de licencias. Cuando LICENSE_FILE_PATH está configurada, Lerian STA ignora LICENSE_KEY. Cada entorno necesita LICENSE_FILE_PATH o LICENSE_KEY, y ORGANIZATION_IDS.Lerian SISBAJUD en dos componentes
Las páginas de Lerian SISBAJUD pasaron a dos versiones: la Lerian SISBAJUD Mensageria v1.0.0 y el Lerian SISBAJUD executor v1.0.0. La Mensageria recibe las órdenes como archivos a través de Lerian STA y escribe los archivos de respuesta. El executor ejecuta las órdenes en Midaz y necesita su propia base de datos PostgreSQL. Cada componente tiene sus propias variables de entorno: consulta las páginas de la Mensageria y del executor. La referencia de la API tiene una sección para cada componente, y las URL de las operaciones cambiaron. Antes de pasar a estas versiones, registra cada institución en los dos componentes con el mismoinstitutionId y enabled en true.Lifecycle Management a través del agente BYOC de Lerian
Lifecycle Management pasó del dashboard de Lifecycle al agente BYOC de Lerian, y Lerian retiró el dashboard. Lerian instala, actualiza, hace rollback y elimina productos en tu clúster a través del agente, cuando lo solicitas. Para usar Lifecycle Management, pide al soporte de Lerian la credencial del agente y la dirección del plano de control. Luego, instala el agente con su chart.Variables de licencia de Payments BTG v1.0.1
Las páginas de Payments BTG pasaron a la versión v1.0.1, que valida su licencia cuando inicia. En v1.0.1, cada pod, incluido el worker, necesitaLICENSE_KEY y ORGANIZATION_IDS en todos los entornos. El valor de ORGANIZATION_IDS es global o una lista de UUID de organizaciones en minúsculas, separados por comas. Un rechazo de licencia lleva un código LCS. Las operaciones de la API no cambiaron. Antes de actualizar, define las dos variables en cada pod y abre la regla de salida que describe License Manager.Comisiones deducibles en TED OUT en Bank Transfer v3.1.0
Bank Transfer v3.1.0 rechaza un TED OUT con422 BTF-3002 cuando el paquete de comisiones que coincide con él tiene una comisión con isDeductibleFrom: true. El rechazo se aplica en el modo native y en el modo legacy con BTF_FEE_ENABLED=true. En TED OUT y P2P, el totalAmount es el monto que Bank Transfer debita del remitente, y los límites de uso cuentan ese monto. Las lecturas de transferencias llevan organizationId y ledgerId, List Transfers acepta un filtro ledgerId, y la referencia de la API añadió 422 BTF-2004 y BTF-2005. Bank Transfer pide a Midaz que cree un índice de metadatos de transacción, lo que necesita el permiso settings post de Midaz en los dos modos de comisión. Antes de actualizar, confirma que ningún paquete de plugin-fees con el que puede coincidir un TED OUT tenga una comisión con isDeductibleFrom: true.Nombres de campo en inglés y consulta de clave en Pix JD v1.2.4
Las páginas y la referencia de la API de Pix JD pasaron a la v1.2.4, en la que la consulta de clave acepta unindirectId opcional para un pago que pasa por un participante indirecto. Pix JD añade nombres en inglés para algunos campos de MED 2.0, Pix Automático y la consulta de clave. Cuando un campo tiene un nombre en inglés, el nombre en portugués sigue funcionando y está obsoleto, y dos valores diferentes para un campo responden 400 PIX-0148. Dos rutas de MED tienen paths en inglés que requieren el mismo permiso que las rutas en portugués. Como indica la página de variables de entorno, el riel ya no lee MULTI_TENANT_ALLOW_INSECURE_HTTP a partir de la 1.2.1. En modo multi-tenant con un Tenant Manager en http://, define ALLOW_INSECURE_TLS=true en la API y en el worker antes de esa actualización, o el servicio no inicia.Modo de comisión de Bank Transfer v3.1.0
Bank Transfer v3.1.0, el plugin de TED JD, puede cobrar comisiones mediante el Fees Engine de Midaz.MIDAZ_FEE_MODE elige legacy (plugin-fees, /v1) o native (Midaz, /v2), y el auto predeterminado elige native en Midaz 4.1.0 o posterior. Con auto, si tus paquetes de comisiones todavía están en plugin-fees, las transferencias quedan sin comisión en cuanto Midaz ejecute la 4.1.0 o posterior. native necesita los permisos de Midaz packages get y estimates post, un native explícito también necesita organizations get, y BTF_FEE_ENABLED se aplica solo a legacy. Define MIDAZ_FEE_MODE=legacy antes de actualizar y luego mueve tus paquetes como describe la guía de migración. Pasa a native solo cuando cada pod de Bank Transfer ejecute la 3.1.0 o posterior y los paquetes existan en Midaz.Header de idempotencia y confirmación automática en Matcher v5.0.0
Las páginas y la referencia de la API de Matcher pasaron a Matcher v5.0.0, donde una coincidenciaDATE_LAG va a revisión y la política de duplicados predeterminada es FLAG_AS_EXCEPTION. Matcher v5.0.0 lee una clave de idempotencia solo del header X-Idempotency y no usa una clave en Idempotency-Key o X-Idempotency-Key. Envía las claves de idempotencia en X-Idempotency y revisa las coincidencias que tu proceso espera confirmar de forma automática.Código de MFA y socios en Access Manager v3.10.0
En Access Manager v3.10.0, un usuario que desactiva MFA en su propia cuenta debe enviar un código. Las páginas de socios y las operaciones de socios salieron del sitio. Si tu aplicación permite que los usuarios desactiven MFA o eliminen un método en su propia cuenta, obtén el código y envíalo en la solicitud.Pix JD v1.2.0
Las páginas y la referencia de la API de Pix JD pasaron a la versión v1.2.0 del plugin, que añade una validación de cuenta asíncrona para JD. En v1.2.0, una ruta reclama en JD Courier las recurrencias de Pix Automático. Antes de la actualización, sigue el paso a la 1.2.0 en la página de variables de entorno.Variables de licencia de CCS
La página de variables de entorno de CCS cambióLICENSE_KEY y ORGANIZATION_IDS de obligatorias en producción a obligatorias en todos los entornos. Define las dos variables en todos los entornos, incluido el de desarrollo.Sacador avalista y búsqueda de pagos en Payments BTG
La referencia de la API de Payments BTG quitó el sacador avalista de la emisión de boletos, y una solicitud que envía un sacador avalista responde400 PBP-0001. La página Boletos y pago de facturas añadió cómo encontrar un pago por su Idempotency-Key cuando una solicitud de creación termina sin el id del pago. Quita el sacador avalista de tus solicitudes de boleto y, después de un error, envía la solicitud de nuevo con el mismo Idempotency-Key antes de buscar el pago.Activación de rieles en JD Courier v1.1.0
Las páginas y la referencia de la API de JD Courier pasaron a v1.1.0 y añadieron la activación y la suspensión de un riel. En v1.1.0, el Courier no entrega a los motores ningún mensaje de un riel hasta que un operador activa el riel. Activa cada riel como describe la página de despliegue.Las reservas de Tracer usan solo gRPC en Midaz 4.2.0
En Midaz 4.2.0, el Ledger llega a Tracer para las reservas solo por gRPC, en el puerto 4021 de forma predeterminada. Las operaciones REST de reserva salieron de la referencia de la API de Tracer. Despliega Tracer antes que el Ledger y no regreses Tracer a una versión anterior a la 4.2.0 mientras se ejecute un Ledger 4.2.0.Configuración y actualización de Pix JD v1.0.0
Las páginas de Pix JD pasaron a la versión v1.0.0 del plugin. En v1.0.0, la organización, el ledger, el activo y la cuenta de compensación de Midaz vienen del binding del systemplane y de dos clavestenant_policy/midaz.*, y los pagos y las devoluciones requieren X-Idempotency. Sigue los nuevos pasos de actualización: escribe primero las claves tenant_policy/midaz.* y después elimina las variables de identidad MIDAZ_* retiradas.Flujo y consulta del pago de facturas en Payments BTG
Las páginas de Payments BTG añadieron los pasos de un pago de factura: el ledger reserva los fondos antes de que BTG reciba el pago. Un resultado desconocido responde202 con el estado UNCONFIRMED, la referencia añadió una operación de consulta de factura y la lista de errores añadió siete códigos y quitó PBP-0209. No envíes de nuevo un pago UNCONFIRMED con un nuevo Idempotency-Key y define CONSULT_AUDIT_HMAC_KEY: un pod que atiende la API de pagos no arranca sin ella.Formato de error de TED JD v3.0.1
En TED JD v3.0.1, cada error es un documento de problema RFC 9457 enapplication/problem+json, y un código de JD SPB está en upstream.code. Actualiza el manejo de errores de tu integración.Variables de licencia de SISBAJUD v1.2.0
Lerian SISBAJUD v1.2.0 requiereLICENSE_KEY y ORGANIZATION_IDS en todos los entornos. Define las dos variables.Nombre del entorno en el chart de Access Manager
La página de Helm de Access Manager añadió el nombre del entorno. El valor predeterminado del chart esdevelopment. Para cualquier entorno distinto de development, staging o local, expón Caradhras por https con un certificado de una autoridad de certificación pública. Luego apunta Auth e Identity a esa dirección https.Rechazos de Streaming Hub v2.3.0
En Streaming Hub v2.3.0, un rechazo401 o 403 es un documento de problema con el código unauthorized o forbidden. El hub responde 503 cuando Access Manager no devuelve un veredicto. Actualiza el manejo de errores de tu integración.Páginas de Lerian Console v2.6.0
Las páginas de la Console pasaron a corresponder a Lerian Console v2.6.0. La actualización añadió páginas para las instituciones de Reporter, las operaciones de TED IN, las rutas contables de TED JD y las devoluciones de Pix BTG, y cubrió los parámetros de reporte y el estadoPartial failure. La actualización eliminó las páginas de Console de BC Correios. La Console muestra el client secret de una aplicación una vez, cuando creas la aplicación. Guárdalo en ese momento.Revisión recomendada
Planes de tarifas y cobros de comisiones en Midaz 4.4.0
Las páginas de Fees y la referencia de la API del Ledger pasaron a Midaz 4.4.0. Un plan de tarifas es un conjunto de comisiones que asignas a una cuenta, con una cuota gratuita para cada comisión y mes calendario. En las transacciones/v2 que envía una cuenta con un plan activo, el plan cobra a esa cuenta en lugar de los paquetes de comisiones. Cobras las comisiones de servicio de un plan con un cobro de comisiones, y la lectura de uso devuelve las unidades de una cuenta en un mes. Un paquete de comisiones puede redondear cada comisión que cobra con rounding. Obtener los totales de saldos por clave y activo devuelve los totales disponibles y retenidos de los saldos de una clave y un activo en un ledger.Para usar los planes de tarifas, da los permisos account-plans y fee-charges de Midaz a las aplicaciones que los llaman. Usar planes de tarifas muestra cada paso.TED entre cores y etiquetas de comisión en Bank Transfer v3.4.0
Las páginas y la referencia de la API de TED JD pasaron a Bank Transfer v3.4.0. Cuando tu institución opera dos cores en un ISPB, una TED entre tus dos cores pasa por el relay de JD Courier como una TED entre cores, con los tipos de transferenciaCROSS_CORE y CROSS_CORE_IN. El plugin confirma la retención cuando el otro core acredita al destinatario, y la libera cuando el otro core rechaza el crédito en el primer intento. Una TED entre cores necesita la política de tenant onus.shared_ispb_gate_enabled, las variables de JD Courier y los vínculos CROSS_CORE_OUT, CROSS_CORE_IN y CROSS_CORE_RETURN_IN en el enrutamiento del ledger.En el modo de comisión native, una iniciación puede llevar una etiqueta de comisión en feeContext, y un paquete de comisiones en el ledger del pagador selecciona por ella. Una etiqueta que ningún paquete selecciona se rechaza con 422 BTF-0008. Los catálogos de eventos sumaron Eventos de TED JD, con el payload de cada evento.Lerian SCR durante una caída de BACEN
Durante una caída de BACEN, Lerian SCR sigue en rotación:scr_endpoint reporta la caída, y /readyz no pasa a 503. Una consulta que nunca llegó a BACEN responde 503 con SCR-1002, y su detail nombra a BACEN. Revisa las alertas que usan el readiness de Lerian SCR para detectar una caída de BACEN.Hechos de averbação para fondos y originadores en Streaming Hub v3.0.0
Una suscripción limitada a un fondo o a un originador puede recibir los cuatro hechos de averbação de Lerian Consignado. Un originador los recibe solo cuandooriginador_ref lo nombra, y un fondo solo cuando remetente_fundo_ref lo nombra.Una suscripción limitada que omite event_types los recibe sin ningún cambio en la suscripción. Una suscripción limitada que lista sus tipos de evento recibe solo los tipos que lista. Para recibir otro hecho de averbação, crea una suscripción nueva que lo liste.Inicio de sesión con passkey en Access Manager v3.14.0
Las páginas de Access Manager y las referencias de las API de Auth e Identity pasaron a Access Manager v3.14.0. Cuando tu organización activa el inicio de sesión con passkey, una persona puede iniciar sesión con una passkey en lugar de una contraseña. Un inicio de sesión con passkey no pide un segundo factor. Mientras la opción está activada, Auth rechaza el inicio de sesión con contraseña de una persona que tiene una passkey con403 AUT-1019. Las passkeys y el SSO se excluyen.Cada persona agrega y quita su propia passkey con la API de Identity. En un despliegue BYOC, define MFA_SECRET en Auth antes de activar las passkeys. Lee Passkeys para ver las llamadas, los permisos y los requisitos de despliegue.Resultados de la TED recibida en TED Lerian
Una TED recibida para una cuenta de la institución termina enRECORDED, no acredita a ningún cliente y publica incoming_transfer.recorded. Una cuenta es de la propia institución cuando el documento de su titular en el CRM de Midaz es el CNPJ de la organización a la que está vinculado el ISPB. TED Lerian devuelve una TED para una cuenta de cliente cuyo closingDate en el CRM de Midaz es hoy o anterior, con el motivo oficial 1 (cuenta cerrada). Cuando una consulta al CRM de Midaz falla o no da una respuesta clara, la TED va a revisión manual.Los vínculos de ISPB aceptan solo la organización y el ledger donde esta instalación acredita las TEDs recibidas, y rechazan cualquier otro con 422 TED-0002. Sin un horario de corte, la ventana de operación sigue el horario oficial del STR. Revisa cómo tu sistema maneja RECORDED e incoming_transfer.recorded.Respuestas tardías de BACEN en Lerian SCR
Cuando BACEN responde después de que una consulta ya respondióSCR-1004, Lerian SCR igual escribe esa respuesta en su caché de resultados. Un acierto completo en la caché evita la llamada a BACEN y la tarifa. El servicio no arranca cuando Postgres no responde en un plazo de 10 segundos. Revisa cómo tu integración reintenta una consulta después de SCR-1004.Recorridos de los rieles nativos y el evento de liquidación de SPB
En los recorridos de SLC, SILOC y STR de Diagramas de integración, Lerian publica un crédito del ciclo de tarjetas, la devolución de un depósito excedente y un crédito LTR0005R2 como el evento de Lerian SPBspb.ldl.third-party-settlement-received. Tu institución envía el depósito del ciclo de tarjetas (LDL0022) por su propia conexión con el STR y recibe ahí la respuesta LDL0022R1. La disputa SLC0002, los archivos ASLC del domicilio, la DDA0101, el ROC y los pasos de la registradora de recibibles ocurren entre tu institución y la infraestructura, fuera de Lerian.Para los créditos liquidados y devueltos, esta entrada reemplaza la entrada del 15 de octubre de 2026 sobre SLC. Revisa tus suscripciones y runbooks operativos con los recorridos revisados.Recorridos de Pix y de TED
La sección Rieles nativos de Diagramas de integración añadió recorridos de Pix Lerian sobre Lerian SPI. Son Enviar y recibir Pix, Cobrar con un código QR dinámico, Devolver un Pix recibido, Autorizar y pagar con Pix Automático, y Reportar un fraude y recuperar fondos. La sección también añadió recorridos de TED Lerian sobre Lerian SPB: Enviar y recibir TED, y Cancelar o devolver una TED. El índice de mensajes lista los códigos de mensaje de estos recorridos.Página Fee Debts del módulo Midaz
Las páginas de Fees Engine del módulo Midaz añadieron una guía de Fee Debts. Muestra cómo filtrar las deudas de comisión de un ledger por saldo y por estado, y qué significa cada columna. La acción Collect se aplica a todas las deudas abiertas de un saldo. Midaz las liquida de la más antigua a la más reciente, hasta el saldo disponible. Midaz no cobra comisión sobre un cobro, y no puedes revertirlo. Para definir un monto máximo, usa la API de cobro conmaxAmount.Grupos de acceso de Reporter
La página ¿Qué es Reporter? lista los tres grupos de acceso que Reporter declara en Access Manager. El gruporeporter-viewer-group lee. El grupo reporter-contributor-group lee, crea y cambia. El grupo reporter-editor-group también elimina y aprueba una presentación regulatoria. El grupo de administradores de Access Manager, admin-group, tiene el mismo acceso que reporter-editor-group. Revisa el grupo de cada usuario de Reporter.Catálogo de eventos y host de Try It
El resumen de streaming de eventos lista Pix Lerian y TED Lerian, con sus páginas de eventos y las rutas de sus manifiestos de streaming. El Try It de las referencias de las API de TED JD, Payments BTG, Pix BTG y BC Correios usa un host de ejemplo. Reemplázalo con la URL que recibes en el onboarding del entorno.Transacciones en Midaz 4.3.0
Las páginas de Midaz y la referencia de la API del Ledger pasaron a Midaz 4.3.0. Una transacción/v2 acepta un scheme opcional que nombra su esquema de pago, por ejemplo PIX o CARD. En /v2, una ruta contable puede vincular rutas de operación opcionales en optionalOperationRoutes. Una transacción de bloqueo o de desbloqueo no se puede revertir, y una reversión responde 0539.Esquemas de pago y validación solo por reglas en Tracer
Las páginas y la referencia de la API de Tracer pasaron a Midaz 4.3.0. Tracer aceptascheme como un campo abierto de 1 a 50 caracteres: A-Z, 0-9, _ y -. Una validación solo por reglas decide únicamente por las reglas y no verifica ni cuenta ningún límite de gasto. El endpoint de uso del límite informa el período actual, y cada cifra de uso incluye la capacidad que retienen las reservas del ledger aún no confirmadas. Un maxAmount de 0 deniega cada transacción de su alcance.Páginas de Lerian Console v2.16.0
Las páginas de Console cambiaron para coincidir con Lerian Console v2.16.0. En Payments, el ledger viene del encabezado de Console, y eliges la cuenta debitada por su alias o por su ID completo. Boletos emite un boleto a la vez. Las páginas de Fees añadieron la pantalla Fee Debts, que necesita Midaz 4.2.0 o posterior, y los campos Metadata selector y Deferrable de un paquete. Un límite de Tracer recibe su Reset Time (UTC) cuando lo creas y puedes eliminar una ruta contable.Verificación de fraude y desbloqueo de devoluciones en Pix BTG v1.11.0
Las páginas y la referencia de la API de Pix BTG pasaron al plugin v1.11.0. Las páginas añadieron la verificación de fraude en Pix entrantes y en devoluciones entrantes, donde el plugin consulta un endpoint de decisión que tú operas. La verificación está desactivada por defecto, yANTIFRAUD_HOOK_ENABLED la activa. Las páginas de devoluciones describen el desbloqueo de devoluciones en PENDING y de devoluciones de cash-out en CREATED. La referencia de la API añadió Complete a charge.TED Lerian
La sección Interfaces tiene una guía de TED Lerian. TED Lerian es la interfaz que conecta Midaz con Lerian SPB. Envía TEDs, hace transferencias internas, recibe TEDs, devuelve un TED recibido y cancela un TED. Midaz registra el dinero. Las páginas Eventos e integración con el ledger y Operar Lerian SPB salieron de la sección TED Lerian y pasaron a la sección SPB (TED) de Rieles Brasil. La Referencia de API agregó TED Lerian y su lista de errores.Lerian SRC
La pestaña Rieles Brasil y la Referencia de API agregaron Lerian SRC. Lerian SRC envía consultas de restricción a BC Protege+ de BACEN antes de que tu institución abra una cuenta o cambie la titularidad de una relación existente. Registra el veredicto de BACEN para cada consulta y mantiene una pista de evidencias.Lerian BC Correios
La pestaña Rieles Brasil y la Referencia de API agregaron Lerian BC Correios. Lerian BC Correios recoge de BACEN los correos de BC Correio de tu institución, los almacena con un registro de auditoría y envía mensajes a los departamentos de BACEN.Guía de inicio de Access Manager
La guía del ciclo de vida de Access Manager ya no trata la disponibilidad de PostgreSQL, Valkey o Caradhras como requisito para iniciar el servicio. Confirma la preparación con las comprobaciones de estado antes de activar el control de acceso en un producto.Eventos de clearing de SLC en los diagramas de integración
Los diagramas de integración de SLC ahora identifican los eventos de vista previa de posiciones, créditos liquidados y créditos devueltos. Revisa tus suscripciones y runbooks operativos con los recorridos actualizados.Modelo de cuentas y saldos de Midaz
La guía de cuentas y saldos de Midaz ahora distingue las cuentas separadas de un cliente de varios saldos dentro de una sola cuenta. Revisa el modelo de cuentas y los controles a nivel de saldo con la guía actual.Páginas de Lerian Console v2.13.0
Las páginas de la Console pasaron a corresponder a Lerian Console v2.13.0, y Versiones de los productos lista la versión de producto que necesitan algunas pantallas. Cuando un producto ejecuta una versión anterior, un aviso como Requires Bank Transfer 3.1.0 or later reemplaza esa parte de la pantalla. El módulo Tracer abre en su dashboard con Tracer 4.1.0 o posterior, y la Console ya no leeNEXT_PUBLIC_TRACER_DASHBOARD_ENABLED. En Bank Transfer, la lista Transfers y la tarjeta Recent Transfers muestran las transferencias del ledger seleccionado. En TED Out y P2P, Total muestra el monto debitado del remitente, y la configuración de Fee Policy aplica solo en el modo de comisión legacy. Una nueva página describe Environments, la pantalla que lista los entornos en los que tienes una cuenta y permite elegir tu entorno predeterminado.Access Manager v3.11.1 y socios
Las páginas y las referencias de las API Auth e Identity de Access Manager pasaron a Access Manager v3.11.1. La referencia de Auth añadió las operaciones de descubrimiento e inicio de SSO, y la referencia de Identity añadió las operaciones de socios, de catálogo de ámbito y de tenants propios. Las guías de socios volvieron, con una visión general, una guía de la Console y una guía de la API. Puedes dar permisos a un socio solo en un producto que acepta socios, y la visión general indica cómo encontrar esos productos en tu despliegue. Una solicitud para eliminar un grupo que tiene miembros o subgrupos ahora responde409 con IDE-1058 o IDE-1059. La lista de errores también añadió AUT-0033, AUT-1011, AUT-1012, IDE-0064, IDE-0065 y IDE-0066, y la página de aprovisionamiento automático de Tenant Manager salió del sitio.Módulo Matcher de Lerian Console
Las páginas de la interfaz de Matcher pasaron a describir el módulo Matcher de Lerian Console v2.12.0.Páginas de Lerian Console v2.12.0
Las páginas de la Console pasaron a corresponder a Lerian Console v2.12.0. En v2.12.0, abres Authorization desde la barra lateral de Settings o desde el menú de engranaje, y la lista de aplicaciones tiene una columna Description. La página Productos añadió Matcher.Recorridos en Diagramas de integración
La pestaña Diagramas de integración tenía cuatro secciones: Productos Lerian, Rieles nativos, Interfaces de socios e Infraestructuras de mercado. Rieles nativos traía los recorridos de SLC, SILOC y STR para crédito con garantía y liquidación diaria, con una columna de Lerian que muestra el endpoint o el evento de cada paso entre tu institución y Lerian. Un índice de mensajes lista cada código y sus recorridos. En las páginas de rieles, los manuales oficiales prevalecen sobre los diagramas.Organización de las pestañas y Diagramas de integración
El sitio reagrupó sus pestañas y quitó la pestaña Soluciones y sus páginas. Plataforma pasó a ser una sección de Productos Lerian, e Interfaces pasó a ser una sección de Rieles Brasil, sin cambios en las direcciones de sus páginas. El sitio añadió una pestaña Diagramas de integración antes de Referencia de API.JD Courier
La pestaña Interfaces y la Referencia de API añadieron JD Courier. JD Courier permite que dos o más motores de core bancario compartan un canal JD y un ISPB en SPB (TED) y en Pix. Se ejecuta en BYOC y en Lerian Cloud.Deuda de comisión en Midaz 4.2.0
En Midaz 4.2.0, la parte no pagada de una comisión diferible en una transacción directa/v2 puede convertirse en una deuda de comisión que los créditos /v2 siguientes liquidan, de la más antigua a la más reciente. La deuda de comisión está desactivada de forma predeterminada, y Valkey debe persistir sus claves.Referencia de la API de Identity de Access Manager
La referencia de la API de Identity perdió las operaciones de socios, de catálogo de alcances y de tenants del usuario. La lista de errores de Access Manager añadióIDE-0038.Consignado v3.7.0
La referencia de la API de Consignado añadió una operación que lee el cadastro guardado con una averbação, y la referencia de eventos pasó a corresponder a lo que emite v3.7.0. En Lerian Consignado v3.7.0, el saldo devedor enviado a Dataprev es el valor presente de las cuotas impagas.Sin acción
Midaz v4.2.2
Las páginas de Midaz y las referencias de la API de Ledger y Tracer pasaron a Midaz v4.2.2. Las operaciones de la API no cambiaron.Variables de entorno de SPI
La página de variables de entorno de SPI quitóBACEN_SPI_SIGNING_KEY_FILE.Obsolescencia
Campo de tipo de transacción de Tracer obsoleto
En Midaz 4.3.0,transactionType es el nombre obsoleto del scheme de Tracer. Todavía funciona en solicitudes, alcances de reglas y de límites, expresiones CEL y eventos. Los filtros de listado de reglas, límites y eventos de auditoría aceptan transaction_type como el nombre obsoleto de scheme. Usa scheme en tu integración, en las reglas y en los límites.ENV_NAME de Bank Transfer obsoleto
En Bank Transfer v3.2.0,ENVIRONMENT_NAME reemplaza a ENV_NAME, que todavía funciona como su nombre obsoleto. El servicio no arranca cuando las dos variables nombran entornos distintos. Define ENVIRONMENT_NAME y quita ENV_NAME.