Pular para o conteúdo principal
O TED IN permite que sua instituição receba transferências de qualquer banco brasileiro de forma automática. Nenhuma ação da sua equipe é necessária — o plugin cuida da detecção, validação e crédito. Quando um cliente em outro banco envia uma TED para a sua instituição, os fundos aparecem na conta do destinatário em minutos.

​
Como funciona

  1. Um cliente em outro banco inicia uma transferência TED endereçada a uma das contas da sua instituição
  2. A cada 30 segundos, o plugin consulta a rede JD SPB em busca de novas transferências recebidas
  3. A conta do destinatário é validada no seu CRM usando o número de documento presente na mensagem de transferência
  4. O valor é creditado automaticamente na conta do destinatário (menos a tarifa de recebimento, se configurada)
Diagrama de fluxo TED IN

​
Prazo de detecção e processamento

O que seu cliente experimenta após o banco de origem enviar a transferência:
TempoO que acontece
T+0sBanco de origem submete a transferência à rede BACEN
T+30sPlugin detecta a transferência; status muda para RECEIVED
T+32sConta do destinatário é localizada e confirmada; status muda para PROCESSING
T+35sValor é creditado na conta do destinatário; status muda para COMPLETED
T+36sNotificação via webhook é enviada ao seu sistema
SLA típico: Menos de 1 minuto a partir do momento em que o banco de origem envia a transferência.

​
Estados da transferência

EstadoO que significa para o destinatário
RECEIVEDTransferência detectada na rede; em processamento
PROCESSINGConta do destinatário confirmada; crédito sendo aplicado
COMPLETEDFundos chegaram na conta do destinatário
FAILEDDestinatário não pôde ser identificado; fundos devolvidos ao remetente

​
Tarifa de recebimento (cashin)

Sua organização pode cobrar uma tarifa opcional sobre transferências recebidas. Quando habilitada, a tarifa é deduzida do valor antes do crédito — o destinatário recebe o valor líquido. O valor e a configuração da tarifa são definidos por organização por meio do Fees Engine. Fórmula: valor creditado = valor da transferência − tarifa Exemplo: uma transferência de R1.000,00comtarifadeR 1.000,00 com tarifa de R 2,50 resulta em R$ 997,50 creditados na conta do destinatário. Isso é o oposto do TED OUT, onde a tarifa é adicionada ao valor e o remetente paga mais.

​
O que acontece quando o destinatário não é encontrado

Se o número de documento na transferência recebida não puder ser associado a uma conta no seu CRM, a transferência é automaticamente devolvida ao banco de origem. O cliente remetente recebe seu dinheiro de volta. Nenhuma intervenção manual é necessária e nenhum fundo permanece sem contabilização. O registro da transferência é marcado como FAILED com o motivo “Conta do destinatário não pôde ser identificada.”

​
Consultar transferências recebidas

Use o endpoint Listar Transferências para recuperar todas as transferências recebidas. Filtre por type=TED_IN para visualizar apenas as transferências recebidas. Endpoint: GET /v1/transfers Resposta (campos principais): 
{
  "data": [
    {
      "transferId": "019c96a0-ab20-7def-a1b2-1f2a3b4c5d6e",
      "type": "TED_IN",
      "status": "COMPLETED",
      "amount": 5000.00,
      "feeAmount": 0.00,
      "totalAmount": 5000.00,
      "recipientHolderName": "Empresa ABC Ltda",
      "createdAt": "2026-01-21T10:15:00-03:00"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "totalCount": 150,
    "hasNextPage": true
  }
}
Para opções completas de parâmetros de consulta, consulte a referência Listar Transferências.

​
Webhooks

Configure um webhook para receber notificações em tempo real quando transferências chegarem. O evento transfer.incoming.completed é disparado assim que uma transferência é creditada. Consulte Webhooks para detalhes de configuração e estrutura do payload.

​
Reconciliação

Para reconciliação contábil e financeira, cada registro de transferência inclui os seguintes campos:
CampoUso
controlNumberNúmero de controle do JD SPB — único por transferência, usado para reconciliação interbancária
transferIdIdentificador interno da Lerian
createdAtTimestamp de detecção da transferência
completedAtTimestamp de crédito dos fundos
O histórico de transferências é mantido por 5 anos, conforme exigido pelas regulamentações do BACEN.

​
Garantias de processamento

O plugin é projetado para que nenhuma transferência seja perdida e nenhuma seja creditada duas vezes:
  • Sem créditos duplicados — cada mensagem de transferência carrega um número de sequência único; o plugin rejeita qualquer tentativa de processar a mesma mensagem mais de uma vez
  • Retry automático em caso de falha — erros transitórios (como uma interrupção momentânea do serviço) são tentados novamente com backoff exponencial antes que qualquer estado de falha seja registrado
  • Dead-letter queue para problemas irresolvíveis — se uma transferência não puder ser processada após todas as tentativas, ela é movida para uma dead-letter queue para revisão manual, garantindo que nada seja descartado silenciosamente