API ya Uthibitishaji wa DNI RENAPER: Thibitisha Vitambulisho vya Argentina kwa Wakati Halisi

Kuingiza watumiaji nchini Ajentina kunamaanisha kuamini DNI — Documento Nacional de Identidad ambayo kila mkazi hubeba. Lakini picha ya DNI inathibitisha tu kuwa hati ipo, siyo kwamba ni halisi au kwamba inamilikiwa na mtu anayeiwasilisha. Ili kuziba pengo hilo lazima uangalie nambari dhidi ya chanzo kilichoitoa: RENAPER. Mwongozo huu unaelezea nini uthibitishaji wa RENAPER hufanya, maelezo ya kiufundi ya sehemu ya mwisho ya Didit, na jinsi ya kuiunganisha kwa dakika.

Mambo muhimu ya kuzingatia:

• RENAPER ni nini — Rejista rasmi ya kiraia ya Ajentina (Registro Nacional de las Personas), chanzo chenye mamlaka cha ukweli kwa kila DNI ya Ajentina.
• Kile ambacho hundi hufanya — Didit inathibitisha nambari ya DNI dhidi ya RENAPER na kulinganisha uso wa kibayometriki wa selfie ya mtumiaji na picha ya serikali iliyosajiliwa.
• Kwa nini ni muhimu — hati inaweza kughushiwa; rekodi ya rejista haiwezi. Kuthibitisha dhidi ya RENAPER kunathibitisha kuwa mtu aliye nyuma ya kitambulisho ni halisi, yuko hai, na ni yule anayedai kuwa.
• Jinsi ya kuitumia — POST moja kwa sehemu ya mwisho ya uthibitishaji wa hifadhidata ya Didit, au kuweka moduli kwenye mtiririko wa kazi usio na msimbo. $0.20 kwa kila swali la uhakika, matokeo chini ya sekunde 2.

RENAPER ni nini?

RENAPER — Registro Nacional de las Personas — ni rejista ya kitaifa ya kiraia ya Ajentina, inayofanya kazi chini ya Wizara ya Mambo ya Ndani. Ni hifadhidata moja yenye mamlaka ya utambulisho wa kila raia na mkazi wa Ajentina: inatoa DNI, inatunza rekodi za kibayometriki na kibiolojia nyuma yake, na ni chanzo halali cha ukweli kwa utambulisho wa kiraia nchini.

Kwa sababu RENAPER inashikilia picha iliyosajiliwa na data ya kibinafsi iliyounganishwa na kila DNI, kuiuliza inakuwezesha kuthibitisha mambo mawili kwa wakati mmoja:

• DNI ni halisi na inafanya kazi — nambari ipo kwenye rejista na inaendana na mtu halisi.
• Mtu anayeiwasilisha ni mtu huyo — selfie yao ya moja kwa moja inalingana na picha ambayo RENAPER inayo kwenye faili.

Mchanganyiko huo — uthibitishaji wa rejista pamoja na kulinganisha uso wa kibayometriki — ni wenye nguvu zaidi kuliko kusoma hati kwa kutumia utambuzi wa herufi za macho (OCR) pekee.

Kile ambacho uthibitishaji wa RENAPER huangalia

Unapotuma DNI kwa huduma ya RENAPER ya Didit, jukwaa hufanya utafutaji wenye mamlaka na kulinganisha kibayometriki 1:1. Jibu la uhakika hurudisha source_data iliyopangiliwa moja kwa moja kutoka kwenye rejista, ambayo inaweza kujumuisha:

• full_name, first_name, last_name
• date_of_birth
• identification_number na tax_id
• face_match_score — kufanana kati ya selfie iliyowasilishwa na picha ya rejista

match_type ya kiwango cha juu (kwa mfano, full_match) na matokeo ya validation ya kila uga hukuambia ni sifa gani hasa zilizolingana, ili injini yako ya hatari iweze kufanya uamuzi badala ya kubahatisha.

Kwa nini uthibitishaji wa RENAPER ni muhimu

Kwa biashara yoyote inayounganisha watumiaji wa Ajentina — taasisi za kifedha, kubadilishana sarafu za kidijitali, programu za mikopo, masoko, waendeshaji wa kamari — DNI iliyogushiwa au kuibiwa ndiyo njia ya kawaida zaidi ya udanganyifu. Uchunguzi wa hati hugundua nakala mbaya; hazigundui kadi iliyochapishwa kikamilifu iliyounganishwa na kitambulisho kilichoibiwa. Uthibitishaji wa rejista hufanya hivyo, kwa sababu unajibu swali pekee muhimu: je, kitambulisho hiki kipo kwenye chanzo cha serikali, na je, mtu aliye hai mbele yetu ndiye mmiliki halali?

Hii pia ni kigezo cha kufuata kanuni. Wajibu wa AML na Mjue Mteja Wako (KYC) wa Ajentina — na matarajio ya UIF (Unidad de Información Financiera) — yanasukuma mashirika yaliyodhibitiwa kuelekea uthibitishaji wa chanzo chenye mamlaka. Kulinganisha dhidi ya RENAPER kunakupa rekodi inayoweza kutetewa na kukaguliwa kwamba kitambulisho kilithibitishwa kwenye rejista, siyo tu kuchanganuliwa.

Maelezo ya kiufundi

Didit inaonyesha RENAPER kupitia sehemu ya mwisho ya uthibitishaji wa hifadhidata iliyounganishwa. Ni ombi la POST moja — hakuna SDK inayohitajika.

