Ação necessária
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.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.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.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.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.Revisão recomendada
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.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.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.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.Lerian ConsoleMidazReporter