Saltar al contenido principal
POST
Permite identificar personas (nombres, fecha de nacimiento, direcciones, teléfonos, correos electrónicos, números de identificación nacional) y calcular una puntuación de coincidencia de nombre a partir de un correo electrónico o un número de teléfono, o ambos, mediante una red global de información de riesgo. Se cobra por solicitud. Didit ofrece este servicio a través de POST /v3/database-validation/ para que puedas contrastar los datos enviados con la red de identidad conectada y recibir resultados de coincidencia normalizados. Se trata de una red de enriquecimiento de terceros, no de un registro gubernamental oficial: no presentes sus resultados como una verificación basada en fuentes primarias.

Cobertura

  • Cobertura: 50+ mercados
  • País: Global
  • ID del servicio: glb_identity_enrichment
  • Dominio de datos: Identidad
  • Categoría: IdentityEnrichment

Datos de entrada

  • Datos de entrada obligatorios: —
  • Datos de entrada opcionales: email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Consentimiento: Obligatorio
  • Disponibilidad en flujos: Solo API independiente
  • Cobertura: 50+ mercados
  • Precio: $0.20 por consulta exitosa
Este servicio no se ofrece como paso de Validación de base de datos dentro de un flujo. Eso limita dónde se ejecuta la comprobación, no lo que puedes enviarle: invócalo mediante la API independiente, donde proporcionas los datos de entrada directamente.

Parámetros del cuerpo

string
predeterminado:"GLB"
requerido
Código de país ISO 3166-1 alfa-3 de este servicio de base de datos.Ejemplo: GLB
string
predeterminado:"glb_identity_enrichment"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: glb_identity_enrichment
Consentimiento explícito del usuario final para este servicio.Ejemplo: true
string
predeterminado:"john.doe@example.com"
Dirección de correo electrónico.Ejemplo: john.doe@example.com
string
predeterminado:"+15550101000"
Número de teléfono en formato internacional.Ejemplo: +15550101000
string
predeterminado:"John"
Nombre de pila que se va a validar.Ejemplo: John
string
predeterminado:"Doe"
Apellido que se va a validar.Ejemplo: Doe
string
Nombre legal completo que se va a validar.Ejemplo: John Doe
string
predeterminado:"US"
País de residencia opcional en formato ISO 3166-1 alfa-2. Solo se usa para acotar la búsqueda de identidad.Ejemplo: US
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular las comprobaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • Proporciona al menos uno de email o phone: son las claves de búsqueda. Una solicitud sin ninguno de los dos no puede realizar una búsqueda de enriquecimiento y se rechaza antes de consultar la fuente (no se cobra).
  • Añade un nombre siempre que lo tengas: la fuente puntúa la búsqueda en función de él. Envía first_name + last_name: son los campos que compara el mapa validation de la respuesta. Una solicitud que solo envía full_name la fuente sigue asignándole una puntuación, pero la respuesta incluye un validation vacío y un match_type de nivel superior nulo.
  • country_of_residence es un código ISO 3166-1 alfa-2 que se usa para acotar la búsqueda.
  • Se cobra toda búsqueda completada, incluida la que no encuentra ninguna persona (persons_found: 0). Solo es gratuita una solicitud rechazada antes de la búsqueda, es decir, cuando no se proporciona ni email ni phone.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para glb_identity_enrichment documenta actualmente esta estructura normalizada:
  • first_name
  • last_name
  • persons_found

Precios y SLA

Las consultas de Global - Identity Enrichment solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.20 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando no se puede acceder al registro, cuando faltan campos obligatorios ni cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 típico < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de las fuentes externas varía según el país y el conjunto de datos.

Continúa leyendo

Última modificación el 1 de noviembre de 2026