API de Verificació d'Identitat Nacional de Finlàndia (CA)

Incorporar usuaris a Finlàndia significa confirmar que són qui diuen ser. Es verifiquen les dades d'entrada amb l'agència oficial emissora de la Targeta d'Identitat Finlandesa. Un document o una dada introduïda només demostra que la dada existeix, no que sigui genuïna o que pertanyi a la persona que tens al davant. La Verificació d'Identitat Nacional de Finlàndia tanca aquesta bretxa comprovant les dades amb el registre oficial d'identitat del govern del país. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La Verificació d'Identitat Nacional de Finlàndia valida la identificació nacional amb el registre oficial d'identitat del govern del país.
• Què s'obté — un match_type normalitzat més resultats a nivell de camp que pots encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — Un document es pot falsificar; un registre no. Validar la identificació amb la font governamental autoritzada confirma que el titular és real i està identificat correctament.
• Com utilitzar-lo — un POST a l'endpoint de validació de base de dades de Didit, o un mòdul de flux de treball sense codi. 2,10 $ per consulta concloent, resultats en segons.

Què valida la Verificació d'Identitat Nacional de Finlàndia

Verifica les dades d'entrada amb l'agència oficial emissora de la Targeta d'Identitat Finlandesa. Didit l'exposa a través d'un únic endpoint perquè puguis verificar les dades enviades amb el registre oficial d'identitat del govern del país i rebre un resultat estructurat i normalitzat, no un bolcat de registre en brut que hagis de processar tu mateix.

Una resposta concloent retorna les source_data coincidents i un bloc de validation per camp, de manera que el teu motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

Un document es pot falsificar; un registre no. Validar la identificació amb la font governamental autoritzada confirma que el titular és real i està identificat correctament.

Per a les empreses regulades a Finlàndia — fintechs, plataformes de criptomonedes, prestamistes, mercats i operadors de jocs — la comprovació amb una font autoritzada produeix un registre defensable i auditable que la identitat es va confirmar a la font, no només es va capturar d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de base de dades. És un únic POST, no es requereix SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Obligatori	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alpha-3. Utilitza FIN.
services	string	Sí	Identificador del servei. Utilitza fin_national_id.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
date_of_birth	string	Sí	Data de naixement.
national_id	string	Sí	Identificador nacional.
address	string	No	Adreça (comprovació creuada opcional).

Exemple de sol·licitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=FIN" \
  -F "services=fin_national_id" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111"

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "FIN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "fin_national_id",
      "service_name": "Finland National ID",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 2,10 $ per consulta concloent. Se't factura només pels resultats concloents — sense càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirma un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Finlàndia.
• Crypto i Web3 — compleix els requisits d'incorporació de VASP amb proves d'identitat de font autoritzada.
• Préstecs — redueix el frau d'identitat sintètica i de primera part amb dades verificades a la font.
• Mercats i plataformes de serveis — verifica els usuaris amb dades autoritzades, no només amb un formulari autodeclarat.
• iGaming — satisfà les comprovacions d'identitat i elegibilitat per als jugadors de Finlàndia amb un registre auditable.

Com integrar-se amb Didit

Pots executar la Verificació d'Identitat Nacional de Finlàndia de dues maneres:

1. Flux de treball sense codi. A la Consola de Negocis de Didit, obre el Creador de Fluxos de Treball, afegeix el mòdul Validació de Base de Dades, selecciona Finlàndia → Verificació d'Identitat Nacional de Finlàndia i activa'l. Els usuaris que coincideixen s'encaminen automàticament, sense necessitat d'enginyeria.
2. API directa. Truca a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=fin_national_id. Llegeix match_type i el bloc de validation per camp per impulsar la teva lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que pots provar el flux complet d'extrem a extrem abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la Verificació d'Identitat Nacional de Finlàndia?

Valida les dades enviades amb el registre oficial d'identitat del govern del país i retorna un resultat de coincidència normalitzat, de manera que saps si la identificació nacional existeix a la font autoritzada i quins camps han coincidit.

Què passa si la font no està disponible temporalment?

No se't cobra. La facturació només s'aplica als resultats concloents — el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quina rapidesa té la comprovació?

La validació de la base de dades sol retornar-se en un parell de segons, de manera que s'adapta a un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és un únic POST HTTPS a un endpoint. També pots connectar-lo a un flux de treball sense codi a la Consola de Negocis.

A punt per començar?

Valida la teva primera identificació nacional de Finlàndia avui mateix.

• Llegeix la referència de l'API: Verificació d'Identitat Nacional de Finlàndia
• Consulta totes les validacions de base de dades: Preus i cobertura de la validació de base de dades
• Comença a construir: Crea un compte Didit gratuït — 500 verificacions al mes, gratuïtes.