Saltar al contenido principal
La página New Transfer crea una transferencia en dos pasos. En el paso 1 ingresas los datos de la transferencia y pides una previsualización de comisiones (initiate). En el paso 2 revisas la transferencia y la confirmas (process). La Console muestra el paso 1 como un formulario y el paso 2 como una pantalla de revisión. La Console ejecuta la transferencia cuando haces clic en Confirm Transfer.
El asistente no pide un tipo de transferencia. El plugin crea un P2P cuando ISPB Code es el ISPB de tu institución, y un TED Out para cualquier otro ISPB. El TED entrante (TED In) llega desde JD, así que no tiene paso de creación manual.

​
Acceder al asistente

1

Abre la página Transfers

En la barra lateral del Midaz Module, expande Bank Transfer. Haz clic en Transfers.
2

Inicia una transferencia nueva

Haz clic en New Transfer en la parte superior derecha de la página.
El encabezado de la página muestra New Transfer. El subtítulo dice Initiate a new bank transfer in two simple steps. Un stepper cerca de la parte superior muestra tu posición en el flujo: el paso 1 es el formulario y el paso 2 es la revisión. La pantalla de éxito aparece cuando el plugin acepta la transferencia para su procesamiento.
Un banner ámbar Outside TED Operating Hours aparece arriba cuando la hora actual está fuera de la ventana de operación de TED configurada. El banner indica la ventana de operación: de lunes a viernes, entre las horas de apertura y cierre configuradas, en la zona horaria configurada. Un banner TED Operating Window Closed aparece cuando la ventana almacenada cierra todos los días, y un banner TED Operating Window Misconfigured cuando el plugin no acepta la ventana almacenada.
No envíes un TED Out fuera de la ventana de operación ni en un feriado de BACEN. La Console no bloquea el botón, pero el plugin rechaza la solicitud con un error 422 (BTF-0010). La respuesta informa la próxima vez que abre la ventana de operación. La ventana predeterminada es de lunes a viernes, 06:30–17:00 (America/Sao_Paulo, UTC−3). Las transferencias P2P ignoran la ventana.

Configuración del horario de operación

Ajusta la ventana de operación en Settings.

​
Paso 1: recopila los datos e inicia

El formulario tiene tres secciones. La Console marca todos los campos obligatorios. Cuando haces clic en Continue, la Console llama al endpoint /initiate del backend con los valores de abajo. El endpoint /initiate calcula las comisiones y devuelve una previsualización para la pantalla de revisión.

​
Source Account

  • Sender Account (obligatorio): elige la cuenta de origen en la lista desplegable. La lista contiene las cuentas del ledger que permiten enviar. Si el ledger no tiene ninguna cuenta emisora elegible, el campo pasa a ser una entrada de texto. Entonces escribes el ID de la cuenta directamente.

​
Destination Account

  • Recipient Name (obligatorio): el nombre completo del beneficiario, hasta 200 bytes. Un carácter acentuado cuenta como dos.
  • CPF/CNPJ (obligatorio): el documento del beneficiario. Un CPF tiene 11 dígitos y un CNPJ tiene 14 dígitos.
  • Account Number (obligatorio): el número de cuenta del beneficiario.
  • Account Type (obligatorio): Checking, Savings, Payment o Salary.
  • ISPB Code (obligatorio): el ISPB de 8 dígitos del banco del beneficiario.
  • Branch: el código de sucursal del banco del beneficiario, de 1 a 4 dígitos. El plugin acepta un TED sin sucursal.

​
Transfer Details

  • Amount (obligatorio): el monto de la transferencia, de 0.01 a 999,999.99, con dos decimales como máximo.
  • Currency (obligatorio): fijo en BRL.
  • Purpose (SPB finality code) (obligatorio): el código de finalidad SPB, de 1 a 4 dígitos. 10 es un crédito en cuenta.
  • Description (opcional): una descripción de texto libre de hasta 140 bytes. Un carácter acentuado cuenta como dos.
Haz clic en Continue para pasar al paso de revisión. La respuesta de /initiate lleva el identificador de inicio, el desglose de comisiones y la finalización estimada. Estos valores alimentan la siguiente pantalla.

​
Paso 2: revisa y confirma

La Console construye la pantalla de revisión a partir de la respuesta de /initiate del paso 1. El identificador de inicio, el desglose de comisiones y la finalización estimada se trasladan. Revisa la transferencia antes de ejecutarla. La pantalla muestra:
  • Sender Account, Recipient Name, CPF/CNPJ, Recipient Account, Account Type, ISPB, Branch, Description: exactamente lo que ingresaste en el paso 1.
  • Amount: el monto que ingresaste.
  • Fee: la comisión total que calcula el plugin.
  • Fee Breakdown: una línea por entrada de comisión, con su etiqueta y su monto. Una entrada Deductible sale del monto de la transferencia. Las demás entradas se suman a él.
  • Total: el monto final que el plugin debita del emisor.
  • Estimated Completion: la marca de tiempo en que la transferencia debería completarse.
Haz clic en Back para volver al formulario. La Console conserva lo que ingresaste antes. Cuando haces clic en Continue de nuevo, la Console vuelve a ejecutar /initiate para que la previsualización de comisiones coincida con tus cambios.
Cuando haces clic en Confirm Transfer, la Console envía la transferencia revisada al endpoint /process del backend. Esta llamada crea y ejecuta la transferencia a través de la integración de JD SPB. El botón muestra Confirming… mientras la llamada está en curso. La Console redirige a la pantalla de éxito cuando el plugin acepta la transferencia. De lo contrario, muestra uno de estos mensajes:
  • We could not confirm the outcome with the bank.: los fondos siguen retenidos y la transferencia espera en la cola de conciliación. No envíes la transferencia de nuevo.
  • Confirmation window expired o Signing data no longer matches: no se envió nada. Haz clic en Start over.
  • Transfer already submitted: haz clic en View transfers para encontrarla.

​
Pantalla de éxito

Después de que /process devuelve una respuesta exitosa, la Console muestra una pantalla de éxito con:
  • Transfer ID: el identificador de la transferencia.
  • Confirmation Number: la referencia que devuelve la integración de JD.
  • Status: el estado después de la confirmación (normalmente Created, Pending, Processing o Completed).
  • Fee y Total: los valores aplicados.
La pantalla de éxito ofrece dos acciones: