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

# O que é o Bank Transfer?

> Mova dinheiro entre bancos brasileiros no mesmo dia útil com o plugin Bank Transfer da Lerian: transferências de saída, de entrada e P2P, com conformidade BACEN embutida.

O TED (Transferência Eletrônica Disponível) é o sistema de transferências interbancárias do Brasil. O dinheiro se move entre dois bancos quaisquer no mesmo dia útil.

A Lerian chega ao TED por três caminhos. O **Lerian SPB** é a mensageria própria da Lerian com o Sistema de Pagamentos Brasileiro. É uma conexão direta, sem parceiro de conectividade no caminho, e carrega outros fluxos de mensagens do SPB além do TED. O [TED Lerian](https://docs.lerian.studio/pt/interfaces/ted-lerian/what-is-ted-lerian.md) conecta o Midaz ao Lerian SPB: ele envia, recebe, devolve e concilia TEDs, com o dinheiro registrado no Midaz. O **plugin Bank Transfer** conecta a sua instituição pelo parceiro de conectividade JD. Ele dá à sua instituição transferências de saída e de entrada, P2P interno e tratamento de tarifas.

> [!TIP]
>
> **Referência regulatória**
>
> Esta página dá uma visão geral prática de como o TED funciona. Para detalhes técnicos, legais e regulatórios completos, consulte a [documentação oficial](https://www.bcb.gov.br/estabilidadefinanceira/spb) publicada pelo Banco Central do Brasil (BACEN).

## O que você pode construir

***

* **Pagamento de folha**: envie salários ou pagamentos a prestadores diretamente para as contas dos funcionários em qualquer banco brasileiro
* **Pagamentos a fornecedores**: pague faturas e liquide obrigações B2B sem acesso manual ao portal do banco
* **Saques de clientes**: deixe os clientes moverem fundos da sua plataforma para as contas bancárias externas deles sob demanda
* **Movimentação interna de fundos**: mova dinheiro entre contas da sua própria instituição, sem roteamento externo (P2P)

## Tipos de transferência

***

| Tipo | O que significa para o seu negócio |
| - | - |
| **TED OUT** | O seu cliente envia dinheiro para uma conta em outro banco |
| **TED IN** | A sua instituição recebe dinheiro de outro banco automaticamente |
| **P2P** | O dinheiro se move no mesmo dia entre duas contas dentro da sua instituição, sem roteamento externo |
| **TED entre cores** | O seu cliente envia dinheiro para uma conta que o outro core da sua instituição detém, pelo JD Courier. Veja [Transferências entre cores](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-cross-core.md) |

## Como funciona

***

1. **Iniciar**: você informa os dados bancários do destinatário e o valor. O plugin mostra a tarifa antes
2. **Confirmar**: você autoriza a transferência, e o plugin reserva os fundos no Midaz
3. **Enviar**: o plugin assina o pagamento e o despacha pela rede STR do BACEN até o banco de destino
4. **Liquidar**: o banco do destinatário credita os fundos, e você recebe o número de controle do JD SPB como confirmação

## Horário de funcionamento e limites

***

O que os seus clientes podem esperar:

| Regra | Detalhes |
| - | - |
| Janela de funcionamento | De segunda a sexta, 06:30–17:00, horário de Brasília (padrão, configurável) |
| SLA de liquidação | No mesmo dia (D+0) para transferências confirmadas dentro da janela |
| Fins de semana / feriados | O TED fica indisponível; agende transferências para o próximo dia útil |

> [!NOTE]
>
> Fora da janela de funcionamento, o plugin rejeita a transferência e não move fundos. O erro indica o próximo horário disponível.

## O que o plugin resolve para você

***

O seu time não precisa construir nem manter:

* **Cálculo de tarifas**: o plugin calcula as tarifas pelo Fees Engine na iniciação, antes de você confirmar
* **Idempotência**: uma nova tentativa da requisição leva uma chave de idempotência, então retorna o resultado original e nunca cria uma segunda transferência
* **Conformidade com o BACEN**: o plugin aplica a janela de funcionamento e registra uma trilha de auditoria completa
* **Calendário de feriados**: validação de dia útil do BACEN, apoiada na tabela `bacen_holidays` (com carga para 2026–2099)
* **Notificações por webhook**: os webhooks avisam o seu sistema quando uma transferência é concluída, chega ou falha
* **Conciliação**: cada transferência registra os timestamps e o histórico de status para auditoria
* **Devoluções automáticas**: uma transferência recebida que o plugin não consegue creditar pode voltar ao banco de origem. Quando o plugin não encontra a conta do destinatário, a transferência só é devolvida se a sua configuração autorizar devoluções automáticas. Caso contrário, o plugin retém a devolução para revisão de um operador. Isso é diferente de um chargeback, que estorna um crédito já concluído
* **Devoluções a pedido**: você pode devolver um TED concluído recebido como STR0008R2 ao banco de origem, ou estornar um P2P concluído, pela API

> [!TIP]
>
> Para configurar a precificação de tarifas de transferências TED na sua organização, veja [Fees Engine](https://docs.lerian.studio/pt/products/midaz/fees/fees-engine-overview.md).

> [!TIP]
>
> [Explore a API de TED](https://docs.lerian.studio/pt/reference/interfaces/ted-jd/initiate-transfer.md). Navegue pelos endpoints para iniciar e gerenciar transferências.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.