Uthibitishaji wa Vitambulisho vya Kenya Kupitia API (SW)

Kusajili watumiaji nchini Kenya kunamaanisha kuthibitisha kuwa wao ni wale wanaodai kuwa. Huhakiki data dhidi ya Ofisi ya Usajili wa Kitaifa. Hati au maelezo yaliyoandikwa huonyesha tu data ipo — si kwamba ni halisi au inamhusu mtu aliye mbele yako. Uthibitishaji wa Kitambulisho cha Kenya huziba pengo hilo kwa kuangalia data dhidi ya rejista rasmi ya serikali ya utambulisho nchini. Mwongozo huu unaeleza nini ukaguzi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuiunganisha kwa dakika chache.

Mambo muhimu:

• Inachokagua — Uthibitishaji wa Kitambulisho cha Kenya huthibitisha Kitambulisho cha kitaifa dhidi ya rejista rasmi ya serikali ya utambulisho nchini.
• Unachopata — match_type iliyorekebishwa pamoja na matokeo ya kiwango cha uga unayoweza kuelekeza moja kwa moja kwenye mantiki ya kuidhinisha / kukagua / kukataa.
• Kwa nini ni muhimu — Hati inaweza kughushiwa; rekodi ya rejista haiwezi. Kuthibitisha Kitambulisho dhidi ya chanzo rasmi cha serikali kunathibitisha kuwa mwenyeji ni halisi na ametambuliwa kwa usahihi.
• Jinsi ya kuitumia — POST moja kwa hatua ya mwisho ya uthibitishaji wa hifadhidata ya Didit, au moduli ya mtiririko wa kazi isiyo na msimbo. $3.15 kwa swali lenye jibu kamili, matokeo kwa sekunde.

Nini Uthibitishaji wa Kitambulisho cha Kenya Huhakiki

Huhakiki data dhidi ya Ofisi ya Usajili wa Kitaifa. Didit huifichua kupitia hatua moja ya mwisho ili uweze kuthibitisha data iliyowasilishwa dhidi ya rejista rasmi ya serikali ya utambulisho nchini na kupokea matokeo yaliyopangwa, yaliyorekebishwa — si takataka ghafi ya rejista unayopaswa kuchambua mwenyewe.

Jibu kamili hurejesha source_data iliyolingana na kizuizi cha validation cha kila uga, ili injini yako ya hatari ipate uamuzi wazi, unaoweza kusomwa na mashine.

Kwa nini Ni Muhimu

Hati inaweza kughushiwa; rekodi ya rejista haiwezi. Kuthibitisha Kitambulisho dhidi ya chanzo rasmi cha serikali kunathibitisha kuwa mwenyeji ni halisi na ametambuliwa kwa usahihi.

Kwa biashara zinazodhibitiwa nchini Kenya — fintechs, mifumo ya crypto, wakopeshaji, masoko, na waendeshaji wa michezo ya kubahatisha — kukagua dhidi ya chanzo rasmi hutoa rekodi inayoweza kutetewa, inayoweza kukaguliwa kwamba utambulisho ulithibitishwa kwenye chanzo, si tu kukusanywa kutoka kwa fomu au picha.

Maelezo ya Kiufundi

Didit hutoa huduma hii kupitia hatua ya mwisho ya uthibitishaji wa hifadhidata. Ni POST moja — hakuna SDK inayohitajika.

Hatua ya Mwisho

POST /v3/database-validation/

Vigezo vya Ombi

Kigezo	Aina	Inahitajika	Maelezo
issuing_state	string	Ndio	Msimbo wa nchi wa ISO 3166-1 alpha-3. Tumia KEN.
services	string	Ndio	Kitambulisho cha huduma. Tumia ken_national_id.
first_name	string	Ndio	Jina la kwanza.
last_name	string	Ndio	Jina la mwisho.
date_of_birth	string	Ndio	Tarehe ya kuzaliwa.
national_id	string	Ndio	Kitambulisho cha kitaifa.

Mfano wa Ombi

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

Mfano wa Majibu (ulinganifu kamili)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "KEN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "ken_national_id",
      "service_name": "Kenya National ID",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "verifications": {
          "date_of_birth": true,
          "full_name": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Utendaji na Malipo

• Muda wa Kuchelewa: kwa kawaida sekunde chache.
• Gharama: $3.15 kwa swali lenye jibu kamili. Unatozwa tu kwa matokeo kamili — hakuna malipo kwa kukatika 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 kwa robo mwaka.

Matumizi

• Fintech & neobanks — thibitisha mshikilizi wa akaunti halisi, anayeweza kuthibitishwa kabla ya kufungua pochi au kutoa mkopo nchini Kenya.
• Crypto & Web3 — tekeleza mahitaji ya usajili wa VASP na uthibitisho wa utambulisho wa chanzo rasmi.
• Ukopeshaji — punguza utambulisho bandia na udanganyifu wa wahusika wa kwanza kwa data iliyothibitishwa na chanzo.
• Masoko & mifumo ya kazi za muda — thibitisha watumiaji dhidi ya data rasmi, si tu fomu iliyoripotiwa na wao wenyewe.
• iGaming — tekeleza ukaguzi wa utambulisho na ustahiki kwa wachezaji wa Kenya na rekodi inayoweza kukaguliwa.

Jinsi ya Kuunganisha na Didit

Unaweza kuendesha Uthibitishaji wa Kitambulisho cha Kenya kwa njia mbili:

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

Kila akaunti ya Didit inajumuisha uthibitishaji 500 bila malipo kwa mwezi, ili uweze kujaribu mtiririko kamili kuanzia mwanzo hadi mwisho kabla ya kulipia swali lolote.

Maswali Yanayoulizwa Mara kwa Mara

Uthibitishaji wa Kitambulisho cha Kitaifa cha Kenya unathibitisha nini?

Huhakiki data iliyowasilishwa dhidi ya rejista rasmi ya utambulisho ya serikali ya nchi na kurejesha matokeo ya ulinganifu yaliyorekebishwa, ili ujue kama Kitambulisho cha kitaifa kipo kwenye chanzo rasmi na ni sehemu gani zilizolingana.

Nini hufanyika ikiwa chanzo hakipatikani kwa muda?

Haulipishwi. Malipo hutumika tu kwa matokeo kamili — kukatika kwa chanzo, sehemu zinazokosekana, na kukataliwa kabla ya chanzo ni bure.

Ukaguzi ni wa haraka kiasi gani?

Uthibitishaji wa hifadhidata kwa kawaida hurejeshwa kwa sekunde chache, hivyo inafaa ndani ya mtiririko wa usajili wa wakati halisi.

Je, ninahitaji SDK?

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

Uko Tayari Kuanza?

Thibitisha Kitambulisho chako cha kwanza cha Kenya leo.

• Soma marejeleo ya API: Uthibitishaji wa Kitambulisho cha Kenya
• Tazama uthibitishaji wote wa hifadhidata: Bei na Ufikiaji wa Uthibitishaji wa Hifadhidata
• Anza kujenga: Fungua akaunti ya bure ya Didit — uthibitishaji 500 kwa mwezi, bure.