Sehemu ya mwisho

POST https://verification.didit.me/v3/database-validation/

Vigezo vya ombi

Kigezo	Aina	Inahitajika	Maelezo
issuing_state	string	Ndiyo	Msimbo wa nchi wa ISO 3166-1 alpha-3. Tumia ARG.
services	string	Ndiyo	Kitambulisho cha huduma. Tumia arg_renaper.
document_number	string	Ndiyo	DNI ya Ajentina, tarakimu 7–8, bila nafasi au alama za uandishi.
selfie	faili	Ndiyo	Picha ya moja kwa moja ya mtumiaji, kwa kulinganisha uso wa kibayometriki.
gender	string	Ndiyo	Msimbo wa jinsia (k.m. M, F).
first_name	string	Hapana	Jina la kwanza, kwa uthibitishaji wa ziada.
last_name	string	Hapana	Jina la familia, kwa uthibitishaji wa ziada.

Mfano wa ombi

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ARG" \
  -F "services=arg_renaper" \
  -F "document_number=11111111" \
  -F "selfie=@./selfie.jpg" \
  -F "gender=M"

Mfano wa jibu (ulinganifu kamili)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ARG",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "arg_renaper",
      "service_name": "Argentina - Uthibitishaji wa DNI (RENAPER)",
      "source_data": {
        "full_name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "date_of_birth": "1990-01-01",
        "identification_number": "SAMPLE-ID-12345",
        "tax_id": "SAMPLE-12345",
        "face_match_score": "0.990"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Utendaji na bili

• Muda wa kusubiri: kwa kawaida chini ya sekunde 2 (p95).
• Gharama: $0.20 kwa kila swali la uhakika. Unatozwa tu kwa matokeo ya uhakika — hakuna malipo kwa kukatika kwa rejista, sehemu zinazokosekana, au kukataliwa kabla ya chanzo.
• Kuegemea: 99.9% upatikanaji wa robo mwaka kwenye miundombinu ya Didit.

Matumizi

• Fintech & neobanks — thibitisha mwenye akaunti halisi, aliye hai kabla ya kufungua pochi au kutoa mkopo nchini Ajentina.
• Crypto & Web3 — timiza mahitaji ya kuingiza VASP na uthibitisho wa kitambulisho cha chanzo chenye mamlaka pamoja na kufungamana kibayometriki.
• Mikopo — unganisha rekodi ya RENAPER na tax_id iliyorudishwa ili kupunguza utambulisho bandia na udanganyifu wa wahusika wa kwanza.
• Masoko & majukwaa ya kazi za muda — thibitisha wauzaji, madereva, na wasafirishaji dhidi ya rejista, siyo tu picha ya kadi.
• iGaming — timiza hundi za umri na kitambulisho kwa wachezaji wa Ajentina kwa njia inayoweza kutetewa ya ukaguzi.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha uthibitishaji wa RENAPER kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Katika Didit Business Console, fungua Workflow Builder, ongeza moduli ya Database Validation, chagua Argentina → RENAPER (arg_renaper), na uiwashe. Watumiaji wa Ajentina wanaelekezwa kwenye hundi kiotomatiki — hakuna uhandisi unaohitajika.
2. API ya moja kwa moja. Piga sehemu ya mwisho ya /v3/database-validation/ iliyoonyeshwa hapo juu na services=arg_renaper. Soma match_type na kizuizi cha validation cha kila uga ili kuendesha mantiki yako ya kuidhinisha / kukagua / kukataa.

Njia yoyote hurudisha matokeo yaliyopangiliwa sawa, kwa hivyo unaweza kuanza katika jengo lisilo na msimbo na kuhamia API baadaye bila kubadilisha mfumo wako wa data. Kila akaunti ya Didit inajumuisha uthibitishaji 500 wa bure kwa mwezi, kwa hivyo unaweza kujaribu mtiririko kamili wa RENAPER kuanzia mwanzo hadi mwisho kabla ya kulipia swali moja.

Maswali yanayoulizwa mara kwa mara

Je, picha ya DNI inalinganishwa na selfie ya mtumiaji?

Ndiyo. Uthibitishaji wa RENAPER unajumuisha kulinganisha uso wa kibayometriki 1:1 kati ya selfie iliyowasilishwa na picha ambayo RENAPER inayo kwenye faili, iliyorudishwa kama face_match_score.

Nini kinatokea ikiwa RENAPER haipatikani kwa muda?

Haulipishwi. Bili inatumika tu kwa matokeo ya uhakika; kukatika kwa rejista, sehemu zinazokosekana, na kukataliwa kabla ya chanzo ni bure.

Uthibitishaji wa RENAPER ni wa haraka kiasi gani?

Kwa kawaida chini ya sekunde mbili kwa p95, kwa hivyo inafaa ndani ya mtiririko wa kuingiza watumiaji kwa wakati halisi bila kuongeza msuguano.

Je, ninahitaji SDK?

Hapana. Uthibitishaji wa RENAPER ni HTTPS POST moja. Unaweza pia kuiunganisha kwenye mtiririko wa kazi usio na msimbo katika Business Console ikiwa unapendelea uhandisi sifuri.

Uko tayari kuanza?

Thibitisha DNI yako ya kwanza ya Ajentina dhidi ya RENAPER leo.

• Soma marejeleo ya API: Uthibitishaji wa DNI RENAPER
• 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.