Skip to main content
A página Nova Transferência cria uma transferência em dois passos. No passo 1 você informa os dados da transferência e pede uma prévia da tarifa (initiate). No passo 2 você revisa a transferência e a confirma (process). O Console mostra o passo 1 como um formulário e o passo 2 como uma tela de revisão. O Console executa a transferência quando você clica em Confirmar Transferência.
Esse assistente sempre cria uma TED Saída (TED de saída). A TED de entrada (TED Entrada) chega automaticamente pelo poller da JD, então ela não tem passo de criação manual. Uma transferência P2P usa um fluxo separado. Você não pode criar uma transferência P2P nesta página.

​
Como acessar o assistente

1

Abra a página de Transferências

Na barra lateral do módulo Midaz, expanda Transferência Bancária. Clique em Transferências.
2

Comece 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 passos perto do topo mostra onde você está no fluxo: o passo 1 é o formulário e o passo 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 funcionamento configurada para o TED. O banner informa a janela de funcionamento: de segunda a sexta, entre as horas de abertura e de fechamento configuradas, no fuso horário configurado.
Não envie uma transferência TED fora da janela de funcionamento. 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 de funcionamento abre. A janela padrão é de segunda a sexta, 06:30–17:00 (America/Sao_Paulo, UTC−3).

Configurar o horário de funcionamento

Ajuste a janela de funcionamento em Configurações.

​
Passo 1: colete os dados e inicie

O formulário tem três seções. O Console marca todos os campos obrigatórios. Quando você clica em Continuar, o Console chama o endpoint /initiate do backend com os valores abaixo. O endpoint /initiate calcula as tarifas e devolve uma prévia para a tela de revisão.

​
Conta de origem

  • Conta do Remetente (obrigatório): escolha a conta de origem na lista suspensa. A lista traz as contas do ledger que permitem envio. Se o ledger não tem conta de remetente elegível, o campo vira uma entrada de texto. Você então 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. O CPF tem 11 dígitos e o 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.
O Código ISPB e a Agência valem para transferências TED (TED Saída e TED Entrada). Esse assistente cria uma TED Saída, então os dois campos são obrigatórios aqui.

​
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 em texto livre de até 140 caracteres.
Clique em Continuar para ir ao passo de revisão. A resposta do /initiate traz o identificador de iniciação, o detalhamento das tarifas e a conclusão estimada. Esses valores alimentam a próxima tela.

​
Passo 2: revise e confirme

O Console monta a tela de revisão a partir da resposta do /initiate no passo 1. O identificador de iniciação, o detalhamento das tarifas e a conclusão estimada são levados adiante. Confira a transferência antes de executá-la. A tela mostra:
  • Tipo de Transferência: sempre TED Saída 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 no passo 1.
  • Valor: o valor que você informou.
  • Taxa: a tarifa total que o plugin calcula.
  • Detalhamento de Taxas: uma linha por entrada de tarifa, com o rótulo e o valor dela. Uma entrada Dedutível sai do valor da transferência. As outras entradas somam a ele.
  • Total: o valor final que o plugin debita do remetente.
  • Conclusão Estimada: o timestamp em que a transferência deve terminar.
Clique em Voltar para retornar ao formulário. O Console mantém o que você informou antes. Quando você clica em Continuar de novo, o Console executa /initiate outra vez, para a prévia da tarifa combinar com as suas mudanças.
Quando você clica em Confirmar Transferência, o Console envia a transferência revisada ao endpoint /process do backend. Essa chamada cria e executa a transferência pela integração JD SPB. O botão mostra 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 o /process retorna com sucesso, o Console mostra 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 devolve.
  • Status: o status depois da confirmação (normalmente Criada, Pendente, Processando ou Concluída).
  • Taxa e Total: os valores aplicados.
A tela de sucesso oferece duas ações: