perguntas frequentes sobre a API IBAN-Test

A API IBAN-Test destina-se a programadores, lojas online, produtos SaaS e sistemas internos que precisam de validar automaticamente IBAN, BIC ou contas bancárias.

Estas perguntas frequentes explicam os tokens Bearer, os pedidos API, as respostas JSON, os limites de utilização e as integrações mais comuns. A referência técnica completa com endpoints e parâmetros está disponível na documentação API.

Como utilizar a API IBAN-Test?

Como é feito um pedido API?

Como é feito um pedido API?

Utilize o seu token API como token Bearer no cabeçalho HTTP.

Authorization: Bearer YOUR_API_TOKEN

URL de base:

https://www.iban-test.eu/api

Validar um IBAN:

GET /v2/iban/validate/{iban}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate/DE89%203704%200044%200532%200130%2000"

Validar um BIC:

GET /v2/bic/validate/{bic}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Validar uma conta bancária:

GET /v2/bank-account/validate?bankcode=37040044&accountnumber=532013000

Gerar um IBAN:

GET /v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000

A referência técnica completa, com parâmetros, campos de resposta e funções de teste, está disponível na documentação API.

Voltar ao topo

Qual é o formato de resposta da API?

O que devolve a API?

O que devolve a API?

Todos os endpoints da API devolvem JSON. O resultado inclui error, code, message e os detalhes específicos do endpoint.

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

Consoante o endpoint e o país, os detalhes podem incluir informações bancárias, dados BIC, resultados de validação da conta ou o IBAN gerado.

Consulte os códigos de estado, os parâmetros e os esquemas de resposta atuais na documentação API.

Débitos diretos SEPA: Core e B2B

A validação do IBAN também devolve a participação do banco nos sistemas de débito direto SEPA, verificada nos registos de participantes do EPC.

  • details.sepa.sddCore – Débito direto SEPA Core
  • details.sepa.sddB2b – Débito direto SEPA B2B

Os dois sistemas são verificados de forma independente. confirmed indica uma correspondência inequívoca e atual no registo. unknown indica que não foi possível confirmar a participação; não significa que o banco não suporte o sistema.

A verificação diz respeito à participação do banco. Não confirma a existência da conta, a sua elegibilidade para débitos, um mandato ou o sucesso de uma cobrança.

Campos SEPA e exemplos de resposta

Voltar ao topo

Porque está o meu acesso à API bloqueado?

Porque está o meu acesso à API bloqueado ou desativado?

Porque está o meu acesso à API bloqueado ou desativado?

Isto pode acontecer quando atinge o limite de utilização disponível, quando o token API é inválido ou quando é detetada uma utilização suspeita ou abusiva.

Se apenas esgotou o limite, pode aguardar a próxima reposição ou escolher um plano com um volume de pedidos superior.

Se o acesso parecer bloqueado por outro motivo, contacte o apoio através do formulário de contacto.

Voltar ao topo

Posso integrar o IBAN-Test em formulários ou lojas online?

Sim.

Sim. A API IBAN-Test foi concebida para validação automática em formulários, lojas online, produtos SaaS, mandatos SEPA e processos internos.

Entre os casos mais comuns estão a verificação dos dados bancários no checkout, no registo, antes de um débito direto ou da importação de grandes conjuntos de dados de pagamento.

Desta forma, deteta erros de escrita e dados bancários inválidos mais cedo, em vez de só os descobrir após pagamentos falhados ou débitos diretos devolvidos.

Voltar ao topo