API ya Uthibitishaji wa Mtumiaji wa Marekani (SW)

Kuingiza watumiaji nchini Marekani kunamaanisha kuthibitisha kuwa wao ni wale wanaodai kuwa. Inathibitisha data ya kuingiza kwenye hifadhidata ya uzalishaji wa viongozi. Hati au maelezo yaliyoandikwa huonyesha tu kuwa data ipo — si kwamba ni halisi au inamhusu mtu aliye mbele yako. Uthibitishaji wa Mtumiaji wa Marekani huziba pengo hilo kwa kuangalia data dhidi ya vyanzo vya data vya makazi na watumiaji vilivyoidhinishwa. Mwongozo huu unaeleza nini ukaguzi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuunganisha kwa dakika chache.

Mambo muhimu:

• Inachokagua — Uthibitishaji wa Mtumiaji wa Marekani unathibitisha anwani na data ya makazi dhidi ya vyanzo vya data vya makazi na watumiaji vilivyoidhinishwa.
• Unachopata — match_type iliyorekebishwa pamoja na matokeo ya kiwango cha uga ambayo unaweza kuelekeza moja kwa moja kwenye mantiki ya kuidhinisha / kukagua / kukataa.
• Kwa nini ni muhimu — Uthibitishaji wa anwani dhidi ya data yenye mamlaka unathibitisha kuwa mwombaji anaishi kweli mahali anapodai — ishara muhimu ya kuzuia udanganyifu na kufuata sheria.
• Jinsi ya kuitumia — POST moja kwa eneo la mwisho la uthibitishaji wa hifadhidata la Didit, au moduli ya mtiririko wa kazi isiyo na msimbo. $0.08 kwa hoja ya uhakika, matokeo kwa sekunde.

Nini Uthibitishaji wa Mtumiaji wa Marekani unathibitisha

Inathibitisha data ya kuingiza kwenye hifadhidata ya uzalishaji wa viongozi. Didit inaiweka wazi kupitia eneo moja la mwisho ili uweze kuthibitisha data iliyowasilishwa dhidi ya vyanzo vya data vya makazi na watumiaji vilivyoidhinishwa na kupokea matokeo yaliyopangwa, yaliyorekebishwa — si utupaji wa sajili ghafi unayopaswa kuchambua mwenyewe.

Jibu la uhakika linarudisha 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 yenye mamlaka unathibitisha kuwa mwombaji anaishi kweli mahali anapodai — ishara muhimu ya kuzuia udanganyifu na kufuata sheria.

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

Maelezo ya kiufundi

Didit inatoa huduma hii kupitia eneo la mwisho la uthibitishaji wa hifadhidata lililounganishwa. Ni POST moja — hakuna SDK inayohitajika.

Eneo la 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 USA.
services	string	Ndiyo	Kitambulisho cha huduma. Tumia usa_states_consumer.
first_name	string	Ndiyo	Jina la kwanza.
last_name	string	Ndiyo	Jina la mwisho.
date_of_birth	string	Ndiyo	Tarehe ya kuzaliwa.
address	string	Hapana	Anwani (ukaguzi wa hiari).
phone	string	Hapana	Simu (ukaguzi wa hiari).
email	string	Hapana	Barua pepe (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=USA" \
  -F "services=usa_states_consumer" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01"

Mfano wa majibu (ulinganifu wa uhakika)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "USA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "usa_states_consumer",
      "service_name": "United States of America - United States Consumer",
      "source_data": {
        "address": "123 Sample Street",
        "address_match_score": "1.000",
        "city": "Sample City",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "postal_code": "10001",
        "state": "Sample State",
        "street": "sample_value",
        "verifications": {
          "address": true,
          "date_of_birth": true,
          "full_name": true
        }
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Utendaji na malipo

• Ucheleweshaji: kwa kawaida sekunde chache.
• Gharama: $0.08 kwa hoja ya uhakika. Unatozwa tu kwa matokeo ya 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 kila robo mwaka.

Matumizi

• Fintech na neobanks — thibitisha mmiliki halisi, anayeweza kuthibitishwa wa akaunti kabla ya kufungua pochi au kutoa mkopo nchini Marekani.
• Crypto & Web3 — kutimiza mahitaji ya kuingiza VASP na uthibitisho wa utambulisho wa chanzo chenye mamlaka.
• Ukopeshaji — punguza udanganyifu wa utambulisho bandia na wa wahusika wa kwanza na data iliyothibitishwa na chanzo.
• Masoko na mifumo ya gig — thibitisha watumiaji dhidi ya data yenye mamlaka, si tu fomu iliyoripotiwa na wao wenyewe.
• iGaming — kutimiza ukaguzi wa utambulisho na ustahiki kwa wachezaji wa Marekani na rekodi inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha Uthibitishaji wa Mtumiaji wa Marekani kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Katika Didit Business Console, fungua Workflow Builder, ongeza moduli ya Database Validation, chagua United States → United States Consumer Verification, na uiwashe. Watumiaji wanaolingana huelekezwa kiotomatiki — hakuna uhandisi unaohitajika.
2. API moja kwa moja. Piga eneo la mwisho la /v3/database-validation/ lililoonyeshwa hapo juu na services=usa_states_consumer. 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, kwa hivyo unaweza kujaribu mtiririko kamili kuanzia mwanzo hadi mwisho kabla ya kulipa kwa hoja moja.

Maswali yanayoulizwa mara kwa mara

Je, ukaguzi wa Uthibitishaji wa Mtumiaji wa Marekani unathibitisha nini?

Inathibitisha data iliyowasilishwa dhidi ya vyanzo vya data vya makazi na watumiaji vilivyoidhinishwa na kurejesha matokeo ya ulinganifu yaliyorekebishwa, kwa hivyo unajua kama anwani na data ya makazi ipo kwenye chanzo chenye mamlaka na ni sehemu gani zilizolingana.

Nini kinatokea ikiwa chanzo hakipatikani kwa muda?

Hutatozwa. Malipo yanatumika tu kwa matokeo ya uhakika — kukatika kwa chanzo, sehemu zinazokosekana, na kukataliwa kabla ya chanzo ni bure.

Je, ukaguzi ni wa haraka kiasi gani?

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

Je, ninahitaji SDK?

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

Uko tayari kuanza?

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

• Soma rejeleo la API: Uthibitishaji wa Mtumiaji wa Marekani
• Angalia uthibitishaji wote wa hifadhidata: Bei na utangazaji wa Uthibitishaji wa Hifadhidata
• Anza kujenga: Fungua akaunti ya Didit isiyolipishwa — uthibitishaji 500 kwa mwezi, bila malipo.