Skip to main content
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.
Este asistente siempre crea un TED Out (TED saliente). El TED entrante (TED In) llega automáticamente por el poller de JD, así que no tiene paso de creación manual. Una transferencia P2P usa un flujo aparte. No puedes crear una transferencia P2P desde esta página.

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 después de que el backend completa la transferencia.
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.
No envíes una transferencia TED fuera de la ventana de operación. La Console no bloquea el botón, pero el backend 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).

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 100 caracteres).
  • 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 o Savings.
  • ISPB Code (obligatorio): el ISPB de 8 dígitos del banco del beneficiario.
  • Branch (obligatorio): el código de sucursal del banco del beneficiario.
ISPB Code y Branch aplican a las transferencias TED (TED Out y TED In). Este asistente crea un TED Out, así que los dos campos son obligatorios aquí.

Transfer Details

  • Amount (obligatorio): el monto de la transferencia. El monto debe ser mayor que cero.
  • Currency (obligatorio): fijo en BRL.
  • Description (opcional): una descripción de texto libre de hasta 140 caracteres.
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:
  • Transfer Type: siempre TED Out en esta página.
  • 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 después de que el backend responde.

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: