Pular para o conteúdo principal
A página Nova Transferência guia você na criação de uma transferência em duas etapas que espelham o fluxo do backend: você coleta os dados da transferência e solicita uma prévia de taxas (initiate), depois revisa e confirma para executar a transferência (process). A interface mostra a etapa 1 como um formulário e a etapa 2 como uma tela de revisão; a transferência é executada quando você clica em Confirmar Transferência.
O assistente de iniciação sempre cria uma TED Out (TED de saída). A TED de entrada (TED In) chega automaticamente pelo poller do JD e não tem etapa de criação manual. Transferências P2P são tratadas em um fluxo separado e não são criadas a partir desta página.

Acessando o assistente


1

Abra a página Transferências

Na barra lateral do Módulo Midaz, expanda Bank Transfer e clique em Transferências.
2

Inicie uma nova transferência

Clique no botão Nova Transferência no canto superior direito da página.
O cabeçalho da página mostra Nova Transferência com o subtítulo Inicie uma nova transferência bancária em duas etapas simples. Um indicador de progresso próximo ao topo mostra em que ponto do fluxo você está (etapa 1, o formulário; etapa 2, a revisão), seguido pela tela de sucesso quando o backend conclui o processamento.
Se o horário atual estiver fora da janela de operação TED configurada para o seu plugin, um banner âmbar Fora do Horário de Funcionamento do TED aparece no topo. Ele indica que transferências TED são processadas de segunda a sexta, entre os horários de abertura e fechamento configurados, no fuso configurado.
O banner não bloqueia o envio no Console, mas uma transferência TED enviada fora da janela operacional é rejeitada pelo backend (um erro de fora do horário de funcionamento) — ela não é enfileirada para o próximo dia útil. Envie dentro da janela. Por padrão a janela é de segunda a sexta, 06:30–17:00 (America/Sao_Paulo, UTC−3).

Configurando Horário de Funcionamento

Ajuste a janela de operação em Configurações.

Etapa 1 — Coletar dados e iniciar


O formulário tem três seções. Todos os campos obrigatórios estão marcados na interface. Ao clicar em Continuar, o Console chama o endpoint /initiate do backend com os valores abaixo para calcular as taxas e retornar uma prévia que alimenta a tela de revisão.

Conta de Origem

  • Conta do Remetente (obrigatório) — escolha a conta de origem no dropdown. A lista é preenchida com as contas existentes do ledger que permitem envio. Se o ledger não tiver contas de remetente elegíveis, o campo se torna uma entrada de texto livre na qual você pode digitar o ID da conta diretamente.

Conta de Destino

  • Nome do Destinatário (obrigatório) — o nome completo do beneficiário (até 100 caracteres).
  • CPF/CNPJ (obrigatório) — o documento do beneficiário (11 a 14 caracteres).
  • Número da Conta (obrigatório) — o número da conta do beneficiário.
  • Tipo de Conta (obrigatório)Corrente ou Poupança.
  • Código ISPB (obrigatório) — o ISPB de 8 dígitos do banco do beneficiário.
  • Agência (obrigatório) — o código da agência do banco do beneficiário.
Código ISPB e Agência se aplicam a transferências TED (TED Out e TED In). Como este assistente cria uma TED Out, ambos são obrigatórios aqui.

Detalhes da Transferência

  • Valor (obrigatório) — o valor da transferência; deve ser maior que zero.
  • Moeda (obrigatório) — fixa em BRL.
  • Descrição (opcional) — uma descrição livre de até 140 caracteres.
Clique em Continuar para avançar para a etapa de revisão. A resposta de /initiate traz o identificador da iniciação, o detalhamento da taxa e a conclusão estimada que alimentam a próxima tela.

Etapa 2 — Revisar e confirmar


A tela de revisão é construída a partir da resposta de /initiate retornada na etapa 1 — o identificador de iniciação, o detalhamento da taxa e a conclusão estimada são reaproveitados para que você possa conferir a transferência antes de confirmar. Ela resume tudo antes da execução:
  • Tipo de Transferência — sempre TED Out nesta página.
  • Conta do Remetente, Nome do Destinatário, CPF/CNPJ, Conta do Destinatário, Tipo de Conta, ISPB, Agência, Descrição — exatamente o que você informou na etapa 1.
  • Valor — o valor que você informou.
  • Taxa — a taxa total calculada pelo plugin.
  • Detalhamento da Taxa — uma linha por item de taxa, com o rótulo e o valor. Itens marcados como Dedutível serão descontados do valor da transferência em vez de somados.
  • Total — o valor final a ser debitado do remetente.
  • Conclusão Estimada — o carimbo de tempo em que a transferência deve ser concluída.
Clique em Voltar para retornar ao formulário e ajustar qualquer valor. Suas informações anteriores são preservadas; ao clicar em Continuar novamente, o Console executa novamente /initiate para que a prévia de taxas permaneça em sincronia com o que você alterou.
Ao clicar em Confirmar Transferência, o Console envia a transferência revisada para o endpoint /process do backend. É essa chamada que cria e executa a transferência por meio da integração JD SPB. Enquanto a chamada está em andamento, o botão exibe Confirmando…; assim que o backend responde, o Console redireciona para a tela de sucesso.

Tela de sucesso


Após /process retornar com sucesso, a tela de sucesso exibe:
  • ID da Transferência — o identificador atribuído à transferência.
  • Número de Confirmação — a referência retornada pela integração JD.
  • Status — o status após a confirmação (tipicamente Created, Pending, Processing ou Completed).
  • Taxa e Total — os valores aplicados.
Duas ações estão disponíveis:

Permissões


Se o seu perfil não permitir criar transferências, a página exibe um estado somente leitura: um ícone de escudo, a mensagem Você não tem permissão para criar transferências, e um link Voltar que retorna à lista de Transferências. Entre em contato com o seu administrador para solicitar acesso.