VERIFIKASI IDENTITAS
Verifikasi identitas terhosting, dengan keputusan tetap di tangan Anda
Arahkan pelanggan ke alur verifikasi terhosting. Baca status kasus di backend Anda sendiri dan teruskan pengecualian untuk ditinjau manusia.
Alur kerja dengan tata kelola, bukan putusan otomatis
Verifikasi identitas memberikan status kasus dan jalur peninjauan. Ini mendukung keputusan Anda, bukan mengambilnya.
Alur sesi
Sesi dibuat
Tautan sekali pakai dan waktu kedaluwarsa.
Tautan dibuka
Pelanggan membaca pemberitahuan privasi. Waktu untuk menyelesaikannya terbatas.
Status kasus
Pembacaan status atau peristiwa
Selesai, belum terverifikasi, atau perlu ditinjau. Perlakukan setiap status sebagai masukan untuk keputusan Anda sendiri.
Rencana cadangan yang perlu disiapkan
Kedaluwarsa
Tidak mengirim peristiwa. Baca status untuk mengetahuinya.
Dibatalkan
Baca status dari backend Anda.
Berakhir dengan kesalahan
Sesi dapat berakhir dengan kesalahan. Siapkan rencana cadangan.
Tautan verifikasi terhosting
Status kasus untuk keputusan Anda
Jalur tinjauan manusia
Notifikasi peristiwa
Dari sesi ke status kasus
Server
Buat sesi
Menggunakan referensi Anda sendiri untuk subjek. Anda menerima tautan sekali pakai dan waktu kedaluwarsa.
Noxtica
Pelanggan melanjutkan di halaman terhosting
Tautan sekali pakai
Pelanggan membaca pemberitahuan privasi, lalu memberikan bukti yang diminta dalam jangka waktu terbatas.
Server
Pembacaan status atau peristiwa
Status kasus
Baca status dari backend Anda atau terima peristiwa di endpoint Anda.
Konsol
Tinjauan manusia
Pengecualian
Kasus yang perlu diperiksa lebih lanjut akan diteruskan ke peninjauan operator. Aktivitas peninjauan dicatat dalam jejak audit.
Tim Anda
Keputusan Anda
Tim Anda yang mengambil keputusan.
Buat sesi
Pelanggan melanjutkan di halaman terhosting
Baca status dan tentukan keputusan
Apa itu dan untuk siapa
Verifikasi identitas Noxtica (KYC) adalah alur hosted. Server Anda membuat sesi, pelanggan Anda menyelesaikan langkah-langkahnya di halaman yang dihosting oleh Noxtica melalui browser mereka sendiri, lalu server Anda membaca hasilnya melalui pembacaan status atau peristiwa bertanda tangan. Server Anda tidak pernah menerima jawaban atau hasil pengambilan data pelanggan secara langsung.
Hasilnya berupa sinyal otomatis. Anda menentukan arti setiap hasil bagi pelanggan Anda. Noxtica memberikan bukti dan jejak audit kepada Anda.
Untuk siapa
- Engineer backend yang membuat sesi dan membaca hasil.
- Tim operasional dan kepatuhan yang menyiapkan halaman hosted dan menangani antrean tinjauan di Backoffice.
- Tim yang kebijakannya mewajibkan bukti identitas dan memiliki seseorang yang bertanggung jawab atas peninjauan.
Verifikasi bisnis dan merchant
Pendekatan hosted yang sama mencakup bisnis dan merchant. KYB (know your business) adalah onboarding bisnis hosted: perwakilan bisnis memasukkan informasi bisnis, mengunggah dokumen, menyatakan pemilik, meninjau lalu mengirimkan data, dan kasus yang dikirimkan masuk ke tinjauan manusia di Backoffice. Di sana, operator melihat bagan kepemilikan, dokumen, dan hasil penyaringan. KYM (know your merchant) adalah onboarding merchant hosted ditambah pemantauan transaksi yang hanya mengirimkan notifikasi: sebuah peringatan memberi tahu seseorang untuk meninjau dan tidak pernah memulai tindakan pembayaran. Tidak ada pemeriksaan otomatis terhadap registri bisnis yang dijelaskan. Hasilnya berupa sinyal dan operator Anda yang memutuskan. Tersedia. Diaktifkan untuk akun Anda atas permintaan.
Ketersediaan
Ketersediaan terbatas dan terkendali. Verifikasi identitas disediakan per tenant oleh tim akun Anda, dan Anda tidak dapat mengaktifkannya sendiri. Langkah yang disebut opsional hanya berlaku jika diaktifkan untuk organisasi Anda.
Alur terkelola dari awal hingga akhir
Berikut yang terjadi sejak panggilan API pertama hingga hasil diperoleh. Langkah bertanda opsional hanya berlaku jika diaktifkan untuk organisasi Anda.
Server Anda membuat sesi
Panggilan server membuat sesi dengan referensi pelanggan buram milik Anda. Respons berisi id sesi dan tautan sekali pakai.
Pelanggan menerima tautan
Arahkan pelanggan ke tautan melalui pengalihan, tab baru, email atau pesan, maupun kode QR. Halaman terkelola juga menyediakan kode QR dan opsi salin tautan, sehingga pelanggan yang memulai di komputer dapat melanjutkan di ponsel.
Pemberitahuan privasi dan persetujuan
Sebelum pengambilan data apa pun, pelanggan melihat nama bisnis Anda, tujuan verifikasi, dan tautan ke pemberitahuan privasi Anda, lalu menyetujui untuk melanjutkan.
Pilih dokumen, ambil gambar sisi depan dan belakang
Pelanggan memilih salah satu jenis dokumen yang Anda terima, lalu mengambil gambar sisi depan. Sisi belakang wajib diambil untuk kartu identitas, SIM, dan izin tinggal. Paspor tidak memiliki langkah sisi belakang.
Swafoto
Pelanggan mengambil swafoto. Swafoto dibandingkan dengan foto pada dokumen dan diperiksa kualitasnya.
Keaktifan
Pelanggan menyelesaikan tantangan keaktifan singkat di kamera: menolehkan kepala dan berkedip.
Peninjauan
Hasil pengambilan yang selesai menunggu di antrean peninjauan Backoffice Anda sampai seseorang di organisasi mencatat keputusan. Status sesi menjadi review pending dan tidak kedaluwarsa selama menunggu.
Hasil: status terbaca dan peristiwa bertanda tangan
Server Anda membaca status sesi dan dapat berlangganan ke peristiwa webhook bertanda tangan. Baca status sebelum bertindak berdasarkan peristiwa: status adalah sumber acuan.
Masa berlaku tautan
Tautan yang belum dibuka tetap berlaku hingga masa berlakunya sendiri habis, secara default satu hari. Setelah pelanggan pertama kali membuka tautan, pelanggan memiliki waktu 30 menit untuk menyelesaikannya, atau hingga masa berlaku awal berakhir jika lebih cepat.
Hal yang tidak dilakukan halaman terkelola
- Tautan tidak dapat disematkan di iframe. Buka sebagai halaman penuh atau di tab baru.
- Bahasanya mengikuti bahasa browser pelanggan. Anda tidak dapat mengaturnya.
- Sebagian browser dalam aplikasi tidak dapat menjalankannya. Halaman memberi tahu pelanggan cara melanjutkan di browser biasa.
Dokumen yang didukung dan data yang dibaca
Anda memilih dokumen yang boleh digunakan pelanggan dan negara penerbitnya melalui pengaturan halaman terkelola di Backoffice. Pelanggan memilih dari pilihan tersebut. Alur terkelola mengenali empat jenis dokumen:
| Jenis dokumen | Sisi belakang diambil |
|---|---|
| Kartu identitas nasional | Ya |
| SIM | Ya |
| Izin tinggal | Ya |
| Paspor | Tidak |
Teks cetak dibaca dari dokumen. Jika dokumen memiliki zona yang dapat dibaca mesin, zona itu dibaca, digit pemeriksanya diverifikasi, lalu hasilnya dicocokkan dengan teks cetak. SIM tidak memiliki zona yang dapat dibaca mesin dan ketiadaan zona tersebut tidak mengurangi hasilnya.
Kartu identitas nasional dan SIM Turki ditangani secara khusus: nomor identitas pribadi Turki (T.C. Kimlik No) dibaca dan, secara default, wajib diisi untuk kedua dokumen tersebut. Jika digit pemeriksaan suatu nomor valid, nomor dokumen tidak perlu disertakan.
Zona yang tidak dapat ditemukan atau dibandingkan dengan teks cetak merupakan kesenjangan pengukuran. Statusnya perlu ditinjau, bukan gagal. Noxtica tidak memublikasikan daftar negara di luar yang Anda konfigurasi dan tidak menyatakan bahwa semua dokumen dari setiap negara terbaca dengan tingkat yang sama.
Pemeriksaan dan sinyal
Alur terkelola menghasilkan hasil pemeriksaan untuk peninjau. Hasil ini merupakan sinyal yang mendukung peninjauan. Hasil tersebut tidak menentukan keputusan dan tidak menjamin pemblokiran penipuan.
| Pemeriksaan | Hal yang diperiksa |
|---|---|
| Keaslian dokumen | Tata letak, struktur zona yang dapat dibaca mesin, konsistensi cetak, tanda penyuntingan atau area yang disalin, keberadaan hologram, tanda pengambilan ulang dari layar, dan geometri kartu. Setiap pemeriksaan melaporkan hasilnya sendiri. |
| Kecocokan wajah | Membandingkan foto pada dokumen dengan swafoto. Skor rendah menjadi bukti pendukung bagi peninjau. |
| Kualitas swafoto | Ketajaman, pencahayaan, serta ukuran dan pose wajah dalam swafoto. |
| Keaktifan | Tantangan berupa menolehkan kepala dan berkedip. Pemeriksaan gestur menunjukkan bahwa gerakan yang diminta telah dilakukan. Ini bukan pengujian serangan presentasi. |
| Deteksi serangan presentasi (PAD) | Menganalisis bingkai dari tantangan keaktifan dan swafoto, lalu menghasilkan skor. Hasilnya bersifat sebagai saran. |
Hasil dan peninjauan
| Status | Makna |
|---|---|
pending | Dibuat. Pelanggan belum membuka tautan. |
opened | Pelanggan membuka tautan dan sedang menjalani langkah-langkahnya. |
verifying | Pelanggan telah mengirimkan data dan pemrosesan sedang berlangsung. |
review_pending | Pemrosesan selesai dan keputusan perlu dibuat di antrean tinjauan Backoffice Anda. Ini bukan penolakan maupun persetujuan. |
completed | Sesi disetujui berdasarkan suatu keputusan. |
unverified | Pemrosesan selesai dengan hasil negatif. |
error | Pemrosesan tidak dapat diselesaikan karena gangguan atau penolakan. |
expired | Tautan atau jendela pengambilan data kedaluwarsa sebelum keputusan dibuat. |
cancelled_by_user | Pelanggan membatalkan di halaman hosted. Berlaku jika pembatalan diaktifkan untuk organisasi Anda. |
Seseorang yang memenuhi kualifikasi di tim Anda sebaiknya meninjau keputusan negatif sebelum berdampak pada pelanggan. Hasilnya bersifat probabilistik dan dapat mencakup positif palsu maupun negatif palsu. Hasil tersebut bukan bukti identitas yang sah secara hukum.
Untuk developer
Semua langkah di bawah ini menggunakan HTTPS biasa dari server Anda. Referensi lengkap tersedia di dokumentasi.
Tiga cara memulai verifikasi
- Sesi terkelola dari server Anda. Server Anda membuat tautan melalui API dan Noxtica menyediakan halamannya.
- Undangan dari Backoffice. Seseorang di organisasi Anda membuat tautan di Backoffice tanpa kode.
- API langsung dari server Anda. Rute server-ke-server tanpa tautan terkelola. Dengan cara ini, layar Anda sendiri belum dapat mengambil dokumen untuk diperiksa. Gunakan sesi terkelola jika pelanggan perlu mengambil dokumen.
Buat sesi
Lakukan autentikasi dengan kunci server yang memiliki izin identitas. Simpan kunci di server Anda. Kirim Idempotency-Key agar percobaan ulang tidak membuat sesi kedua.
curl -sS https://collect.noxtica.com/v1/kyc/sessions \
-H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'Respons
Tautan dikembalikan satu kali, dalam respons ini. Perlakukan sebagai rahasia dan jangan mencatatnya di log. Masa berlaku dinyatakan dalam milidetik epoch.
{
"ok": true,
"sessionId": "00000000-0000-4000-8000-000000000001",
"url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
"expiresAt": 1790848845000,
"domainId": null,
"requestId": "req_example"
}Baca status
Sesi yang Anda buat selalu mengembalikan 200, termasuk sesi yang kedaluwarsa. Lakukan polling dengan jeda yang makin panjang dan berhenti saat status akhir tercapai.
GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEYPeristiwa webhook
Peristiwa dikirim melalui HTTPS dengan tanda tangan ke endpoint yang Anda daftarkan di Backoffice. Peristiwa adalah notifikasi, bukan keputusan.
| Peristiwa | Dipicu saat |
|---|---|
kyc.session.completed | Sesi terkelola mencapai status completed, unverified, atau error. Sesi berstatus review pending akan memicu peristiwa ini nanti, setelah peninjau mengambil keputusan. |
kyc.session.cancelled | Pelanggan membatalkan sesi di halaman terkelola. Berlangganan secara eksplisit. Diaktifkan untuk organisasi Anda. |
kyc.verification.completed | Verifikasi mencapai status akhir. |
kyc.erasure.completed | Permintaan penghapusan data selesai. Jika penghapusan data diaktifkan untuk organisasi Anda. |
kyc.document.expiry_warning | Dokumen terverifikasi hampir kedaluwarsa atau sudah kedaluwarsa. Jika diaktifkan untuk organisasi Anda. |
kyc.reverification.due | Jadwal verifikasi ulang telah tiba. Jika diaktifkan untuk organisasi Anda. |
Contoh peristiwa
Hanya nilai sintetis. Peristiwa tidak pernah memuat referensi pelanggan Anda: cocokkan peristiwa dengan pelanggan melalui id sesi.
{
"id": "00000000-0000-4000-8000-000000000001:endpoint_example",
"type": "kyc.session.completed",
"created_at": 1790762445000,
"tenant_id": "tenant_example",
"data": {
"schemaVersion": "1",
"sessionId": "00000000-0000-4000-8000-000000000001",
"status": "completed",
"verificationId": "verification_example",
"reasonCodes": ["provider_manual_review"],
"occurredAt": 1790762445000,
"deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
}
}Verifikasi setiap pengiriman
- Setiap pengiriman menyertakan header X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event, dan X-Noxtica-Delivery.
- Tanda tangan berupa HMAC-SHA256 atas timestamp, titik, dan isi permintaan mentah. Verifikasi tanda tangan sebelum mengurai isi permintaan, dan tetapkan sendiri toleransi timestamp.
- Pengiriman dilakukan setidaknya sekali dan urutannya tidak tetap. Deduplicasikan berdasarkan X-Noxtica-Delivery, lalu baca status sesi sebelum bertindak.
SDK tidak diperlukan. Dokumentasi menyediakan contoh dalam curl, Node.js, dan Python.
Baca selengkapnya di dokumentasi
Perlindungan data
Bagian ini menjelaskan hal-hal yang dinyatakan dalam dokumentasi. Ini bukan nasihat hukum; Kebijakan Privasi dan halaman Keamanan menjelaskan cara Noxtica menangani data pribadi.
Retensi
Noxtica tidak menghapus detail verifikasi atau bukti secara otomatis dan tidak menetapkan tanggal retensi untuk data tersebut. Data itu tetap berada di tenant Anda sampai administrator tenant menghapusnya.
Penghapusan
Administrator tenant menghapus verifikasi di Backoffice dengan menyertakan alasan, konfirmasi yang diketik, dan pemeriksaan step-up baru. Penghapusan menghapus verifikasi, file dan catatan buktinya, tetapi menyimpan catatan penggunaan penagihan, bukti dasar hukum, dan jejak audit. Tindakan ini tidak dapat dibatalkan.
Hak subjek data
Permintaan penghapusan data ditangani melalui halaman Penghapusan Data KYC. Administrator kedua menyetujui permintaan, penahanan hukum dapat menundanya, dan setiap item tersimpan memiliki bukti penghapusan. Sebelum menjanjikan jadwal kepada pelanggan, tanyakan kepada tim akun Anda cakupan permintaan yang disetujui untuk tenant Anda.
Akses bukti
Membuka hasil tangkapan asli memerlukan izin terpisah yang lebih tinggi daripada meninjau kasus. Akses ini terbatas untuk administrator, memerlukan pemeriksaan step-up baru, dan setiap tampilan diaudit. Peran lain hanya melihat temuan dan pengukuran, bukan hasil tangkapan asli.
Enkripsi dan isolasi
Bukti identitas mentah disimpan dalam keadaan terenkripsi saat tidak digunakan, dan hanya jika penyimpanan bukti mentah diaktifkan untuk tenant Anda. Sesi milik organisasi lain akan ditampilkan sebagai tidak ditemukan.
Residensi
Penyimpanan bukti memiliki pengaturan residensi per tenant: TR, EU, atau US. Tanyakan kepada tim akun Anda cakupannya untuk tenant Anda. Halaman ini tidak menyatakan bahwa data tetap berada di negara tertentu.
Persetujuan dan dasar hukum
Sebelum pengambilan data, halaman terkelola menampilkan tujuan dan pemberitahuan privasi Anda kepada pelanggan. Pihak berwenang di organisasi Anda mencatat dasar hukumnya; Noxtica tidak memilihkannya untuk Anda. Anda bertanggung jawab atas pemberitahuan, persetujuan, dan dasar hukum di setiap yurisdiksi tempat Anda beroperasi.
Pertanyaan umum
Bisakah saya mengaktifkan verifikasi identitas sendiri?
Tidak. Fitur ini disediakan per tenant dengan ketersediaan yang dikendalikan. Hubungi tim untuk membahas kasus penggunaan dan yurisdiksi Anda.
Apakah pelanggan disetujui secara otomatis?
Tidak. Tidak ada hasil pemeriksaan yang dengan sendirinya menjadikan verifikasi terkelola berstatus terverifikasi. Setiap verifikasi terkelola menunggu seseorang mencatat keputusan; hanya status completed yang berarti disetujui.
Apakah deteksi serangan presentasi memblokir penipuan?
Tidak. PAD bersifat sebagai saran. Noxtica melaporkan hasilnya dan tidak pernah membiarkannya menentukan keputusan. Perlakukan hasilnya, seperti hasil pemeriksaan lainnya, sebagai sinyal bagi peninjau.
Apakah hasilnya merupakan bukti identitas secara hukum?
Tidak. Tidak ada hasil yang menjadi bukti identitas secara hukum di luar cakupan penyedia dan kontrak yang dikonfigurasi. Noxtica bukan lembaga pelaporan konsumen, dan hasilnya tidak boleh digunakan untuk menentukan kelayakan kredit, asuransi, pekerjaan, atau perumahan.
Berapa lama tautan verifikasi berlaku?
Secara default satu hari, dan Anda dapat mengaturnya saat membuat sesi. Setelah pelanggan membuka tautan, pelanggan memiliki waktu 30 menit untuk menyelesaikannya.
Bisakah saya menyematkan halaman terkelola atau mengatur bahasanya?
Tidak. Halaman menolak dimuat di iframe, dan bahasanya mengikuti bahasa browser pelanggan.
Peristiwa apa yang dapat saya terima?
Enam peristiwa identitas: kyc.session.completed, kyc.session.cancelled, kyc.verification.completed, kyc.erasure.completed, kyc.document.expiry_warning, dan kyc.reverification.due. Beberapa bergantung pada pengaturan organisasi Anda.
Berapa lama bukti disimpan?
Noxtica tidak menetapkan tanggal retensi dan tidak menghapus detail verifikasi atau bukti secara otomatis. Administrator tenant menghapusnya.
Apakah verifikasi bisnis dan merchant tersedia?
Ya. Verifikasi bisnis (KYB) dan verifikasi merchant (KYM) tersedia. Server Anda membuat tautan, bisnis atau merchant menyelesaikan onboarding di halaman yang dihosting Noxtica, lalu operator Anda meninjau kasusnya di Backoffice. Diaktifkan untuk akun Anda atas permintaan.
Halaman terkait
Hal yang tidak dilakukan verifikasi identitas
- Ketersediaan terkontrol. Verifikasi identitas disediakan per tenant.
- Bukan bukti identitas hukum. Di luar cakupan penyedia dan kontrak yang dikonfigurasi, hasil apa pun bukan bukti identitas hukum. Hasil bersifat probabilistik dan dapat mencakup positif palsu maupun negatif palsu.
- Anda yang memutuskan. Orang yang memenuhi kualifikasi di tim Anda sebaiknya meninjau keputusan yang merugikan. Noxtica bukan biro pelaporan konsumen. Jangan gunakan keluaran untuk menentukan kelayakan kredit, asuransi, pekerjaan, atau perumahan.
- Tanggung jawab Anda. Anda bertanggung jawab atas pemberitahuan, persetujuan, dan dasar hukum untuk mengumpulkan bukti identitas dari pelanggan di setiap yurisdiksi tempat Anda beroperasi.
Skor, alasan, dan putusan adalah estimasi probabilistik, bukan pernyataan fakta. Tim Anda mengambil setiap keputusan.Baca sanggahan