Verifique o formato nacional, o comprimento e os dígitos de controlo antes de guardar os dados de pagamento do cliente.
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.
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.
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.
Consulte o resultado individual para a sua transferência, transferência imediata ou débito direto.
Quatro esquemas SEPA, quatro resultados independentes
Transferência SEPA
details.sepa.sct
Indica a participação do banco no esquema de transferências SEPA normais.
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.
Débito direto Core
details.sepa.sddCore
Indica a participação no esquema de débitos diretos SEPA Core.
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
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.
confirmed com o motivo matched confirma a participação do banco nesse esquema. Cada esquema deve ser avaliado separadamente.
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.
Para verificações gerais de formato, dígitos de controlo e diretórios bancários, consulte a API de validação de IBAN.