PENGESAHAN IDENTITI
Pengesahan identiti yang dihoskan, dengan keputusan di tangan anda
Hantar pelanggan ke aliran pengesahan yang dihoskan. Baca status kes dalam bahagian belakang anda sendiri dan salurkan kes luar biasa untuk semakan manusia.
Aliran kerja terkawal, bukan keputusan automatik
Pengesahan identiti memberikan status kes dan laluan semakan. Ia menyokong keputusan anda, bukan membuat keputusan bagi pihak anda.
Laluan sesi
Sesi dicipta
Pautan sekali guna dan tarikh luput.
Pautan dibuka
Pelanggan membaca notis privasi. Tempoh untuk melengkapkan proses adalah terhad.
Status kes
Bacaan status atau peristiwa
Selesai, tidak disahkan atau memerlukan semakan. Anggap setiap status sebagai input kepada keputusan anda sendiri.
Pilihan sandaran untuk dirancang
Tamat tempoh
Tiada peristiwa dihantar. Baca status untuk mengetahuinya.
Dibatalkan
Baca status daripada bahagian belakang anda.
Berakhir dengan ralat
Sesi boleh berakhir dengan ralat. Rancang pilihan sandaran.
Pautan pengesahan hos
Status kes untuk keputusan anda
Laluan semakan manusia
Pemberitahuan peristiwa
Daripada sesi kepada status kes
Pelayan
Cipta sesi
Menggunakan rujukan anda sendiri untuk subjek. Anda menerima pautan sekali guna dan tarikh luput.
Noxtica
Pelanggan menggunakan halaman hos
Pautan sekali guna
Pelanggan membaca notis privasi, kemudian memberikan bukti yang diminta dalam tempoh masa yang terhad.
Pelayan
Bacaan status atau peristiwa
Status kes
Baca status daripada bahagian belakang anda atau terima peristiwa pada titik akhir anda.
Konsol
Semakan manusia
Kes luar biasa
Kes yang memerlukan penelitian lanjut dihantar untuk semakan operator. Aktiviti semakan direkodkan dalam jejak audit.
Pasukan anda
Keputusan anda
Pasukan anda membuat keputusan.
Cipta sesi
Pelanggan melengkapkan proses pada halaman hos
Baca status dan buat keputusan
Maksudnya dan untuk siapa
Pengesahan identiti Noxtica (KYC) ialah aliran yang dihoskan. Pelayan anda mencipta sesi, pelanggan anda melengkapkan langkah-langkah pada halaman yang dihoskan oleh Noxtica dalam pelayar mereka sendiri, dan pelayan anda membaca hasil melalui semakan status atau peristiwa yang ditandatangani. Pelayan anda tidak pernah menerima jawapan atau imej tangkapan pelanggan secara langsung.
Hasilnya ialah isyarat automatik. Anda menentukan maksud setiap hasil bagi pelanggan anda. Noxtica memberikan bukti dan jejak audit kepada anda.
Untuk siapa
- Jurutera bahagian belakang yang mencipta sesi dan membaca hasil.
- Pasukan operasi dan pematuhan yang menyediakan halaman dihoskan dan mengurus baris gilir semakan dalam Backoffice.
- Pasukan yang dasar mereka memerlukan bukti identiti dan mempunyai seseorang yang bertanggungjawab terhadap semakan.
Pengesahan perniagaan dan pedagang
Pendekatan dihoskan yang sama merangkumi perniagaan dan pedagang. KYB (kenali perniagaan anda) ialah proses pendaftaran perniagaan yang dihoskan: wakil perniagaan memasukkan maklumat perniagaan, memuat naik dokumen, mengisytiharkan pemilik, menyemak dan menghantar permohonan. Kes yang dihantar akan disemak oleh manusia dalam Backoffice, tempat operator melihat graf pemilikan, dokumen dan saringan. KYM (kenali pedagang anda) ialah proses pendaftaran pedagang yang dihoskan serta pemantauan transaksi untuk pemberitahuan sahaja: amaran ialah pemberitahuan untuk disemak oleh seseorang dan tidak akan memulakan tindakan pembayaran. Tiada semakan automatik daftar perniagaan dinyatakan. Hasilnya ialah isyarat dan operator anda membuat keputusan. Tersedia. Diaktifkan untuk akaun anda atas permintaan.
Ketersediaan
Ketersediaan terkawal. Pasukan akaun anda menyediakan pengesahan identiti bagi setiap penyewa, dan anda tidak boleh mengaktifkannya sendiri. Langkah yang dinyatakan sebagai pilihan hanya terpakai apabila didayakan untuk organisasi anda.
Aliran terhos, dari mula hingga selesai
Berikut ialah proses daripada panggilan API pertama hingga hasilnya. Langkah yang ditandakan pilihan hanya terpakai apabila diaktifkan untuk organisasi anda.
Pelayan anda mencipta sesi
Panggilan pelayan mencipta sesi dengan rujukan pelanggan legap anda sendiri. Respons memberikan id sesi dan pautan sekali guna.
Pelanggan menerima pautan
Hantar pelanggan ke pautan melalui lencongan, tab baharu, e-mel atau mesej, atau kod QR. Halaman terhos juga menyediakan kod QR dan pilihan salin pautan supaya pelanggan yang bermula pada komputer boleh menyambung melalui telefon.
Notis privasi dan persetujuan
Sebelum sebarang tangkapan dibuat, pelanggan melihat nama perniagaan anda, tujuan pengesahan dan pautan ke notis privasi anda, kemudian bersetuju untuk meneruskan.
Pilih dokumen dan tangkap bahagian hadapan serta belakang
Pelanggan memilih salah satu jenis dokumen yang anda terima, kemudian menangkap bahagian hadapan. Kad pengenalan, lesen memandu dan permit kediaman memerlukan tangkapan bahagian belakang. Pasport tidak mempunyai langkah bahagian belakang.
Swafoto
Pelanggan mengambil swafoto. Swafoto dibandingkan dengan potret pada dokumen dan diperiksa kualitinya.
Keaktifan
Pelanggan melengkapkan cabaran keaktifan ringkas di hadapan kamera: pusingan kepala dan kelipan mata.
Semakan
Tangkapan yang selesai menunggu dalam barisan semakan Backoffice anda sehingga seseorang dalam organisasi anda merekodkan keputusan. Status sesi kekal review pending dan tidak tamat tempoh sementara menunggu.
Hasil: status dibaca dan peristiwa bertandatangan
Pelayan anda membaca status sesi dan boleh melanggan peristiwa webhook bertandatangan. Baca status sebelum bertindak atas sesuatu peristiwa: status ialah rujukan utama.
Tempoh sah pautan
Pautan yang belum dibuka kekal sah sehingga tamat tempoh yang ditetapkan, iaitu satu hari secara lalai. Selepas pelanggan mula-mula membuka pautan, pelanggan mempunyai 30 minit untuk menyelesaikannya, atau sehingga masa tamat tempoh asal jika lebih awal.
Perkara yang tidak dilakukan oleh halaman terhos
- Pautan tidak boleh dibenamkan dalam iframe. Buka sebagai halaman penuh atau dalam tab baharu.
- Bahasa halaman mengikut bahasa pelayar pelanggan. Anda tidak boleh menetapkannya.
- Sesetengah pelayar dalam aplikasi tidak dapat menjalankannya. Halaman akan memberitahu pelanggan cara meneruskannya dalam pelayar biasa.
Dokumen yang disokong dan perkara yang dibaca
Anda memilih jenis dokumen dan negara pengeluar yang boleh digunakan oleh pelanggan dalam tetapan halaman terhos di Backoffice. Pelanggan memilih daripada pilihan tersebut. Aliran terhos mengenali empat jenis dokumen:
| Jenis dokumen | Bahagian belakang ditangkap |
|---|---|
| Kad pengenalan kebangsaan | Ya |
| Lesen memandu | Ya |
| Permit kediaman | Ya |
| Pasport | Tidak |
Teks bercetak dibaca daripada dokumen. Jika dokumen mempunyai zon boleh dibaca mesin, zon itu dibaca, digit semaknya disahkan dan hasilnya disemak silang dengan teks bercetak. Lesen memandu tidak mempunyai zon boleh dibaca mesin dan ketiadaannya tidak menjejaskan penilaian.
Kad pengenalan kebangsaan dan lesen memandu Turki dikendalikan secara khusus: nombor pengenalan peribadi Turki (T.C. Kimlik No) dibaca dan secara lalai menjadi medan wajib bagi kedua-dua dokumen tersebut. Jika nombor lulus semakan digit, nombor dokumen juga tidak diperlukan.
Zon yang tidak dapat ditemui atau dibandingkan dengan teks bercetak ialah jurang pengukuran. Statusnya ialah semakan, bukan gagal. Noxtica tidak menerbitkan senarai negara selain tetapan yang anda konfigurasikan, dan tidak mendakwa bahawa semua dokumen dari setiap negara dibaca dengan sama baik.
Semakan dan isyarat
Aliran terhos menghasilkan keputusan semakan untuk penyemak. Ini ialah isyarat untuk membantu semakan. Keputusan ini tidak menentukan hasil dan tidak menjamin penipuan akan disekat.
| Semakan | Perkara yang diperiksa |
|---|---|
| Ketulenan dokumen | Susun atur, struktur zon boleh dibaca mesin, konsistensi cetakan, tanda suntingan atau bahagian yang disalin, kehadiran hologram, tanda tangkapan semula skrin dan geometri kad. Setiap semakan melaporkan hasilnya sendiri. |
| Padanan wajah | Membandingkan potret pada dokumen dengan swafoto. Skor rendah ialah bukti untuk pertimbangan penyemak. |
| Kualiti swafoto | Ketajaman, dedahan, serta saiz dan posisi wajah dalam swafoto. |
| Keaktifan | Cabaran berupa pusingan kepala dan kelipan mata. Semakan gerak isyarat menunjukkan bahawa pergerakan yang diminta telah dilakukan. Ini bukan ujian serangan persembahan. |
| Pengesanan serangan persembahan (PAD) | Menganalisis bingkai cabaran keaktifan dan swafoto, lalu menghasilkan skor. Hasilnya hanya sebagai panduan. |
Hasil dan semakan
| Status | Maksud |
|---|---|
pending | Dicipta. Pelanggan belum membuka pautan. |
opened | Pelanggan telah membuka pautan dan sedang mengikuti langkah-langkah. |
verifying | Pelanggan telah menghantar maklumat dan pemprosesan sedang berjalan. |
review_pending | Pemprosesan selesai dan keputusan perlu dibuat dalam baris gilir semakan Backoffice anda. Ini bukan penolakan dan bukan kelulusan. |
completed | Keputusan telah meluluskan sesi. |
unverified | Pemprosesan selesai dengan hasil negatif. |
error | Pemprosesan tidak dapat diselesaikan akibat kerosakan atau penolakan. |
expired | Pautan atau tempoh pengambilan imej tamat sebelum keputusan dibuat. |
cancelled_by_user | Pelanggan membatalkan proses pada halaman yang dihoskan. Terpakai apabila pembatalan diaktifkan untuk organisasi anda. |
Seseorang yang layak dalam pasukan anda patut menyemak keputusan negatif sebelum keputusan itu memberi kesan kepada pelanggan. Hasilnya bersifat kebarangkalian dan boleh merangkumi positif palsu serta negatif palsu. Hasil ini bukan bukti identiti dari segi undang-undang.
Untuk pembangun
Semua yang berikut menggunakan HTTPS biasa dari pelayan anda. Rujukan penuh tersedia dalam dokumentasi.
Tiga cara untuk memulakan pengesahan
- Sesi terhos daripada pelayan anda. Pelayan anda mencipta pautan melalui API dan Noxtica mengehos halaman tersebut.
- Jemputan daripada Backoffice. Seseorang dalam organisasi anda mencipta pautan dalam Backoffice tanpa kod.
- API langsung daripada pelayan anda. Laluan pelayan-ke-pelayan tanpa pautan terhos. Buat masa ini, skrin anda sendiri tidak boleh menangkap dokumen untuk disemak. Gunakan sesi terhos apabila pelanggan perlu menangkap dokumen.
Cipta sesi
Sahkan identiti menggunakan kunci pelayan dengan kebenaran identiti. Simpan kunci itu pada pelayan anda. Hantar Idempotency-Key supaya percubaan semula tidak mencipta 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
Pautan dikembalikan sekali sahaja dalam respons ini. Anggap pautan itu sebagai rahsia dan jangan rekodkannya dalam log. Masa tamat tempoh dinyatakan dalam milisaat 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 cipta sentiasa mengembalikan 200, termasuk sesi yang telah tamat tempoh. Buat tinjauan berkala dengan sela masa yang semakin panjang dan berhenti apabila status akhir dicapai.
GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEYPeristiwa webhook
Peristiwa dihantar melalui HTTPS dengan tandatangan ke endpoint yang anda daftarkan dalam Backoffice. Peristiwa ialah pemberitahuan, bukan keputusan.
| Peristiwa | Dicetuskan apabila |
|---|---|
kyc.session.completed | Sesi terhos mencapai status completed, unverified atau error. Jika sesi berstatus review pending, peristiwa ini dicetuskan kemudian apabila penyemak membuat keputusan. |
kyc.session.cancelled | Pelanggan membatalkan sesi pada halaman terhos. Langgan secara jelas. Tersedia apabila diaktifkan untuk organisasi anda. |
kyc.verification.completed | Pengesahan mencapai status akhir. |
kyc.erasure.completed | Permintaan pemadaman selesai. Tersedia apabila pemadaman diaktifkan untuk organisasi anda. |
kyc.document.expiry_warning | Dokumen yang disahkan hampir tamat tempoh atau telah tamat tempoh. Tersedia apabila diaktifkan untuk organisasi anda. |
kyc.reverification.due | Tiba masanya untuk pengesahan semula berjadual. Tersedia apabila diaktifkan untuk organisasi anda. |
Contoh peristiwa
Nilai sintetik sahaja. Peristiwa tidak membawa rujukan pelanggan anda: padankan peristiwa dengan pelanggan menggunakan 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"
}
}Sahkan setiap penghantaran
- Setiap penghantaran membawa pengepala X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event dan X-Noxtica-Delivery.
- Tandatangan ialah HMAC-SHA256 yang dikira daripada cap masa, titik dan isi permintaan mentah. Sahkan tandatangan sebelum menghuraikan isi, dan tetapkan toleransi cap masa anda sendiri.
- Penghantaran berlaku sekurang-kurangnya sekali dan tertibnya tidak tetap. Buang pendua berdasarkan X-Noxtica-Delivery, kemudian semak status sesi sebelum bertindak.
SDK tidak diperlukan. Dokumentasi menyediakan contoh dalam curl, Node.js dan Python.
Ketahui lebih lanjut dalam dokumentasi
Perlindungan data
Bahagian ini menerangkan perkara yang dinyatakan dalam dokumentasi. Ini bukan nasihat undang-undang. Dasar Privasi dan halaman Keselamatan menerangkan cara Noxtica mengendalikan data peribadi.
Penyimpanan
Noxtica tidak memadam butiran atau bukti pengesahan secara automatik dan tidak menetapkan tarikh penyimpanan untuknya. Data kekal dalam tenant anda sehingga pentadbir tenant memadamkannya.
Pemadaman
Pentadbir tenant memadam pengesahan dalam Backoffice dengan memberikan sebab, menaip pengesahan dan menjalankan semakan step-up baharu. Pemadaman membuang pengesahan, fail dan rekod buktinya, tetapi mengekalkan rekod penggunaan pengebilan, resit asas undang-undang dan jejak audit. Tindakan ini tidak boleh dibuat asal.
Hak subjek data
Permintaan hak untuk dipadamkan diuruskan pada halaman Pemadaman KYC. Pentadbir kedua meluluskan permintaan, penahanan undang-undang boleh menjedakannya, dan setiap item tersimpan mempunyai resit pemadaman. Sebelum menjanjikan jangka masa kepada pelanggan, tanya pasukan akaun anda tentang skop permintaan yang diluluskan bagi tenant anda.
Akses kepada bukti
Membuka tangkapan asal memerlukan kebenaran yang berasingan dan lebih tinggi daripada menyemak kes. Akses ini terhad kepada pentadbir, memerlukan semakan step-up baharu dan setiap paparan direkodkan dalam audit. Peranan lain hanya melihat penemuan dan ukuran, bukan bahan asal.
Penyulitan dan pengasingan
Bukti identiti mentah disimpan dalam keadaan terenkripsi semasa rehat, dan hanya apabila storan bukti mentah diaktifkan untuk tenant anda. Sesi milik organisasi lain akan dipaparkan sebagai tidak ditemui.
Residensi
Storan bukti mempunyai tetapan residensi setiap tenant: TR, EU atau US. Tanya pasukan akaun anda tentang skopnya untuk tenant anda. Halaman ini tidak menyatakan bahawa data kekal di negara tertentu.
Persetujuan dan asas undang-undang
Sebelum tangkapan, halaman terhos memaparkan tujuan anda dan notis privasi kepada pelanggan. Orang yang diberi kuasa dalam organisasi anda merekodkan asas undang-undang, dan Noxtica tidak memilihnya untuk anda. Anda bertanggungjawab atas notis, persetujuan dan asas undang-undang di setiap bidang kuasa yang anda beroperasi.
Soalan lazim
Bolehkah saya mengaktifkan pengesahan identiti sendiri?
Tidak. Ciri ini disediakan mengikut tenant dengan ketersediaan terkawal. Hubungi pasukan untuk membincangkan kes penggunaan dan bidang kuasa anda.
Adakah pelanggan diluluskan secara automatik?
Tidak. Tiada hasil semakan yang dengan sendirinya menjadikan pengesahan terhos berstatus disahkan. Setiap pengesahan terhos menunggu seseorang merekodkan keputusan, dan hanya status completed menandakan kelulusan.
Adakah pengesanan serangan persembahan menyekat penipuan?
Tidak. PAD hanya sebagai panduan. Noxtica melaporkan hasilnya dan tidak sekali-kali membiarkannya menentukan keputusan. Anggap PAD, seperti setiap semakan lain, sebagai isyarat untuk penyemak.
Adakah hasilnya bukti identiti dari segi undang-undang?
Tidak. Tiada hasil yang menjadi bukti identiti dari segi undang-undang di luar skop penyedia dan kontrak yang dikonfigurasikan. Noxtica bukan agensi pelaporan pengguna, dan hasilnya tidak boleh digunakan untuk menentukan kelayakan kredit, insurans, pekerjaan atau perumahan.
Berapa lama pautan pengesahan sah?
Secara lalai, satu hari. Anda boleh menetapkannya semasa mencipta sesi. Selepas pelanggan membuka pautan, pelanggan mempunyai 30 minit untuk menyelesaikannya.
Bolehkah saya benamkan halaman terhos atau menetapkan bahasanya?
Tidak. Halaman tidak akan dimuatkan dalam iframe, dan bahasanya mengikut pelayar pelanggan.
Peristiwa manakah yang boleh saya terima?
Enam peristiwa identiti: kyc.session.completed, kyc.session.cancelled, kyc.verification.completed, kyc.erasure.completed, kyc.document.expiry_warning dan kyc.reverification.due. Sesetengahnya bergantung pada tetapan organisasi anda.
Berapa lama bukti disimpan?
Noxtica tidak menetapkan tarikh penyimpanan dan tidak memadam butiran atau bukti pengesahan secara automatik. Pentadbir tenant memadamkannya.
Adakah pengesahan perniagaan dan pedagang tersedia?
Ya. Pengesahan perniagaan (KYB) dan pengesahan pedagang (KYM) tersedia. Pelayan anda mencipta pautan, perniagaan atau pedagang melengkapkan onboarding pada halaman yang dihoskan Noxtica, dan pengendali anda menyemak kes dalam Backoffice. Diaktifkan untuk akaun anda atas permintaan.
Halaman berkaitan
Perkara yang tidak dilakukan oleh pengesahan identiti
- Ketersediaan terkawal. Pengesahan identiti diperuntukkan mengikut penyewa.
- Bukan bukti identiti yang sah di sisi undang-undang. Di luar skop penyedia dan kontrak yang dikonfigurasikan, tiada hasil yang menjadi bukti identiti sah di sisi undang-undang. Hasil bersifat kebarangkalian dan mungkin merangkumi positif palsu serta negatif palsu.
- Anda membuat keputusan. Individu yang layak dalam pasukan anda patut menyemak keputusan yang merugikan. Noxtica bukan agensi pelaporan pengguna. Jangan gunakan output untuk menentukan kelayakan kredit, insurans, pekerjaan atau perumahan.
- Tanggungjawab anda. Anda bertanggungjawab terhadap notis, persetujuan dan asas undang-undang untuk mengumpul bukti identiti daripada pelanggan anda di setiap bidang kuasa tempat anda beroperasi.
Skor, sebab dan keputusan ialah anggaran kebarangkalian, bukannya kenyataan fakta. Pasukan anda membuat setiap keputusan.Baca penafian