API ya Uthibitishaji wa Makazi Ureno (SW)

Kuingiza watumiaji nchini Ureno kunamaanisha kuthibitisha kuwa wao ndio wanajidai kuwa. Huangalia data iliyoingizwa dhidi ya chanzo cha data kilichojumuishwa cha umiliki wa mali na rejista za mamlaka za umma. Hati au maelezo yaliyoandikwa yanaonyesha tu kuwa data ipo — sio kwamba ni halisi au inamilikiwa na mtu uliyenaye. Uthibitishaji wa Makazi Ureno unaziba pengo hilo kwa kuangalia data dhidi ya vyanzo vya data vya mamlaka vya makazi na watumiaji. Mwongozo huu unafafanua nini ukaguzi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuyaunganisha kwa dakika chache.

Mambo muhimu:

• Inachokagua — Uthibitishaji wa Makazi Ureno unathibitisha anwani na data ya makazi dhidi ya vyanzo vya data vya mamlaka vya makazi na watumiaji.
• Unachopata — match_type iliyoratibiwa pamoja na matokeo ya kiwango cha uga unayoweza kuingiza moja kwa moja kwenye mantiki ya kuidhinisha / kukagua / kukataa.
• Kwa nini ni muhimu — Uthibitishaji wa anwani dhidi ya data ya mamlaka unathibitisha kuwa mwombaji anaishi kweli mahali anapodai — ishara muhimu ya kupambana na udanganyifu na kufuata kanuni.
• Jinsi ya kuitumia — POST moja kwa sehemu ya mwisho ya uthibitishaji wa hifadhidata ya Didit, au moduli ya mtiririko wa kazi isiyo na msimbo. $1.02 kwa hoja yenye uhakika, matokeo kwa sekunde chache.

Nini Uthibitishaji wa Makazi Ureno unathibitisha

Huathibitisha data iliyoingizwa dhidi ya chanzo cha data kilichojumuishwa cha umiliki wa mali na rejista za mamlaka za umma. Didit inaiweka wazi kupitia sehemu moja ya mwisho ili uweze kuthibitisha data iliyowasilishwa dhidi ya vyanzo vya data vya mamlaka vya makazi na watumiaji na kupokea matokeo yaliyopangwa, yaliyosawazishwa — sio faili ghafi ya rejista unayopaswa kuchambua mwenyewe.

Majibu yenye uhakika hurudisha source_data iliyolingana na kizuizi cha validation kwa kila uga, ili injini yako ya hatari ipate uamuzi wazi, unaoweza kusomwa na mashine.

Kwa nini ni muhimu

Uthibitishaji wa anwani dhidi ya data ya mamlaka unathibitisha kuwa mwombaji anaishi kweli mahali anapodai — ishara muhimu ya kupambana na udanganyifu na kufuata kanuni.

Kwa biashara zilizodhibitiwa nchini Ureno — fintechs, mifumo ya crypto, wakopeshaji, sokoni, na waendeshaji wa michezo ya kubahatisha — kuangalia dhidi ya chanzo cha mamlaka kunatoa rekodi inayoweza kutetewa, inayoweza kukaguliwa kwamba utambulisho ulithibitishwa kwenye chanzo, sio tu kukusanywa kutoka kwa fomu au picha.

Maelezo ya Kiufundi

Didit inatoa huduma hii kupitia sehemu ya mwisho ya uthibitishaji wa hifadhidata iliyounganishwa. Ni POST moja tu — hakuna SDK inayohitajika.

Sehemu ya Mwisho

POST /v3/database-validation/

Vigezo vya Ombi

Kigezo	Aina	Inahitajika	Maelezo
issuing_state	string	Ndiyo	Msimbo wa nchi wa ISO 3166-1 alpha-3. Tumia PRT.
services	string	Ndiyo	Kitambulisho cha huduma. Tumia prt_residential.
first_name	string	Ndiyo	Jina la kwanza.
last_name	string	Ndiyo	Jina la mwisho.
address	string	Ndiyo	Anwani.
date_of_birth	string	Hapana	Tarehe ya kuzaliwa (ukaguzi wa hiari).

