Pular para o conteúdo principal
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. Endpoint: POST /v1/transfers/initiate Resposta (campos principais): 
{
  "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. Consulte a especificação completa da requisição na referência Processar Transferência. Endpoint: POST /v1/transfers/process Resposta (campos principais): 
{
  "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
  "confirmationNumber": "20260205001",
  "status": "PROCESSING",
  "feeAmount": 1.50,
  "totalAmount": 1001.50
}

​
Prazo de liquidação

1

Confirmada (T+0s)

Os fundos são provisionados e a transferência é submetida à rede BACEN.
2

Reconhecida (T+2s)

A rede confirma o recebimento da mensagem de pagamento. Status: PROCESSING.
3

Liquidada (T+90s típico)

O banco de destino confirma a liquidação. Status: COMPLETED. O número de confirmação é finalizado.
4

Cliente notificado (T+95s)

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.failed é enviado.
O plugin realiza tentativas automáticas de até cinco vezes. Se a transferência não puder ser confirmada após as tentativas, um reembolso de segurança é emitido e o saldo do remetente é restaurado. Nenhuma ação manual é necessária.
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 para mais detalhes.
Para uma lista completa de códigos de erro, consulte a referência de erros do TED.

​
Consultar status da transferência

Acompanhe o progresso de uma transferência a qualquer momento. Endpoint: GET /v1/transfers/ Resposta (campos principais): 
{
  "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
  "confirmationNumber": "20260205001",
  "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//cancel
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.
BancoISPB
Banco do Brasil00000000
Bradesco60746948
Itaú60701190
Santander90400888
Caixa Econômica00360305
Nubank18236120
Inter00416968
Para uma lista completa, consulte o diretório ISPB no site do Banco Central.