API ya Kuhakiki Kitambulisho cha Venezuela (SW)

Kusajili watumiaji nchini Venezuela kunamaanisha kuthibitisha kuwa wao ndio wanajidai kuwa. Inathibitisha Cédula ya Venezuela dhidi ya sajili ya kiraia ya SAIME. Hati au maelezo yaliyoandikwa huonyesha tu kwamba data ipo — sio kwamba ni halisi au inamhusu mtu aliye mbele yako. Uhakiki wa Cédula ya Venezuela huziba pengo hilo kwa kuangalia data dhidi ya sajili rasmi ya utambulisho ya serikali ya nchi. Mwongozo huu unaelezea nini hundi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuiunganisha kwa dakika chache.

Mambo muhimu:

• Inachokagua — Uhakiki wa Cédula ya Venezuela unathibitisha Kitambulisho cha kitaifa dhidi ya sajili rasmi ya utambulisho ya serikali ya nchi.
• Unachopata — match_type iliyorekebishwa pamoja na matokeo ya kiwango cha sehemu unayoweza kuingiza 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 chenye mamlaka cha serikali kunathibitisha kuwa mmiliki ni halisi na anatambuliwa kwa usahihi.
• Jinsi ya kuitumia — POST moja kwa sehemu ya mwisho ya uthibitisho wa hifadhidata ya Didit, au moduli ya mtiririko wa kazi isiyo na msimbo. $0.20 kwa swali lenye uhakika, matokeo kwa sekunde chache.

Nini Uhakiki wa Cédula ya Venezuela unathibitisha

Inathibitisha Cédula ya Venezuela dhidi ya sajili ya kiraia ya SAIME. Didit inaifichua kupitia sehemu moja ya mwisho ili uweze kuthibitisha data iliyowasilishwa dhidi ya sajili rasmi ya utambulisho ya serikali ya nchi na kupokea matokeo yaliyopangwa, yaliyorekebishwa — sio dondoo ghafi ya sajili unayopaswa kuchambua mwenyewe.

Jibu lenye uhakika linarudisha source_data iliyolingana na kizuizi cha validation cha kila sehemu, 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 chenye mamlaka cha serikali kunathibitisha kuwa mmiliki ni halisi na anatambuliwa kwa usahihi.

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

Maelezo ya kiufundi

Didit inafichua huduma hii kupitia sehemu ya mwisho ya uthibitisho wa 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 VEN.
services	string	Ndio	Kitambulisho cha huduma. Tumia ven_cedula.
document_number	string	Ndio	Nambari ya hati.
first_name	string	La	Jina la kwanza (ukaguzi wa hiari).
last_name	string	La	Jina la mwisho (ukaguzi wa hiari).

Ombi la mfano

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=VEN" \
  -F "services=ven_cedula" \
  -F "document_number=1111111"

Jibu la mfano (ulinganifu kamili)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "VEN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "ven_cedula",
      "service_name": "Venezuela - Cédula verification",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Utendaji na bili

• Muda wa kusubiri: kwa kawaida sekunde chache.
• Gharama: $0.20 kwa swali lenye uhakika. Unalipia tu matokeo yenye uhakika — hakuna malipo kwa kukatika kwa chanzo, sehemu zinazokosekana, au kukataliwa kabla ya chanzo.
• Kuegemea: inaendeshwa kwenye miundombinu ya Didit kwa lengo la 99.9% la muda wa kufanya kazi kwa robo mwaka.

Matukio ya matumizi

• Fintech & neobanks — thibitisha mshikilizi wa akaunti halisi, anayeweza kuthibitishwa kabla ya kufungua mkoba au kutoa mkopo nchini Venezuela.
• Crypto & Web3 — kutana na mahitaji ya usajili wa VASP na uthibitisho wa utambulisho wa chanzo chenye mamlaka.
• Kukopesha — punguza utambulisho bandia na ulaghai wa mtu wa kwanza kwa data iliyothibitishwa na chanzo.
• Masoko & majukwaa ya kazi za muda — thibitisha watumiaji dhidi ya data yenye mamlaka, sio tu fomu iliyoripotiwa na wao wenyewe.
• iGaming — kamilisha ukaguzi wa utambulisho na ustahiki kwa wachezaji wa Venezuela na njia inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha Uhakiki wa Cédula ya Venezuela kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Katika Dashibodi ya Biashara ya Didit, fungua Mjenzi wa Mtiririko wa Kazi, ongeza moduli ya Uthibitisho wa Hifadhidata, chagua Venezuela → Uhakiki wa Cédula ya Venezuela, na uamilishe. Watumiaji wanaolingana huendeshwa kiotomatiki — hakuna uhandisi unaohitajika.
2. API ya moja kwa moja. Piga sehemu ya mwisho ya /v3/database-validation/ iliyoonyeshwa hapo juu na services=ven_cedula. Soma match_type na kizuizi cha validation cha kila sehemu ili kuendesha mantiki yako ya kuidhinisha / kukagua / kukataa.

Kila akaunti ya Didit inajumuisha uthibitisho 500 bila malipo kwa mwezi, ili uweze kujaribu mtiririko kamili kutoka mwanzo hadi mwisho kabla ya kulipia swali hata moja.

Maswali yanayoulizwa mara kwa mara

Uhakiki wa Cédula ya Venezuela unathibitisha nini?

Inathibitisha data iliyowasilishwa dhidi ya sajili rasmi ya utambulisho ya serikali ya nchi na inarudisha matokeo ya ulinganifu yaliyorekebishwa, ili ujue kama Kitambulisho cha kitaifa kipo kwenye chanzo chenye mamlaka na ni sehemu zipi zilizolingana.

Nini kinatokea ikiwa chanzo hakipatikani kwa muda?

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

Hundi ni ya haraka kiasi gani?

Uthibitisho wa hifadhidata kwa kawaida hurudi kwa sekunde chache, kwa hivyo unatosha ndani ya mtiririko wa usajili wa wakati halisi.

Je, ninahitaji SDK?

Hapana. Hundi ni HTTPS POST moja kwa sehemu moja ya mwisho. Unaweza pia kuiunganisha kwenye mtiririko wa kazi usio na msimbo katika Dashibodi ya Biashara.

Uko tayari kuanza?

Thibitisha Kitambulisho chako cha kwanza cha Venezuela leo.

• Soma marejeleo ya API: Uhakiki wa Cédula ya Venezuela
• Angalia uthibitisho wote wa hifadhidata: Bei na utangazaji wa Uthibitisho wa Hifadhidata
• Anza kujenga: Fungua akaunti ya Didit bila malipo — uthibitisho 500 kwa mwezi, bure.