API de Verificació Residencial a Portugal (CA)

Incorporar usuaris a Portugal significa confirmar que són qui diuen ser. Es verifiquen les dades d’entrada amb una font de dades combinada de propietat i registres d’autoritats públiques. Un document o un detall escrit només prova que les dades existeixen, no que siguin genuïnes o pertanyin a la persona que teniu al davant. La Verificació Residencial de Portugal tanca aquesta bretxa comprovant les dades amb fonts autoritzades de dades residencials i de consum. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La Verificació Residencial de Portugal valida les dades d'adreça i residencials amb fonts autoritzades de dades residencials i de consum.
• Què obtens — un match_type normalitzat i resultats a nivell de camp que pots dirigir directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — La verificació d'adreces amb dades autoritzades confirma que un sol·licitant realment viu on diu — un senyal clau contra el frau i per al compliment.
• Com utilitzar-lo — una POST a l'endpoint de validació de bases de dades de Didit, o un mòdul de flux de treball sense codi. 1,02 $ per consulta concloent, resultats en segons.

Què valida la Verificació Residencial de Portugal

Es verifiquen les dades d'entrada amb una font de dades combinada de propietat i registres d'autoritats públiques. Didit ho exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb fonts autoritzades de dades residencials i de consum i rebre un resultat estructurat i normalitzat, no un abocament de registre en brut que hàgiu de parsejar vosaltres mateixos.

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

Per què és important

La verificació d'adreces amb dades autoritzades confirma que un sol·licitant realment viu on diu — un senyal clau contra el frau i per al compliment.

Per a empreses regulades a Portugal — fintechs, plataformes cripto, prestadors, 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 bases de dades. És un únic POST — no es requereix SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Requerit	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alfa-3. Utilitzeu PRT.
services	string	Sí	Identificador de servei. Utilitzeu prt_residential.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
address	string	Sí	Adreça.
date_of_birth	string	No	Data de naixement (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=PRT" \
  -F "services=prt_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001"

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "PRT",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "prt_residential",
      "service_name": "Portugal Residential",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 1,02 $ per consulta concloent. Se us facturarà només pels resultats concloents — no hi ha 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 — confirmeu un titular de compte real i verificable abans d'obrir una cartera o estendre crèdit a Portugal.
• Cripto i Web3 — compliu els requisits d'incorporació de VASP amb proves d'identitat de font autoritzada.
• Préstecs — reduïu el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis — verifiqueu els usuaris amb dades autoritzades, no només un formulari autoinformat.
• iGaming — compliu les comprovacions d'identitat i elegibilitat per als jugadors de Portugal amb un registre auditable.

Com integrar-se amb Didit

Podeu executar la Verificació Residencial de Portugal de dues maneres:

1. Flux de treball sense codi. A la Consola de Negocis de Didit, obriu el Creador de Fluxos de Treball, afegiu el mòdul Validació de Base de Dades, seleccioneu Portugal → Verificació Residencial de Portugal i activeu-lo. Els usuaris que coincideixen es dirigeixen automàticament — no es requereix enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=prt_residential. Llegiu match_type i el bloc de validation per camp per impulsar la vostra lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que podeu provar tot el flux de punta a punta abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de Verificació Residencial de Portugal?

Valida les dades enviades amb fonts autoritzades de dades residencials i de consum i retorna un resultat de coincidència normalitzat, de manera que sabeu si l'adreça i les dades residencials existeixen a la font autoritzada i quins camps van coincidir.

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

No se us cobrarà. 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.

Què tan ràpida és la comprovació?

La validació de la base de dades normalment retorna 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 una única POST HTTPS a un endpoint. També podeu connectar-la a un flux de treball sense codi a la Consola de Negocis.

Llest per començar?

Valideu la vostra primera adreça i dades residencials de Portugal avui mateix.

• Llegiu la referència de l'API: Verificació Residencial de Portugal
• Vegeu totes les validacions de bases de dades: Preus i cobertura de validació de bases de dades
• Comenceu a construir: Creeu un compte gratuït de Didit — 500 verificacions al mes, gratuïtes.