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.
The wizard does not ask for a transfer type. The plugin creates a P2P when ISPB Code is your institution’s ISPB, and a TED Out for any other ISPB. Inbound TED (TED In) arrives from JD, so it has no manual creation step.

​
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 when the plugin accepts the transfer for processing.

​
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. A TED Operating Window Closed banner appears when the stored window closes every day, and a TED Operating Window Misconfigured banner when the plugin does not accept the stored window.
Do not submit a TED Out outside the operating window or on a BACEN holiday. The Console does not block the button, but the plugin 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). P2P transfers ignore the window.

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 200 bytes. An accented character counts as two.
  • 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, Savings, Payment, or Salary.
  • ISPB Code (required): the beneficiary bank’s 8-digit ISPB.
  • Branch: the beneficiary bank’s branch code, 1 to 4 digits. The plugin accepts a TED without a branch.

​
Transfer Details

  • Amount (required): the transfer amount, from 0.01 to 999,999.99, with at most two decimals.
  • Currency (required): fixed to BRL.
  • Purpose (SPB finality code) (required): the SPB finality code, 1 to 4 digits. 10 is a credit to account.
  • Description (optional): a free-text description up to 140 bytes. An accented character counts as two.
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:
  • 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 when the plugin accepts the transfer. Otherwise it shows one of these:
  • We could not confirm the outcome with the bank.: the funds stay on hold and the transfer waits in the reconciliation queue. Do not send the transfer again.
  • Confirmation window expired or Signing data no longer matches: nothing was sent. Click Start over.
  • Transfer already submitted: click View transfers to find it.

​
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: opens the wizard again.