> ## 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.

# Berbagi KYC via API: KYC yang Dapat Digunakan Kembali

> Didit memungkinkan berbagi data verifikasi antar-mitra via API secara aman, meniadakan KYC berulang dengan token berbagi berumur pendek.

## Cara Kerja

Misalkan pengguna `A` telah lolos Verifikasi Pengguna di `Service X` dan sekarang mendaftar di mitra `Service Y`. Jika `Service X` setuju untuk membagikan informasi tentang `A` dengan `Service Y`, hal ini dapat dilakukan sebagai berikut:

1. **Buat Token Berbagi (`Service X`)**: `Service X` memanggil API untuk membuat `share_token` yang aman dan berumur pendek untuk sesi verifikasi pengguna tertentu. Token ini ditujukan untuk digunakan oleh `Service Y` saja. Lihat Referensi API: [Share Session API](https://docs.didit.me/id/sessions-api/share-session/share.md).

2. **Kirim Token ke Mitra (`Service X` -> `Service Y`)**: `Service X` mentransmisikan `share_token` yang dibuat secara aman ke `Service Y` melalui saluran backend yang telah diatur sebelumnya.

3. **Impor Sesi (`Service Y`)**: `Service Y` menggunakan `share_token` yang diterima untuk memanggil API guna mengimpor data pengguna. Ini membuat salinan lengkap dari sesi verifikasi, termasuk semua dokumen dan pemeriksaan, di dalam lingkungan milik `Service Y`. Lihat Referensi API: [Import Shared Session API](https://docs.didit.me/id/sessions-api/share-session/import.md).

### Opsi Impor

Saat mengimpor sesi, `Service Y` memiliki kendali atas cara menangani hasilnya:

* **`trust_review`**: Parameter boolean ini menentukan apakah `Service Y` memercayai peninjauan dan status akhir (`Approved`/`Declined`) dari `Service X`.
  * `true`: Sesi disalin dengan status asli. Pengguna langsung menjalani onboarding (atau ditolak) di `Service Y`.
  * `false`: Data sesi disalin, tetapi statusnya secara otomatis diatur ke `In Review`. Hal ini memungkinkan `Service Y` untuk menggunakan dokumen dan data yang terkumpul namun tetap melakukan proses peninjauan internalnya sendiri untuk membuat keputusan akhir.
* **`workflow_id`**: `Service Y` harus menentukan alur kerja verifikasi miliknya yang mana yang akan dikaitkan dengan sesi yang diimpor.
* **`vendor_data`**: `Service Y` dapat menetapkan pengenal pengguna internal miliknya sendiri ke sesi yang diimpor.

### Pertimbangan Penting

* **Hanya Sesi yang Telah Selesai**: Token berbagi hanya dapat dibuat untuk sesi yang memiliki status selesai (`Approved`, `Declined`, `In Review`).
* **Tidak Ada Duplikat**: Sesi tertentu hanya dapat diimpor satu kali ke dalam aplikasi mitra tertentu. Upaya berikutnya akan ditolak.

***

## KYC yang Dapat Digunakan Kembali vs. Berbagi KYC via API

Meskipun kedua fitur ini memfasilitasi penggunaan kembali identitas, keduanya memiliki tujuan yang berbeda:

| Fitur | KYC yang Dapat Digunakan Kembali yang Dikendalikan Pengguna | Berbagi KYC via API (Berbagi B2B) |
| - | - | - |
| **Siapa yang memulai?** | Pengguna akhir, saat onboarding. | Bisnis, melalui panggilan API server-ke-server. |
| **Persetujuan** | Pengguna secara eksplisit memberikan persetujuan untuk membagikan data mereka di setiap penggunaan kembali. | Persetujuan biasanya diatur dalam ketentuan layanan antara pengguna dan bisnis awal. Perjanjian pembagian data yang jelas antar bisnis mitra diwajibkan. |
| **Alur Data** | Didit ID milik pengguna memfasilitasi pembagian data secara langsung dengan aplikasi baru. | `Service X` membagikan data dengan `Service Y` melalui token yang aman. |
| **Kasus Penggunaan** | Pengguna yang ingin mendaftar dengan cepat ke berbagai layanan yang tidak saling terkait. | Ekosistem mitra, grup layanan keuangan, atau konglomerat di mana identitas pengguna perlu dapat dipindahkan ke berbagai platform terkait. |

***

> ## ❗️ Penting: Pembatasan Pembagian Data
>
> Membagikan data pribadi pengguna antar organisasi yang berbeda tunduk pada persyaratan hukum dan regulasi yang ketat. Sebelum menggunakan fitur ini, organisasi Anda bertanggung jawab untuk memastikan Anda sepenuhnya mematuhi semua undang-undang perlindungan data yang berlaku, seperti GDPR di Uni Eropa dan UK GDPR di Britania Raya.
>
> Anda harus:
>
> 1. **Menetapkan Dasar Hukum**: Pastikan Anda memiliki dasar hukum yang sah untuk membagikan data. Hal ini sering kali memerlukan perjanjian pembagian data yang jelas antara Anda dan organisasi mitra Anda.
> 2. **Memastikan Persetujuan Pengguna**: Pastikan bahwa pengguna Anda telah diberi tahu dengan benar dan telah menyetujui agar data mereka dibagikan kepada mitra Anda, sebagaimana diuraikan dalam ketentuan layanan dan kebijakan privasi Anda.
> 3. **Menangani Transfer Internasional dengan Tepat**: Jika data ditransfer lintas batas (misalnya, dari UE ke negara non-UE), Anda harus memastikan perlindungan yang sesuai telah diterapkan sebagaimana diwajibkan oleh hukum.
>
> Didit menyediakan kemampuan teknis untuk pembagian data, tetapi organisasi Anda dan mitra Anda semata-mata bertanggung jawab atas semua kewajiban hukum dan kepatuhan terkait data yang Anda bagikan. Kami sangat menyarankan untuk berkonsultasi dengan penasihat hukum Anda sebelum mengimplementasikan fitur ini.


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