Validación en bases de datos - activar servicios y qué se cobra
La validación en bases de datos contrasta los datos de identidad extraídos con un registro oficial o autorizado. Por qué un servicio dice "Requiere incorporación", por qué devuelve 403 o nada, y qué consultas se cobran.
La validación en bases de datos se ejecuta en segundo plano contra un registro oficial: la persona nunca la ve. Solo se activa tras la primera recarga de tu organización, algunos servicios muestran además "Requiere incorporación" hasta que Didit los habilita para ti, y toda consulta que el registro responde se cobra, incluida una sin coincidencia.
Leer el documento te dice qué hay impreso en él. La validación en bases de datos te dice si una fuente autorizada está de acuerdo: un registro civil, una autoridad fiscal, un buró de crédito, una base de datos de licencias de conducir. Cada país expone uno o más servicios, cada uno con su propio precio, sus datos de entrada y sus reglas de consentimiento. Consulta países y servicios disponibles y precios por servicio.
#Se ejecuta en silencio, después del paso del documento
No existe una pantalla de validación en bases de datos. El paso toma los datos extraídos del documento (o los que pasaste al crear la sesión), los envía al registro y guarda la respuesta en el informe de la sesión. De ahí se derivan dos consecuencias:
- Si el paso de ID extrajo mal el número o el nombre, el registro se consulta con el valor equivocado y la comprobación falla o vuelve como no concluyente. Corrige primero la extracción. Consulta corregir un nombre o un campo mal leído.
- No puedes "reenviar" una validación en bases de datos al usuario como reenvías un documento o un selfie, porque no hay nada que la persona pueda repetir. Pedir un reenvío de
DATABASE_VALIDATIONdevuelve un error que indica que esa función no forma parte de los pasos reenviables de la sesión. Para ejecutarla de nuevo, llama a la API independiente de validación en bases de datos con los datos corregidos. Esa llamada se cobra por consulta como cualquier otra.
#Por qué no se está ejecutando
Revísalo en este orden. Explica casi todos los avisos de "la validación en bases de datos no hizo nada".
- ¿Tu organización ha recargado alguna vez?
La validación en bases de datos (y la verificación de teléfono) solo se activa tras una primera recarga. Los créditos de bienvenida, incluidos los 10 $ de cuenta nueva, no cuentan. Hasta entonces el paso se omite, una sesión puede volver aprobada con la comprobación silenciosamente no realizada, y una llamada directa a
POST /v3/database-validation/responde 403. Consulta recargas, facturas y métodos de pago. - ¿El servicio está marcado como Requiere incorporación?
En el paso de validación en bases de datos del flujo, algunos servicios muestran "Requiere incorporación. Ponte en contacto con el soporte de Didit para habilitarlo." El servicio es visible pero está desactivado para tu organización hasta que Didit lo active. No es un error y no hay interruptor de autoservicio: abre un ticket de soporte indicando el servicio y el país, y el equipo inicia la incorporación.
- ¿El país está configurado siquiera?
Una llamada a la API para un país que nunca seleccionaste en el flujo, o una llamada independiente a un servicio que no has habilitado, responde con "No database validation services configured" para ese país. Añade el servicio al paso, o pasa el
service_idexacto de la página del país. - ¿El saldo es positivo?
La validación en bases de datos nunca está en el plan gratuito. Un saldo cero o negativo devuelve
insufficient_credits, igual que cualquier función de pago. Consulta arreglar un error de "créditos insuficientes".
#Servicios que necesitan incorporación con el proveedor
Un puñado de fuentes gubernamentales exige que Didit dé de alta a tu organización ante el proveedor, no basta con activar un interruptor. Hoy aplica a:
- Australia (DVS: licencia de conducir, pasaporte, visado, Medicare y el resto de servicios DVS)
- Nueva Zelanda (DIA: pasaporte, ciudadanía, registros de nacimiento y defunción, licencia de conducir)
- Canadá (servicios de buró de crédito y de cotejo tipo FINTRAC)
Para estos, soporte te envía los formularios del proveedor, el proveedor emite credenciales para tu cuenta y la activación suele tardar hasta dos semanas. Australia y Nueva Zelanda han exigido históricamente además un acuerdo de servicio mínimo (un importe prepagado único, actualmente 5.000 USD, que entra en tu saldo como créditos que nunca caducan). Ese requisito aplica solo al acceso a los registros de esos dos países, no a ninguna otra función de Didit, y se está revisando a medida que Didit completa su propia acreditación en el esquema australiano, así que pregunta a soporte por las condiciones vigentes antes de planificar en torno a él.
Algunos servicios exigen además el consentimiento explícito del usuario final antes de enviar la consulta (por ejemplo la comprobación de pasaporte DIA de Nueva Zelanda). El paso del flujo marca esos servicios, y el consentimiento debe recogerse en tu flujo antes de que la comprobación pueda ejecutarse.
#Qué se cobra
Pagas por servicio, por cada consulta que el registro responde, al precio de la página de ese servicio. Léelo como "se preguntó al registro y respondió", no como "la respuesta fue la que querías":
| Resultado | ¿Se cobra? |
|---|---|
| Coincidencia, coincidencia parcial, sin coincidencia | Sí |
| No concluyente, imagen biométrica inutilizable | Sí |
| Formato de documento no válido, entrada no válida (rechazada por el registro) | Sí |
REGISTRY_UNAVAILABLE, REGISTRY_ERROR (el registro nunca respondió) | No |
| Solicitud rechazada antes de llegar al registro (400 en la API independiente, o paso del flujo omitido por campos ausentes o mal formados) | No |
Una sesión puede generar varias consultas cobradas si ejecuta varios servicios, y cada consulta se cobra una vez por servicio, no por país. Desglose completo: precios de validación en bases de datos y códigos de resultado.
Un resultado vacío no es una falta de coincidencia. Si un servicio no devuelve nada en
absoluto en lugar de un resultado NO_MATCH, las causas habituales son la regla de la primera
recarga, un servicio pendiente de incorporación o una caída del registro; conviene descartarlas
antes de depurar tu integración. Consulta errores de la API y su significado.
#Qué devuelve
Cada servicio devuelve un código de resultado estándar más los datos propios del registro cuando la fuente lo permite: qué campos coincidieron, una puntuación de coincidencia cuando el registro puntúa en lugar de responder sí o no, y en los servicios biométricos (RENAPER de Argentina, BVN de Nigeria, Panamá) una comparación facial contra el retrato del registro. Lo que Didit guarda de esa respuesta lo gobierna la configuración de Datos devueltos del paso. Consulta elegir qué datos devuelve una verificación y el informe de validación en bases de datos.
#Probar antes de salir a producción
Las aplicaciones sandbox nunca llegan a un registro real ni gastan créditos: un escenario de sandbox como decline_database_no_match fuerza el resultado que quieras ensayar. Lo que el sandbox no puede decirte es si un servicio concreto está aprovisionado para tu organización en producción; para eso hace falta la primera recarga y una llamada real. Consulta pruebas en sandbox.