Access Manager
Access Manager v3.15.0: cadastre um método de MFA exigido durante a entrada
No Access Manager v3.15.0, quando a organização exige um método de MFA que um usuário não cadastrou, a entrada respondeAUT-0019 com um token de MFA válido apenas para a adesão. O usuário configura e confirma o método com Iniciar adesão à MFA e Confirmar adesão à MFA e, depois, conclui o desafio de MFA.Trate AUT-0019 em Solicitar token de acesso e em Verificar login por MFA.SPB
Ativação de certificado e fechamento por dois operadores no Lerian SPB
As páginas e a referência de API do Lerian SPB passaram para a build mais nova do Lerian SPB. O trilho lê o código do certificador de uma ativação a partir do emissor do certificado, então a requisição de ativação não traz maiscertifierCode, e um corpo que o envia responde 422. Um certificado que você rotacionou antes desta versão não tem código do certificador registrado, e a ativação dele responde SPB-0003. Cada dia do demonstrativo de uma declaração de compulsório traz mode, I ou A. Dois operadores podem fechar como falha qualquer mensagem que passou do prazo de liquidação, e não apenas uma transferência, e podem declarar uma perna LDL ou LTR a partir de uma resposta do STR que o trilho reteve sem ler. O trilho agora fecha uma perna LDL ou LTR que nunca enviou quando a grade do STR dela fecha ou o dia termina.Antes de ativar um certificado que você rotacionou antes desta versão, rotacione-o de novo. Remova certifierCode das suas requisições de ativação. Envie mode em cada dia de uma declaração de compulsório.SPI
Respostas do Pix Automático e bloqueios de consulta DICT no Lerian SPI
As requisiçõespain.014, camt.029 e camt.055 do Pix Automático do Lerian SPI aceitam apenas a decisão. O rail lê os participantes e os identificadores da mensagem que registrou, e qualquer outro campo recebe 422. O bloqueio de consulta DICT recebe e devolve payerId, o CPF ou CNPJ do usuário final, no lugar de payerIdHash. Ao atualizar, todo bloqueio de consulta DICT é removido.Envie apenas os campos da decisão nessas três requisições. Depois de atualizar, registre de novo cada bloqueio de consulta DICT com payerId.SILOC
Requisições retidas e ciclo LBTR no Lerian SILOC
As páginas e a referência de API do Lerian SILOC passaram para a build mais nova do Lerian SILOC. Dois operadores diferentes agora podem encerrar uma requisição de saída retida à espera de uma resposta que a Núclea nunca enviou.GET /api/v1/siloc/outbound/messages aceita held=true para listar essas requisições. Uma requisição FAILED pode, portanto, ser uma que a Núclea talvez tenha recebido, e o evento studio.lerian.br-siloc.siloc_outbound.failed dela traz o motivo. Um LTR0002 ou LTR0008 para uma operação cuja resposta anterior está ativa responde 409 e SILOC-0026. Um 503 e SILOC-0002 agora significa que o comando não executou.Não trate uma requisição FAILED como prova de que ela nunca chegou à Núclea. Liste as requisições retidas. Peça a dois operadores que encerrem uma somente depois de confirmar com a Núclea que ela não vai responder. Trate SILOC-0026 na sua integração. Envie de novo, com a mesma chave X-Idempotency, uma requisição recusada com SILOC-0002.Narya
Teto de gasto dos agendamentos e sessões de produto no Narya
As páginas do Narya passaram para a build mais nova do Narya. Um agendamento tem um teto de gasto apenas quando você define um, com--budget ou [schedules] ceiling_usd. O Narya não dá mais a um novo agendamento um teto de $5.00 por disparo, e um agendamento guardado mantém o teto que tem. Uma sessão de produto trabalha na API de um produto Lerian, e o dono dela confirma cada escrita. Scripts de workflow podem chamar ferramentas com callTool, e os hooks Stop do Claude Code rodam quando um turno termina. O config.toml pode declarar endpoints que usam http simples. Uma execução de workflow, ou uma sessão que não é de produto, que você inicia pela API sem clientKind não é acompanhada, e o Narya recusa os pedidos de permissão dela.Defina um teto em cada agendamento que precisa de um. Rode narya schedule budget <schedule-id> none para remover um teto. Envie clientKind inline ou tui, ou defina a postura da sessão como attended, quando uma pessoa responde aos pedidos.TED
Erros de devolução e fechamento do dia no TED Lerian
As páginas e a referência de API do TED Lerian passaram para a build mais nova do TED Lerian. Nas duas ações de devolução de TED recebida,TED-1011 é um HTTP 422. Uma devolução cuja resposta do trilho é desconhecida (TED-1010) continua solicitada até que a conciliação ou a revisão manual a feche. Quando o ledger recusa um estorno (TED-1001), o crédito permanece e a transferência recebida vai para revisão manual. No fechamento do dia, uma TED pendente que o trilho não conhece passa para AWAITING_RECONCILIATION. Os eventos de devolução de TED recebida trazem previousStatus.Trate TED-1011 como 422 nas ações de devolução. Depois de um TED-1010 em uma devolução, leia o status da TED antes de agir de novo. Aceite AWAITING_RECONCILIATION para uma TED pendente.Lerian ConsoleMidazReporter
Rotas de operação opcionais e arredondamento de tarifas no Console v3.0.0
As páginas do Console passaram para o Console v3.0.0. Uma rota contábil pode marcar uma rota de operação como opcional, e uma transação pode deixar uma rota opcional sem uso. O Console verifica a rota em Go to Review e de novo quando você envia. Um pacote de tarifas pode arredondar todas as tarifas que ele cobra, com o Midaz 4.4.0 ou posterior. A maioria das telas mostra datas e horas no horário de Brasília, qualquer que seja o fuso do navegador. As telas do Reporter agrupam os documentos regulatórios em Regulatórios: Catálogo, Meus regulatórios e Entregas.Revise suas rotas contábeis e marque como opcional cada rota de operação que algumas transações deixam sem uso.Reporter
Chave de licença, calendário de relatórios e períodos de remessa no Reporter v4.6.0
As páginas e a referência da API do Reporter foram atualizadas para o Reporter v4.6.0. O Reporter não inicia sem uma chave de licença da Lerian emLICENSE_KEY. Quando REPORT_TIMEZONE não está definida, os dias dos relatórios e os períodos de remessa seguem America/Sao_Paulo. Cada remessa regulatória registra o seu período e o seu tipo de remessa, original ou substituição. Um mapeamento pode fazer join e calcular em qualquer leitura, ler listas e campos aninhados do MongoDB e ler um conjunto de várias fontes de dados. Você pode ver previamente uma consulta de um mapeamento e ler as linhas de uma remessa. Os filtros de relatório aceitam startsWith, notStartsWith, isNull e notNull. Um filtro nin no PostgreSQL também retorna as linhas sem valor. O papel do reporter-contributor-group agora é operator, com o mesmo acesso.Antes de atualizar, defina LICENSE_KEY para cada processo do Reporter. Se os seus livros fecham em UTC, defina REPORT_TIMEZONE=UTC. Revise os relatórios que filtram com nin no PostgreSQL. Reescreva cada mapeamento salvo que usa sign, statedIn ou accumulate, porque o Reporter v4.6.0 não o carrega.Tracer
O Tracer no Midaz 4.4.0 verifica os valores de configuração na inicialização
No Midaz 4.4.0, o Tracer não inicia quando uma variável de ambiente tem um valor que ele não consegue ler, e o erro informa o nome da variável. Por exemplo,API_KEY_ENABLED=1 e AUTH_CACHE_TTL=60 impedem a inicialização. O Tracer também verifica os valores de STREAMING_* quando o streaming está desligado.Antes de atualizar, escreva cada variável booleana como true ou false, e cada AUTH_TIMEOUT e AUTH_CACHE_TTL com unidade, como 60s. Variáveis de ambiente lista as verificações.Midaz
Atualização para o Midaz 4.4.0: valores de configuração e aliases duplicados
No Midaz 4.4.0, o Ledger não inicia quando uma variável de ambiente tem um valor que ele não consegue ler, e o erro nomeia a variável. Um booleano aceita apenastrue ou false, um número precisa ser inteiro e uma duração precisa de uma unidade, como 12s. A migração de onboarding é interrompida se um ledger tiver duas contas com o mesmo alias ou dois ativos com o mesmo código. Contas e ativos excluídos não contam. A migração lista os duplicados, e o Midaz não os mescla nem os exclui.Antes de atualizar, confira os seus valores de ambiente. Se a migração for interrompida, entre em contato com a Lerian antes de rodar a atualização de novo.Midaz
Planos de tarifas e cobranças de tarifas no Midaz 4.4.0
As páginas de Fees e a referência da API do Ledger foram atualizadas para o Midaz 4.4.0. Um plano de tarifas é um conjunto de tarifas que você atribui a uma conta, com uma cota gratuita para cada tarifa e mês calendário. Nas transações/v2 que uma conta com um plano ativo envia, o plano cobra essa conta em vez dos pacotes de tarifas. Você cobra as tarifas de serviço de um plano com uma cobrança de tarifas, e a leitura de uso retorna as unidades de uma conta em um mês. Um pacote de tarifas pode arredondar cada tarifa que cobra com rounding. Consultar os totais de saldos por chave e ativo retorna os totais disponíveis e em bloqueio dos saldos de uma chave e um ativo em um ledger.Para usar os planos de tarifas, dê as permissões account-plans e fee-charges do Midaz às aplicações que os chamam. Usar planos de tarifas mostra cada passo.PixTED
Relay entre cores, reivindicação de contas e trânsito Pix no JD Courier v1.2.0
As páginas e a referência da API do JD Courier foram atualizadas para a v1.2.0. O Courier repassa um crédito ou uma devolução de TED, ou um cash-in ou uma devolução de Pix, entre dois motores da sua instituição. Relay entre cores traz o contrato que cada motor segue, inclusive o outro core. Um motor pode reivindicar as próprias contas, os CNPJs dos seus cobradores do Pix Automático e o lado do cobrador das suas recorrências. Com o trânsito Pix, os motores também enviam as próprias chamadas Pix à JD pelo Courier. Um motor pode ter várias aplicações do Access Manager, uma para cada produto que chama o Courier.A JD chama o endereço Pix do Courier como um parceiro do Access Manager da sua instalação. Configure o parceiro como descreve Access Manager. Os operadores não declaram mais um bypass no SPB. Variáveis de ambiente do JD Courier lista as variáveis do Courier.SISBAJUD
Custódia de chaves no AWS KMS, registros de ordem e papéis do executor no Lerian SISBAJUD v1.1.0
As páginas e a referência da API do Lerian SISBAJUD foram atualizadas para a Mensageria v1.1.0 e o executor v1.1.0. Com o AWS KMS,KMS_AWS_KEY_MODE define a custódia das chaves de cada componente. No modo managed, o componente cria as suas chaves para cada instituição. No modo provided, você cria as chaves, e o componente registra cada rotação que o custodiante das suas chaves faz. AWS KMS na Mensageria lista os requisitos da chave e as permissões da AWS.A Mensageria registra o aviso de uma transferência judicial a receber (registro 08). Um arquivo de resposta de bloqueio responde a ele com o código 01. A Mensageria estaciona os pedidos de esclarecimento (registro 09) e as interrupções de um bloqueio permanente (registro 10). Responda manualmente a um pedido de esclarecimento estacionado. Depois de uma interrupção estacionada, novos créditos podem continuar bloqueados até que você pare o bloqueio manualmente.O executor declara os papéis viewer, operator, investigator, cross-org-reader, admin e platform-admin. Papéis lista as permissões de cada papel. Uma rotação de chave pode retornar os novos códigos SBJ-0012, SBJ-0013 e SBJ-0014. A lista de erros os descreve.TED
TED entre cores e rótulos de tarifa no Bank Transfer v3.4.0
As páginas e a referência da API do TED JD foram atualizadas para o Bank Transfer v3.4.0. Quando a sua instituição opera dois cores em um ISPB, um TED entre os seus dois cores passa pelo relay do JD Courier como um TED entre cores, com os tipos de transferênciaCROSS_CORE e CROSS_CORE_IN. O plugin confirma a retenção quando o outro core credita o destinatário, e a libera quando o outro core recusa o crédito na primeira tentativa. Um TED entre cores precisa da política de tenant onus.shared_ispb_gate_enabled, das variáveis do JD Courier e dos vínculos CROSS_CORE_OUT, CROSS_CORE_IN e CROSS_CORE_RETURN_IN no roteamento do ledger.No modo de tarifa native, uma iniciação pode levar um rótulo de tarifa em feeContext, e um pacote de tarifas no ledger do pagador seleciona por ele. Um rótulo que nenhum pacote seleciona é recusado com 422 BTF-0008. Os catálogos de eventos ganharam Eventos do TED JD, com o payload de cada evento.SPB
Fechamento da grade e quedas do queue manager no Lerian SPB
O Lerian SPB reenvia uma mensagem que não saiu, sem limite de tentativas. Após o fechamento da sua grade do STR no seu dia de movimento, o trilho fecha essa mensagem comoFAILED sem enviá-la. Uma transferência ou uma movimentação então informa settlement.failed. O trilho não fecha uma mensagem LDL ou LTR dessa forma. O trilho marca como SENT uma transferência que um envio pode ter entregado. Essa transferência aguarda a resposta do BACEN ou que operadores a fechem como falha. DISPATCH_MAX_AUTO_ATTEMPTS deixou de existir.Enquanto a conexão com o queue manager está fora do ar, o trilho continua atendendo leituras. Ele recusa cada requisição que enviaria uma nova mensagem STR com 503 e SPB-1001, e não armazena nada para essa requisição. Trate SPB-1001 na sua integração: envie a requisição de novo com a mesma chave X-Idempotency quando a conexão voltar.Narya
Servidores de ferramentas de um repositório confiado no Narya
O Narya lê o.mcp.json de um repositório em que você confia e inicia os servidores de ferramentas MCP que ele declara. Apenas as sessões desse repositório recebem as ferramentas deles, e o narya host status lista esses servidores com o repositório deles. O custo de uma requisição precificada pelo catálogo de modelos conta a tarifa do fornecedor de $0.01 para cada busca na web. Os tetos de gasto contam essa tarifa.Antes de atualizar, revise o .mcp.json de cada repositório em que você confia. O Narya inicia os servidores que ele declara sob a sua resposta de confiança atual.SPI
Requisições como participante direto e arquivo regulatório no Lerian SPI
O Lerian SPI envia o teste de conectividade, a solicitação de relatório da Conta PI, o relatório de liquidação do MED 2.0 e o registro dos responsáveis como seu participante direto. Ele faz o mesmo com as solicitações de mandato e de agendamento do Pix Automático, suas respostas de aceite ou rejeição e seus cancelamentos. Os corpos dessas requisições não recebemparticipantIspb, e um corpo que o traz recebe 422. O cancelamento de agendamento também não recebe counterpartyIspb nem requestedBy. GET /api/v1/spi/responsibles retorna os responsáveis do seu participante direto. O trilho arquiva cada envelope ICOM e cada requisição e resposta do DICT. Um usuário com o recurso br-spi-regulatory-archive lê um item arquivado por meio de GET /api/v1/spi/regulatory-archive/{itemId}. Para um Pix enviado que o BACEN não respondeu, a resolução manual o declara SETTLED ou REJECTED, com uma aprovação que nomeia esse resultado.Remova participantIspb, counterpartyIspb e requestedBy dos corpos dessas requisições. Defina as variáveis do arquivo regulatório para os binários spi e dict: fora de um ambiente de desenvolvimento, eles não iniciam sem um bucket.STA
Chaves de idempotência no Lerian STA v1.2.0
As páginas e a referência da API do Lerian STA passaram para o Lerian STA v1.2.0. A criação de transferência e a consulta manual de entrada precisam de um headerX-Idempotency. Uma requisição sem ele retorna 400 com STA-0001. Durante 7 dias, uma repetição com a mesma chave e a mesma requisição retorna a primeira resposta de sucesso, e o Lerian STA não cria a transferência nem roda a consulta de novo. A mesma chave com uma requisição diferente retorna 422. O Lerian STA não tem modo multi-tenant: uma instalação atende um cliente, e o Lerian STA não lê mais DEFAULT_TENANT_ID. Os eventos do Lerian STA carregam o tenant default em ce-tenantid.Antes da atualização, envie uma chave X-Idempotency com cada criação de transferência e cada consulta manual. Mantenha a mesma chave quando tentar de novo a mesma requisição. Se os seus consumidores de eventos filtram por ce-tenantid, ajuste o filtro para default. O Lerian CCS v1.0.0 envia os lotes ACCS001 sem o header X-Idempotency, e o Lerian STA v1.2.0 os recusa. Se você roda o Lerian CCS v1.0.0, mantenha o Lerian STA na v1.1.0.SILOC
Fechamento do LBTR e indisponibilidades da Núclea no Lerian SILOC
O Lerian SILOC recusa uma decisãoLTR0002 ou LTR0008 enviada pela API às 17h30 de Brasília ou depois com 422 e SILOC-0025, e não armazena nada. Uma requisição não enviada termina FAILED quando o prazo dela acaba: LTR0002, LTR0008 e SLC0004 às 17h30 do seu dia de movimento, e os outros códigos quando o dia de movimento deles termina. Cada requisição FAILED publica studio.lerian.br-siloc.siloc_outbound.failed. REDIS_DB, CERT_READINESS_MIN_DAYS, SFN_CUSTODY_CACHE_ENTRIES e XSD_VALIDATOR_TIMEOUT_SEC precisam conter um inteiro, ou o serviço não inicia.Enquanto o queue manager do SILOC da Núclea não está acessível, o serviço continua em rotação. Ele recusa cada nova requisição de saída com 503 e SILOC-0024, e não armazena nada. Trate SILOC-0025 e o resultado FAILED na sua integração. Envie de novo uma requisição recusada com SILOC-0024 com a mesma chave X-Idempotency quando a conexão voltar.SCR
O Lerian SCR durante uma indisponibilidade do BACEN
Durante uma indisponibilidade do BACEN, o Lerian SCR continua em rotação:scr_endpoint informa a indisponibilidade, e o /readyz não passa a 503. Uma consulta que nunca chegou ao BACEN responde 503 com SCR-1002, e o detail dela nomeia o BACEN. Revise os alertas que usam a prontidão do Lerian SCR para detectar uma indisponibilidade do BACEN.Pix
Rótulos de tarifa, recusas do Tracer e hosts de QR no Pix JD v1.5.0
As páginas e a referência de API do Pix JD passaram para a v1.5.0. Uma ordem de pagamento pode trazer um rótulo de tarifa emfeeContext, e o pacote de tarifas do Midaz que seleciona pelo rótulo precifica o Pix. Um rótulo pelo qual nenhum pacote de tarifas do ledger do pagador seleciona responde 422 PIX-0162, e nada fica retido. Quando o seu Tracer recusa o crédito de um Pix recebido, o Pix espera como PENDING, com pendingReason TRACER_DENIED. Um operador da sua instituição pode devolvê-lo ao pagador, ou creditá-lo quando o seu Tracer deixar o crédito passar. Cada participante direto pode publicar os QR codes dinâmicos dele em um host próprio.Confirme que a sua integração aceita TRACER_DENIED em pendingReason. Para precificar Pix por rótulo, veja Precifique um TED ou Pix por um contexto de tarifa. Para mudar o host de QR de um participante, siga Hospedagem de QR code dinâmico.TED
Tarifas do TED Lerian pelos seus pacotes de tarifas do Midaz
O TED Lerian cobra tarifas apenas pelos pacotes de tarifas do Midaz do seu ledger. O TED Lerian marca cada lançamento comtedOperation (ted_sent, ted_internal, ted_received ou ted_refund) e tedPurposeCode, para que um pacote possa selecionar por eles. Um pacote que não seleciona por tedOperation também pode precificar TEDs recebidas e reembolsos. A cotação de tarifa é uma estimativa, e o feeAmount de uma transferência mostra a tarifa que o Midaz cobrou do remetente.Antes de reservar qualquer valor, o TED Lerian confere a finalidade no domínio FinlddCli do BACEN (TED-0003) e os dígitos verificadores do CPF ou CNPJ do destinatário (TED-0007). Um ano de feriados carregado cobre todas as datas dele, e uma data cujo ano não está carregado recebe 503 TED-0022. Restrinja seus pacotes de tarifas com esses rótulos e carregue o calendário de feriados de cada ano antes de ele começar.Streaming Hub
Fatos de averbação para fundos e originadores no Streaming Hub v3.0.0
Uma subscription restrita a um fundo ou a um originador pode receber os quatro fatos de averbação do Lerian Consignado. Um originador os recebe apenas quandooriginador_ref o nomeia, e um fundo apenas quando remetente_fundo_ref o nomeia.Uma subscription restrita que omite event_types os recebe sem nenhuma mudança na subscription. Uma subscription restrita que lista os tipos de evento recebe apenas os tipos que lista, e os tipos de evento dela não podem mudar. Para receber outro fato de averbação, crie uma subscription nova que o liste.Pix
Regras do DICT e eventos de negócio no Pix BTG v1.12.0
As páginas e a referência da API do Pix BTG foram atualizadas para a v1.12.0. A criação de chave e a criação de reivindicação recusam uma conta salário (SLRY) com PIX-0129. Um número de conta pode ter de 1 a 20 letras maiúsculas ou dígitos. Quando o dígito verificador é uma letra, o DICT recebe esse dígito como 0. O doador pode cancelar uma reivindicação com o motivo COURT_ORDER.Os relatos de infração e as transações do grafo de rastreamento carregam transactionDepth. Uma recuperação de fundos aceita um maxHops de 1 a 2, e o grafo de rastreamento não usa os parâmetros de consulta dele.O Pix BTG pode publicar eventos de negócio em deploys BYOC. Eles ficam desativados por padrão. Para ativá-los, defina as variáveis em Eventos de negócio.Antes da atualização, pare de enviar um maxHops acima de 2 e não registre chaves Pix para contas salário. Mantenha o número de conta original no CRM.Access Manager
Login com passkey no Access Manager v3.14.0
As páginas do Access Manager e as referências das APIs de Auth e Identity foram atualizadas para o Access Manager v3.14.0. Quando a sua organização ativa o login com passkey, uma pessoa pode entrar com uma passkey em vez de uma senha. Um login com passkey não pede um segundo fator. Enquanto a opção está ativada, o Auth recusa o login com senha de uma pessoa que tem uma passkey com403 AUT-1019. As passkeys e o SSO se excluem.Cada pessoa adiciona e remove a própria passkey pela API de Identity. Em um deploy BYOC, defina MFA_SECRET no Auth antes de ativar as passkeys. Leia Passkeys para ver as chamadas, as permissões e os requisitos de deploy.TED
Devoluções e créditos ao cliente no Bank Transfer v3.3.0
As páginas e a referência da API do TED JD foram atualizadas para o Bank Transfer v3.3.0. Return a Transfer devolve um TED IN concluído ao banco pagador, ou estorna um P2P concluído. A requisição precisa da permissãotransfers:return. Uma devolução envia apenas os próprios eventos de webhook.O plugin também credita o destinatário em sete créditos ao cliente que o banco pagador envia como outras mensagens STR. Cada um tem o próprio tipo de transferência, de TED_IN_STR0005 a TED_IN_STR0051, e o próprio vínculo no roteamento do ledger. Um TED OUT que a JD ainda responde como pendente depois de 24 horas em conciliação aguarda um operador, com a retenção mantida. Com a política de tenant fees.refund_on_devolucao em true, o reembolso de uma devolução integral de um TED OUT concluído também devolve a tarifa ao remetente. Antes da atualização, adicione um vínculo no roteamento do ledger para cada tipo de crédito ao cliente que você recebe, e aceite os novos tipos de transferência e eventos de devolução na sua integração.Pix
Créditos em espera e clientes de indiretos no Pix JD v1.4.0
As páginas e a referência da API do Pix JD foram atualizadas para a v1.4.0. Quando o ledger recusa o crédito de um Pix recebido porque o saldo de destino não aceita créditos, o Pix espera comoPENDING, com pendingReason BALANCE_NOT_RECEIVING. Um operador pode creditar esse Pix ou devolvê-lo ao pagador. Uma lista mostra os débitos do Pix Automático que esperam, com o pendingReason de cada um. Para recusar uma reivindicação de posse, envie fraudDeclared como true. Com JOBS_CLAIM_RECEIVED_POLL_ENABLED, OUTBOX_ENABLED e STREAMING_ENABLED em true, o Pix JD emite key.claim-received quando outro participante reivindica uma chave que você detém.Uma requisição por um participante indireto declara o cliente e não informa nenhuma conta sua: payer em um pagamento, X-Payer-Document na consulta de chave e na decodificação de QR, e recipient em um QR code dinâmico. A devolução de um Pix que caiu na posição de um participante indireto precisa do indirectId dele, ou responde 422 PIX-0135. Uma devolução que informa um participante indireto que não recebeu o Pix original responde 404 PIX-0147. Um ISPB tem 8 letras maiúsculas ou dígitos, e a lista de erros ganhou os códigos de PIX-0151 a PIX-0160.Antes da atualização, siga os passos para a 1.4.0 na página de variáveis de ambiente. Em um deploy self-hosted em que o Pix JD não publica a declaração de permissões dele, dê aos papéis do Pix a permissão parked-credits (ação post). Atualize fora do intervalo das 00:00 às 08:00, horário de Brasília. Uma aplicação existente da JD com a origem jd-consultores continua funcionando. Para uma nova integração direta, dê à JD a credencial dela.Access Manager
Credenciais de serviço e papéis declarados no Access Manager v3.13.1
As páginas do Access Manager e as referências das APIs de Auth e Identity foram atualizadas para o Access Manager v3.13.1. Em um deploy single-tenant, uma pessoa emite a application com que um serviço Lerian faz login por Emitir uma credencial de serviço. Criar uma application recusasource com 400.Um produto Lerian pode declarar os próprios papéis e as próprias permissões. O Identity recusa com 422 adicionar ou remover um papel em uma permissão declarada, ou um grupo em um papel declarado. O Console lista um papel declarado como Custom. Para mudar quem tem esse acesso, adicione ou remova pessoas no papel do produto ou em um grupo que tem o papel.O Identity responde a um token ausente com 401 AUT-0006, a um token inválido com 401 AUT-0007 e a uma permissão negada com 403 AUT-1020. Quando a verificação de autorização não responde a tempo, o Identity responde 504 AUT-1021. Remova source das suas requisições de Criar uma application e atualize o tratamento de erros da sua integração.SPB
Certificado SFN e estados de liquidação no Lerian SPB
O Lerian SPB usa um certificado SFN, emPROCESS_CERT_PATH. A chave privada dele assina toda mensagem STR de saída e descriptografa as mensagens de entrada que o BACEN criptografa para esse certificado. SPB_SIGNER_KIND define a custódia dessa chave. As variáveis CERT_PATH, KEY_PATH, OUTBOX_POSTGRES_MAX_OPEN_CONNS e OUTBOX_POSTGRES_MAX_IDLE_CONNS deixaram de existir, assim como o arquivo metadata.json. O padrão de STR_MQ_CIPHER_SPEC é ECDHE_RSA_AES_256_CBC_SHA384.Depois que o STR liquida uma devolução, o crédito devolvido termina em RETURNED. Um redesconto convertido termina em CONVERTED, e um movimento de moeda eletrônica pode terminar em CANCELLED. A conversão de um redesconto informa dois fatos settlement.*, e o fato do pagamento tem um settlementId que termina em -PGTO. O fato settlement.failed também informa uma transferência que um operador encerra como falha. Os avisos LTR0003R2 e LTR0006R2 não têm fato settlement.*.Antes da atualização, defina PROCESS_CERT_PATH e a custódia da chave dele. Em um HSM, permita assinatura e descriptografia nessa chave. Defina STR_MQ_CIPHER_SPEC com a CipherSpec do seu canal STR_MQ_CHANNEL. Faça seu consumidor do ledger registrar os avisos LTR0003R2 e LTR0006R2 a partir dos fatos spb.ldl.* e tratar os novos estados finais.SPI
Operações travadas e catálogo 5.13.2 no Lerian SPI
A referência da API do SPI removeu as operações de avaliação, de solicitação e de execução da recuperação de uma operação. Uma operação que precisa de atenção aparece na lista de operações travadas com as ações que ela aceita, e a resolução manual precisa de uma aprovaçãoAPPROVED. Quando o BACEN não responde a um Pix enviado dentro do prazo, a ação RECONCILE_WITH_BACEN pede ao BACEN o lançamento do pagamento. Quando a resposta camt.054 do BACEN informa o pagamento como liquidado ou rejeitado, o trilho conclui ou rejeita o pagamento.O padrão de BACEN_SPI_CATALOGUE_VERSION é 5.13.2. Um BACEN_SPI_XSD_DIR que você define precisa conter os schemas dessa versão. Um valor de variável que não é válido para o tipo dela, como yes em uma chave liga-desliga, interrompe a inicialização. Mova suas chamadas de recuperação para as ações de operações travadas. Se você define BACEN_SPI_XSD_DIR, coloque nele os schemas da 5.13.2.SILOC
Frames estacionados e TLS do MQ no Lerian SILOC
O Lerian SILOC estaciona em seu banco de dados um frame que recusou mais deMQ_BACKOUT_THRESHOLD vezes, e MQ_BACKOUT_QUEUE deixou de existir. O feed de quarentena retorna os bytes do frame em frame e deixa de retornar um frame depois que você o resolve. O serviço não inicia quando o PostgreSQL não responde em até 10 segundos.A nova variável MQ_CIPHER_SPEC define o cipher spec do canal MQ, com o padrão ECDHE_RSA_AES_256_CBC_SHA384. A nova variável MQ_CERT_LABEL informa o certificado que o serviço apresenta no canal.Antes da atualização, remova MQ_BACKOUT_QUEUE e defina MQ_CIPHER_SPEC com o cipher spec do seu canal de conexão com o servidor. Com REDIS_TLS=true, confirme que o seu servidor Redis aceita TLS. Se o sistema operacional não confia na autoridade certificadora do seu servidor Redis, defina essa autoridade em REDIS_CA_CERT.Consignado
Credenciais de parceiro e resultados de renegociação no Lerian Consignado 4.0.0
As páginas e a referência da API do Consignado foram atualizadas para o Lerian Consignado 4.0.0. Um fundo ou um originador pode chamar as próprias rotas com uma credencial de parceiro do Access Manager, e a referência da API ganhou essas operações. Você pode reativar um fundo ou um originador. Um envio completo de um novo certificado e de um novo cliente OAuth porPUT /v1/credentials/dataprev encerra uma revogação das credenciais do Dataprev. A leitura do status da portabilidade é POST /v1/consignado/portabilidade/efetivacoes, com os filtros no corpo, e a referência da API removeu a leitura de uso.O resultado de uma renegociação publica consignado.renegociacao.efetivada ou consignado.renegociacao.recusada. O fato consignado.exclusao.rejected tem a versão de schema 1.1.0. Uma exclusão de portabilidade do lado de origem que não teve resposta publica consignado.portabilidade.rejeitada com reason_code GW-M005-NAO-EXECUTADO. Uma averbação com o bloco de booking responde RATE_OUTSIDE_PRODUCT_RANGE quando o monthly_rate dela vezes 12 fica fora da faixa de taxa anual da versão de produto do Lender que ela informa. Uma averbação com um número de contrato que já é um contrato no gateway responde CONTRACT_ALREADY_REGISTERED. A Lerian habilita a renegociação automática por tenant, sob solicitação, e ela vem desligada por padrão.A publicação de permissões na inicialização exige o Access Manager 3.13.0 ou posterior. Isso substitui a orientação do Access Manager 3.12.0 na entrada de 26 de outubro de 2026 sobre o Consignado. Atualize o Access Manager antes de atualizar o gateway. Leia o status da portabilidade com POST e pare de chamar a leitura de uso. Leia ce-schemaversion antes de decodificar consignado.exclusao.rejected. Depois de GW-M005-NAO-EXECUTADO, envie a exclusão de novo com uma nova chave.Narya
Entrada por pipe, regras de execução e assinaturas de extensão no Narya
Uma execuçãonarya -p coloca o texto enviado por pipe à entrada padrão antes do prompt. Ela lê a entrada padrão até o fim, a menos que a entrada padrão seja um terminal. A execução também aceita regras --allow que deixam a execução realizar ações nomeadas sem perguntar. Uma execução de workflow informa o repository em que trabalha. Uma mensagem, uma lane, um agendamento, uma execução de workflow e um resumo aceitam uma chave de idempotência.Um monitor com wake definido como true inicia um turno quando a saída dele chega enquanto a conversa está ociosa. A pessoa que iniciou o monitor paga por esse turno. O Narya nomeia uma sessão sem título depois da primeira resposta dela e cobra essa rodada da sessão. O Narya recusa o purge de uma sessão que tem um compartilhamento ativo. Os arquivos de agente leem disallowedTools e effort, e o Narya ignora qualquer chave que Estendendo o Narya não lista. Até um segredo antigo de extensão deixar de funcionar, o Narya-Signature carrega uma assinatura para cada segredo, separadas por um espaço.Para uma execução narya -p que não pode ler a entrada padrão, redirecione-a de /dev/null. Para limitar as ferramentas de um agente, use tools e disallowedTools. Se você constrói uma extensão, aceite uma chamada quando uma das assinaturas em Narya-Signature for verificada com o segredo que você guarda.TED
Resultados da TED recebida no TED Lerian
Uma TED recebida para uma conta da instituição termina emRECORDED, não credita nenhum cliente e publica incoming_transfer.recorded. Uma conta é da própria instituição quando o documento do seu titular no CRM do Midaz é o CNPJ da organização à qual o ISPB está vinculado. O TED Lerian devolve uma TED para uma conta de cliente cujo closingDate no CRM do Midaz é hoje ou anterior, com o motivo oficial 1 (conta encerrada). Quando uma consulta ao CRM do Midaz falha ou não dá uma resposta clara, a TED vai para revisão manual.Os vínculos de ISPB aceitam apenas a organização e o ledger onde esta instalação credita as TEDs recebidas e recusam qualquer outro com 422 TED-0002. Sem um horário de corte, a janela de operação segue a grade oficial do STR. Revise como o seu sistema trata RECORDED e incoming_transfer.recorded.SCR
Respostas tardias do BACEN no Lerian SCR
Quando o BACEN responde depois que uma consulta já respondeuSCR-1004, o Lerian SCR ainda grava essa resposta no cache de resultados. Um acerto completo no cache dispensa a chamada ao BACEN e a tarifa. O serviço não inicia quando o Postgres não responde em até 10 segundos. Revise como a sua integração repete uma consulta depois de SCR-1004.SLCSILOCSPB
Jornadas dos trilhos nativos e o evento de liquidação do SPB
Nas jornadas de SLC, SILOC e STR de Diagramas de integração, a Lerian publica um crédito do ciclo de cartão, a devolução de um depósito excedente e um crédito LTR0005R2 como o evento do Lerian SPBspb.ldl.third-party-settlement-received. Sua instituição envia o depósito do ciclo de cartão (LDL0022) pela própria conexão com o STR e recebe a resposta LDL0022R1 por ela. A contestação SLC0002, os arquivos ASLC do domicílio, a DDA0101, o ROC e os passos da registradora de recebíveis acontecem entre a sua instituição e a infraestrutura, fora da Lerian.Para os créditos liquidados e devolvidos, esta entrada substitui a entrada de 15 de outubro de 2026 sobre o SLC. Revise suas assinaturas e seus runbooks operacionais de acordo com as jornadas revisadas.DocumentationPixTED
Jornadas de Pix e de TED
A seção Trilhos nativos de Diagramas de integração ganhou jornadas do Pix Lerian sobre o Lerian SPI. Elas são Enviar e receber Pix, Cobrar com um QR code dinâmico, Devolver um Pix recebido, Autorizar e pagar com Pix Automático e Comunicar uma fraude e recuperar fundos. A seção também ganhou jornadas do TED Lerian sobre o Lerian SPB: Enviar e receber TED e Cancelar ou devolver uma TED. O índice de mensagens lista os códigos de mensagem dessas jornadas.MidazLerian Console
Página Dívidas de Tarifa do módulo Midaz
As páginas do Fees Engine do módulo Midaz ganharam um guia de Dívidas de Tarifa. Ele mostra como filtrar as dívidas de tarifa de um ledger por saldo e por status, e o que cada coluna significa. A ação Cobrar se aplica a todas as dívidas em aberto de um saldo. O Midaz as liquida da mais antiga para a mais nova, até o limite do saldo disponível. O Midaz não cobra tarifa sobre uma cobrança, e você não pode revertê-la. Para definir um valor máximo, use a API de cobrança commaxAmount.Reporter
Grupos de acesso do Reporter
A página O que é o Reporter lista os três grupos de acesso que o Reporter declara no Access Manager. O gruporeporter-viewer-group lê. O grupo reporter-contributor-group lê, cria e altera. O grupo reporter-editor-group também exclui e aprova uma remessa regulatória. O grupo de administradores do Access Manager, admin-group, tem o mesmo acesso que o reporter-editor-group. Revise o grupo de cada usuário do Reporter.Documentation
Catálogo de eventos e host do Try It
A visão geral do streaming de eventos lista o Pix Lerian e o TED Lerian, com as páginas de eventos e as rotas dos manifestos de streaming deles. O Try It das referências das APIs do TED JD, do Payments BTG, do Pix BTG e do BC Correios usa um host de exemplo. Substitua-o pela URL que você recebe no onboarding do ambiente.MidazTracer
Os produtos Lerian são de código fechado
Desde 21 de outubro de 2026, todo produto Lerian é de código fechado. O modelo Community do Midaz deixou de existir. O Midaz e o Tracer são instalados a partir das imagens públicas no Docker Hub. Se você instala o Midaz ou o Tracer a partir do código-fonte, passe a usar as imagens do Docker Hub. Para suporte, use o Lerian Support Portal.MidazTracer
Recusas de autenticação e de tenant no Midaz 4.3.0
No Midaz 4.3.0, um token ausente ou inválido respondeAUT-0006 ou AUT-0007, não 0042. Uma permissão negada responde AUT-1020, não 0043. Quando o Access Manager não decide, a resposta é AUT-0033, não 0525. No modo multi-tenant, a resolução do tenant recusa com códigos como TENANT_SUSPENDED e TENANT_MANAGER_UNAVAILABLE.O Midaz mantém 0042, 0043 e 0525 apenas para uma recusa que não traz código. Se a sua integração decide por esses três códigos, decida pelo status HTTP ou pelos códigos novos.MidazTracer
Atualização e exclusão de contas no Midaz 4.3.0
No Midaz 4.3.0, o Ledger publica as mensagens de auditoria de transação apenas quandoAUDIT_LOG_ENABLED é true. O /readyz do Ledger verifica o RabbitMQ pela API de gerenciamento com as credenciais de RABBITMQ_DEFAULT_USER e responde 503 quando essa verificação falha. Cada chave de tarifa que você adiciona a um pacote deve seguir ^[a-z][a-zA-Z0-9]*$.Antes da atualização, defina AUDIT_LOG_ENABLED=true se você consome as mensagens de auditoria. Dê também ao usuário RABBITMQ_DEFAULT_USER acesso à API de gerenciamento. Atualize o Tracer e depois todos os Ledgers antes de a sua integração enviar scheme ou optionalOperationRoutes. Enquanto um Ledger 4.3.0 roda, não faça o rollback do Tracer para uma versão abaixo de 4.3.0.Cada reserva que o Ledger envia ao Tracer leva o segmento e o portfólio da conta de origem e o esquema da transação. Os limites e as regras do Tracer com escopo por segmento, portfólio ou esquema se aplicam a essas reservas. No modo enforce, eles podem negar a transação. Antes da atualização, revise esses limites e regras.Quando você exclui uma conta, o Midaz também arquiva os Instrumentos dela e remove o alias dela dos pacotes de tarifas e de cobrança. O Midaz remove cada tarifa que credita o alias. Ele desabilita um pacote de tarifas que fica sem tarifas e um pacote de cobrança que debita ou credita o alias. Antes de excluir uma conta, registre a data de encerramento no Instrumento dela. Para manter uma tarifa que lança no alias, aponte-a antes para outra conta.TED
Licença e conclusão do TED OUT no Bank Transfer v3.2.0
As páginas e a referência da API do TED JD foram atualizadas para o Bank Transfer v3.2.0. Na v3.2.0, cada ambiente precisa deLICENSE_KEY e ORGANIZATION_IDS. IS_DEVELOPMENT seleciona o serviço de licença de desenvolvimento, e LICENSE_SERVICE_ADDRESS deixou de existir.O TED OUT envia transfer.completed quando é liquidado e também envia transfer.rejected quando o STR recusa a liquidação. A partir da v3.2.0, use transfer.completed como o sinal de conclusão do TED OUT, no lugar da orientação da entrada de 24 de agosto de 2026. Antes da atualização, defina as duas variáveis de licença em cada ambiente. Confirme também que ENVIRONMENT_NAME ou ENV_NAME é production, staging, uat, development, local ou test.Pix
Apenas nomes de campo em inglês no Pix JD v1.3.0
As páginas e a referência da API do Pix JD foram atualizadas para a v1.3.0. Na v1.3.0, um campo que tinha um nome em inglês e um nome descontinuado em português mantém apenas o nome em inglês. Um corpo de requisição com o nome em português responde400 PIX-0061, e a API ignora um parâmetro de consulta com esse nome. O registro de uma chave aleatória precisa de X-Idempotency. Antes da atualização, siga os passos para a 1.3.0 na página de variáveis de ambiente.Pix
ID end-to-end no Pix Lerian v1.1.0
As páginas e a referência da API do Pix Lerian foram atualizadas para a v1.1.0. O Pix Lerian é a interface que conecta o Midaz ao Lerian SPI pelo seu adaptador de conectividade Lerian.Em um pagamento por chave ou por QR Code, o Pix Lerian fixa o ID end-to-end quando você inicia a transferência, e o processamento o reutiliza. O processamento recusaX-End-To-End-Id nesses pagamentos com 400 PIX-0300. Um endToEndId que você envia deve conter o seu ISPB nos caracteres 2 a 9. X-Idempotency é a chave de idempotência. Antes da atualização, pare de enviar X-End-To-End-Id ao processar um pagamento por chave ou por QR Code.SPB
Eventos e depósitos LDL0022 do Lerian SPB
O Lerian SPB publica todas as famílias de eventos no backbone de streaming e não envia webhooks. Uma devolução (STR0010) devolve um crédito TED que você recebeu e termina no própriosettlement.settled ou settlement.failed. O evento settlement.returned deixou de existir. As liquidações LDL, os depósitos LDL0022, o pagamento LTR0004 e os avisos LDL e LTR0005R2 não solicitados não têm fato settlement.*. Uma requisição de depósito LDL0022 informa apenas advisoryId. O trilho obtém o valor, o lado e o período do aviso e recusa um corpo com qualquer outro membro.Antes da atualização, mova todo consumidor de webhook para o backbone de streaming. Faça seu consumidor do ledger registrar essas operações a partir dos fatos spb.ldl.*. Envie apenas advisoryId em uma requisição de depósito LDL0022. Defina LDL_ADVISORY_CONSUMER_ENABLED como true ou false, porque o serviço não inicia quando a variável não está definida.SPI
Devoluções de entrada e campos obrigatórios no Lerian SPI
O Lerian SPI retém uma devolução de entrada e a anuncia emspi.payment.return_received, com o returnId dela. Seu cliente autoriza ou recusa a devolução por esse returnId. Uma devolução autorizada é liquidada apenas quando o SPI a confirma, e o trilho recusa uma devolução que nenhuma decisão conclui dentro da janela dela.Uma recusa FRAD de um Pix de entrada sai como FRAD apenas quando seu cliente a marca como a decisão do sistema antifraude dele. Caso contrário, ela sai como DS04. Uma ordem de pagamento precisa de acceptedAt, o instante em que o seu sistema recebeu a confirmação do pagador. Uma recuperação de fundos precisa de userComplaintAt, o instante em que o seu canal de atendimento registrou a reclamação do pagador. Um perfil de recebedor do BR Code precisa de ispbParticipante, o ISPB de um participante para o qual o trilho liquida. Sem esses campos, o trilho responde 422.Com um endpoint BACEN SPI https, defina BACEN_SPI_SIGNING_CERT_FILE. Com o backend file, o padrão de BACEN_SPI_SIGNER_KIND, defina também BACEN_SPI_SIGNING_KEY_FILE. A referência da API do DICT removeu o bloqueio judicial e o desbloqueio de uma chave, a limpeza de chaves órfãs e a conciliação sob demanda. Esta entrada substitui a entrada de 6 de outubro de 2026 sobre o SPI. Envie esses campos, decida cada devolução de entrada e atualize o tratamento de erros da sua integração.SILOC
Chaves e liquidação de ciclo no Lerian SILOC
O Lerian SILOC não inicia a menos queOT_REPLAY_ENABLED, STATUS_REPLAY_ENABLED, RECONCILE_ENABLED, LDL_FACT_CONSUMER_ENABLED e CARD_COMMAND_CONSUMER_ENABLED sejam cada uma true ou false. Com RECONCILE_ENABLED=true, ele liquida um ciclo OT apenas quando o resultado multilateral GEN0015 da câmara coincide com a obrigação. A obrigação também precisa da prova do STR, e o período de depósito dela precisa do PAG0103. A referência da API removeu o recebimento de ROC e ganhou a leitura dos resultados multilaterais da câmara. Defina as cinco chaves antes da atualização.SCR
Instalação e idempotência no Lerian SCR
Uma instalação do Lerian SCR atende uma instituição. Uma nova tentativa enquanto a primeira requisição ainda roda responde409 SCR-0006, então envie de novo depois de Retry-After. Uma resposta com X-Idempotency-Fenced: true retém a chave dela, e uma nova tentativa com essa chave responde 422 SCR-0005 sem rodar. SCR-1003, SCR-1004 e SCR-9001 dizem se a requisição chegou ao BACEN. Rode uma instalação para cada instituição e atualize o tratamento de erros da sua integração.Consignado
Recusas e prazo da documentação no Consignado
Um número de contrato tem de 2 a 15 letras ou dígitos na averbação, no refinanciamento, na renegociação e na portabilidade de entrada. Quando o Dataprev recusa a documentação, o anexo de CCB responde422 com os códigos do Dataprev em upstream, e o contrato volta a aguardar a documentação. Envie a documentação corrigida com uma nova chave X-Idempotency ou exclua o contrato. A leitura da averbação mostra documentation_due_at e documentation_overdue. DEFAULT_TENANT_ID e DATAPREV_RECONCILIATION_TENANT_ID deixaram de existir, e apenas um deploy multi-tenant lê LEILAO_TENANT_ID. Atualizar um gateway single-tenant (MULTI_TENANT_ENABLED=false) exige uma limpeza na versão atual e um banco de dados novo. Fale com o suporte da Lerian antes de atualizá-lo.Com as configurações padrão, o gateway publica seu manifesto de permissões no Access Manager na inicialização, e uma publicação com falha interrompe a inicialização. A publicação exige o Access Manager 3.12.0 ou posterior, então atualize o Access Manager antes de atualizar o gateway. Com um serviço de identidade multi-tenant, defina IDP_DECLARATION_ENABLED como false, porque ele recusa a publicação.Streaming Hub
O Streaming Hub confere os tipos de evento no catálogo
Tire cada chave deevent_types do campo eventKey de GET /v1/catalog: o hub pode recusar uma chave que o catálogo não lista na schema major da subscription, com 422 unknown_event_type. Uma subscription nova também aceita um mapa opcional event_majors, que define a schema major por tipo de evento.Um job de entrega tem no máximo oito tentativas, e uma tentativa que começa 24 horas ou mais depois de o hub receber o evento é a última. O dashboard recusa um período que começa antes do histórico que o hub ainda guarda e devolve coverage_start. As contagens de saúde da subscription cobrem o intervalo de window_start a snapshot_at.Narya
Home hospedada e teto diário de gasto no Narya
As páginas do Narya descrevem dois modos: o host na sua própria máquina e uma home que a Lerian hospeda para a sua organização. Na home hospedada, cada sessão roda em um container. O Narya lê o teto diário de gasto em[spend] daily_ceiling_usd. O teto cobre todo o trabalho pago de uma pessoa em um dia UTC, e sem ele o Narya não define teto diário. Para manter um teto diário, defina [spend] daily_ceiling_usd.Midaz
Transações no Midaz 4.3.0
As páginas do Midaz e a referência da API do Ledger foram atualizadas para o Midaz 4.3.0. Uma transação/v2 aceita um scheme opcional que nomeia o esquema de pagamento dela, por exemplo PIX ou CARD. No /v2, uma rota contábil pode vincular rotas de operação opcionais em optionalOperationRoutes. Uma transação de bloqueio ou de desbloqueio não pode ser revertida, e uma reversão responde 0539.Tracer
Esquemas de pagamento e validação apenas por regras no Tracer
As páginas e a referência da API do Tracer foram atualizadas para o Midaz 4.3.0. O Tracer aceitascheme como um campo aberto de 1 a 50 caracteres: A-Z, 0-9, _ e -. Uma validação apenas por regras decide só pelas regras e não verifica nem conta nenhum limite de gasto. O endpoint de uso do limite informa o período atual, e cada valor de uso inclui a capacidade que as reservas do ledger ainda não confirmadas retêm. Um maxAmount de 0 nega cada transação do seu escopo.Lerian Console
Páginas do Lerian Console v2.16.0
As páginas do Console mudaram para corresponder ao Lerian Console v2.16.0. Em Payments, o ledger vem do cabeçalho do Console, e você escolhe a conta debitada pelo alias ou pelo ID completo. Boletos emite um boleto por vez. As páginas de Fees ganharam a tela Fee Debts, que precisa do Midaz 4.2.0 ou posterior, e os campos Metadata selector e Deferrable de um pacote. Um limite do Tracer recebe o Reset Time (UTC) quando você o cria e você pode excluir uma rota contábil.Pix
Verificação de fraude e desbloqueio de devolução no Pix BTG v1.11.0
As páginas e a referência da API do Pix BTG foram atualizadas para o plugin v1.11.0. As páginas ganharam a verificação de fraude em Pix recebidos e em devoluções recebidas, em que o plugin consulta um endpoint de decisão que você opera. A verificação vem desligada por padrão, eANTIFRAUD_HOOK_ENABLED a liga. As páginas de devolução descrevem o desbloqueio de devoluções em PENDING e de devoluções de cash-out em CREATED. A referência da API ganhou Complete a charge.TED
TED Lerian
A seção Interfaces tem um guia do TED Lerian. O TED Lerian é a interface que conecta o Midaz ao Lerian SPB. Ele envia TEDs, faz transferências internas, recebe TEDs, devolve um TED recebido e cancela um TED. O Midaz registra o dinheiro. As páginas Eventos e integração com o ledger e Operação do Lerian SPB saíram da seção TED Lerian e foram para a seção SPB (TED) de Trilhos Brasil. A Referência da API adicionou o TED Lerian e a sua lista de erros.Tracer
Campo de tipo de transação do Tracer descontinuado
No Midaz 4.3.0,transactionType é o nome descontinuado do scheme do Tracer. Ele ainda funciona em requisições, escopos de regra e de limite, expressões CEL e eventos. Os filtros de listagem de regras, limites e eventos de auditoria aceitam transaction_type como o nome descontinuado de scheme. Use scheme na sua integração, nas regras e nos limites.TED
ENV_NAME do Bank Transfer descontinuado
No Bank Transfer v3.2.0,ENVIRONMENT_NAME substitui ENV_NAME, que ainda funciona como o nome descontinuado dela. O serviço não inicia quando as duas variáveis nomeiam ambientes diferentes. Defina ENVIRONMENT_NAME e remova ENV_NAME.Consignado
Averbação em duas etapas no Consignado
No Lerian Consignado, a averbação executa apenas o Manual 003 do Dataprev, exigenome_trabalhador e não leva documento. Quando o Dataprev a aceita, a operação responde attachment_pending e o gateway publica consignado.averbacao.accepted. Envie a CCB assinada e a evidência de assinatura ao anexo de CCB, sob a própria chave X-Idempotency, dentro dos 7 dias que o Manual 004 permite.O anexo de CCB não executa mais uma averbação. Antes de o Dataprev aceitar a averbação, o anexo responde 409 AVERBACAO_NOT_ACCEPTED. Um contrato recebe uma única documentação aceita. Um pacote diferente responde 409 AVERBACAO_DOCUMENTATION_CONFLICT enquanto o primeiro está aceito ou a caminho do Dataprev. A documentação leva o data_hora_assinatura, o instante em que o trabalhador assinou, e a averbação recusa esse campo.O evento consignado.averbacao.confirmed passa a seguir o aceite da documentação pelo Dataprev. O saldo devedor que o gateway informa ao Dataprev pelo Manual 015 passa a começar quando o Dataprev aceita a averbação, não mais quando aceita a documentação. A referência da API ganhou GET e PATCH /v1/consignado/contracts/{numero_contrato}/registro-b3 para o código de instrumento B3 de um contrato com averbação confirmada, e o PATCH publica consignado.registro_b3.registered.Para desistir de um contrato que aguarda documentos, envie a exclusão dele. Documentos enviados depois disso respondem 409 AVERBACAO_EXCLUDED, a menos que o Dataprev rejeite a exclusão. Se a documentação já estiver registrada ou a caminho do Dataprev, a exclusão responde 409 EXCLUSION_DOCUMENTATION_UNDERWAY. Enquanto a averbação estiver em attachment_pending, envie de novo a mesma documentação ao anexo de CCB e exclua o contrato quando a averbação estiver em confirmed.As falhas do Dataprev respondem 503 DATAPREV_UNAVAILABLE ou 504 DATAPREV_TIMEOUT no lugar de CLT-0008, e uma leitura do Dataprev com dados inutilizáveis responde 502 DATAPREV_INVALID_RESPONSE. As falhas do Tenant Manager, do Access Manager e do Streaming Hub também respondem 503 ou 504 com códigos próprios, como TENANT_MANAGER_UNAVAILABLE, AUT-0033 e STREAMING_HUB_TIMEOUT. Depois de 504 DATAPREV_TIMEOUT, tente um comando de novo com a mesma chave e nunca com uma chave nova, porque ele pode ter chegado ao Dataprev. A resposta ao leilão de portabilidade é a exceção, como explica a referência dela.Uma chave reutilizada em outra requisição responde 422 IDEMPOTENCY_KEY_REUSE, então envie uma chave nova. Uma resposta do trilho que o gateway não conseguiu registrar responde 503 OUTCOME_UNKNOWN, então tente de novo com a mesma chave. A averbação recusa datas e condições de contabilização inconsistentes com 422 antes de chamar o Dataprev.Três códigos 409 substituem RAIL_COMMAND_CLAIM_CONFLICT em alguns casos. Um comando diferente com a mesma chave responde RAIL_COMMAND_PAYLOAD_MISMATCH, e uma nova tentativa de um comando recusado responde RAIL_COMMAND_ALREADY_REFUSED. Uma nova tentativa sem resultado conhecido responde RAIL_COMMAND_OUTCOME_UNRESOLVED, então consulte os comandos do trilho e não envie o comando com uma chave nova.As recusas de fundo, de lance e de prazo de portabilidade respondem códigos 422 próprios no lugar de CLT-0006, como FUNDO_NOT_REGISTERED, BID_NO_PROPOSTA_LEFT e PORTABILIDADE_WINDOW_EXPIRED.A cessão de um crédito que o Dataprev ainda não respondeu responde 409 CESSAO_CREDIT_PENDING, e CESSAO_CREDIT_NOT_ACCEPTED passa a significar que o Dataprev recusou o crédito. A leitura de créditos cedidos lista cada crédito com numero_contrato e omite credit_key e id_solicitacao para um contrato sem lance.As variáveis de ambiente ganharam IDP_DECLARATION_ENABLED, e OUTBOX_RETENTION_PUBLISHED_HOURS passa a ter 1 como padrão. DATAPREV_RECONCILIATION_CNPJS deixou de existir, porque a conciliação do repasse passa a ler todos os empregadores. Envie a averbação sem documentos e os documentos pelo anexo de CCB, não contabilize nem desembolse um contrato a partir de consignado.averbacao.accepted e atualize o tratamento de erros da sua integração. Faça essa mudança junto com a atualização, porque a v3.7.1 ainda exige a CCB assinada na averbação.Payments
Consulta de pagador do Payments BTG v1.0.2
As páginas do Payments BTG foram atualizadas para v1.0.2. Pagamentos de contas e DARF agora leem o pagador pelos endpoints de CRM atendidos porMIDAZ_LEDGER_URL em /v2, e MIDAZ_CRM_URL não configura mais essa consulta. Antes de atualizar, confirme que a URL do ledger do Midaz atende endpoints de CRM em /v2.STA
Lerian STA v1.1.0
As páginas do Lerian STA passaram para o Lerian STA v1.1.0. O Lerian STA v1.1.0 pode ler a licença de um arquivo de licença assinado que a Lerian emite. Defina o caminho do arquivo emLICENSE_FILE_PATH. Com um arquivo de licença, o Lerian STA verifica a licença localmente e não chama o serviço de licenças. Quando LICENSE_FILE_PATH está definida, o Lerian STA ignora LICENSE_KEY. Todo ambiente precisa de LICENSE_FILE_PATH ou LICENSE_KEY, e de ORGANIZATION_IDS.SRC
Lerian SRC
A aba Trilhos Brasil e a Referência da API adicionaram o Lerian SRC. O Lerian SRC envia consultas de restrição ao BC Protege+ do BACEN antes que sua instituição abra uma conta ou mude a titularidade de um relacionamento existente. Ele registra o veredito do BACEN para cada consulta e mantém uma trilha de evidências.SISBAJUD
Lerian SISBAJUD em dois componentes
As páginas do Lerian SISBAJUD passaram para duas versões: a Lerian SISBAJUD Mensageria v1.0.0 e o Lerian SISBAJUD executor v1.0.0. A Mensageria recebe as ordens como arquivos pelo Lerian STA e escreve os arquivos de resposta. O executor executa as ordens no Midaz e precisa do seu próprio banco de dados PostgreSQL. Cada componente tem as suas próprias variáveis de ambiente: veja as páginas da Mensageria e do executor. A referência da API tem uma seção para cada componente, e as URLs das operações mudaram. Antes de passar para essas versões, registre cada instituição nos dois componentes com o mesmoinstitutionId e enabled igual a true.BC Correios
Lerian BC Correios
A aba Trilhos Brasil e a Referência da API adicionaram o Lerian BC Correios. O Lerian BC Correios coleta no BACEN as correspondências do BC Correio da sua instituição, armazena-as com uma trilha de auditoria e envia mensagens aos departamentos do BACEN.Platform
Lifecycle Management pelo agente BYOC da Lerian
O Lifecycle Management passou do dashboard do Lifecycle para o agente BYOC da Lerian, e a Lerian desativou o dashboard. A Lerian instala, faz upgrade, faz rollback e remove produtos no seu cluster pelo agente, a seu pedido. Para usar o Lifecycle Management, peça ao suporte da Lerian a credencial do agente e o endereço do plano de controle. Depois, instale o agente com o chart dele.Access Manager
Orientação sobre a inicialização do Access Manager
A orientação de ciclo de vida do Access Manager não trata mais a disponibilidade de PostgreSQL, Valkey ou Caradhras como pré-requisito para iniciar o serviço. Confirme a prontidão pelas verificações de integridade antes de ativar a aplicação de acesso em um produto.SLC
Eventos de clearing do SLC nos diagramas de integração
Os diagramas de integração do SLC agora identificam os eventos de prévia de posições, créditos liquidados e créditos devolvidos. Revise suas assinaturas e seus runbooks operacionais de acordo com as jornadas atualizadas.Midaz
Modelo de contas e saldos do Midaz
A orientação de contas e saldos do Midaz agora distingue as contas separadas de um cliente de vários saldos dentro de uma única conta. Revise o modelo de contas e os controles em nível de saldo de acordo com a orientação atual.Payments
Variáveis de licença do Payments BTG v1.0.1
As páginas do Payments BTG passaram para a versão v1.0.1, que valida a sua licença quando inicia. Na v1.0.1, cada pod, inclusive o worker, precisa deLICENSE_KEY e ORGANIZATION_IDS em todos os ambientes. O valor de ORGANIZATION_IDS é global ou uma lista de UUIDs de organizações em minúsculas, separados por vírgula. Uma recusa de licença carrega um código LCS. As operações da API não mudaram. Antes de atualizar, defina as duas variáveis em cada pod e abra a regra de saída que o License Manager descreve.TED
Tarifas dedutíveis em TED OUT no Bank Transfer v3.1.0
O Bank Transfer v3.1.0 recusa um TED OUT com422 BTF-3002 quando o pacote de tarifas que corresponde a ele tem uma tarifa com isDeductibleFrom: true. A recusa vale no modo native e no modo legacy com BTF_FEE_ENABLED=true. Em TED OUT e P2P, o totalAmount é o valor que o Bank Transfer debita do remetente, e os limites de uso contam esse valor. As leituras de transferência carregam organizationId e ledgerId, o List Transfers aceita um filtro ledgerId, e a referência da API ganhou 422 BTF-2004 e BTF-2005. O Bank Transfer pede ao Midaz que crie um índice de metadata de transação, o que precisa da permissão settings post do Midaz nos dois modos de tarifa. Antes de atualizar, garanta que nenhum pacote do plugin-fees ao qual um TED OUT pode corresponder tenha uma tarifa com isDeductibleFrom: true.Pix
Nomes de campo em inglês e consulta de chave no Pix JD v1.2.4
As páginas e a referência da API do Pix JD passaram para a v1.2.4, em que a consulta de chave aceita umindirectId opcional para um pagamento que passa por um participante indireto. O Pix JD adiciona nomes em inglês para alguns campos do MED 2.0, do Pix Automático e da consulta de chave. Quando um campo tem um nome em inglês, o nome em português continua funcionando e está obsoleto, e dois valores diferentes para um campo respondem 400 PIX-0148. Duas rotas do MED têm paths em inglês que exigem a mesma permissão que as rotas em português. Como a página de variáveis de ambiente informa, o trilho não lê mais MULTI_TENANT_ALLOW_INSECURE_HTTP a partir da 1.2.1. No modo multi-tenant com um Tenant Manager em http://, defina ALLOW_INSECURE_TLS=true na API e no worker antes dessa atualização, ou o serviço não inicia.Lerian Console
Páginas do Lerian Console v2.13.0
As páginas do Console passaram a corresponder ao Lerian Console v2.13.0, e Versões dos produtos lista a versão de produto de que algumas telas precisam. Quando um produto roda uma versão anterior, um aviso como Requer Bank Transfer 3.1.0 ou posterior substitui essa parte da tela. O módulo Tracer abre no dashboard dele com o Tracer 4.1.0 ou posterior, e o Console não lê maisNEXT_PUBLIC_TRACER_DASHBOARD_ENABLED. No Bank Transfer, a lista Transferências e o card Transferências Recentes mostram as transferências do ledger selecionado. Em TED Out e P2P, o Total mostra o valor debitado do remetente, e as configurações de Política de Taxas valem apenas no modo de tarifa legacy. Uma nova página descreve Ambientes, a tela que lista os ambientes em que você tem conta e permite escolher o seu ambiente padrão.Access Manager
Access Manager v3.11.1 e parceiros
As páginas e as referências das APIs Auth e Identity do Access Manager passaram para o Access Manager v3.11.1. A referência do Auth ganhou as operações de descoberta e de início do SSO, e a referência do Identity ganhou as operações de parceiros, de catálogo de escopo e dos próprios tenants. Os guias de parceiros voltaram, com uma visão geral, um guia do Console e um guia da API. Você pode dar permissões a um parceiro apenas em um produto que aceita parceiros, e a visão geral diz como encontrar esses produtos no seu deploy. Uma requisição para excluir um grupo que tem membros ou subgrupos agora responde409 com IDE-1058 ou IDE-1059. A lista de erros também ganhou AUT-0033, AUT-1011, AUT-1012, IDE-0064, IDE-0065 e IDE-0066, e a página de provisionamento automático do Tenant Manager saiu do site.MidazTracer
Midaz v4.2.2
As páginas do Midaz e as referências da API do Ledger e do Tracer passaram para o Midaz v4.2.2. As operações da API não mudaram.TED
Modo de tarifa do Bank Transfer v3.1.0
O Bank Transfer v3.1.0, o plugin do TED JD, pode cobrar tarifas pelo Fees Engine do Midaz.MIDAZ_FEE_MODE escolhe legacy (plugin-fees, /v1) ou native (Midaz, /v2), e o auto padrão escolhe native no Midaz 4.1.0 ou posterior. Com auto, se seus pacotes de tarifas ainda estão no plugin-fees, as transferências ficam sem tarifa assim que o Midaz rodar a 4.1.0 ou posterior. native precisa das permissões do Midaz packages get e estimates post, um native explícito também precisa de organizations get, e BTF_FEE_ENABLED vale apenas para legacy. Defina MIDAZ_FEE_MODE=legacy antes de atualizar e depois mova seus pacotes como o guia de migração descreve. Passe para native apenas quando cada pod do Bank Transfer rodar a 3.1.0 ou posterior e os pacotes existirem no Midaz.Matcher
Header de idempotência e confirmação automática no Matcher v5.0.0
As páginas e a referência da API do Matcher passaram para o Matcher v5.0.0, em que uma correspondênciaDATE_LAG vai para revisão e a política de duplicidade padrão é FLAG_AS_EXCEPTION. O Matcher v5.0.0 lê uma chave de idempotência apenas do header X-Idempotency e não usa uma chave em Idempotency-Key ou X-Idempotency-Key. Envie as chaves de idempotência em X-Idempotency e revise as correspondências que o seu processo espera confirmar automaticamente.Access Manager
Código de MFA e parceiros no Access Manager v3.10.0
No Access Manager v3.10.0, um usuário que desabilita a MFA da própria conta precisa enviar um código. As páginas de parceiros e as operações de parceiro saíram do site. Se a sua aplicação permite que os usuários desabilitem a MFA ou removam um método da própria conta, colete o código e envie-o na requisição.Pix
Pix JD v1.2.0
As páginas e a referência da API do Pix JD passaram para a versão v1.2.0 do plugin, que adiciona uma validação de conta assíncrona para o JD. Na v1.2.0, uma rota reivindica no JD Courier as recorrências do Pix Automático. Antes da atualização, siga o passo para a 1.2.0 na página de variáveis de ambiente.CCS
Variáveis de licença do CCS
A página de variáveis de ambiente do CCS mudouLICENSE_KEY e ORGANIZATION_IDS de obrigatórias em produção para obrigatórias em todos os ambientes. Defina as duas variáveis em todos os ambientes, inclusive no de desenvolvimento.Payments
Sacador avalista e busca de pagamento no Payments BTG
A referência da API do Payments BTG removeu o sacador avalista da emissão de boleto, e uma requisição que envia um sacador avalista responde400 PBP-0001. A página Boletos e pagamento de contas ganhou como encontrar um pagamento pelo Idempotency-Key quando uma requisição de criação termina sem o id do pagamento. Remova o sacador avalista das suas requisições de boleto e, depois de um erro, envie a requisição de novo com o mesmo Idempotency-Key antes de buscar o pagamento.PixTED
Ativação de trilhos no JD Courier v1.1.0
As páginas e a referência da API do JD Courier passaram para a v1.1.0 e ganharam a ativação e a suspensão de um trilho. Na v1.1.0, o Courier não entrega aos motores nenhuma mensagem de um trilho até que um operador ative o trilho. Ative cada trilho como a página de deploy descreve.MatcherLerian Console
Módulo Matcher do Lerian Console
As páginas da Matcher UI passaram a descrever o módulo Matcher do Lerian Console v2.12.0.Lerian Console
Páginas do Lerian Console v2.12.0
As páginas do Console passaram a corresponder ao Lerian Console v2.12.0. Na v2.12.0, você abre a Autorização pela barra lateral de Configurações ou pelo menu de engrenagem, e a lista de aplicações tem uma coluna Descrição. A página Produtos ganhou o Matcher.Documentation
Jornadas em Diagramas de integração
A aba Diagramas de integração tinha quatro seções: Produtos Lerian, Trilhos nativos, Interfaces de parceiros e Infraestruturas de mercado. Trilhos nativos trazia as jornadas de SLC, SILOC e STR para crédito com garantia e liquidação diária, com uma coluna da Lerian que mostra o endpoint ou o evento de cada passo entre sua instituição e a Lerian. Um índice de mensagens lista cada código e suas jornadas. Nas páginas de trilhos, os manuais oficiais prevalecem sobre os diagramas.Documentation
Organização das abas e Diagramas de integração
O site reagrupou as abas e removeu a aba Soluções e as páginas dela. Plataforma passou a ser uma seção de Produtos Lerian, e Interfaces passou a ser uma seção de Trilhos Brasil, sem mudança nos endereços das páginas delas. O site adicionou uma aba Diagramas de integração antes de Referência da API.TracerMidaz
As reservas do Tracer usam somente gRPC no Midaz 4.2.0
No Midaz 4.2.0, o Ledger chega ao Tracer para reservas somente por gRPC, na porta 4021 por padrão. As operações REST de reserva saíram da referência da API do Tracer. Faça o deploy do Tracer antes do Ledger e não volte o Tracer para uma versão abaixo da 4.2.0 enquanto um Ledger 4.2.0 estiver em execução.Pix
Configuração e upgrade do Pix JD v1.0.0
As páginas do Pix JD passaram para a versão v1.0.0 do plugin. Na v1.0.0, a organização, o ledger, o ativo e a conta de compensação do Midaz vêm do binding do systemplane e de duas chavestenant_policy/midaz.*, e pagamentos e devoluções exigem X-Idempotency. Siga os novos passos de upgrade: grave primeiro as chaves tenant_policy/midaz.* e depois remova as variáveis de identidade MIDAZ_* retiradas.Payments
Fluxo e consulta de pagamento de contas no Payments BTG
As páginas do Payments BTG ganharam os passos de um pagamento de conta: o ledger reserva os fundos antes de o BTG receber o pagamento. Um resultado desconhecido responde202 com status UNCONFIRMED, a referência ganhou uma operação de consulta de conta e a lista de erros ganhou sete códigos e perdeu o PBP-0209. Não reenvie um pagamento UNCONFIRMED com um novo Idempotency-Key e defina CONSULT_AUDIT_HMAC_KEY: um pod que atende a API de pagamento não inicia sem ela.TED
Formato de erro do TED JD v3.0.1
No TED JD v3.0.1, todo erro é um documento de problema RFC 9457 emapplication/problem+json, e um código do JD SPB fica em upstream.code. Atualize o tratamento de erros da sua integração.SISBAJUD
Variáveis de licença do SISBAJUD v1.2.0
O Lerian SISBAJUD v1.2.0 exigeLICENSE_KEY e ORGANIZATION_IDS em todos os ambientes. Defina as duas variáveis.Access Manager
Nome do ambiente no chart do Access Manager
A página de Helm do Access Manager ganhou o nome do ambiente. O padrão do chart édevelopment. Para qualquer ambiente diferente de development, staging ou local, exponha o Caradhras por https com um certificado de uma autoridade certificadora pública. Depois aponte o Auth e o Identity para esse endereço https.Streaming Hub
Recusas do Streaming Hub v2.3.0
No Streaming Hub v2.3.0, uma recusa401 ou 403 é um documento de problema com código unauthorized ou forbidden. O hub responde 503 quando o Access Manager não retorna um veredito. Atualize o tratamento de erros da sua integração.Lerian Console
Páginas do Lerian Console v2.6.0
As páginas do Console passaram a corresponder ao Lerian Console v2.6.0. A atualização adicionou páginas para instituições do Reporter, operações TED IN, Rotas Contábeis do TED JD e devoluções do Pix BTG, e cobriu os parâmetros de relatório e o statusPartial failure. A atualização removeu as páginas de Console do BC Correios. O Console mostra o client secret de uma aplicação uma vez, quando você cria a aplicação. Guarde-o nesse momento.PixTED
JD Courier
A aba Interfaces e a Referência de API ganharam o JD Courier. O JD Courier permite que dois ou mais motores de core bancário compartilhem um canal JD e um ISPB no SPB (TED) e no Pix. Ele roda em BYOC e na Lerian Cloud.Midaz
Dívida de tarifa no Midaz 4.2.0
No Midaz 4.2.0, a parte não paga de uma tarifa diferível em uma transação direta/v2 pode virar uma dívida de tarifa que os créditos /v2 seguintes liquidam, da mais antiga para a mais nova. A dívida de tarifa vem desativada por padrão, e o Valkey precisa persistir as chaves dela.Access Manager
Referência da API do Identity do Access Manager
A referência da API do Identity perdeu as operações de parceiro, de catálogo de escopos e de tenants do usuário. A lista de erros do Access Manager ganhouIDE-0038.Consignado
Consignado v3.7.0
A referência da API do Consignado ganhou uma operação que lê o cadastro guardado com uma averbação, e a referência de eventos passou a corresponder ao que a v3.7.0 emite. No Lerian Consignado v3.7.0, o saldo devedor enviado ao Dataprev é o valor presente das parcelas não pagas.SPI
Variáveis de ambiente do SPI
A página de variáveis de ambiente do SPI perdeuBACEN_SPI_SIGNING_KEY_FILE.