Skip to main content
The New Transfer page creates a transfer in two steps. In step 1 you enter the transfer details and request a fee preview (initiate). In step 2 you review the transfer and confirm it (process). The Console shows step 1 as a form and step 2 as a review screen. The Console runs the transfer when you click Confirm Transfer.
This wizard always creates a TED Out (outbound TED). Inbound TED (TED In) arrives automatically through the JD poller, so it has no manual creation step. A P2P transfer uses a separate flow. You cannot create a P2P transfer from this page.

​
Accessing the wizard

1

Open the Transfers page

In the Midaz Module sidebar, expand Bank Transfer. Click Transfers.
2

Start a new transfer

Click New Transfer at the top right of the page.
The page header shows New Transfer. The subtitle reads Initiate a new bank transfer in two simple steps. A stepper near the top shows your place in the flow: step 1 is the form and step 2 is the review. The success screen appears after the backend completes the transfer.

​
Operating hours banner

An amber Outside TED Operating Hours banner appears at the top when the current time is outside the configured TED operating window. The banner states the operating window: Monday through Friday, between the configured open and close times, in the configured timezone.
Do not submit a TED transfer outside the operating window. The Console does not block the button, but the backend rejects the request with a 422 error (BTF-0010). The response reports the next time the operating window opens. The default window is Monday through Friday, 06:30–17:00 (America/Sao_Paulo, UTC−3).

Configuring Operating Hours

Adjust the operating window in Settings.

​
Step 1 — Collect details and initiate

The form has three sections. The Console marks all required fields. When you click Continue, the Console calls the backend /initiate endpoint with the values below. The /initiate endpoint computes the fees and returns a preview for the review screen.

​
Source Account

  • Sender Account (required) — choose the source account from the dropdown. The list holds the ledger accounts that allow sending. If the ledger has no eligible sender account, the field becomes a text input. You then type the account ID directly.

​
Destination Account

  • Recipient Name (required) — the beneficiary’s full name (up to 100 characters).
  • CPF/CNPJ (required) — the beneficiary’s document. A CPF has 11 digits and a CNPJ has 14 digits.
  • Account Number (required) — the beneficiary’s account number.
  • Account Type (required) — Checking or Savings.
  • ISPB Code (required) — the beneficiary bank’s 8-digit ISPB.
  • Branch (required) — the beneficiary bank’s branch code.
ISPB Code and Branch apply to TED transfers (TED Out and TED In). This wizard creates a TED Out, so both fields are required here.

​
Transfer Details

  • Amount (required) — the transfer amount. The amount must be greater than zero.
  • Currency (required) — fixed to BRL.
  • Description (optional) — a free-text description up to 140 characters.
Click Continue to move to the review step. The /initiate response carries the initiation identifier, the fee breakdown, and the estimated completion. These values drive the next screen.

​
Step 2 — Review and confirm

The Console builds the review screen from the /initiate response in step 1. The initiation identifier, the fee breakdown, and the estimated completion carry over. Check the transfer before you run it. The screen shows:
  • Transfer Type — always TED Out on this page.
  • Sender Account, Recipient Name, CPF/CNPJ, Recipient Account, Account Type, ISPB, Branch, Description — exactly what you entered in step 1.
  • Amount — the amount you entered.
  • Fee — the total fee that the plugin computes.
  • Fee Breakdown — one line per fee entry, with its label and its amount. A Deductible entry comes out of the transfer amount. Other entries add to it.
  • Total — the final amount that the plugin debits from the sender.
  • Estimated Completion — the timestamp when the transfer should complete.
Click Back to return to the form. The Console keeps your previous entries. When you click Continue again, the Console re-runs /initiate so the fee preview matches your changes.
When you click Confirm Transfer, the Console sends the reviewed transfer to the backend /process endpoint. This call creates and runs the transfer through the JD SPB integration. The button shows Confirming… while the call is in flight. The Console redirects to the success screen after the backend responds.

​
Success screen

After /process returns successfully, the Console shows a success screen with:
  • Transfer ID — the identifier of the transfer.
  • Confirmation Number — the reference that the JD integration returns.
  • Status — the status after confirmation (typically Created, Pending, Processing, or Completed).
  • Fee and Total — the applied values.
The success screen offers two actions:
  • View Transfer — opens the Transfer Detail page for this transfer.
  • New Transfer — restarts the wizard with a clean form.