Pular para o conteúdo principal
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.
O assistente não pede um tipo de transferência. O plugin cria uma P2P quando o Código ISPB é o ISPB da sua instituição, e uma TED Out para qualquer outro ISPB. A TED de entrada (TED In) chega da JD, então ela não tem passo de criação manual.

​
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 quando o plugin aceita a transferência para processamento.
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 configurada para o TED. O banner informa a janela de operação: de segunda a sexta, entre as horas de abertura e de fechamento configuradas, no fuso horário configurado. Um banner Janela de Funcionamento do TED Fechada aparece quando a janela armazenada fecha todos os dias, e um banner Janela de Funcionamento do TED Inválida quando o plugin não aceita a janela armazenada.
Não envie uma TED Out fora da janela de operação ou em um feriado do BACEN. O Console não bloqueia o botão, mas o plugin rejeita a requisição com um erro 422 (BTF-0010). A resposta informa o próximo horário em que a janela de operação abre. A janela padrão é de segunda a sexta, 06:30–17:00 (America/Sao_Paulo, UTC−3). Transferências P2P ignoram a janela.

Configurar o horário de funcionamento

Ajuste a janela de operação 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é 200 bytes. Um caractere acentuado conta como dois.
  • 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, Poupança, Pagamento ou Salário.
  • Código ISPB (obrigatório): o ISPB de 8 dígitos do banco do beneficiário.
  • Agência: o código da agência do banco do beneficiário, de 1 a 4 dígitos. O plugin aceita uma TED sem agência.

​
Detalhes da transferência

  • Valor (obrigatório): o valor da transferência, de 0,01 a 999.999,99, com no máximo duas casas decimais.
  • Moeda (obrigatório): fixa em BRL.
  • Finalidade (código SPB) (obrigatório): o código de finalidade SPB, de 1 a 4 dígitos. 10 é crédito em conta.
  • Descrição (opcional): uma descrição em texto livre de até 140 bytes. Um caractere acentuado conta como dois.
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:
  • 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 quando o plugin aceita a transferência. Caso contrário, mostra uma destas mensagens:
  • Não foi possível confirmar o resultado com o banco.: os valores continuam retidos e a transferência aguarda na fila de conciliação. Não envie a transferência de novo.
  • Janela de confirmação expirada ou Os dados de assinatura não correspondem mais: nada foi enviado. Clique em Recomeçar.
  • Transferência já enviada: clique em Ver transferências para encontrá-la.

​
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: