> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# KYC yang Dapat Digunakan Kembali: Verifikasi Sekali

> Didit memungkinkan verifikasi sekali dan pakai kembali di berbagai aplikasi dengan aman. Pangkas friksi onboarding tanpa KYC berulang. Gratis.

KYC yang Dapat Digunakan Kembali memungkinkan pengguna memverifikasi identitas mereka satu kali dan membagikan verifikasi tersebut secara aman ke berbagai aplikasi yang terintegrasi dengan Didit. Hal ini mengurangi hambatan onboarding sekaligus menjaga keamanan dan kepatuhan.

Prompt Integrasi KYC yang Dapat Digunakan Kembali
        Salin prompt ke papan klip



      
      

\<pre>

\````# Goal
Integrate Didit Reusable KYC — hand off a finished verification session from one Didit application to another without re-running the verification. Two endpoints: **share** on the source application, **import-shared** on the receiving application.

\# Delivery mode
Cross-application share flow. Both calls authenticate with each side's own application API key (`x-api-key`). Source session must already be in a finished status (Approved / Declined / In Review).

\# Step 1 — Mint a share token (source application)
POST https://verification.didit.me/v3/session/{sessionId}/share/
x-api-key: YOUR_API_KEY
Content-Type: application/json

\```bash
curl -X POST 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/share/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"for_application_id": "a5f3bca2-46e2-411e-90ef-a580900a57ee",
"ttl_in_seconds": 7200
}'
\```
Response: { share_token, for_application_id, session_kind: "user" | "business" }.

\`ttl_in_seconds` — min 60, max 86400 (24h), default 3600 (1h).

\# JWT payload (token contents)
The HS256-signed JWT carries:
\- `session_id` — UUID of the source session being shared.
\- `session_kind` — "user" (KYC) or "business" (KYB) — drives which related rows are cloned.
\- `from_application_id` — calling application UUID.
\- `for_application_id` — receiving application UUID — only this app can redeem.
\- `iat` / `exp` — issued-at and expiry epoch seconds.

The token is not idempotent (each call mints a fresh JWT) and cannot be revoked — it simply expires.

\# Step 2 — Redeem the token (receiving application)
POST https://verification.didit.me/v3/session/import-shared/

\```bash
curl -X POST 'https://verification.didit.me/v3/session/import-shared/' \
-H 'x-api-key: RECEIVING_APP_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"share_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"trust_review": false,
"workflow_id": "9f9b1234-aaaa-bbbb-cccc-1234567890ab",
"vendor_data": "user-1"
}'
\```
Required: share_token, trust_review, workflow_id (must exist on the receiving app). Optional: vendor_data (defaults to source).

\`trust_review`:
\- `true` — cloned session keeps the source status (Approved stays Approved).
\- `false` — cloned session is forced to "In Review" so your reviewers re-decide.

Response (201): the V3 decision payload for both kinds — KYC for user sessions, KYB for business sessions — the same shape as GET /v3/session/{sessionId}/decision/, discriminated by `session_kind`. The cloned session has a fresh session_id and `shared_from_session` pointing at the source for audit.

\# Failure modes to handle
\- 400 "Invalid share token." — malformed JWT / wrong signature.
\- 400 "Share token has expired." — past exp.
\- 400 "This token is not valid for this application." — JWT `for_application_id` doesn't match the receiving app.
\- 400 "Original session does not exist." — source session deleted between mint and redeem.
\- 403 "This session has already been shared with your application." — same token can only be redeemed once per receiving app. Mint a new token.
\- 404 "Workflow does not exist for this application." — `workflow_id` is from a different application.
\- Source status not finished — 400 "Only finished sessions (Approved, Declined, In Review) can be shared."

\# What gets cloned
\- session_kind="user": KYC, Face, Liveness, FaceMatch, AML, POA, Phone, Location, DatabaseValidation rows + activity log.
\- session_kind="business": KYBCompany, KYBKeyPeopleCheck, KYBDocument + shared feature rows (AML, Phone, Email, Location, QuestionnaireResponse) + activity log.

\# See also
\- Mint share token: /sessions-api/share-session
\- Redeem share token: /sessions-api/import-shared-session
\- Canonical decision schema: /reference/data-models#overview
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Tempel ke

Bab dari pelajaran KYB Didit Academy ini berlanjut pada verifikasi pihak dan penggunaan ulang sesi KYC.Dalam pelajaran KYB Academy, bab 7:04 menampilkan verifikasi pihak yang menggunakan ulang sesi KYC yang sudah ada alih-alih mewajibkan UBO memverifikasi dua kali.[Verifikasi pihak dan penggunaan ulang sesi KYC — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?start=424\&rel=0\&playsinline=1)## Cara kerja**1. Verifikasi awal**Pengguna menyelesaikan proses KYC standar (Verifikasi Identitas + pengenalan wajah). Data verifikasi dienkripsi dan disimpan di Didit ID pengguna, sesuai dengan eIDAS2.**2. Gunakan ulang di aplikasi baru**Saat pengguna mengakses aplikasi lain yang terintegrasi dengan Didit, mereka memilih opsi untuk menggunakan ulang KYC mereka yang sudah ada. Pemeriksaan pengenalan wajah singkat mengonfirmasi identitas mereka, dan mereka memberikan persetujuan untuk membagikan data tertentu.**3. Onboarding instan**Aplikasi baru menerima informasi KYC yang terverifikasi secara instan — tanpa unggah ulang dokumen, tanpa menunggu.## Manfaat Utama| Untuk Pengguna | Untuk Bisnis | Untuk Kepatuhan |
| - | - | - |
| Verifikasi sekali, gunakan di mana saja | Onboarding pengguna lebih cepat | Mempertahankan standar regulasi |
| Kendali atas pembagian data | Penurunan tingkat drop-off | Jejak audit lengkap |
| Hitungan detik, bukan menit | Tingkat konversi lebih tinggi | Dukungan lintas yurisdiksi |## Keamanan dan Kepatuhan| Area | Detail |
| - | - |
| **Enkripsi** | Enkripsi end-to-end untuk semua data yang disimpan dan ditransfer |
| **Autentikasi ulang biometrik** | Pengenalan wajah diwajibkan untuk setiap penggunaan ulang |
| **Regulasi** | Sesuai dengan eIDAS2, mendukung persyaratan AML/KYC |
| **Lintas batas** | Bekerja di berbagai yurisdiksi |![Alur KYC yang dapat digunakan kembali dari Didit memungkinkan pengguna terverifikasi membawa identitas ke berbagai layanan](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/reusable-kyc.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=12c89122aad772b3683a629343b6dabc)KYC yang Dapat Digunakan Kembali tersedia secara otomatis bagi pengguna yang telah menyelesaikan verifikasi awal. Pengguna dapat memilih untuk menggunakan kembali KYC mereka atau melakukan pemeriksaan baru kapan saja.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.