> ## 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 TED Out in Lerian Console with the two-step initiate-and-confirm wizard — collect details, preview fees, and execute the outbound TED transfer.

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

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

## Accessing the wizard

***

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

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

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.

<Warning>
  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).
</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. 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.

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

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

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

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