Uthibitishaji wa Ofisi za Makampuni New Zealand Kupitia API (SW)

Kuingiza watumiaji New Zealand kunamaanisha kuthibitisha kuwa wao ndio wanavyojidai kuwa. Inathibitisha data iliyoingizwa dhidi ya huduma ya Usajili wa Wakurugenzi na Wanahisa. Hati au maelezo yaliyoandikwa huonyesha tu kuwa data ipo — si kwamba ni halisi au inamhusu mtu uliyemwona. Uthibitishaji wa Ofisi za Makampuni New Zealand hufunga pengo hilo kwa kuangalia data dhidi ya mamlaka ya kitaifa ya kodi. Mwongozo huu unaeleza nini ukaguzi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuiunganisha kwa dakika chache.

Mambo muhimu:

• Inachokagua — Uthibitishaji wa Ofisi za Makampuni New Zealand huthibitisha namba za utambulisho wa kodi dhidi ya mamlaka ya kitaifa ya kodi.
• 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 Kitambulisho cha Kodi huunganisha mwombaji na utambulisho halisi wa kifedha, kupunguza ulaghai wa utambulisho bandia na wa mtu wa kwanza.
• Jinsi ya kuitumia — POST moja kwa endpoint ya uthibitishaji wa hifadhidata ya Didit, au moduli ya mtiririko wa kazi isiyo na msimbo. $0.16 kwa kila hoja yenye uhakika, matokeo kwa sekunde.

Nini Uthibitishaji wa Ofisi za Makampuni New Zealand unathibitisha

Inathibitisha data iliyoingizwa dhidi ya huduma ya Usajili wa Wakurugenzi na Wanahisa. Didit huifichua kupitia endpoint moja ili uweze kuthibitisha data iliyowasilishwa dhidi ya mamlaka ya kitaifa ya kodi na kupokea matokeo yaliyopangwa, yaliyorekebishwa — si picha ghafi ya rejista unayopaswa kuchambua mwenyewe.

Majibu yenye uhakika hurejesha 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 Kitambulisho cha Kodi huunganisha mwombaji na utambulisho halisi wa kifedha, kupunguza ulaghai wa utambulisho bandia na wa mtu wa kwanza.

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

Maelezo ya kiufundi

Didit hufichua huduma hii kupitia endpoint ya uthibitishaji wa hifadhidata iliyounganishwa. Ni POST moja — hakuna SDK inayohitajika.

Endpoint

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 NZL.
services	string	Ndiyo	Kitambulisho cha Huduma. Tumia nzl_zealand_companies_office.
first_name	string	Ndiyo	Jina la kwanza.
last_name	string	Ndiyo	Jina la mwisho.
address	string	Ndiyo	Anuani.

Mfano wa ombi

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NZL" \
  -F "services=nzl_zealand_companies_office" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001"

Mfano wa majibu (ulinganifu kamili)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "NZL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nzl_zealand_companies_office",
      "service_name": "New Zealand Companies Office",
      "source_data": {
        "address": "123 Sample Street",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Utendaji na bili

• Ucheleweshaji: kwa kawaida sekunde chache.
• Gharama: $0.16 kwa kila hoja yenye uhakika. Unatozwa tu kwa matokeo yenye uhakika — hakuna malipo kwa kukosekana kwa chanzo, sehemu zinazokosekana, au kukataliwa kabla ya chanzo.
• Kuegemea: inaendeshwa kwenye miundombinu ya Didit kwa lengo la 99.9% ya muda wa kufanya kazi kila robo mwaka.

Matumizi

• Fintech & neobanks — thibitisha mmiliki halisi wa akaunti anayeweza kuthibitishwa kabla ya kufungua mkoba au kutoa mkopo New Zealand.
• Crypto & Web3 — kutana na mahitaji ya kuingiza VASP na uthibitisho wa utambulisho kutoka chanzo chenye mamlaka.
• Ukopeshaji — punguza ulaghai wa utambulisho bandia na wa mtu wa kwanza na data iliyothibitishwa kutoka chanzo.
• Masoko & majukwaa ya gig — thibitisha watumiaji dhidi ya data yenye mamlaka, si tu fomu iliyojiripoti.
• iGaming — kamilisha ukaguzi wa utambulisho na ustahiki kwa wachezaji wa New Zealand na rekodi inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kutumia Uthibitishaji wa Ofisi za Makampuni New Zealand kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Katika Didit Business Console, fungua Workflow Builder, ongeza moduli ya Database Validation, chagua New Zealand → New Zealand Companies Office Verification, na uiwashe. Watumiaji wanaolingana huelekezwa kiotomatiki — hakuna uhandisi unaohitajika.
2. API ya moja kwa moja. Piga endpoint /v3/database-validation/ iliyoonyeshwa hapo juu na services=nzl_zealand_companies_office. 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 hoja moja.

Maswali yanayoulizwa mara kwa mara

Uthibitishaji wa Ofisi za Makampuni New Zealand unathibitisha nini?

Inathibitisha data iliyowasilishwa dhidi ya mamlaka ya kitaifa ya kodi na kurejesha matokeo ya ulinganifu yaliyorekebishwa, kwa hivyo unajifunza kama namba ya utambulisho wa kodi ipo kwenye chanzo chenye mamlaka na ni sehemu gani zilizolingana.

Nini kinatokea ikiwa chanzo hakipatikani kwa muda?

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

Ukaguzi una kasi gani?

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

Je, ninahitaji SDK?

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

Uko tayari kuanza?

Thibitisha namba yako ya kwanza ya utambulisho wa kodi ya New Zealand leo.

• Soma rejeleo la API: Uthibitishaji wa Ofisi za Makampuni New Zealand
• 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.