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

# Verifikasi Identitas saat Pendaftaran dan Verifikasi Ulang sebelum Pencairan Dana

> Dengan Didit, wajibkan Verifikasi Identitas sebelum akun dibuat dan verifikasi ulang sebelum pencairan dana, dengan klaim terverifikasi di token.

Identitas terverifikasi Autentikasi Didit meminta pengguna membuktikan siapa dirinya pada momen yang Anda pilih: sebelum akun mereka dibuat, dan lagi sebelum tindakan sensitif seperti penarikan dana.
Aplikasi Anda menerima hasilnya dan klaim terverifikasi yang Anda pilih, misalnya `over_18` atau nama terverifikasi, di dalam token pengguna, dan tidak pernah berupa dokumen atau foto mereka.

Atur melalui konsol di **Authentication > Verified identity**, atau melalui API dengan [`verified/`](#atur-melalui-api).

![Halaman Verified identity di Didit Business Console, dengan tingkat verifikasi pendaftaran beserta harganya, dan aturan verifikasi tambahan sebelum tindakan sensitif](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: pemeriksaan saat pendaftaran dan aturan sebelum tindakan sensitif.

## Cara kerjanya

Setiap pemeriksaan berjalan sebagai sesi verifikasi milik aplikasi Anda sendiri, yang dibuat dengan `vendor_data` pengguna.
Artinya, sesi tersebut muncul di daftar verifikasi Anda dan pada pengguna yang sama bersama login dan transaksinya, masuk ke peninjauan manual seperti verifikasi lainnya, dan ditagih sesuai harga verifikasi tersebut.

| Pemeriksaan | Yang dilakukan pengguna | Harga daftar |
| - | - | - |
| Liveness | Mengambil satu swafoto, yang diperiksa untuk mendeteksi liveness. | \$0.10 |
| Login swafoto | Mengambil swafoto yang dicocokkan Didit dengan wajah yang sudah tersimpan untuk pengguna tersebut. | \$0.10 |
| Full ID | Memindai dokumen identitas dan mengambil swafoto: dokumen, liveness, dan pencocokan wajah. | \$0.33 |

Didit menjalankan setiap pemeriksaan dengan alur kerja default-nya, atau dengan salah satu alur kerja Anda sendiri yang Anda pilih untuk pemeriksaan tersebut.
Lihat [harga](https://docs.didit.me/id/getting-started/pricing.md) untuk semua harga verifikasi.

## Saat pendaftaran

Pilih tingkat yang harus dilalui seseorang sebelum akunnya dibuat:

| Tingkat | Nilai | Arti |
| - | - | - |
| Tanpa verifikasi | `none` | Siapa pun dengan email, telepon, atau passkey dapat mendaftar. Ini nilai default. |
| Liveness | `liveness` | Orang sungguhan yang mendaftar: satu swafoto, diperiksa dengan Deteksi Liveness. |
| Full ID | `full_id` | Dokumen, Deteksi Liveness, dan Pencocokan Wajah, sebelum akun dibuat. |

Tingkat baru hanya berlaku bagi orang yang mendaftar setelah perubahan itu, dan tidak pernah berlaku untuk akun yang sudah ada.

Di halaman yang di-hosting, Didit mengarahkan pengguna melalui pemeriksaan selama pendaftaran. Di layar Anda sendiri, panggilan pendaftaran mengembalikan `verification_required` dengan `verification_url` yang berlaku selama 30 menit: arahkan pengguna ke sana. Didit hanya menerbitkan kode masuk setelah pemeriksaan disetujui.

## Step-up sebelum tindakan sensitif

Step-up meminta pengguna untuk memverifikasi ulang hanya ketika suatu tindakan cukup berisiko. Anda mengaktifkan aturannya, lalu aplikasi Anda menanyakan ke Didit sebelum setiap tindakan sensitif apakah ada aturan yang berlaku.

![Ponsel yang menampilkan step-up yang meminta pengguna mengonfirmasi identitasnya dengan swafoto](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

Tampilan yang dilihat pengguna saat step-up meminta swafoto.

| Aturan | Diminta saat | Pemeriksaan default |
| - | - | - |
| `payout` | Penarikan atau transfer melebihi ambang batas Anda, misalnya 500 dalam mata uang Anda. Pencairan dalam mata uang lain selalu diperiksa. | Login dengan swafoto |
| `device` | Pencairan dilakukan dalam sesi di perangkat yang tidak pernah dipakai pada sesi sebelumnya milik pengguna. | Login dengan swafoto |
| `bank` | Pengguna menambahkan atau mengubah rekening bank. | Verifikasi Identitas lengkap |
| `contact` | Pengguna mengubah alamat email atau nomor teleponnya. | Liveness |

Anda dapat mengubah pemeriksaan setiap aturan menjadi liveness, login dengan swafoto, atau Verifikasi Identitas lengkap.
Ketika beberapa aturan berlaku, Didit meminta pemeriksaan yang paling ketat.
Ketika Didit belum memiliki data wajah pengguna, login dengan swafoto berubah menjadi pemeriksaan Verifikasi Identitas lengkap.

### Meminta step-up

Aplikasi Anda memanggil `POST {issuer}/step-up/` dengan token akses pengguna, atau metode `stepUp()` dari SDK:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Kolom | Aturan |
| - | - |
| `action` | `payout`, `bank` atau `contact`. Pencairan juga menerapkan aturan `device`. |
| `amount` | Wajib untuk `payout`, dengan maksimal dua angka desimal. |
| `currency` | Kode ISO 4217. Defaultnya adalah mata uang dari aturan pencairan Anda. |
| `return_to` | Tujuan pengguna kembali setelah memverifikasi. Ketika suatu aturan berlaku, nilainya harus salah satu [URL redirect](https://docs.didit.me/id/authentication/overview.md#url-redirect) yang sudah Anda daftarkan. |

* `200 {"required": false}`: tidak ada aturan yang berlaku, jadi lanjutkan.
* `201` dengan `verification_url`: kirim pengguna ke sana. Step-up tetap terbuka selama 30 menit (`expires_in: 1800`).

### Membaca hasil di backend Anda

Pengguna kembali ke `return_to` dengan tambahan `step_up=<id>&status=approved`, tetapi query tersebut tidak membuktikan apa pun.
Backend Anda membaca step-up dengan `GET {issuer}/step-up/{step_up_id}/` dan token akses dari sesi yang sama, lalu hanya bertindak ketika `status` bernilai `approved`.

| Status | Arti |
| - | - |
| `pending` | Pengguna belum menyelesaikan pemeriksaan. |
| `approved` | Pengguna lulus. Lanjutkan tindakannya. |
| `review` | Pemeriksaan menunggu peninjauan dari tim Anda. |
| `declined` | Pengguna tidak lulus. Hasil ini belum final selama `verification_url` masih berfungsi: pengguna dapat mencoba lagi, dan step-up kembali ke `pending`. |
| `expired` | Waktu 30 menit sudah habis. Buat step-up baru. |
| `superseded` | Pemeriksaan lain mengambil alih, atau hasilnya bukan untuk step-up ini. Buat yang baru. |

Step-up tidak pernah bersifat fail-open: ketika verifikasi tidak tersedia, tindakan tetap diblokir.
[Panduan memulai cepat JavaScript](https://docs.didit.me/id/authentication/quickstarts/javascript.md#step-up-dan-autentikasi-ulang), [Next.js](https://docs.didit.me/id/authentication/quickstarts/nextjs.md#step-up-sebelum-tindakan-sensitif) dan [iOS](https://docs.didit.me/id/authentication/quickstarts/ios.md#langkah-tambahan-sebelum-tindakan-sensitif) menunjukkan sisi SDK, dan [Referensi API](https://docs.didit.me/id/authentication/api-reference/create-step-up.md) memuat kontrak lengkapnya.

## Yang diterima aplikasi Anda

Pilih klaim terverifikasi mana yang masuk ke token pengguna:

| Klaim | Nilai |
| - | - |
| `over_18`, `over_21` | Apakah orang tersebut berusia minimal 18 tahun, atau 21 tahun, berdasarkan tanggal lahir yang telah diverifikasi. |
| `given_name`, `family_name` | Nama depan dan nama belakang yang telah diverifikasi. |
| `birthdate` | Tanggal lahir dari dokumen, dalam format `YYYY-MM-DD`. |
| `nationality` | Kode ISO 3166-1 alpha-2. |
| `country` | Kode ISO 3166-1 alpha-2 dari negara dokumen. |
| `document_verified` | Apakah dokumen identitas telah diverifikasi. |
| `liveness` | Apakah pemeriksaan liveness telah lulus. |

Token akses dan token ID membawa klaim tersebut dalam `verified`, dengan `level`, yaitu tingkat tertinggi yang telah dilalui orang tersebut: `liveness`, `liveness_face_match`, atau `full_id`.
Nilainya `{}` jika orang tersebut belum melewati satu pun tingkat, dan `GET /session/` mengembalikan `null` sebagai gantinya.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Pemeriksaan yang disetujui selama sesi akan masuk ke token pada penyegaran berikutnya, dalam waktu 5 menit.
* Siapa pun yang memegang token dapat membaca klaim ini, termasuk frontend aplikasi Anda, jadi pilih hanya klaim pribadi yang benar-benar dibutuhkan aplikasi Anda.
* Aplikasi Anda hanya menerima klaim, bukan dokumen, swafoto, atau data wajah.

## Atur melalui API

`GET` dan `PATCH` pada `verified/` di [API manajemen autentikasi](https://docs.didit.me/id/authentication/set-up-by-api.md) aplikasi Anda membaca dan mengubah pengaturan yang sama dengan konsol:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Kolom | Nilai |
| - | - |
| `signup_level` | `none`, `liveness` atau `full_id`. |
| `rules` | Satu entri untuk setiap aturan yang Anda ubah: `rule` (`payout`, `device`, `bank` atau `contact`), `enabled`, `method` (`liveness`, `selfie` atau `full_id`), dan hanya untuk `payout`, `threshold` dan `currency`. |
| `claims` | Klaim yang akan dimasukkan ke dalam token, dari tabel di atas. |
| `workflows` | Opsional: ID alur kerja Anda sendiri untuk `liveness`, `selfie` atau `full_id`, atau `null` untuk default Didit. |

Aturan yang tidak Anda sertakan tetap menggunakan pengaturannya saat ini.


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