> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiating a Transfer

> Create a new TED Out through the Bank Transfer initiate wizard.

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**.

<Note>
  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.
</Note>

## Accessing the wizard

***

<Steps>
  <Step title="Open the Transfers page">
    From the Midaz Module sidebar, expand **Bank Transfer** and click **Transfers**.
  </Step>

  <Step title="Start a new transfer">
    Click the **New Transfer** button at the top right of the page.
  </Step>
</Steps>

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.

<Warning>
  The banner does not block submission in the Console. A TED transfer submitted outside the operating window is **queued and processed on the next business day** — it is not rejected. By default the window is Monday through Friday, 06:30–17:00 (`America/Sao_Paulo`, UTC−3).
</Warning>

<Card title="Configuring Operating Hours" icon="clock" horizontal href="/en/rails/ted/console/bt-configuring-operating-hours">
  Adjust the operating window in Settings.
</Card>

## 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.

<Note>
  **ISPB Code** and **Branch** apply to TED transfers (TED Out and TED In). Since this wizard creates a TED Out, both are required here.
</Note>

### 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.

<Note>
  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.
</Note>

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](/en/rails/ted/console/bt-checking-transfer-details) for this transfer.
* **New Transfer** — restarts the wizard with a clean form.