Skip to main content
A página Nova Transferência cria uma transferência em duas etapas. Na etapa 1 você informa os dados da transferência e solicita uma prévia de taxas (initiate). Na etapa 2 você revisa a transferência e a confirma (process). O Console mostra a etapa 1 como um formulário e a etapa 2 como uma tela de revisão. O Console executa a transferência quando você clica em Confirmar Transferência.
Este assistente sempre cria uma TED Out (TED de saída). A TED de entrada (TED In) chega automaticamente pelo poller do JD, portanto não tem etapa de criação manual. Uma transferência P2P usa um fluxo separado. Você não pode criar uma transferência P2P 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. Clique em Transferências.
2

Inicie uma nova transferência

Clique em Nova Transferência no canto superior direito da página.
O cabeçalho da página mostra Nova Transferência. O subtítulo diz 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á: a etapa 1 é o formulário e a etapa 2 é a revisão. A tela de sucesso aparece depois que o backend conclui a transferência.
Um banner âmbar Fora do Horário de Funcionamento do TED aparece no topo quando o horário atual está fora da janela de operação TED configurada. O banner indica a janela de operação: de segunda a sexta, entre os horários de abertura e fechamento configurados, no fuso configurado.
Não envie uma transferência TED fora da janela operacional. O Console não bloqueia o botão, mas o backend rejeita a requisição com um erro 422 (BTF-0010). A resposta informa o próximo horário em que a janela operacional abre. 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. O Console marca todos os campos obrigatórios. Ao clicar em Continuar, o Console chama o endpoint /initiate do backend com os valores abaixo. O endpoint /initiate calcula as taxas e retorna uma prévia para a tela de revisão.

​
Conta de Origem

  • Conta do Remetente (obrigatório) — escolha a conta de origem no dropdown. A lista contém as contas do ledger que permitem envio. Se o ledger não tiver uma conta de remetente elegível, o campo se torna uma entrada de texto. Então você digita 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. Um CPF tem 11 dígitos e um CNPJ tem 14 dígitos.
  • 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). Este assistente cria uma TED Out, portanto ambos os campos são obrigatórios.

​
Detalhes da Transferência

  • Valor (obrigatório) — o valor da transferência. O valor 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. Esses valores alimentam a próxima tela.

​
Etapa 2 — Revisar e confirmar

O Console constrói a tela de revisão a partir da resposta de /initiate da etapa 1. O identificador da iniciação, o detalhamento da taxa e a conclusão estimada são reaproveitados. Confira a transferência antes de executá-la. A tela mostra:
  • 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 que o plugin calcula.
  • Detalhamento de Taxas — uma linha por item de taxa, com o rótulo e o valor. Um item Dedutível sai do valor da transferência. Os demais itens somam a ele.
  • Total — o valor final que o plugin debita 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. O Console mantém suas informações anteriores. Quando você clica em Continuar novamente, o Console executa /initiate de novo para que a prévia de taxas corresponda às suas alterações.
Quando você clica em Confirmar Transferência, o Console envia a transferência revisada para o endpoint /process do backend. Essa chamada cria e executa a transferência por meio da integração JD SPB. O botão exibe Confirmando… enquanto a chamada está em andamento. O Console redireciona para a tela de sucesso depois que o backend responde.

​
Tela de sucesso

Depois que /process retorna com sucesso, o Console exibe uma tela de sucesso com:
  • ID da Transferência — o identificador da transferência.
  • Número de Confirmação — a referência que a integração JD retorna.
  • Status — o status após a confirmação (tipicamente Created, Pending, Processing ou Completed).
  • Taxa e Total — os valores aplicados.
A tela de sucesso oferece duas ações: