Pular para o conteúdo principal
O plugin Bank Transfer no Midaz Module permite iniciar, acompanhar e conciliar transferências bancárias pela integração JD SPB, direto do Lerian Console. Em um só lugar, você pode monitorar a saúde das transferências, operar fluxos TED, investigar falhas e configurar a integração.

​
O que o Bank Transfer cobre

O plugin trata três tipos de transferência, cada um com um fluxo diferente no Console:
  • TED Out: transferências TED de saída para outra instituição. Você as cria na página Nova Transferência.
  • TED In: transferências TED de entrada recebidas da JD. Elas aparecem na lista de transferências. Não há etapa de criação manual.
  • P2P: transferências entre duas contas da sua própria instituição. Você as cria na página Nova Transferência.
A página Nova Transferência não pede um tipo. O plugin cria uma P2P quando o ISPB do destinatário é o ISPB da sua instituição, e uma TED Out para qualquer outro ISPB.

​
Ativando o plugin

O Bank Transfer é um plugin opcional. Habilite-o em Configurações do Midaz → Plugins antes de usá-lo.

Gerenciando plugins

Saiba como habilitar, desabilitar e configurar plugins no Midaz Module.
Depois de habilitado, a seção Transferência Bancária aparece no grupo Plugins da barra lateral esquerda com sete páginas:
  • Dashboard: indicador de saúde, KPIs, volume de transferências por tipo e atividade recente.
  • Transferências: as transferências do ledger selecionado, com filtros e exportação CSV.
  • Conciliação: transferências cujo resultado precisa de conciliação, com concentração de falhas.
  • Operações TED IN: coletar, reprocessar e retomar o poller do TED IN e revisar lacunas de conciliação, mensagens retidas e créditos não entregáveis.
  • Webhooks: registros de webhook e entregas com falha.
  • Configurações: horário de funcionamento, limites de uso e política de tarifas.
  • Rotas Contábeis: prontidão do roteamento do ledger e os vínculos que ligam cada organização, ledger e tipo de transferência às rotas contábeis do Midaz.
Seu ambiente também controla a disponibilidade: além do toggle Configurações → Plugins dentro do Console, um flag de plugin em tempo de execução (NEXT_PUBLIC_BANK_TRANSFER_ENABLED) controla o plugin. O flag fica desligado por padrão. O Bank Transfer fica visível apenas quando o administrador define o flag como true para o seu ambiente. O Console lê o flag em tempo de execução, então você define a variável de ambiente e reinicia o container do Console sem rebuild. Se o card Transferência Bancária (TED JD) não aparecer em Configurações → Plugins, o flag está desligado para o seu ambiente. Veja Lerian Console via Helm.
Cada tela do Bank Transfer precisa da permissão bank-transfer: get para vê-la, post para agir nela, patch para alterar as configurações e o documento de roteamento, e delete para excluir um webhook. A página Nova Transferência precisa de post para abrir.

​
Páginas disponíveis

Dashboard

Monitore a saúde do sistema, o volume de transferências e a atividade recente.

Transferências

Navegue, filtre e exporte transferências de todos os tipos e status.

Conciliação

Revise as transferências marcadas para conciliação e seus códigos de falha.

Operações TED IN

Rode o poller de entrada, inspecione lacunas e registre para onde foi o dinheiro retido.

Webhooks

Registre endpoints de webhook, rotacione o segredo de assinatura deles e tente de novo as entregas com falha.

Configurações

Configure horário de funcionamento, limites de uso e política de tarifas.

Rotas Contábeis

Vincule cada escopo às rotas contábeis do Midaz com que o plugin lança.

​
Status das transferências

As transferências passam por um conjunto de status do ciclo de vida. O Dashboard, a lista Transferências e a página de detalhes da transferência mostram os mesmos status.