Skip to main content
The New Transfer page walks you through creating a transfer in two steps that mirror the backend flow: you collect the transfer details and request a fee preview (initiate), then you review and confirm to execute the transfer (process). The UI shows step 1 as a form and step 2 as a review screen; the transfer is executed when you click Confirm Transfer.
The initiate wizard always creates a TED Out (outbound TED). Inbound TED (TED In) arrives automatically through the JD poller and does not have a manual creation step. P2P transfers are handled in a separate flow and are not created from this page.

​
Accessing the wizard

1

Open the Transfers page

From the Midaz Module sidebar, expand Bank Transfer and click Transfers.
2

Start a new transfer

Click the New Transfer button at the top right of the page.
The page header shows New Transfer with the subtitle Initiate a new bank transfer in two simple steps. A stepper near the top indicates where you are in the flow (step 1, the form; step 2, the review), followed by the success screen once the backend finishes processing.

​
Operating hours banner

If the current time is outside the TED operating window configured for your plugin, an amber Outside TED Operating Hours banner appears at the top. It indicates that TED transfers are processed Monday through Friday, between the configured open and close times, in the configured timezone.
The banner does not block submission in the Console, but a TED transfer submitted outside the operating window is rejected by the backend (an outside-operating-hours error) — it is not queued for the next business day. Submit during the window instead. By default the 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. All required fields are marked in the UI. When you click Continue, the Console calls the backend /initiate endpoint with the values below to compute fees and return a preview that feeds the review screen.

​
Source Account

  • Sender Account (required) — choose the source account from the dropdown. The list is populated with the ledger’s existing accounts that allow sending. If the ledger has no eligible sender accounts, the field becomes a text input where you can 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 (11 to 14 characters).
  • 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). Since this wizard creates a TED Out, both are required here.

​
Transfer Details

  • Amount (required) — the transfer 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, fee breakdown, and estimated completion that drive the next screen.

​
Step 2 — Review and confirm

The review screen is built from the /initiate response returned in step 1 — the initiation identifier, fee breakdown, and estimated completion all carry over so you can check the transfer before committing. It summarizes everything before you execute:
  • 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 computed by the plugin.
  • Fee Breakdown — one line per fee entry, with its label and amount. Entries marked as Deductible will be taken from the transfer amount rather than added on top.
  • Total — the final amount to be debited from the sender.
  • Estimated Completion — the timestamp at which the transfer is expected to complete.
Click Back to return to the form and adjust any value. Your previous entries are preserved; clicking Continue again re-runs /initiate so the fee preview stays in sync with what you changed.
Clicking Confirm Transfer sends the reviewed transfer to the backend /process endpoint. This is the call that creates and executes the transfer through the JD SPB integration. While the call is in flight, the button shows Confirming…; once the backend responds, the Console redirects to the success screen.

​
Success screen

Once /process returns successfully, a success screen shows:
  • Transfer ID — the identifier assigned to the transfer.
  • Confirmation Number — the reference returned by the JD integration.
  • Status — the status after confirmation (typically Created, Pending, Processing, or Completed).
  • Fee and Total — the applied values.
Two actions are available:
  • View Transfer — opens the Transfer Detail page for this transfer.
  • New Transfer — restarts the wizard with a clean form.

​
Permissions

If your role does not allow creating transfers, the page shows a read-only state: a shield icon, the message You do not have permission to create transfers, and a Go Back link that returns to the Transfers list. Contact your administrator to request access.