Wakala wako wa AI anaweza kuendesha KYC. Kwa amri moja.
Sakinisha Ujuzi kumi na mbili wa Wakala wa chanzo huria wa Didit kwenye Cursor, Claude Code, Codex, au OpenCode kwa amri moja ya `npx`. Uliza wakala kwa Kiingereza rahisi. Inaandika code na kupiga API halisi.
Mpe Cursor kichupo cha nyaraka na inabuni endpoints na inabadilisha status
enums kuwa herufi ndogo. Mpe ujuzi wa Didit na kila mstari unaelekeza kwenye API halisi, endpoint iliyofungwa,
headers zilizofungwa, scaffold ya handler ya webhook iliyosainiwa. Amri moja ya `npx`.
Jinsi inavyofanya kazi
Kutoka npx install hadi mtumiaji aliyethibitishwa kwa hatua nne.
Hatua 01
Sakinisha ujuzi
Endesha `npx skills add didit-protocol/skills` kwenye mradi wako. CLI inagundua Cursor, Claude Code, Codex, au OpenCode na kuweka kila ujuzi kwenye folda sahihi. Sakinisha moja tu na `--skill didit-face-match`.
Hatua 02
Pata API key
Ama pata moja kwa sekunde 60 kwenye [business.didit.me](https://business.didit.me) na `export DIDIT_API_KEY=…`, au ruhusu wakala kujisajili yenyewe kwa programu, `POST /programmatic/register/` ikifuatiwa na `verify-email/`, na key inarudi kwenye jibu. Hakuna kivinjari kinachohitajika.
Hatua 03
Uliza kwa Kiingereza rahisi
*“Ongeza Didit KYC kwenye mtiririko wangu wa kujisajili.”* *“Chunguza mtumiaji huyu dhidi ya orodha za AML.”* Wakala anasoma ujuzi husika, anaandika code, na kuunganisha handler ya webhook iliyosainiwa. Sahihi mara ya kwanza, hakuna kubadilisha tab ya nyaraka.
Hatua 04
Mtumiaji anathibitisha
Didit inasimamia kamera, upigaji wa hati, selfie, uhamishaji wa simu. Chini ya sekunde 30 kwa mtumiaji. Uamuzi wa chini ya sekunde 2 kwenye webhook yako, iliyosainiwa na `X-Signature-V2` ili uweze kuamini.
Ujuzi unakupa nini
Ujuzi kumi na mbili. Hakuna "hallucinations" kabisa. Kila API ya Didit.
Kila ujuzi ni faili moja ya Markdown inayofunga endpoint, headers, umbo la body, na status enum. Chanzo huria. Imewekwa toleo na API.
Ujuzi kumi na mbili. Mmoja kwa kila uwezo wa Didit.
Ujuzi mkuu kwa akaunti, sessions, workflows, na bili (endpoints 45+) pamoja na ujuzi kumi na moja tofauti kwa ID, liveness, face match, face search, umri, AML, barua pepe, simu, uthibitisho wa anwani, na uthibitisho wa database.
didit-liveness-detection99.9% accurate selfie liveness
didit-face-matchCompare two faces, 0–100 score
didit-aml-screening1,300+ sanctions + PEP lists
didit-proof-of-addressOCR + geocoding
didit-database-validationGov databases · 18 countries
+ face-search, age, email, phone, 12 in total.
02 · Sakinisha
Amri moja ya npx. Imekamilika.
`npx skills add didit-protocol/skills` inasakinisha zote kumi na mbili. Ongeza `--skill didit-face-match` kuchagua moja. Unapendelea Git? `git clone` na nakili unachohitaji. Hupendi zana? Weka `SKILL.md` moja kwenye folda ya ujuzi ya agent wako.
Detects Cursor, Claude Code, Codex, OpenCode automatically.
03 · Hosts
Cursor, Claude Code, Codex, OpenCode.
Ujuzi uleule wa Markdown kila mahali. CLI inatambua kiotomatiki runtime yako na kuandika kwenye `.cursor/skills/` au `.claude/skills/`. Imejengwa kwenye kiwango huru cha [agentskills.io](https://agentskills.io), hakuna SDK ya muuzaji.
Inafunga endpoint halisi, headers halisi, status casing halisi, bei za moja kwa moja. Agent inaacha kubuni njia na kupunguza herufi za enums. Endpoints 51 hujaribiwa kila toleo.
`export DIDIT_API_KEY=…` na ujuzi umeunganishwa. Au ruhusu agent kujisajili yenyewe kupitia `POST /programmatic/register/` na kuchukua key bila kuacha terminal.
Versioned with the API · new endpoint, same-day skill.
Unganisha
Sakinisha ujuzi. Uliza wakala. Tuma.
Kushoto: usakinishaji. Kulia: cURL ambayo wakala anaandika mara tu ujuzi unapowekwa.
npx skills addSakinisha
$ npx skills add didit-protocol/skills✓ Ujuzi 12 umesakinishwa# or just one$ npx skills add didit-protocol/skills \
--skill didit-face-match# set the api key$ export DIDIT_API_KEY="sk_live_..."
OKTayariCursor, Claude Code, Codex, OpenCode imetambuliwa kiotomatiki.
Sakinisha Didit Agent Skills zote 12 kwa prompt moja.
Bandika kwenye Cursor, Claude Code, Codex, au OpenCode. Wakala husakinisha ujuzi, huweka mazingira, huunda kiolezo cha kuunda kipindi + kishughulikiaji cha webhook kilichotiwa saini, na hujaribu dhidi ya API hai.
didit-integration-prompt.md
You are installing the Didit Agent Skills into this project and wiring the first verification session against the live https://verification.didit.me/v3/ API. After this prompt, the project should pass identity verification — Know Your Customer (KYC), Anti-Money Laundering (AML) screening, document Optical Character Recognition (OCR) — through Didit.
Didit ships twelve open-source Agent Skills at https://github.com/didit-protocol/skills and follows the open standard at https://agentskills.io. The CLI auto-detects whether you are running inside Cursor, Claude Code, Codex, or OpenCode and drops the skills into the right folder.
PRE-REQUISITES
- A Didit API key (DIDIT_API_KEY). Either issued from https://business.didit.me, or self-registered by the agent via POST /programmatic/register/ + POST /programmatic/verify-email/ (no browser needed).
- A workflow_id from the Workflow Builder that bundles ID Verification + Passive Liveness + Face Match + IP Analysis + AML — or just use the didit-kyc-onboarding skill below to create one programmatically.
- A webhook endpoint that verifies the X-Signature-V2 header with HMAC-SHA256 on the raw body bytes (do NOT re-serialise the parsed JSON; the signature will not match).
STEP 1 — Install the skills
Recommended:
npx skills add didit-protocol/skills
This installs all twelve skills. To install only one:
npx skills add didit-protocol/skills --skill didit-face-match
Or git clone the repo and copy what you need:
git clone https://github.com/didit-protocol/skills.git
cp -r skills/didit-kyc-onboarding .claude/skills/
cp -r skills/didit-id-document-verification .claude/skills/
The twelve skills:
- didit-verification-management : the hub. Account, sessions, workflows, billing, blocklist, webhook config. 45+ endpoints
- didit-kyc-onboarding : full KYC recipe (ID + selfie + face match) in one call
- didit-id-document-verification : passports, ID cards, driver's licences. OCR, MRZ, NFC. 4,000+ documents, 220+ countries
- didit-liveness-detection : 99.9%-accurate liveness from a single selfie
- didit-face-match : compare two faces, get a 0–100 score
- didit-face-search : 1:N face search for deduplication and blocklists
- didit-biometric-age-estimation : estimate age from a selfie
- didit-email-verification : email OTP, detects breached / disposable / undeliverable
- didit-phone-verification : phone OTP via SMS, WhatsApp, or Telegram. Catches VoIP
- didit-aml-screening : 1,300+ sanctions, PEP, adverse-media lists. Dual-score risk
- didit-proof-of-address : utility bills, bank statements. OCR + geocoding
- didit-database-validation : government databases across 18 countries
STEP 2 — Set the environment
Every skill reads DIDIT_API_KEY. Session-based skills also expect DIDIT_WORKFLOW_ID. Signed-webhook handlers expect DIDIT_WEBHOOK_SECRET.
export DIDIT_API_KEY="<your api key>"
export DIDIT_WORKFLOW_ID="<your workflow id>" # optional
export DIDIT_WEBHOOK_SECRET="<your secret>" # optional
Programmatic alternative (no browser):
curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
-H "Content-Type: application/json" \
-d '{"email": "dev@example.com", "password": "MyStr0ng!Pass"}'
# check the email, get the 6-char code, then:
curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \
-H "Content-Type: application/json" \
-d '{"email": "dev@example.com", "code": "<code>"}'
# response includes api_key — export it as DIDIT_API_KEY.
STEP 3 — Create a verification session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: $DIDIT_API_KEY
Content-Type: application/json
Body:
{
"workflow_id": "$DIDIT_WORKFLOW_ID",
"vendor_data": "<your user id, max 256 chars>",
"callback_url": "https://<your-app>/kyc/callback",
"metadata": { "source": "agent-skill" }
}
Response: 201 Created. The hosted session URL is on the `url` field. Redirect the user, or send them the link by email / SMS / WhatsApp. Sub-2-second p99 verdict on completion.
STEP 4 — Read the signed webhook
Didit POSTs to your callback. KYC session statuses are Title Case With Spaces.
Body (excerpted):
{
"session_id": "<uuid>",
"vendor_data": "<your user id>",
"status": "Approved",
"id_verification": { "status": "Approved" },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.94 },
"aml": { "status": "Approved", "hits": [] }
}
Full enum:
Approved | Declined | In Review | In Progress | Not Started | Abandoned | Expired | Resubmitted | Awaiting User | Not Finished
Verify X-Signature-V2 BEFORE parsing the body — HMAC-SHA256 of the raw bytes with your webhook secret. Re-serialising the parsed body changes whitespace and key order and the signature will not match.
STEP 5 — Read the decision on demand
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: $DIDIT_API_KEY
Returns the full decision payload — id_verification, liveness, face, ip_analysis, aml. Use this whenever the agent needs to confirm the user's status before allowing an action. Never trust client-supplied "I'm verified" flags.
STEP 6 — Branch on status
Approved → continue
Declined → block, surface decision_reason_code, allow resubmit of the failed step
In Review → wait for the analyst webhook; don't block forever
Resubmitted → user re-took a failed step; new verdict is coming
Awaiting User → user hasn't completed the flow; nudge with a reminder
Expired → create a new session
Abandoned and Declined sessions are NOT billed.
STEP 7 — Optional: ongoing AML monitoring
If AML monitoring is enabled on the workflow ($0.07 per user per year), Didit fires status.updated whenever the user lands on a new sanctions / PEP / adverse-media list. No extra endpoint to call.
WEBHOOK EVENT NAMES
- status.updated : KYC or KYB session status changed
- data.updated : session data corrected after creation
- user.status.updated : User entity changed status (Active, Flagged, Blocked)
- user.data.updated : User entity counters, metadata, or aggregate fields changed
- activity.created : timeline activity recorded
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox is separate from production.
CONSTRAINTS
- KYC session statuses use Title Case With Spaces (Approved, In Review). Do NOT transform them to UPPER_SNAKE_CASE — that casing is for Know Your Business (KYB) sessions and Transaction Monitoring, not KYC.
- HMAC verification runs against the RAW request body bytes. Never re-serialise the parsed JSON.
- Bundle price is $0.30 (ID + Liveness + Face Match + IP Analysis). AML adds $0.20. 500 verifications free every month, forever.
- Default record retention is unlimited unless you configure it shorter (30 days to 10 years per application).
Read the docs:
- https://docs.didit.me/getting-started/agent-skills
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/integration/webhooks
Skills repo:
- https://github.com/didit-protocol/skills
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.
Inatii kwa muundo
Fungua nchi mpya kwa kubofya mara moja. Tunafanya kazi ngumu.
Tunafungua kampuni tanzu za ndani, tunapata leseni, tunafanya majaribio ya kupenya, tunapata vyeti, na tunalingana na kila kanuni mpya. Ili kusafirisha uthibitishaji katika nchi mpya, geuza swichi. Nchi 220+ ziko hewani, zinakaguliwa na kupimwa kila robo mwaka, mtoa huduma pekee wa utambulisho ambaye serikali ya nchi mwanachama wa EU imemwita rasmi kuwa salama zaidi kuliko uthibitishaji wa ana kwa ana.
Open-source Agent Skills. Moja kwa kila uwezo wa Didit.
0
API endpoints zimefunikwa. Zote hujaribiwa kila toleo.
<0s
Uamuzi wa KYC wa mwisho hadi mwisho kwa kila session kwenye p99.
0
Uthibitishaji wa bure kila mwezi, kwenye kila akaunti.
Ngazi tatu, orodha moja ya bei
Anza bure. Lipa kulingana na matumizi. Panua hadi Enterprise.
Uthibitishaji 500 bila malipo kila mwezi, milele. Lipa kadri unavyotumia kwa uzalishaji. Mikataba maalum, uhifadhi wa data, na SLA (Service Level Agreements) kwenye Enterprise.
Bure
Bure
$0 / mwezi. Hakuna kadi ya mkopo inayohitajika.
Kifurushi cha bure cha KYC (Uthibitishaji wa Kitambulisho + Passive Liveness + Face Match + Uchambuzi wa Kifaa & IP), 500 / mwezi, kila mwezi
Watumiaji Waliozuiwa
Utambuzi wa Marudio
Ishara 200+ za udanganyifu kwenye kila session
KYC inayoweza kutumika tena kwenye mtandao wa Didit
Jukwaa la Usimamizi wa Kesi
Workflow Builder
Nyaraka za umma, sandbox, SDKs, server ya MCP (Model Context Protocol)