Comprueba el formato del país, la longitud y los dígitos de control antes de guardar los datos de pago del cliente.
API de validación de IBAN SEPA
Valida IBAN y comprueba la participación del banco en SEPA
Comprueba un IBAN y la participación del banco en transferencias SEPA, transferencias inmediatas y adeudos directos Core y B2B. Obtén un resultado independiente para cada esquema en una respuesta JSON, a partir de datos bancarios y registros de participantes del EPC.
Empieza con 10 consultas API gratuitas cada 24 horas.
¿El IBAN es válido y el banco admite tu esquema SEPA?
Son comprobaciones independientes. Un IBAN puede superar las validaciones de formato y dígitos de control sin que se haya confirmado la participación del banco en un esquema de pago concreto. Comprueba ambos aspectos al recoger datos de pago o preparar una remesa.
Utiliza los directorios bancarios disponibles para identificar el banco y su BIC. La comprobación mediante directorios está disponible para 40 países.
Consulta el resultado individual para tu transferencia, transferencia inmediata o adeudo directo.
Cuatro esquemas SEPA, cuatro resultados independientes
Transferencia SEPA
details.sepa.sct
Indica la participación del banco en el esquema de transferencias SEPA ordinarias.
Transferencia SEPA inmediata
details.sepa.sctInst
Indica la participación en el esquema de transferencias inmediatas. No comprueba la accesibilidad en tiempo real a través de RT1/TIPS ni garantiza una ejecución inmediata.
Adeudo directo Core
details.sepa.sddCore
Indica la participación en el esquema de adeudos directos SEPA Core.
Adeudo directo B2B
details.sepa.sddB2b
Indica la participación en el esquema entre empresas B2B. No deduzcas este resultado a partir del resultado de Core.
Los datos proceden de los registros independientes de cada esquema del European Payments Council. Para confirmar la participación se requiere una identificación inequívoca del banco y una coincidencia con un participante vigente en datos de registro actualizados.
Solicitud a la API SEPA y respuesta JSON
Utiliza el endpoint de validación de IBAN con tu clave API. Los resultados SEPA se incluyen cuando se devuelven datos bancarios; no hace falta una solicitud adicional para comprobar los esquemas.
curl --get "https://www.iban-test.eu/api/v2/iban/validate" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--data-urlencode "iban=DE89370400440532013000"
Extracto de respuesta de ejemplo que muestra solo los campos SEPA. Los resultados reales dependen del IBAN y de los datos de registro disponibles.
{
"details": {
"sepa": {
"sct": {
"status": "confirmed",
"reason": "matched"
},
"sctInst": {
"status": "confirmed",
"reason": "matched"
},
"sddCore": {
"status": "confirmed",
"reason": "matched"
},
"sddB2b": {
"status": "confirmed",
"reason": "matched"
}
}
}
}
Consulta la referencia completa de campos SEPA y motivos del resultado.
Cómo tratar los resultados confirmados y desconocidos
Gestiona primero los IBAN no válidos. La participación en SEPA es información adicional y no modifica el resultado de la validación del IBAN.
confirmed con el motivo matched confirma la participación del banco en ese esquema. Cada esquema debe evaluarse por separado.
unknown significa que no se pudo confirmar la participación. Revisa el motivo y utiliza una revisión o un procedimiento alternativo en lugar de marcar automáticamente al banco como no compatible.
Por ejemplo, missing_bic indica que el BIC del banco no estaba disponible; no_match, que no se encontró un participante coincidente; y stale_data, que los datos del registro están desactualizados.
Esta API valida IBAN y comprueba la participación bancaria. No inicia pagos, no verifica la titularidad o existencia de cuentas, no confirma mandatos de adeudo directo ni garantiza la liquidación. Tu proveedor de pagos debe gestionar la elegibilidad de la cuenta y el enrutamiento de pagos en tiempo real.
Integra comprobaciones SEPA en tu proceso de pago
Utiliza estos resultados al dar de alta clientes, configurar adeudos directos y preparar pagos. Empieza con una clave API gratuita, examina una respuesta y procesa el esquema necesario en tu aplicación.
Para validar el formato, los dígitos de control y los datos de directorios bancarios, consulta la API de validación de IBAN.
