perguntas frequentes sobre a API IBAN-Test

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.

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.

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.

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.