API de validação de IBAN SEPA

Valide IBAN e verifique a participação do banco na SEPA

Verifique um IBAN e a participação do banco em transferências SEPA, transferências imediatas e débitos diretos Core e B2B. Obtenha um resultado independente para cada esquema numa resposta JSON, com base em dados bancários e registos de participantes do EPC.

Obter uma chave API gratuita Ver o pedido e a resposta

Comece com 10 pedidos API gratuitos a cada 24 horas.

O IBAN é válido e o banco suporta o seu esquema SEPA?

São verificações distintas. Um IBAN pode passar nas verificações de formato e dígitos de controlo sem que a participação do banco num determinado esquema de pagamento esteja confirmada. Verifique ambos os aspetos ao recolher dados de pagamento ou preparar um lote de pagamentos.

Validar o IBAN

Verifique o formato nacional, o comprimento e os dígitos de controlo antes de guardar os dados de pagamento do cliente.

Identificar o banco

Utilize os diretórios bancários disponíveis para identificar o banco e o BIC. A verificação através de diretórios está disponível para 40 países.

Verificar o esquema necessário

Consulte o resultado individual para a sua transferência, transferência imediata ou débito direto.

Quatro esquemas SEPA, quatro resultados independentes

SCT

Transferência SEPA

details.sepa.sct

Indica a participação do banco no esquema de transferências SEPA normais.

SCT Inst

Transferência SEPA imediata

details.sepa.sctInst

Indica a participação no esquema de transferências imediatas. Não é uma verificação de acessibilidade em tempo real através de RT1/TIPS nem uma garantia de execução imediata.

SDD Core

Débito direto Core

details.sepa.sddCore

Indica a participação no esquema de débitos diretos SEPA Core.

SDD B2B

Débito direto B2B

details.sepa.sddB2b

Indica a participação no esquema entre empresas B2B. Não deduza este resultado a partir do resultado Core.

Os dados provêm dos registos separados de cada esquema do European Payments Council. Um resultado confirmado exige uma identificação inequívoca do banco e uma correspondência com um participante atualmente aderente em dados de registo atualizados.

Pedido à API SEPA e resposta JSON

Utilize o endpoint de validação de IBAN com a sua chave API. Os resultados SEPA são incluídos quando são devolvidos dados bancários; não é necessário um pedido adicional para verificar os esquemas.

curl --get "https://www.iban-test.eu/api/v2/iban/validate" \
  --header "Authorization: Bearer YOUR_API_TOKEN" \
  --data-urlencode "iban=DE89370400440532013000"

Excerto de uma resposta de exemplo que apresenta apenas os campos SEPA. Os resultados reais dependem do IBAN e dos dados de registo disponíveis.

{
  "details": {
    "sepa": {
      "sct": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sctInst": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sddCore": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sddB2b": {
        "status": "confirmed",
        "reason": "matched"
      }
    }
  }
}

Consulte a referência completa dos campos SEPA e dos motivos do resultado.

Trate corretamente os resultados confirmados e desconhecidos

1. Verificar o resultado da validação

Trate primeiro os IBAN inválidos. A participação na SEPA é informação adicional e não altera o resultado da validação do IBAN.

2. Consultar o estado do seu esquema

confirmed com o motivo matched confirma a participação do banco nesse esquema. Cada esquema deve ser avaliado separadamente.

3. Distinguir desconhecido de não suportado

unknown significa que não foi possível confirmar a participação. Verifique o motivo e utilize uma revisão ou um procedimento alternativo, em vez de classificar automaticamente o banco como não compatível.

Por exemplo, missing_bic significa que o BIC do banco não estava disponível; no_match, que não foi encontrado um participante correspondente; e stale_data, que os dados do registo estão desatualizados.

Esta API valida IBAN e verifica a participação bancária. Não inicia pagamentos, não verifica a titularidade ou existência de contas, não confirma mandatos de débito direto nem garante a liquidação. A elegibilidade da conta e o encaminhamento dos pagamentos em tempo real devem ser tratados pelo seu prestador de serviços de pagamento.

Integre verificações SEPA no seu processo de pagamento

Utilize estes resultados na adesão de clientes, na configuração de débitos diretos e na preparação de pagamentos. Comece com uma chave API gratuita, examine uma resposta e trate o esquema necessário na sua aplicação.

Começar com uma chave API gratuita Ver a documentação API

Para verificações gerais de formato, dígitos de controlo e diretórios bancários, consulte a API de validação de IBAN.

Validação de dados bancários

Verificação em diretórios bancários de 40 países

O IBAN-Test vai além dos dígitos de controlo. Para estes países, verifica o identificador do banco nos diretórios disponíveis e apresenta dados como a instituição, a localidade e o BIC, quando existem. Saiba como funciona a validação de IBAN.

ALAlbânia ADAndorra ATÁustria BEBélgica BGBulgária HRCroácia CYChipre CZTchéquia DKDinamarca EEEstônia FIFinlândia FRFrança DEAlemanha GIGibraltar GRGrécia HUHungria ISIslândia IEIrlanda ITItália LVLetônia LILiechtenstein LTLituânia LULuxemburgo MTMalta MDMoldávia MEMontenegro NLPaíses Baixos MKMacedônia do Norte NONoruega PLPolônia PTPortugal RORomênia SMSan Marino RSSérvia SKEslováquia SIEslovênia ESEspanha SESuécia CHSuíça VACidade do Vaticano

Verificação do formato IBAN

Verificação de 115 formatos IBAN

Verifique a estrutura, o comprimento e os dígitos de controlo de um IBAN para detetar erros de escrita ou algarismos trocados antes de um pagamento falhar. Nos países indicados acima, é também possível confirmar os dados em diretórios bancários.

Servidor MCP para agentes de IA – Ligue clientes de IA às ferramentas de validação de IBAN – https://www.iban-test.eu/mcp – Documentação API