Mfano wa Ombi

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"

Mfano wa Majibu (ulinganifu kamili)

{
  "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"
      }
    }
  ]
}

Utendaji na Malipo

• Kuchelewa: kwa kawaida sekunde chache.
• Gharama: $1.02 kwa hoja yenye uhakika. Unalipishwa tu kwa matokeo yenye uhakika — hakuna malipo kwa muda wa kutofanya kazi kwa chanzo, sehemu zinazokosekana, au kukataliwa kabla ya chanzo.
• Kuegemea: huendeshwa kwenye miundombinu ya Didit kwa lengo la 99.9% la muda wa kufanya kazi kila robo mwaka.

Matumizi

• Fintech & neobanks — thibitisha mmiliki halisi, anayeweza kuthibitishwa wa akaunti kabla ya kufungua pochi au kutoa mkopo nchini Ureno.
• Crypto & Web3 — kutimiza mahitaji ya kuingiza VASP kwa ushahidi wa utambulisho kutoka chanzo chenye mamlaka.
• Kukopesha — punguza udanganyifu wa utambulisho wa bandia na udanganyifu wa wahusika wa kwanza kwa data iliyothibitishwa kutoka chanzo.
• Sokoni & mifumo ya kazi za muda — thibitisha watumiaji dhidi ya data ya mamlaka, sio tu fomu iliyoripotiwa na wao wenyewe.
• iGaming — timiza ukaguzi wa utambulisho na ustahiki kwa wachezaji wa Ureno na rekodi inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha Uthibitishaji wa Makazi Ureno kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Kwenye Didit Business Console, fungua Workflow Builder, ongeza moduli ya Database Validation, chagua Portugal → Portugal Residential Verification, na uiwashe. Watumiaji wanaolingana hupelekwa moja kwa moja — hakuna uhandisi unaohitajika.
2. API ya moja kwa moja. Piga sehemu ya mwisho ya /v3/database-validation/ iliyoonyeshwa hapo juu na services=prt_residential. Soma match_type na kizuizi cha validation kwa kila uga ili kuendesha mantiki yako ya kuidhinisha / kukagua / kukataa.

Kila akaunti ya Didit inajumuisha uthibitishaji 500 wa bure kwa mwezi, kwa hivyo unaweza kujaribu mtiririko kamili kutoka mwanzo hadi mwisho kabla ya kulipia hoja moja.

Maswali Yanayoulizwa Mara kwa Mara

Uthibitishaji wa Makazi Ureno unathibitisha nini?

Unathibitisha data iliyowasilishwa dhidi ya vyanzo vya data vya mamlaka vya makazi na watumiaji na hurudisha matokeo ya ulinganifu yaliyosawazishwa, kwa hivyo unajua kama anwani na data ya makazi ipo kwenye chanzo chenye mamlaka na ni sehemu gani zilingana.

Nini kinatokea ikiwa chanzo hakipatikani kwa muda?

Hulipishwi. Malipo yanatumika tu kwa matokeo yenye uhakika — muda wa kutofanya kazi wa chanzo, sehemu zinazokosekana, na kukataliwa kabla ya chanzo ni bure.

Ukaguzi una kasi gani?

Uthibitishaji wa hifadhidata kwa kawaida hurudi kwa sekunde chache, kwa hivyo unafaa katika mtiririko wa kuingiza wa wakati halisi.

Ninahitaji SDK?

Hapana. Ukaguzi ni POST moja ya HTTPS kwa sehemu moja ya mwisho. Unaweza pia kuiunganisha kwenye mtiririko wa kazi usio na msimbo kwenye Business Console.

Uko Tayari Kuanza?

Thibitisha anwani yako ya kwanza ya Ureno na data ya makazi leo.

• Soma marejeleo ya API: Uthibitishaji wa Makazi Ureno
• Tazama uthibitishaji wote wa hifadhidata: Bei na Chanjo ya Uthibitishaji wa Hifadhidata
• Anza kujenga: Fungua akaunti ya bure ya Didit — uthibitishaji 500 kwa mwezi, bure.