Uthibitishaji wa Cédula ya Kolombia Kupitia API (SW)

Kuingiza watumiaji nchini Kolombia kunamaanisha kuthibitisha kuwa wao ni wale wanaojidai kuwa wao. Huhakiki data ya Cédula de Ciudadanía ya Kolombia kupitia mtoa huduma wa uthibitishaji kitambulisho wa Didit nchini Kolombia. Hati au maelezo yaliyoandikwa huonyesha tu kwamba data ipo — si kwamba ni halisi au inamhusu mtu aliyeko mbele yako. Uthibitishaji wa Cédula ya Kolombia huziba pengo hilo kwa kuangalia data dhidi ya sajili rasmi ya serikali ya utambulisho nchini humo. Mwongozo huu unaeleza nini ukaguzi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuiunganisha kwa dakika chache.

Mambo muhimu:

• Inachokikagua — Uthibitishaji wa Cédula ya Kolombia huthibitisha kitambulisho cha kitaifa dhidi ya sajili rasmi ya serikali ya utambulisho nchini humo.
• Unachopata — match_type iliyorekebishwa pamoja na matokeo ya kiwango cha uga ambayo unaweza kupeleka moja kwa moja kwenye mantiki ya kuidhinisha / kukagua / kukataa.
• Kwa nini ni muhimu — Hati inaweza kughushiwa; rekodi ya sajili haiwezi. Kuthibitisha kitambulisho dhidi ya chanzo rasmi cha serikali kunathibitisha kuwa mwenye hati ni halisi na ametambuliwa kwa usahihi.
• Jinsi ya kuitumia — POST moja kwenye sehemu ya mwisho ya uthibitishaji hifadhidata ya Didit, au moduli ya mtiririko wa kazi isiyo na msimbo. $0.20 kwa swala la uhakika, matokeo kwa sekunde.

Nini Uthibitishaji wa Cédula ya Kolombia Huthibitisha

Huhakiki data ya Cédula de Ciudadanía ya Kolombia kupitia mtoa huduma wa uthibitishaji kitambulisho wa Didit nchini Kolombia. Didit inaiweka wazi kupitia sehemu moja ya mwisho ili uweze kuthibitisha data iliyowasilishwa dhidi ya sajili rasmi ya serikali ya utambulisho nchini humo na kupokea matokeo yaliyopangwa, yaliyorekebishwa — si takataka ghafi ya sajili unayopaswa kuchambua mwenyewe.

Jibu la 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

Hati inaweza kughushiwa; rekodi ya sajili haiwezi. Kuthibitisha kitambulisho dhidi ya chanzo rasmi cha serikali kunathibitisha kuwa mwenye hati ni halisi na ametambuliwa kwa usahihi.

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

Maelezo ya kiufundi

Didit inaweka huduma hii wazi kupitia sehemu ya mwisho ya uthibitishaji hifadhidata iliyounganishwa. Ni POST moja — hakuna SDK inayohitajika.

Sehemu 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 COL.
services	string	Ndio	Kitambulisho cha huduma. Tumia col_cedula.
personal_number	string	Ndio	Namba ya kibinafsi.
first_name	string	Hapana	Jina la kwanza (ukaguzi wa hiari).
last_name	string	Hapana	Jina la mwisho (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=COL" \
  -F "services=col_cedula" \
  -F "personal_number=1111111"

Mfano wa jibu (ulinganifu wa uhakika)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "COL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "col_cedula",
      "service_name": "Colombia - Cédula verification",
      "source_data": {
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Utendaji na bili

• Ucheleweshaji: kwa kawaida sekunde chache.
• Gharama: $0.20 kwa swala la uhakika. Unalipishwa tu kwa matokeo ya uhakika — hakuna malipo kwa kukatika kwa chanzo, sehemu zinazokosekana, au kukataliwa kabla ya chanzo.
• Kuegemea: huendeshwa kwenye miundombinu ya Didit kwa lengo la 99.9% ya muda wa kufanya kazi kwa robo mwaka.

Kesi za matumizi

• Fintech & neobanks — thibitisha mshikilia akaunti halisi, anayeweza kuthibitishwa kabla ya kufungua pochi au kutoa mkopo nchini Kolombia.
• Crypto & Web3 — kutimiza mahitaji ya kuingiza VASP na uthibitisho wa kitambulisho kutoka chanzo rasmi.
• Mikopo — punguza udanganyifu wa kitambulisho bandia na wa mtu wa kwanza kwa data iliyothibitishwa kutoka chanzo.
• Masoko & majukwaa ya kazi za muda — thibitisha watumiaji dhidi ya data rasmi, si tu fomu iliyoripotiwa mwenyewe.
• iGaming — timiza ukaguzi wa kitambulisho na ustahiki kwa wachezaji wa Kolombia na rekodi inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha Uthibitishaji wa Cédula ya Kolombia kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Kwenye Didit Business Console, fungua Workflow Builder, ongeza moduli ya Database Validation, chagua Colombia → Colombia Cédula Verification, na uamilishe. Watumiaji wanaolingana huelekezwa kiotomatiki — hakuna uhandisi unaohitajika.
2. API ya moja kwa moja. Piga sehemu ya mwisho ya /v3/database-validation/ iliyoonyeshwa hapo juu na services=col_cedula. 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 bila malipo kwa mwezi, kwa hivyo unaweza kujaribu mtiririko kamili kuanzia mwanzo hadi mwisho kabla ya kulipia swala moja.

Maswali yanayoulizwa mara kwa mara

Nini uthibitishaji wa Cédula ya Kolombia unathibitisha?

Inathibitisha data iliyowasilishwa dhidi ya sajili rasmi ya serikali ya utambulisho nchini humo na kurudisha matokeo ya ulinganifu yaliyorekebishwa, ili ujue kama kitambulisho cha kitaifa kipo kwenye chanzo rasmi na ni sehemu zipi zilizolingana.

Nini hutokea ikiwa chanzo hakipatikani kwa muda?

Hulipishwi. Bili hutumika tu kwa matokeo ya uhakika — kukatika kwa chanzo, sehemu zinazokosekana, na kukataliwa kabla ya chanzo ni bure.

Ukaguzi ni wa haraka kiasi gani?

Uthibitishaji wa hifadhidata kwa kawaida hurudi kwa sekunde chache, kwa hivyo inafaa ndani ya mtiririko wa kuingiza watumiaji kwa wakati halisi.

Je, ninahitaji SDK?

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

Uko tayari kuanza?

Thibitisha kitambulisho chako cha kwanza cha kitaifa cha Kolombia leo.

• Soma marejeleo ya API: Uthibitishaji wa Cédula ya Kolombia
• Angalia uthibitishaji wote wa hifadhidata: Bei na chanjo ya Uthibitishaji wa Hifadhidata
• Anza kujenga: Fungua akaunti ya Didit bila malipo — uthibitishaji 500 kwa mwezi, bila malipo.