Uthibitishaji wa Hali ya CPF ya Brazil Kupitia API (SW)

Kuingiza watumiaji nchini Brazil kunamaanisha kuthibitisha kuwa wao ndio wanajidai kuwa. Hurejesha hali ya CPF (kawaida, iliyosimamishwa, iliyofutwa), jina na tarehe ya kuzaliwa kutoka Receita Federal kupitia SERPRO. Hati au maelezo yaliyochapishwa yanaonyesha tu kuwa data ipo — si kwamba ni halisi au inamhusu mtu aliye mbele yako. Uthibitishaji wa hali ya CPF ya Brazil huziba pengo hilo kwa kuangalia data dhidi ya mamlaka ya kodi ya kitaifa. Mwongozo huu unaelezea nini ukaguzi hufanya, maelezo kamili ya kiufundi, na jinsi ya kuiunganisha kwa dakika chache.

Mambo muhimu ya kuzingatia:

• Inachokagua — Uthibitishaji wa hali ya CPF ya Brazil huthibitisha kitambulisho cha kodi dhidi ya mamlaka ya kodi ya kitaifa.
• Unachopata — match_type iliyorekebishwa pamoja na matokeo ya kiwango cha uga ambayo unaweza kuyaelekeza moja kwa moja kwenye mantiki ya kuidhinisha / kukagua / kukataa.
• Kwa nini ni muhimu — Uthibitishaji wa Kitambulisho cha Kodi unamfunga mwombaji kwa utambulisho wa kifedha unaoweza kuthibitishwa, ukipunguza ulaghai wa utambulisho bandia na wa wahusika wa kwanza.
• 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.20 kwa swala lenye uhakika, matokeo kwa sekunde.

Nini Uthibitishaji wa hali ya CPF ya Brazil huthibitisha

Hurejesha hali ya CPF (kawaida, iliyosimamishwa, iliyofutwa), jina na tarehe ya kuzaliwa kutoka Receita Federal kupitia SERPRO. Didit inaifichua kupitia eneo moja la mwisho ili uweze kuthibitisha data iliyowasilishwa dhidi ya mamlaka ya kodi ya kitaifa na kupokea matokeo yaliyopangwa, yaliyorekebishwa — si takataka ghafi ya rejista unayopaswa kuchambua mwenyewe.

Majibu yenye uhakika hurejesha source_data iliyolingana na kizuizi cha validation cha kiwango cha uga, ili injini yako ya hatari ipate uamuzi wazi, unaoweza kusomwa na mashine.

Kwa nini ni muhimu

Uthibitishaji wa Kitambulisho cha Kodi unamfunga mwombaji kwa utambulisho wa kifedha unaoweza kuthibitishwa, ukipunguza ulaghai wa utambulisho bandia na wa wahusika wa kwanza.

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

Maelezo ya kiufundi

Didit inatoa huduma hii kupitia eneo la mwisho la uthibitishaji wa hifadhidata. 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 BRA.
services	string	Ndiyo	Kitambulisho cha huduma. Tumia bra_cpf.
tax_number	string	Ndiyo	Namba ya kodi.
first_name	string	Hapana	Jina la kwanza (ukaguzi wa hiari).
last_name	string	Hapana	Jina la mwisho (ukaguzi wa hiari).
date_of_birth	string	Hapana	Tarehe ya kuzaliwa (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=BRA" \
  -F "services=bra_cpf" \
  -F "tax_number=1111111"

Mfano wa majibu (ulinganifu kamili)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_cpf",
      "service_name": "Brazil - CPF status check",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "lgpd_minor": "sample_value",
        "minor_under_16": "sample_value",
        "minor_under_18": "sample_value"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Utendaji na malipo

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

Matumizi

• Fintech na benki mpya — thibitisha mmiliki halisi, anayeweza kuthibitishwa wa akaunti kabla ya kufungua mkoba au kutoa mkopo nchini Brazil.
• Crypto & Web3 — kutimiza mahitaji ya kuingiza VASP na uthibitisho wa utambulisho wa chanzo chenye mamlaka.
• Kukopesha — punguza ulaghai wa utambulisho bandia na wa wahusika wa kwanza na data iliyothibitishwa na chanzo.
• Masoko na mifumo ya kazi za muda mfupi — thibitisha watumiaji dhidi ya data yenye mamlaka, si tu fomu iliyoripotiwa mwenyewe.
• iGaming — timiza ukaguzi wa utambulisho na ustahiki kwa wachezaji wa Brazil na rekodi inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha Uthibitishaji wa hali ya CPF ya Brazil kwa njia mbili:

1. Mtiririko wa kazi usio na msimbo. Kwenye Didit Business Console, fungua Workflow Builder, ongeza moduli ya Database Validation, chagua Brazil → Brazil CPF status check Verification, na uiwashe. Watumiaji wanaolingana hupelekwa kiotomatiki — hakuna uhandisi unaohitajika.
2. API ya moja kwa moja. Piga eneo la mwisho la /v3/database-validation/ lililoonyeshwa hapo juu na services=bra_cpf. Soma match_type na kizuizi cha validation cha kiwango cha 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 kutoka mwanzo hadi mwisho kabla ya kulipia swala moja.

Maswali yanayoulizwa mara kwa mara

Ukaguzi wa Uthibitishaji wa hali ya CPF ya Brazil unathibitisha nini?

Inathibitisha data iliyowasilishwa dhidi ya mamlaka ya kodi ya kitaifa na kurejesha matokeo ya ulinganifu yaliyorekebishwa, kwa hivyo unajua kama kitambulisho cha kodi kipo kwenye chanzo chenye mamlaka na ni sehemu gani zilizolingana.

Nini kinatokea ikiwa chanzo hakipatikani kwa muda?

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

Ukaguzi ni wa haraka kiasi gani?

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

Ninahitaji SDK?

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

Tayari kuanza?

Thibitisha kitambulisho chako cha kwanza cha kodi cha Brazil leo.

• Soma rejeleo la API: Uthibitishaji wa hali ya CPF ya Brazil
• 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.