> ## 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. # Enviar (TED OUT) > Envie TEDs para qualquer banco brasileiro com fluxo de duas etapas — preview de tarifa, liquidação no mesmo dia e conformidade com o BACEN. O TED OUT permite que seus clientes enviem dinheiro para qualquer conta em qualquer banco brasileiro. O fluxo em duas etapas — iniciar e confirmar — dá ao cliente a oportunidade de revisar a tarifa antes de a transferência ser efetivada. A liquidação ocorre no mesmo dia (D+0) para transferências confirmadas antes das 17:00, horário de Brasília. ## Como funciona para o seu cliente *** **Etapa 1 — Informar dados e revisar tarifa** O cliente fornece os dados bancários do destinatário e o valor. O sistema calcula a tarifa e retorna o custo total antes de qualquer débito. O cliente vê exatamente o que irá pagar. **Etapa 2 — Confirmar e enviar** Após a confirmação do cliente, os fundos (valor + tarifa) são debitados da conta e a transferência é submetida à rede BACEN. Um número de confirmação é emitido imediatamente. ## Pré-requisitos *** Antes de uma transferência ser iniciada: * O remetente deve ter uma conta cadastrada no CRM * O saldo do remetente deve cobrir o valor da transferência mais a tarifa aplicável * A transferência deve ser solicitada em dia útil entre 06:30 e 17:00 (horário de Brasília) ## Etapa 1: Iniciar a transferência *** O cliente submete os dados do destinatário e o valor. O sistema valida a solicitação, calcula a tarifa e cria uma intenção de transferência válida por 24 horas. Nenhum fundo é movimentado nesta etapa. Consulte a especificação completa da requisição na referência [Iniciar Transferência](/pt/reference/midaz/plugins/ted/initiate-transfer). **Endpoint:** POST /v1/transfers/initiate **Resposta (campos principais):** ```json theme={null} { "initiationId": "019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b", "feeAmount": 1.50, "totalAmount": 1001.50, "status": "PENDING_CONFIRMATION", "expiresAt": "2026-02-06T15:30:00-03:00" } ``` **Direção da tarifa (cash-out):** Para transferências de saída (TED OUT e P2P), a tarifa é adicionada ao valor da transferência: `totalAmount = amount + feeAmount`. A conta do remetente é debitada pelo total completo. Isso é o oposto do TED IN, onde a tarifa é deduzida do valor recebido. A intenção de transferência expira 24 horas após a iniciação. Se o cliente não confirmar dentro desse prazo, uma nova iniciação deverá ser criada. ## Etapa 2: Confirmar a transferência *** Após o cliente revisar a tarifa e confirmar, envie o `initiationId` para processar a transferência. Os fundos são provisionados e o pagamento é enviado à rede BACEN. A maioria das integrações processa a transferência apenas com `initiationId`. Tenants que assinam payloads TED OUT fora do plugin primeiro chamam `POST /v1/transfers/signing/prepare` e depois enviam `signingArtifactId`, `payloadHash` e `signature` junto com o mesmo `initiationId`. Consulte a especificação completa da requisição na referência [Processar Transferência](/pt/reference/midaz/plugins/ted/process-transfer). **Endpoint:** POST /v1/transfers/process **Resposta (campos principais):** ```json theme={null} { "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d", "confirmationNumber": "20260205001", "status": "PROCESSING", "feeAmount": 1.50, "totalAmount": 1001.50 } ``` ## Prazo de liquidação *** Os fundos são provisionados e a transferência é submetida à rede BACEN. A rede confirma o recebimento da mensagem de pagamento. Status: `PROCESSING`. O banco de destino confirma a liquidação. Status: `COMPLETED`. O número de confirmação é finalizado. Um evento de webhook `transfer.completed` é enviado para o seu sistema. **SLA:** Menos de 10 minutos em condições típicas. Liquidação no mesmo dia (D+0) para transferências confirmadas antes das 17:00, horário de Brasília. ## Horário de funcionamento *** O TED opera de segunda a sexta-feira, 06:30–17:00 (Brasília, UTC-3). Transferências solicitadas fora dessa janela são rejeitadas imediatamente — nenhum fundo é movimentado. A resposta de erro inclui o próximo horário disponível. ## Tratamento de erros *** Quando algo dá errado, o dinheiro do seu cliente está sempre contabilizado: A transferência é recusada pela instituição receptora. Os fundos provisionados são liberados imediatamente e o valor total (incluindo a tarifa) é devolvido ao saldo do remetente. Status: `REJECTED`. Um webhook `transfer.rejected` é enviado. O plugin realiza tentativas automáticas (até três tentativas por padrão). Se o resultado ainda for desconhecido após as tentativas — um 5xx ou timeout do JD SPB — a transferência **não** é revertida automaticamente: o hold é preservado e a transferência é encaminhada ao worker de reconciliação, que a resolve contra o ledger. Se a reconciliação se esgotar, a transferência é sinalizada para revisão manual do operador (`MANUAL_REVIEW`). Os fundos nunca são perdidos, mas a resolução pode não ser imediata. (Uma rejeição 4xx clara é diferente — ela reverte o hold imediatamente; veja o caso "rejeitada pelo banco de destino" acima.) Se o banco de destino devolver os fundos após a liquidação inicial (por exemplo, encerramento de conta ou bloqueio regulatório), o valor é revertido no seu ledger como uma transação separada. Isso é tratado fora do ciclo de vida da transferência — o registro original permanece `COMPLETED` e um novo registro de estorno é criado. Os endpoints de transferência suportam idempotência por meio do header de requisição `X-Idempotency`. Use esse header ao tentar novamente uma requisição para evitar submissões duplicadas. Consulte [Retries e idempotência](/pt/reference/retries-idempotency) para mais detalhes. Para uma lista completa de códigos de erro, consulte a [referência de erros do TED](/pt/reference/midaz/plugins/ted/ted-error-list). ## Consultar status da transferência *** Acompanhe o progresso de uma transferência a qualquer momento. **Endpoint:** [GET /v1/transfers/{transferId}](/pt/reference/midaz/plugins/ted/retrieve-transfer) **Resposta (campos principais):** ```json theme={null} { "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d", "confirmationNumber": "20260205001", "senderAccountId": "019c96a0-a910-7abc-d1e2-8c9d0e1f2a3b", "recipientAccountId": null, "type": "TED_OUT", "status": "COMPLETED", "amount": 1000.00, "feeAmount": 1.50, "totalAmount": 1001.50, "createdAt": "2026-02-05T15:30:00-03:00", "completedAt": "2026-02-05T15:35:12-03:00" } ``` ## Cancelar uma transferência *** Uma transferência pode ser cancelada enquanto estiver no status `CREATED` ou `PENDING` — antes de ser submetida à rede. **Endpoint:** [POST /v1/transfers/{transferId}/cancel](/pt/reference/midaz/plugins/ted/cancel-transfer) Transferências nos estados `PROCESSING` ou posteriores não podem ser canceladas. Uma vez submetida à rede BACEN, a transferência deve ser concluída ou falhar antes que qualquer reversão seja possível. ## Códigos ISPB comuns *** *Última verificação: 2026-02-06. Os valores estão sujeitos a alterações.* | Banco | ISPB | | --------------- | -------- | | Banco do Brasil | 00000000 | | Bradesco | 60746948 | | Itaú | 60701190 | | Santander | 90400888 | | Caixa Econômica | 00360305 | | Nubank | 18236120 | | Inter | 00416968 | Para uma lista completa, consulte o [diretório ISPB](https://www.bcb.gov.br/pom/spb/estatistica/port/AODO.asp) no site do Banco Central.