Validació en bases de dades - activar serveis i què es cobra
La validació en bases de dades contrasta les dades d'identitat extretes amb un registre oficial o autoritzat. Per què un servei diu "Requereix incorporació", per què retorna 403 o res, i quines consultes es cobren.
La validació en bases de dades s'executa en segon pla contra un registre oficial: la persona no la veu mai. Només s'activa després de la primera recàrrega de la teva organització, alguns serveis mostren a més "Requereix incorporació" fins que Didit els habilita, i tota consulta que el registre respon es cobra, inclosa una sense coincidència.
Llegir el document et diu què hi ha imprès. La validació en bases de dades et diu si una font autoritzada hi està d'acord: un registre civil, una autoritat fiscal, un buró de crèdit, una base de dades de permisos de conduir. Cada país exposa un o més serveis, cadascun amb el seu preu, les seves dades d'entrada i les seves regles de consentiment. Consulta països i serveis disponibles i preus per servei.
#S'executa en silenci, després del pas del document
No hi ha cap pantalla de validació en bases de dades. El pas pren les dades extretes del document (o les que vas passar en crear la sessió), les envia al registre i desa la resposta a l'informe de la sessió. Se'n deriven dues conseqüències:
- Si el pas d'ID va extreure malament el número o el nom, el registre es consulta amb el valor equivocat i la comprovació falla o torna com a no concloent. Corregeix primer l'extracció. Consulta corregir un nom o un camp mal llegit.
- No pots "reenviar" una validació en bases de dades a l'usuari com reenvies un document o una selfie, perquè no hi ha res que la persona pugui repetir. Demanar un reenviament de
DATABASE_VALIDATIONretorna un error que indica que aquesta funció no forma part dels passos reenviables de la sessió. Per executar-la de nou, crida l'API independent de validació en bases de dades amb les dades corregides. Aquesta crida es cobra per consulta com qualsevol altra.
#Per què no s'està executant
Revisa-ho en aquest ordre. Explica gairebé tots els avisos de "la validació en bases de dades no ha fet res".
- La teva organització ha recarregat alguna vegada?
La validació en bases de dades (i la verificació de telèfon) només s'activa després d'una primera recàrrega. Els crèdits de benvinguda, inclosos els 10 $ de compte nou, no compten. Fins llavors el pas s'omet, una sessió pot tornar aprovada amb la comprovació silenciosament no feta, i una crida directa a
POST /v3/database-validation/respon 403. Consulta recàrregues, factures i mètodes de pagament. - El servei està marcat com a Requereix incorporació?
Al pas de validació en bases de dades del flux, alguns serveis mostren "Requereix incorporació. Contacta amb el suport de Didit per activar-lo." El servei és visible però està desactivat per a la teva organització fins que Didit l'activi. No és un error i no hi ha cap interruptor d'autoservei: obre un tiquet de suport indicant el servei i el país, i l'equip inicia la incorporació.
- El país està configurat?
Una crida a l'API per a un país que mai no vas seleccionar al flux, o una crida independent a un servei que no has habilitat, respon amb "No database validation services configured" per a aquell país. Afegeix el servei al pas, o passa el
service_idexacte de la pàgina del país. - El saldo és positiu?
La validació en bases de dades mai no és al pla gratuït. Un saldo zero o negatiu retorna
insufficient_credits, igual que qualsevol funció de pagament. Consulta arreglar un error de "crèdits insuficients".
#Serveis que necessiten incorporació amb el proveïdor
Un grapat de fonts governamentals exigeix que Didit doni d'alta la teva organització davant del proveïdor; no n'hi ha prou amb activar un interruptor. Avui aplica a:
- Austràlia (DVS: permís de conduir, passaport, visat, Medicare i la resta de serveis DVS)
- Nova Zelanda (DIA: passaport, ciutadania, registres de naixement i defunció, permís de conduir)
- Canadà (serveis de buró de crèdit i de comparació tipus FINTRAC)
Per a aquests, suport t'envia els formularis del proveïdor, el proveïdor emet credencials per al teu compte i l'activació sol trigar fins a dues setmanes. Austràlia i Nova Zelanda han exigit històricament a més un acord de servei mínim (un import prepagat únic, actualment 5.000 USD, que entra al teu saldo com a crèdits que no caduquen mai). Aquest requisit aplica només a l'accés als registres d'aquests dos països, no a cap altra funció de Didit, i s'està revisant a mesura que Didit completa la seva pròpia acreditació a l'esquema australià, així que pregunta a suport per les condicions vigents abans de planificar-hi res.
Alguns serveis exigeixen a més el consentiment explícit de l'usuari final abans d'enviar la consulta (per exemple la comprovació de passaport DIA de Nova Zelanda). El pas del flux marca aquests serveis, i el consentiment s'ha de recollir al teu flux abans que la comprovació es pugui executar.
#Què es cobra
Pagues per servei, per cada consulta que el registre respon, al preu de la pàgina d'aquell servei. Llegeix-ho com "es va preguntar al registre i va respondre", no com "la resposta va ser la que volies":
| Resultat | Es cobra? |
|---|---|
| Coincidència, coincidència parcial, sense coincidència | Sí |
| No concloent, imatge biomètrica inutilitzable | Sí |
| Format de document no vàlid, entrada no vàlida (rebutjada pel registre) | Sí |
REGISTRY_UNAVAILABLE, REGISTRY_ERROR (el registre no va respondre mai) | No |
| Sol·licitud rebutjada abans d'arribar al registre (400 a l'API independent, o pas del flux omès per camps absents o mal formats) | No |
Una sessió pot generar diverses consultes cobrades si executa diversos serveis, i cada consulta es cobra un cop per servei, no per país. Desglossament complet: preus de validació en bases de dades i codis de resultat.
Un resultat buit no és una manca de coincidència. Si un servei no retorna res en lloc d'un
resultat NO_MATCH, les causes habituals són la regla de la primera recàrrega, un servei
pendent d'incorporació o una caiguda del registre; val la pena descartar-les abans de depurar
la teva integració. Consulta errors de l'API i què signifiquen.
#Què retorna
Cada servei retorna un codi de resultat estàndard més les dades pròpies del registre quan la font ho permet: quins camps van coincidir, una puntuació de coincidència quan el registre puntua en lloc de respondre sí o no, i als serveis biomètrics (RENAPER de l'Argentina, BVN de Nigèria, Panamà) una comparació facial contra el retrat del registre. Què desa Didit d'aquesta resposta ho governa la configuració de Dades retornades del pas. Consulta triar quines dades retorna una verificació i l'informe de validació en bases de dades.
#Provar abans de sortir a producció
Les aplicacions sandbox mai no arriben a un registre real ni gasten crèdits: un escenari de sandbox com decline_database_no_match força el resultat que vulguis assajar. El que el sandbox no et pot dir és si un servei concret està aprovisionat per a la teva organització en producció; per a això cal la primera recàrrega i una crida real. Consulta proves en sandbox.