Lerian ConsoleStreaming HubLenderConsignadoTracerFlowkerTED
Lerian Console v3.4.0: alteração, pausa e retomada de assinaturas do Streaming Hub, telas do Lender e busca no Flowker
O Lerian Console v3.4.0 altera o nome, o destino e os tipos de evento de uma assinatura do Streaming Hub, e a pausa e retoma. Isso exige o Streaming Hub 3.4.0. Para o Lender 4.2.0, o módulo Lender ganha um simulador de empréstimo, garantias, registro na registradora, números de contrato, regras de pagamento, novos cronogramas e periodicidades, a taxa mensal fixa, uma retenção da liberação até a CCB ser assinada, a cura da PDD para o Estágio 1 e um a pagar ao fundo que você marca com Marcar repasse. No Consignado, um contrato que um refinanciamento gerou recebe os comandos do trilho, e com o Lerian Consignado 4.5.0 a reversão de um refinanciamento vem pré-preenchida com o contrato que ele gerou. Uma validação que uma reserva do ledger gravou abre a transação do Midaz com Abrir transação. No Flowker, você busca uma execução pelo ID e filtra as configurações de provedor por Provedor. Os diálogos de excluir e desativar um provedor nomeiam os workflows afetados, e uma ativação recusada leva ao workflow que é dono do caminho de webhook. Ao ativar o TED JD, o Console agora executa uma verificação de saúde do plugin.Consignado
Lerian Consignado 4.5.0: situação do contrato, documentos retidos e controle de assinaturas
As páginas e a referência de API do Consignado passaram para o Lerian Consignado 4.5.0. Cinco operações de API são novas. A situação de um contrato diz se ele ainda está vivo, como chegou (averbacao, refinanciamento, renegociacao ou importacao) e por que saiu. A lista de documentos retidos mostra o que um contrato guarda, signed_ccb e biometrics_documents_pack. Com o Streaming Hub 3.4.0, seu back office também pode pausar, retomar e editar uma assinatura do tenant. A lista de comandos do trilho aceita numero_contrato, e uma linha de refinanciamento ou renegociação nomeia os contratos que ela substituiu. O gateway publica consignado.rescisao.revertida quando uma leitura de contrato na Dataprev constata que uma rescisão de vínculo foi cancelada. Ele pode ler sua licença de um arquivo assinado montado, definido em LICENSE_FILE_PATH.O bloco de contabilização agora confere a taxa anual efetiva de monthly_rate com a faixa de taxa da versão do produto do Lender, e a faixa inclui seus limites. Antes, ele conferia monthly_rate vezes 12. Revise as requisições cuja taxa fica perto da borda da faixa de um produto.Streaming Hub
Streaming Hub v3.4.0 edição, pausa e retomada de subscriptions
O Streaming Hub v3.4.0 edita uma subscription no lugar comPATCH /v1/subscriptions/:id: você muda o nome, o destino, os tipos de evento e as versões de schema. A subscription mantém o id e o segredo de assinatura ou a credencial da fila. Envie o ETag da subscription como If-Match, e o hub recusa uma edição desatualizada com 412 subscription_changed. Você também pausa e retoma uma subscription pela API e no Console. Uma pausa cancela as entregas da fila, e uma subscription push não recebe nenhum evento que chega ao hub durante a pausa, nem depois da retomada. Uma subscription pull pausada pula os eventos que ela ainda não leu. A lista de subscriptions mostra o status Pausada, e o Dashboard conta as subscriptions pausadas. No BYOC, um webhook ou um broker RabbitMQ em um endereço privado funciona depois que a operação da Lerian libera o host, e a porta AMQP no RabbitMQ. O hub multi-tenant recusa um broker RabbitMQ privado. SQS e EventBridge nunca recebem liberação.Para tentar de novo uma edição após um 412, leia a subscription outra vez e envie a edição com uma nova chave X-Idempotency. Depois de retomar uma subscription pull, leia com ?after= os eventos que ela pulou, dentro da retenção.Lender
Lender v4.2.0 garantias, registro em qualquer registradora e novos cronogramas
O Lender v4.2.0 adiciona 13 operações de API. Você registra garantias, pessoais ou reais, e as vincula a contratos. Você registra o código que qualquer registradora atribuiu a um contrato de crédito direto, não só a B3. Você marca o repasse que um conjunto de contratos de consignado vendido com o risco transferido deve ao seu fundo. Você compara o caixa retido de um contrato com o que o ledger mantém. Uma versão de taxa fixa traz a taxa como taxa mensal emfixedMonthlyRate, e a faixa de taxa de toda versão fica em pontos-base anuais efetivos. Uma proposta pode pedir o sistema sac ou american, pagamentos quinzenais ou semanais, e regras de pagamento como carência ou parcela final maior. Ela também pode carregar o seu próprio número de contrato em clientContractNumber. Uma versão pode reter a primeira liberação de um contrato de crédito direto até você registrar a CCB assinada.Leia as novas operações na página da API do Lender e defina as opções de cronograma em uma versão quando seus produtos precisarem delas.SISBAJUD
Plugin SISBAJUD v1.3.0 conexão com o Midaz e porta de saúde
O Plugin SISBAJUD usa uma única conexão com o Midaz para a instalação inteira, definida por variáveis de ambiente:MIDAZ_BASE_URL, opcionalmente MIDAZ_AUTH_ADDRESS com o par de cliente do ledger, e MIDAZ_CRM_BASE_URL para o CRM standalone, com o par de cliente do CRM quando MIDAZ_AUTH_ADDRESS está definido. O plugin não guarda credencial do Midaz por instituição, e a configuração de uma instituição mostra connectionSource env. Uma mudança numa instituição vale na próxima ordem, sem reiniciar. Depois que uma instituição recebe a primeira ordem, o ledger dela não muda: o plugin responde 422 SBJ-0066. Prontidão, liveness e métricas respondem em HEALTH_PORT, e a porta principal mantém /health e /version.No canal direto, um bloqueio original que você cancela antes de rodar nunca roda, mostra cancelledBy, e o cancelamento responde ao tribunal. Um cancelamento sem nada a liberar responde CANCELLATION_FULFILLED. Uma revisão que aumenta o valor de uma ordem é recusada com 409 SBJ-0065.SISBAJUD
Lerian SISBAJUD Mensageria v1.2.0 campos de decisão LGPD e origem do Cabine
A chamada LGPDresolve recebe decision, decisionReason, recordsAffected e deliveryRef, e a Mensageria recusa com 422 uma chamada que ainda envia recordsEliminated, recordsRetained ou tokensGenerated. Uma configuração malformada de AUTH_*, TRUSTED_PROXIES, MULTI_TENANT_ENABLED ou IDP_DECLARATION_ENABLED interrompe a inicialização, e o log nomeia a variável.Defina CORS_ALLOWED_ORIGINS com a origem em que os operadores abrem o Lerian Cabine.TED
Os eventos do TED Lerian trazem um ce-id estável
Os eventos do TED Lerian trazem um ce-id UUIDv7 derivado da transição. Uma reentrega da mesma transição repete o ce-id. A API não mudou.Deduplique pelo par (ce-source, ce-id). Leia o ce-id do evento e nunca o reconstrua.TED
O TED Lerian publica suas permissões no Access Manager
Ao iniciar, o TED Lerian pode publicar suas permissões no seu Access Manager, e o Access Manager passa a ter todas as permissões do TED Lerian sem carga manual. Vem desligado. Se o serviço Identity não responder, o TED Lerian inicia mesmo assim e tenta de novo, e a verificaçãodeclaration no corpo de GET /readyz mostra o resultado.Para ligar, defina IDP_DECLARATION_ENABLED como true, com IDP_HOST e o IDP_M2M_CLIENT_ID e o IDP_M2M_CLIENT_SECRET de uma aplicação com a origem plugin-br-ted-lerian.Lerian ConsoleStreaming HubPaymentsLender
Lerian Console v3.3.0: subscriptions do Streaming Hub, pagamento de contas e telas do Lender
O Lerian Console v3.3.0 cria subscriptions do Streaming Hub em um assistente de três etapas, para destinos webhook, pull, Amazon SQS, RabbitMQ e Amazon EventBridge. O catálogo de eventos tem um botão Subscribe que abre o assistente com o evento escolhido, e o Console define a credencial de um destino de fila. Uma subscription mostra um só status: Delivering, Failing, Awaiting verification ou Stopped by the Hub. No Payments, você consulta a conta na origem e depois revisa e confirma o pagamento. O Console avisa sobre um possível pagamento duplicado e mostra um pagamento não confirmado como In confirmation. Um boleto aceita um nosso número opcional, e seus estados são Registered, Not sent e Awaiting registration. No Lender, a tela Parked postings libera um lançamento contábil que parou antes do Midaz. Se você confirmar que o Midaz não tem um lançamento que ele tem, o Lender o registra duas vezes. Você também pode arquivar produtos de crédito e encerrar parcelas curtas retidas. O Console busca a licença no serviço de licenças a cada início e a mantém só em memória.Pague contas pela linha digitável. O Console recusa um código de barras de 44 dígitos. Confira a lista Bill Payments antes de enviar um pagamento de novo.Tracer
A entrada de uso de limite do Tracer mostra o escopo usado
Cada entrada delimitUsageDetails na resposta de POST /v1/validations, e no registro de validação de uma reserva do ledger, agora mostra em scope o único objeto de escopo cujo contador a transação usou: o primeiro objeto do limite que corresponde. Antes, ela listava todos os objetos de escopo do limite, unidos por OR. Os registros que o Tracer gravou antes mantêm a lista completa.Se você lê scope para achar o contador que uma transação usou, leia-o como um único objeto de escopo, e espere a lista completa apenas em registros anteriores.Access Manager
Caradhras: arquivo de licença e prontidão
O Caradhras, o backend de identidade do Access Manager, pode ler a licença de um arquivo de licença assinado que a Lerian emite, definido emLICENSE_FILE_PATH. Quando ele está definido, o Caradhras ignora LICENSE_KEY e não chama o serviço de licença. Com LICENSE_KEY, cada início busca a licença assinada em license.lerian.io. Enquanto o serviço de licença não responde, o Caradhras não fica pronto. Uma licença ausente ou recusada ainda interrompe a inicialização. A etapa de migração do banco precisa da mesma licença.Com LICENSE_KEY, mantenha aberto o HTTPS de saída para https://license.lerian.io para o Caradhras e para a etapa de migração. Defina LICENSE_KEY ou LICENSE_FILE_PATH também na etapa de migração.SPBSILOC
O Lerian Cabine mostra aos operadores de STR e SILOC só o que eles podem usar
Nos workspaces STR e SILOC, o Lerian Cabine agora esconde os itens de menu, as telas e as ações que as permissões do Access Manager do operador não concedem, como já faz no SPI. Um link salvo para uma tela fechada mostra que o operador não tem acesso. Por exemplo, as ações dos casos de conciliação do STR e o controle Executar dos cenários de homologação do SILOC aparecem só para o papeladmin. A página de acesso lista os grupos que concedem cada papel no Lerian SPB e no Lerian SILOC. As páginas de SPB e de SILOC listam a permissão de cada controle.Confirme que os grupos do Access Manager dos seus operadores concedem as permissões do Lerian SPB e do Lerian SILOC que eles usam.Access Manager
Access Manager v3.20.0: arquivo de licença e prontidão
O Auth e o Identity podem ler a licença de um arquivo de licença assinado que a Lerian emite, definido emLICENSE_FILE_PATH. Quando ele está definido, os dois ignoram LICENSE_KEY e não chamam o serviço de licença. Com LICENSE_KEY, eles guardam a licença assinada apenas em memória, então cada início a busca de novo em license.lerian.io. Se o serviço de licença não responder na inicialização, o Auth e o Identity ficam no ar, não prontos, e tentam de novo em vez de encerrar. O /readyz responde 503 até uma licença ser aceita, e a porta principal só abre depois disso. Uma licença ausente ou recusada ainda interrompe a inicialização.Com LICENSE_KEY, mantenha aberto o HTTPS de saída para https://license.lerian.io em todas as cargas de trabalho do Auth e do Identity, e aponte as sondas de prontidão para HEALTH_PORT.TED
Licença do TED Lerian em memória
ComLICENSE_KEY, o TED Lerian guarda a licença assinada apenas em memória, não no PostgreSQL. Cada início busca a licença de novo em license.lerian.io. Se o serviço de licença não responder, o TED Lerian fica não pronto e tenta de novo até ele responder.Com LICENSE_KEY, mantenha aberto o HTTPS de saída para https://license.lerian.io em toda carga de trabalho do TED Lerian, inclusive nos reinícios.Lender
Lender v4.1.0: produtos arquivados, mesas e plano de contas
O Lender arquiva e restaura produtos de empréstimo: um produto arquivado não origina nada novo, e os contratos já feitos ficam como estão. Uma cotação de pagamento parcial pode encurtar o prazo ou reduzir as parcelas, e o consignado mantém a parcela. Uma renegociação a 0% é aceita como concessão de reestruturação. Novas mesas do operador liberam um lançamento que parou antes do Midaz e encerram uma parcela retida com saldo curto de um contrato de consignado cedido. Uma baixa encerra um contrato de consignado que a rail de folha excluiu. Estornar um pagamento depois que a mesa de reembolso pagou o tomador reabre o contrato e abre um recebível de pagamento devolvido. A mesa de reembolso cobre contratos renegociados. Os planos de contas lançam a perda incorrida e a provisão adicional em provisões separadas. As sondas e as métricas passam para a porta de saúde, e a licença pode vir de um arquivo assinado montado.Se você configurou um plano de contas antes da v4.1.0, adicione o par de regras de lançamento da perda incorrida antes que as provisões de contratos inadimplidos sejam lançadas. O início rápido mostra as regras. O job de migração do banco de dados precisa de licença. DefinaLICENSE_KEY ou LICENSE_FILE_PATH, ou a migração não inicia.Pix
Pix BTG v1.15.0: arquivo de licença e resultado não registrado
Todo componente do Pix BTG pode carregar um arquivo de licença assinado porLICENSE_FILE_PATH, como alternativa a LICENSE_KEY. Veja as variáveis de ambiente. Se o serviço de licença não responder na inicialização, os componentes ficam à espera, sem ficar prontos, e continuam tentando em vez de encerrar. Uma nova resposta de idempotência, 422 PIX-3005, informa que a primeira requisição sob a chave foi executada, mas o resultado não foi registrado.Em PIX-3005, concilie a operação original. Não a reenvie e não use uma chave nova.Access Manager
O Access Manager recusa permissão de parceiro que nenhuma requisição pode usar
Quando você cria ou altera um parceiro, o Access Manager recusa uma permissão que nenhuma requisição desse parceiro pode usar dentro do seu escopo. Isso vale para produtos que publicam quais itens de escopo suas rotas carregam, como o Lender a partir da v4.1.0. A resposta é400 IDE-1052, e a mensagem nomeia o produto, o recurso e a ação.Remova essa permissão do parceiro ou altere o escopo dele.Payments
Payments BTG v1.3.0: histórico da chave Pix
O Payments guarda o histórico de cada troca da chave Pix em que os boletos híbridos cobram.GET /v1/admin/pix-config/history o lista, com as chaves de CPF, e-mail e telefone mascaradas. Inscreva uma configuração de webhook no novo evento PIX_KEY_CHANGED para saber de cada troca. O Payments também pode ler a licença de um arquivo de licença que a Lerian emite, definido em LICENSE_FILE_PATH.Adicione PIX_KEY_CHANGED a enabledEvents se quiser acompanhar as trocas de chave.Streaming Hub
Streaming Hub v3.3.0: situação das entregas nas assinaturas
Uma leitura de assinatura, a lista ou uma assinatura individual, retornalast_success_at e last_failure_at. Você percebe que um destino está falhando sem chamar a leitura de saúde. Para parceiros do Consignado, a assinatura de um originador recebe o resultado das próprias cotações de pré-leilão (consignado.cotacao.resolved), e a assinatura de um fundo recebe o bloqueio de FGTS que falhou em um contrato cedido a ele (consignado.garantia.block_failed).Use last_failure_at para monitorar seus destinos.Lerian Console
Chave de licença do Lerian Console v3.2.0
O Lerian Console v3.2.0 não inicia sem uma chave de licença da Lerian emLICENSE_KEY, e sua verificação de readiness responde 503 até que o serviço de licença aceite a chave. As páginas do Console também descrevem os planos de conta nas telas do Fees Engine, as configurações do Tracer de um ledger, o campo Scheme de uma nova transação, o login com passkey e as áreas Configurações e Autorização.Antes de atualizar, defina LICENSE_KEY no deploy do seu Console e libere HTTPS de saída do Console para license.lerian.io. Conceda a permissão de leitura de usuários a cada administrador que abrir Autorização.Consignado
Porta de saúde e assinaturas de parceiros do Lerian Consignado 4.4.0
As páginas e a referência de API do Consignado passaram para o Lerian Consignado 4.4.0. Um fundo ou um originador gerencia suas próprias assinaturas de eventos com a credencial de parceiro. Novos fatos anunciam a janela de execução da garantia do FGTS, um bloqueio de FGTS que falhou e a desativação ou reativação de um originador ou de um fundo. Seu back office pode fechar uma exclusão por portabilidade do lado da origem que ficou estacionada.GET /v1/consignado/fundo/creditos foi removido.Antes de atualizar, defina HEALTH_PORT e aponte a sonda de readiness e a coleta de métricas para essa porta: a porta principal não serve mais /readyz nem /metrics. Mude um fundo que lê seus créditos na rota removida para GET /v1/consignado/fundos/{fundo_id}/contracts, com a credencial de parceiro do fundo. As assinaturas de parceiros precisam do Streaming Hub 3.2.0 com STREAMING_HUB_PARTNERS_URL definido. Em um deploy single-tenant, defina também SUBSCRIPTIONS_HUB_CLIENT_ID e SUBSCRIPTIONS_HUB_CLIENT_SECRET.Pix
Devoluções MED no Pix BTG v1.14.1
Um cash-out comX-Purpose: INSTANT_PAYMENT_REFUND para uma conta em outra instituição precisa de contestedMedRootTransactionId no corpo: o rootTransactionId da recuperação de fundos contestada no MED. Depois de remover os espaços das pontas, o valor tem exatamente 32 letras, dígitos ou sublinhados. Um valor ausente responde 400 PIX-0481, e um valor malformado responde 400 PIX-0482. Um cash-out dentro da sua instituição ignora o campo.Adicione contestedMedRootTransactionId a cada cash-out INSTANT_PAYMENT_REFUND para outra instituição. Para devolver um Pix recebido, use as operações de devolução.TED
Porta de saúde e ISPBs sem vínculo no TED Lerian
O TED Lerian serve/readyz e /metrics apenas na porta de HEALTH_PORT. A porta principal mantém /health e /version. Um TED de cliente que chega por um ISPB sem vínculo não é creditado, e em uma instalação single-tenant o TED Lerian o devolve à instituição remetente com o motivo 2. Uma transferência interna para uma conta encerrada responde 422 TED-1021, e um crédito de operador em uma conta encerrada responde 422 TED-0002. Um TED recebido mostra ledgerCreditId e ledgerRevertId quando eles existem.Antes de atualizar, defina HEALTH_PORT e aponte a sonda de readiness e a coleta de métricas para essa porta. Vincule cada ISPB por onde sua instituição recebe TEDs.Tracer
Verificação de limite, licença e porta de saúde do Tracer
As páginas e a referência de API do Tracer seguem o build mais recente do Midaz.POST /v1/validations executa suas regras e depois verifica um ALLOW contra seus limites de gastos, com o uso atual e a capacidade que as reservas retidas ocupam. Ele não move nenhum contador: apenas uma transação que o ledger do Midaz reserva com o Tracer no modo advisory ou enforce consome um limite. Um requestId que você reutilizar com outro corpo, ou na outra rota de validação, responde 409 com o código 0084. GET /v1/validations/{validation_id}/reservations lista as retenções de uma transação do ledger. As regras podem ler transactionAmount, e uma reserva com várias contas de origem registra o resultado de cada origem.Antes de atualizar, defina LICENSE_KEY ou LICENSE_FILE_PATH: o Tracer não inicia sem uma licença. Defina HEALTH_PORT e aponte a sonda de readiness e a coleta de métricas para essa porta: a porta principal não serve mais /readyz nem /metrics. Revise as regras e os limites cujo escopo tem um subtipo em branco. A atualização remove essas alternativas de escopo: uma regra ativa que fica sem escopo passa a inativa, e um limite que fica sem escopo não conta nada.FlowkerLerian Console
Caminhos de webhook e execuções do Flowker v1.6.0
O caminho de um gatilho de webhook pode terminar em um segmento{name}, como orders/{orderId}. O workflow lê o valor em _webhook.params. Um workflow é dono do seu caminho de webhook até você excluí-lo, então desativar um workflow não libera o caminho para uma nova versão. Uma execução síncrona que falhou responde 502 em todas as visões de resposta, e uma visão passthrough não repassa mais o erro do provedor. A lista de workflows mostra a última execução de cada workflow, uma execução registra quem a iniciou e a etapa em que uma execução com falha parou, e os resultados de uma execução em espera podem ser lidos. O pin por tenant da versão da especificação de um serviço do catálogo foi removido, junto com PUT /v1/catalog/openapi-version-pins/{service} e GET /v1/catalog/openapi-versions/{service}. No Lerian Console, o painel do Flowker abre com o que precisa de atenção, e uma página Configurações define a retenção das execuções.Dê a cada nova versão de um workflow de webhook o seu próprio caminho, ou exclua antes o workflow antigo. Atualize os chamadores que tratam uma execução síncrona com falha como 200 ou que leem o erro do provedor por uma visão passthrough, e remova as chamadas às duas rotas de catálogo removidas.Streaming Hub
Tenant nas entregas e perda por retenção no Streaming Hub v3.2.0
Um Streaming Hub single-tenant atribui cada evento ao tenant configurado e não envia identidade de tenant nas entregas: sem o headerX-Lerian-Tenant-Id e sem o atributo ce-tenantid. Uma leitura pull devolve retention_loss: null, ou o intervalo de eventos que a retenção removeu antes de sua assinatura lê-los. O Streaming Hub verifica sozinho um webhook pendente: a primeira sonda chega cerca de um minuto depois que você cria a assinatura, e o intervalo dobra até uma hora. Uma sonda que falha não muda mais o estado da assinatura, e a atualização devolve cada assinatura degraded para active, que volta a receber eventos. Quando seu webhook responde 429, o Streaming Hub segura a assinatura pelo Retry-After do seu webhook, 30 segundos quando você não envia nenhum, e no máximo uma hora.Se seus consumidores leem o tenant nas entregas, use o tenant de STREAMING_HUB_TENANT_ID. Trate retention_loss nos consumidores pull.ConsignadoLerian Console
Pré-leilão entre originadores no Lerian Consignado
O Lerian Consignado 4.4.0 pode fazer um pré-leilão antes do lance. Vários originadores, e a sua própria conta, cotam a mesma solicitação de empréstimo, cada um por um fundo. O gateway elege uma cotação pela regra que você configura: janela, critério, fundo preferido, fechamento e rodízio. Ele reserva a capacidade desse fundo e envia a cotação eleita ao Dataprev. Você define uma política e limites para cada fundo, e os fundos pelos quais cada originador pode cotar. Uma averbação que cita uma cotação tem que indicar o fundo dessa cotação. O fatoconsignado.solicitacao.received traz o prazo de cotação, e cada cotação termina com um fato consignado.cotacao.resolved. No Lerian Console, as telas Pré-leilão, Fundos do pré-leilão e Pré-leilões, o modo de cotação do formulário Leilão e o botão Fundos de cada originador gerenciam o pré-leilão.O pré-leilão vem desligado. Para usá-lo, defina CONSIGNADO_PRELEILAO_ENABLED como true, com DATAPREV_ENABLED, LEILAO_ENABLED, LEILAO_CLIENT_BID_ENABLED e CONSIGNADO_BID_RECONDUCTION_ENABLED também como true. Dê aos seus papéis as permissões de pré-leilão, de mandato de fundos e de recusa, e depois salve uma configuração de pré-leilão.Pix
Pix agendado no Pix Lerian v1.3.0
O Pix Lerian envia sozinho um Pix agendado na data dele, com até três tentativas no horário de America/Sao_Paulo: das 00:00 às 07:59, das 18:00 às 19:59 e das 20:00 às 20:59. Cada componente serve suas sondas de saúde e de readiness emHEALTH_PORT. O VSync do DICT verifica cada escopo pelo menos a cada 12 horas, e com o intervalo de varredura padrão VSYNC_GATE_TTL_SEC não pode ficar abaixo de 45540. O Decode QR Code responde 422 PIX-0228 para uma cobrança que não pode mais ser paga, e uma conexão perdida com o banco de dados responde 503 PIX-0062: leia o recurso antes de tentar de novo.SPI
Chave HSM e códigos de resolução de QR no Lerian SPI
As páginas e a referência de API do Lerian SPI passaram para o build mais recente do Lerian SPI. ComBACEN_TLS_KEY_KIND=kmip, a chave privada do certificado mTLS do BACEN fica no seu HSM KMIP. Cada recusa da resolução do QR dinâmico tem seu próprio código, de SPI-0020 a SPI-0025. O evento dict_claim.received do lado doador traz o reivindicador e a conta para onde a chave iria.Se você ramifica em SPI-0003 para a resolução do QR, ramifique nos novos códigos.TED
Reembolsos de TED OUT devolvido no TED JD v3.5.1
Uma devolução que chega antes de um TED OUT terminar fica estacionada: o TED aparece na lista de conciliação pendente comTED_OUT_DEVOLUTION_PARKED, e o plugin envia transfer_outgoing.devolution_notified. Quando o TED termina, um operador da sua instituição reembolsa o pagador com a ação REFUND de Resolve Transfer Reconciliation. Close TED IN Reconciliation Gaps fecha as lacunas abertas de uma janela de tempo depois que uma pessoa confere o extrato da JD. As devoluções automáticas de TEDs recebidos saem dentro da janela de operação das devoluções.Revise o processo dos seus operadores para TEDs devolvidos e seus consumidores de eventos.SPBSILOCSPI
Finalidade do resgate no Lerian SPB e permissões do Lerian Cabine
Um resgate da Conta PI para a conta Reservas Bancárias recebefinalidadeLPI 1, para a movimentação própria da instituição ou uma transferência para uma conta em um liquidante no STR, ou 2, para a devolução de um aporte recebido por engano. Com 2, a requisição também leva originalControlNumber, o número de controle do STR desse aporte. Qualquer outro valor responde 422, inclusive 01 preenchido com zero. A leitura do cronograma do STR mostra se a janela adicional está aberta. O Lerian SILOC dispara um alerta PARTICIPANT_EXCLUDED quando um PAG0101 exclui um participante e lê CORS_ALLOWED_ORIGINS para clientes de navegador, como o Lerian Cabine. No workspace SPI, o Lerian Cabine esconde as ações restritas que as permissões do Access Manager do operador não concedem.Envie finalidadeLPI como 1 ou 2 em cada resgate para a conta Reservas Bancárias. Confirme que os grupos do Access Manager dos seus operadores concedem as permissões do SPI que eles usam.STA
Envios retidos e credenciais recusadas no Lerian STA v1.3.0
O Lerian STA mantém um arquivo de saída em espera durante uma indisponibilidade do STA do BACEN, uma falha de conexão ou uma senha recusada, no máximo até o prazo de envio de 48 horas do BACEN. A espera não gasta nenhuma das tentativas do arquivo, e Retry antecipa um envio retido. Quando o BACEN recusa a senha de uma credencial, o Lerian STA marca a credencial como recusada. Um operador informa a senha atual comPUT /v1/credentials/{id}/current-password ou no Lerian Cabine, e os arquivos retidos saem de imediato.BC Correios
Eventos do Lerian BC Correios v1.1.0
O Lerian BC Correios publica nove eventos no Kafka emlerian.streaming.br-correios: para correspondência recebida, lida, arquivada e restaurada, a primeira sincronização, um envio confirmado ou com falha e a análise de IA. Ele precisa de um broker Kafka, e cada instalação atende uma instituição. As configurações levam uma versão: envie a versão que você leu como expectedVersion em cada alteração de configurações. Um salvamento que outro salvamento ultrapassou responde 409 BCC-0013.SISBAJUD
Executor do Lerian SISBAJUD v1.2.0
O executor para de postar um resultado judicial depois deEXECUTOR_RESULT_MAX_ATTEMPTS tentativas com falha, 12 por padrão: ele estaciona o resultado, registra uma decisão humana e dispara um alarme. As versões posteriores da mesma ordem esperam atrás de um resultado estacionado. Quando o Midaz está indisponível no corte de uma ordem, o executor entrega a ordem a uma decisão humana e não envia resultado. Uma ordem de bloqueio com valor mínimo vai para uma decisão humana quando o executor pode bloquear menos que esse mínimo. Em uma instalação single-tenant, uma instituição pode passar para o canal direto e enviar suas ordens direto ao executor. O executor não lê mais ORGANIZATION_IDS.Inclua os resultados estacionados e as ordens entregues no corte na sua revisão das decisões humanas.Tracer
Origem da validação e armazenamento da licença no Tracer
O registro de validação do Tracer de uma transação que o ledger do Midaz reserva agora traz oorganizationId e o ledgerId dessa transação. Recuperar uma validação e cada resultado de Listar validações retornam os dois campos. Os registros de POST /v1/validations e das requisições só de regras não trazem nenhum dos dois, e os registros gravados antes da atualização também não.Use organizationId, ledgerId e transactionId para ligar um registro à sua transação no ledger. Com LICENSE_KEY, o Tracer mantém a licença assinada apenas em memória e não guarda licença no PostgreSQL. Cada reinício busca a licença no servidor de licenças de novo e, enquanto esse servidor não responde, o Tracer reiniciado fica não pronto.Flowker
Provedor Pix JD do Flowker v1.5.0
O Flowker v1.5.0 inclui o provedor nativopix-jd para nós de workflow. Leia o guia de integração para configurar o provedor.Access Manager
Readiness do Access Manager v3.17.0
O Access Manager disponibiliza a readiness em uma porta de saúde separada. Antes de atualizar, definaHEALTH_PORT para Auth e Identity e aponte as sondas de readiness para essa porta.Lender
Originação no Lender v4.0.0
Durante a originação, o Lender encontra ou cadastra cada tomador como titular no CRM do Midaz. Antes de atualizar, cumpra os pré-requisitos do Lender.Lender
Lender no Lerian Console
O módulo Lender no Lerian Console oferece telas para operações de crédito. Um administrador pode ativá-lo em Configurações, Produtos. O módulo requer Lender v4.0.0.Midaz
Idempotência no Midaz Go SDK v6.5.0
O Midaz Go SDK não gera mais uma chave de idempotência aleatória por padrão. Sem uma chave própria, o Midaz trata a criação de uma transação idêntica na janela de idempotência como repetição. Defina uma chave distinta para cada transação que pretende lançar.Pix
Devoluções no Pix BTG v1.14.0
Uma requisição de devolução no Pix BTG precisa deX-Idempotency ou X-Return-End-To-End. Adicione pelo menos um desses headers às requisições de devolução antes de atualizar.Pix
Readiness do Pix JD v1.6.1
O Pix JD disponibiliza readiness e métricas emHEALTH_PORT. Antes de atualizar, aponte a sonda de readiness e a coleta de métricas para essa porta e defina uma chave global de produção em LICENSE_KEY.Reporter
Readiness do Reporter v4.8.0
O Reporter disponibiliza readiness emHEALTH_PORT. Antes de atualizar, defina HEALTH_PORT e aponte as sondas de readiness para essa porta.Payments
Boletos híbridos no Payments BTG v1.2.0
Um boleto híbrido também pode ser pago por Pix. Antes de emitir um, configure a chave Pix e o endereço do recebedor.Pix
Limite diário do Pix Automático
A Lerian configura um limite diário para pagadores pessoas físicas com CPF mediante solicitação pelo Lerian Clients. Se nenhum limite for configurado, não há limite diário.Consignado
Licença e contabilização de portabilidade no Lerian Consignado 4.2.0
As páginas e a referência da API do Consignado foram atualizadas para o Lerian Consignado 4.2.0. O gateway exige uma licença Lerian em todos os modos de deploy e não inicia sem ela. Onumero_ccb aceita no máximo 20 caracteres. A operação de registro de cessão do banco foi removida, e o gateway registra a cessão a partir do fato de cessão da Lender.Uma averbação por portabilidade aceita agora aguarda a documentação. Documente-a pelo anexo da CCB, como uma averbação. Com o bloco de contabilização, que lista cada contrato de origem quitado em origins[], a Lender registra o contrato quando a Dataprev confirma a documentação e o registro de situação dela mostra exatamente esses contratos de origem. Essa contabilização exige Lender 4.0.0 ou posterior; atualize o Lender antes do gateway 4.2.0. A exclusão da instituição de origem precisa acontecer antes, porque a Dataprev recusa uma averbação anterior com a regra PT.Seu back office lê os registros de repasse retidos no bloco held das expectativas de repasse e libera cada um com POST /v1/consignado/reconciliation/held-repasses/{id}/release.O gateway publica cinco novos tipos de evento. consignado.refinanciamento.efetivado, consignado.refinanciamento.revertido e consignado.refinanciamento.recusado informam os resultados de um refinanciamento. Com DATAPREV_MIGRACAO_ENABLED ligado, consignado.migracao.efetivada informa um contrato que a Dataprev moveu para um novo vínculo de emprego. consignado.certificate.expiring é publicado antes de o certificado da Dataprev vencer.A descoberta de leilão e de portabilidade roda para todo tenant com custódia Dataprev completa, e LEILAO_TENANT_ID foi removida. A renegociação automática foi removida: toda renegociação vem do seu pedido de renegociação.Antes de atualizar, defina LICENSE_KEY em toda carga de trabalho e libere HTTPS de saída para https://license.lerian.io. Atualize o Access Manager para a versão 3.14.0 ou posterior antes de um originador chamar uma rota sem id de originador. Depois que um tenant migrar, não volte o gateway para a 4.0.0. Ligue DATAPREV_AVERBACAO_ENABLED e defina AVERBACAO_ARTIFACTS_BUCKET se você envia averbações por portabilidade, ou a rota responde 501.Um comando de trilho cujo resultado a Dataprev deixa desconhecido responde 503 OUTCOME_UNKNOWN. Não o envie de novo: a mesma chave responde 409 RAIL_COMMAND_OUTCOME_UNRESOLVED. Leia os comandos de trilho e feche um refinanciamento, uma renegociação ou uma alteração de termos estacionados pelo que o portal da Dataprev mostra. Quando um 503 DATAPREV_UNAVAILABLE disser que o comando fechou recusado, envie-o de novo com uma nova chave X-Idempotency. Uma subscription que lista tipos de evento não recebe nenhum dos cinco novos. Para recebê-los, crie uma subscription para todo o tenant que liste as chaves deles, obtidas em GET /v1/catalog, como consignado_migracao.efetivada. Se a contabilização responder 422 LOAN_PRODUCT_VERSION_UNKNOWN para uma versão de produto na Lender criada antes do vínculo do gateway com seu tenant, crie uma nova versão. Se a versão acabou de ser criada, aguarde sua chegada e tente novamente. Um papel personalizado do Access Manager precisa de rail-command-close:execute para fechar um refinanciamento, uma renegociação ou uma alteração de termos estacionados e de held-repasses-release:execute para liberar um repasse retido.Tracer
Limites de gastos do Tracer consumidos apenas pelo ledger do Midaz
Apenas uma transação que o ledger do Midaz reserva com o Tracer no modoadvisory ou enforce consome um limite de gastos. O Tracer registra cada decisão de reserva como uma validação com o transactionId da transação do ledger. GET /v1/validations e GET /v1/validations/{validation_id} devolvem esse campo, e GET /v1/validations filtra por transaction_id. O Tracer não lê mais API_KEY_ENABLED_ONLY_VALIDATION.Antes de atualizar, crie no Midaz, com o Tracer no modo advisory ou enforce, cada transação cujo gasto você conta: POST /v1/validations não consome um limite. Se um cliente chamar POST /v1/validations ou POST /v1/validations/rules-only apenas com a API key enquanto a autenticação por plugin está ligada, dê a ele uma credencial do Access Manager. Remova API_KEY_ENABLED_ONLY_VALIDATION da configuração do seu Tracer.Correção de 7 de novembro de 2026: uma versão anterior desta entrada dizia que POST /v1/validations foi removido. A rota está disponível, e ela verifica suas regras e limites sem consumi-los. Veja a entrada do Tracer de 7 de novembro.SPB
Licença e respostas divididas do BACEN 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 Lerian SPB precisa de uma licença em todo ambiente, inclusive desenvolvimento, e não inicia sem ela. A licença é global: o trilho não lê nenhum identificador de organização. Uma licença recusada responde403 com um código LCS- em toda rota sob /v1/str, e o /readyz reporta um check license. Quando uma resposta do BACEN dividida em partes ainda não tem uma parte 30 minutos depois da primeira, o trilho abre um caso de conciliação PARTITIONED_MESSAGE_INCOMPLETE.Antes de atualizar, defina LICENSE_KEY em toda carga de trabalho do Lerian SPB. Inclua os casos PARTITIONED_MESSAGE_INCOMPLETE na sua rotina de conciliação.SPI
Licença e reenvio de um Pix que não saiu no Lerian SPI
As páginas e a referência de API do Lerian SPI passaram para a build mais nova do Lerian SPI. Todo binário do Lerian SPI precisa de uma licença para iniciar, em todo ambiente, e para quando a licença é recusada. Um pagamento Pix que terminouFAILED com 503 e SPI-1001 ou SPI-1004 pode ser enviado de novo. Envie a primeira requisição de novo com a mesma chave X-Idempotency, ou envie a mesma requisição com uma chave nova e o endToEndId do pagamento que falhou. O trilho envia como uma nova tentativa do mesmo pagamento e publica spi_payment.initiated de novo. Uma solicitação de aprovação aceita só o tipo de assunto MANUAL_RESOLUTION.Antes de atualizar, defina LICENSE_KEY em todo binário do Lerian SPI. Se um consumidor age sobre spi_payment.failed, deixe que ele aceite um spi_payment.initiated posterior para o mesmo pagamento.SILOC
Licença e conciliação do ciclo no Lerian SILOC
As páginas e a referência de API do Lerian SILOC passaram para a build mais nova do Lerian SILOC. O Lerian SILOC precisa de uma licença em todo ambiente e não inicia sem ela. Uma requisição que a licença recusa responde403 com um código LCS-. GET /api/v1/siloc/cycles e GET /api/v1/siloc/cycles/{cycleId} trazem a reconciliation do ciclo, e a leitura separada da conciliação do ciclo não existe mais. GET /api/v1/siloc/ot-multilateral-results/{noticeId} devolve o resultado multilateral que uma conciliação indica em resultNoticeId. Uma requisição SLC0004 termina REFUSED quando a resposta SLC0004R1 dela traz uma situação diferente de sucesso. Um LTR0002 ou LTR0008 em DISPATCHED cujo ciclo LBTR terminou sem R1 fica retido aguardando resposta, e dois operadores podem fechá-lo.Antes de atualizar, defina LICENSE_KEY no Lerian SILOC. Leia a conciliação de um ciclo nas leituras do ciclo. Trate REFUSED nas suas requisições SLC0004.SCR
Licença do Lerian SCR
As páginas e a referência de API do Lerian SCR passaram para a build mais nova do Lerian SCR. O Lerian SCR se recusa a iniciar sem uma licença Lerian, em todo ambiente, e nenhuma configuração desliga essa verificação. Um checklicense em down faz o /readyz responder 503.Antes de atualizar, defina LICENSE_KEY no Lerian SCR.TED
Licença da instalação no TED Lerian
As páginas e a referência de API do TED Lerian passaram para a build mais nova do TED Lerian. O TED Lerian confere uma licença para a instalação inteira ao iniciar e a confere de novo em segundo plano. O serviço não inicia comLICENSE_KEY vazia, em nenhum ambiente, e para quando a licença é recusada. Ele não lê mais LICENSE_ENABLED, LICENSE_APPLICATION_ID nem ORGANIZATION_IDS.Defina LICENSE_KEY em toda carga de trabalho do TED Lerian e libere HTTPS de saída para https://license.lerian.io. Remova LICENSE_ENABLED, LICENSE_APPLICATION_ID e ORGANIZATION_IDS.Pix
Liquidação intra-PSP e operações paradas no Pix BTG v1.13.0
As páginas e a referência de API do Pix BTG passaram para a v1.13.0. Um Pix intra-PSP e sua devolução liquidam cada um em uma transação Midaz, sem perna@external. O plugin confere o recebedor primeiro, então um recebedor negado não gera débito. Um Pix para a própria conta do pagador é recusado com PIX-0460. Quando o resultado do débito Midaz de um cash-out é desconhecido, a chamada de processamento responde 201 com o cash-out em CREATED, e o plugin não envia o Pix. O desbloqueio recusa um cash-out ou uma devolução inter-PSP em CREATED com 422 PIX-0470. Cada notificação de webhook ao cliente traz uma Idempotency-Key, e uma notificação reenviada traz a mesma chave.Se você concilia ou gera relatórios a partir do ledger, leia um Pix intra-PSP como uma transação entre as duas contas. Para um cash-out ou uma devolução inter-PSP em CREATED, abra um chamado no suporte da Lerian e informe o id da transferência ou da devolução. Deduplique os webhooks ao cliente pela Idempotency-Key.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.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.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. 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 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.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.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.