API de Verificación Telefónica en España (ES)
Valide la titularidad de números de teléfono en España contra datos de operadores de red móvil en tiempo real, facturando solo resultados concluyentes. Endpoint, parámetros, esquema de respuesta, precios e integración.

Incorporar usuarios en España implica confirmar su identidad. Esto verifica los datos de entrada con los registros de facturación de telecomunicaciones y los datos telefónicos. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o pertenezcan a la persona que tiene delante. La Verificación Telefónica en España cierra esa brecha al cotejar los datos con la información del operador de red móvil. Esta guía explica qué hace la verificación, los detalles técnicos exactos y cómo integrarla en minutos.
Puntos clave:
- Qué verifica — La Verificación Telefónica en España valida la titularidad del número de teléfono contra los datos del operador de red móvil.
- Qué obtiene — un
match_typenormalizado más resultados a nivel de campo que puede dirigir directamente a la lógica de aprobación / revisión / rechazo. - Por qué es importante — Confirmar que un número de teléfono pertenece a la persona declarada bloquea el secuestro de cuentas y el fraude basado en SIM antes de que comience.
- Cómo usarlo — una solicitud
POSTal endpoint de validación de base de datos de Didit, o un módulo de flujo de trabajo sin código. 0,24 $ por consulta concluyente, resultados en segundos.
Qué valida la Verificación Telefónica en España
Verifica los datos de entrada con los registros de facturación de telecomunicaciones y los datos telefónicos. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados contra la información del operador de red móvil y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tenga que analizar usted mismo.
Una respuesta concluyente devuelve los source_data coincidentes y un bloque de validation por campo, para que su motor de riesgo obtenga un veredicto claro y legible por máquina.
Por qué es importante
Confirmar que un número de teléfono pertenece a la persona declarada bloquea el secuestro de cuentas y el fraude basado en SIM antes de que comience.
Para empresas reguladas en España — fintechs, plataformas de criptomonedas, prestamistas, marketplaces y operadores de juegos — la verificación contra una fuente autorizada produce un registro defendible y auditable de que la identidad fue confirmada en la fuente, no solo capturada de un formulario o una foto.
Detalles técnicos
Didit expone este servicio a través del endpoint unificado de validación de base de datos. Es una única solicitud POST — no se requiere SDK.
Endpoint
POST /v3/database-validation/
Parámetros de solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
issuing_state | string | Sí | Código de país ISO 3166-1 alfa-3. Use ESP. |
services | string | Sí | Identificador de servicio. Use esp_phone. |
first_name | string | Sí | Nombre. |
last_name | string | Sí | Apellido. |
address | string | Sí | Dirección. |
landline | string | No | Teléfono fijo (verificación cruzada opcional). |
phone | string | No | Teléfono (verificación cruzada opcional). |
Ejemplo de solicitud
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ESP" \
-F "services=esp_phone" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "address=123 Sample Street, Sample City, 10001"
Ejemplo de respuesta (coincidencia concluyente)
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "ESP",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "esp_phone",
"service_name": "Spain Phone",
"source_data": {
"address": "123 Sample Street",
"first_name": "John",
"last_name": "Doe"
},
"validation": {
"address": "full_match",
"full_name": "full_match"
}
}
]
}
Rendimiento y facturación
- Latencia: típicamente un par de segundos.
- Costo: 0,24 $ por consulta concluyente. Se le factura solo por resultados concluyentes — no hay cargo por tiempo de inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
- Fiabilidad: funciona en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99,9%.
Casos de uso
- Fintech y neobancos — confirme un titular de cuenta real y verificable antes de abrir una billetera o conceder crédito en España.
- Cripto y Web3 — cumpla con los requisitos de incorporación de VASP con pruebas de identidad de fuente autorizada.
- Préstamos — reduzca el fraude de identidad sintética y de primera parte con datos verificados por la fuente.
- Marketplaces y plataformas de servicios — verifique a los usuarios contra datos autorizados, no solo un formulario autodeclarado.
- iGaming — satisfaga los controles de identidad y elegibilidad para jugadores españoles con un rastro auditable.
Cómo integrar con Didit
Puede ejecutar la Verificación Telefónica en España de dos maneras:
- Flujo de trabajo sin código. En la Consola de Negocios de Didit, abra el Constructor de Flujos de Trabajo, agregue el módulo Validación de Base de Datos, seleccione España → Verificación Telefónica en España y actívelo. Los usuarios coincidentes se enrutan automáticamente — no se requiere ingeniería.
- API directa. Llame al endpoint
/v3/database-validation/mostrado arriba conservices=esp_phone. Leamatch_typey el bloque devalidationpor campo para impulsar su lógica de aprobación / revisión / rechazo.
Cada cuenta de Didit incluye 500 verificaciones gratuitas al mes, para que pueda probar el flujo completo de principio a fin antes de pagar por una sola consulta.
Preguntas frecuentes
¿Qué confirma la verificación telefónica en España?
Valida los datos enviados contra la información del operador de red móvil y devuelve un resultado de coincidencia normalizado, para que sepa si la titularidad del número de teléfono existe en la fuente autorizada y qué campos coincidieron.
¿Qué sucede si la fuente no está disponible temporalmente?
No se le cobra. La facturación solo se aplica a resultados concluyentes — el tiempo de inactividad de la fuente, los campos faltantes y los rechazos previos a la fuente son gratuitos.
¿Qué tan rápida es la verificación?
La validación de la base de datos generalmente se completa en un par de segundos, por lo que encaja en un flujo de incorporación en tiempo real.
¿Necesito un SDK?
No. La verificación es una única solicitud HTTPS POST a un solo endpoint. También puede integrarla en un flujo de trabajo sin código en la Consola de Negocios.
¿Listo para empezar?
Valide la titularidad de su primer número de teléfono en España hoy mismo.
- Lea la referencia de la API: Verificación Telefónica en España
- Vea todas las validaciones de base de datos: Precios y cobertura de validación de base de datos
- Empiece a construir: Cree una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.