Tabela de erros ao realizar uma TED

Abaixo os erros que podem ocorrer ao realizar chamada nas APIs de TED

Código do erro	Mensagem de erro apresentada
688	Número da conta inválido: possui mais de 13 caracteres (incluindo o dígito).
688	Nome inválido: possui caracteres especiais não permitidos.
688	Código ISPB Inválido
688	Número do Banco Inválido
688	Banco Não Encontrado
688	Dígito da conta inválido
999	Ocorreu um Erro No Processo
999	Transação Já Efetuada nos últimos 60 segundos

Após sucesso nas solicitações de Transferências na API de TED, podem ocorrer rejeições, e com isso, é enviado via webhook. Abaixo os erros retornados nos webhooks

Código do erro	Mensagem de erro apresentada
SPB1	Conta Destinatária do Crédito Encerrada.
SPB2	Agência ou Conta Destinatária do Crédito Inválida.
SPB3	Ausência ou Divergência na Indicação do CPF ou CNPJ
SPB4	Mensagem Inválida para o Tipo de Transação ou Finalidade
SPB5	Divergência na Titularidade
SPB6	Transferência Insuficiente para Finalidade Indicada
SPB7	Diferença a Maior
SPB13	Código Identificador de Transferência Inválido
SPB17	Número de contrato inválido
SPB18	Valor em duplicidade
SPB19	Devolução por Fraude
SPB22	Devolução de Ordem Bancária pelo Agente Financeiro
SPB26	Devolução de pagamento de tributos por solicitação da IF
SPB27	Devolução de Recolhimento a Maior autorizada pela RFB
SPB31	CPF ou CNPJ inapto junto à Receita Federal do Brasil
SPB61	Transferência supera limite para o tipo de conta destino
SPB70	Por solicitação de cliente da Instituição Participante Recebedora
SPB72	Não conformidade no pagamento
SPB84	RETURN-BANKTRANSF
STR5	Rejeitado sem Saldo
STR14	Cancelado

Abaixo exemplo do JSON enviado no webhook

"{
        ""ProtocoloId"": 123456789,
        ""NsuExterno"":  123456,
        ""DadosTransacao"": {
                ""Cpfcnpj"": ""00000000000"",
                ""NomeCompleto"": ""AAAAAAA"",
                ""Agencia"": 1234,
                ""DataOperacao"": ""2026-01-01T00:00:00.000"",
                ""Conta"": ""00000"",
                ""DataDevolucao"": ""2026-01-01T23:59:59.999"",
                ""DigitoVerificador"": ""0"",
                ""Valor"": 100.00
        },
        ""TerminalExterno"": ""aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"",
        ""StatusCompensacao"": {
                ""Status"": ""ERRO"",
                ""MensagemErro"": ""Mensagem"",
                ""CodErro"": ""000""
        },
        ""TipoTransacao"": ""TRANSFERENCIA""
}"

📘
Novos códigos podem ocorrer dinamicamente para os erros do tipo SPB, uma vez que o motivo dos retornos podem vir de fontes externas, como rejeites da instituição recebedora.