API Impor Sesi Bersama: KYC yang Dapat Digunakan Kembali

Daftar fitur verifikasi yang dikonfigurasi untuk sesi ini, sebagai nama tampilan: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, PHONE, EMAIL_VERIFICATION, AML, IP_ANALYSIS, DATABASE_VALIDATION, QUESTIONNAIRE, AGE_ESTIMATION, FACE_SEARCH, GEOLOCATION (Verifikasi lokasi) (Sesi Verifikasi Bisnis (KYB) menggunakan rangkaian fitur KYB: KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE, AML, PHONE, EMAIL_VERIFICATION, IP_ANALYSIS, QUESTIONNAIRE). Dengan include=events, setiap entri menjadi objek {feature, node_id} dan bukan string biasa, dan fitur email diganti namanya: fitur tersebut muncul sebagai EMAIL dalam mode event, bukan EMAIL_VERIFICATION yang digunakan di sini.

Array laporan Verifikasi Identitas (OCR) yang dihasilkan oleh langkah-langkah dokumen ID dalam graf alur kerja. Selalu berupa array JSON — baca id_verifications[0] dan lakukan iterasi jika alur kerja Anda dapat menjalankan lebih dari satu pemeriksaan ID (misalnya pemeriksaan utama ditambah step-up). Bernilai null sampai setidaknya satu langkah ID menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, kolom dokumen yang diekstrak, URL gambar, skor kualitas, MRZ, parsing alamat, pencocokan lintas-sesi, serta warnings[].

Array laporan NFC / ePassport yang dihasilkan oleh langkah-langkah NFC dalam graf alur kerja. Ini selalu berupa array JSON, bukan objek nfc tunggal — baca nfc_verifications[0] dan lakukan iterasi jika alur kerja Anda dapat menjalankan NFC lebih dari sekali. Bernilai null sampai setidaknya satu langkah NFC menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, chip_protocol, chip_data, authenticity (integritas SOD + DG), certificate_summary, serta warnings[]. Japan My Number Card dibaca melalui JPKI dan bukan ICAO 9303: itemnya memiliki chip_protocol: "jpki", membawa buktinya di bawah jpki, dan membiarkan kolom ICAO bernilai null. Ketika langkah NFC dilewati sebelum dapat ditawarkan (dokumen tanpa chip, sertifikat hilang, tidak ada kemampuan NFC yang dilaporkan, kunci MRZ tidak terbaca, JPKI tidak tersedia untuk My Number Card), ini tetap bernilai null dan nfc_skip_reason menjelaskan alasannya; pelewatan pada langkah itu sendiri (pengguna mengetuk opsi lewati, atau pemindai ternyata tidak tersedia saat pemindaian) tetap menghasilkan laporan dengan is_nfc_skipped: true.

Array laporan liveness yang dihasilkan oleh langkah-langkah liveness dalam graf alur kerja. Selalu berupa array JSON — bukan objek liveness tunggal. Bernilai null sampai setidaknya satu langkah liveness menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, method, score, reference_image, video_url, age_estimation opsional, matches[] lintas-sesi, serta warnings[].

Array laporan Pencocokan Wajah yang dihasilkan oleh langkah-langkah pencocokan wajah dalam graf alur kerja. Selalu berupa array JSON — bukan objek face_match tunggal. Bernilai null sampai setidaknya satu langkah pencocokan wajah menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, score kemiripan, source_image, target_image, serta warnings[].

Array laporan Verifikasi Telepon — selalu berupa array JSON, bukan objek phone tunggal. Bernilai null sampai setidaknya satu langkah telepon menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, nomor telepon dan metadata negara, lifecycle[], matches[], serta warnings[].

Array laporan Verifikasi Email — selalu berupa array JSON, bukan objek email tunggal. Bernilai null sampai setidaknya satu langkah email menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, alamat email, data kebocoran, lifecycle[], matches[], serta warnings[].

Array laporan Bukti Alamat (POA) — selalu berupa array JSON, bukan objek poa tunggal. Bernilai null sampai setidaknya satu langkah POA menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, URL file dokumen, penerbit, tanggal, alamat yang diparsing, serta warnings[].

Laporan Document AI yang dikelompokkan berdasarkan node alur kerja — selalu berupa array JSON, tidak pernah berupa objek tunggal. Bernilai null sampai setidaknya satu langkah Document AI menghasilkan data. Hanya ada jika session_kind = user. Setiap item adalah grup node dengan status agregat, node_id, array items[] dari hasil per dokumen (data yang diekstraksi menggunakan kunci kolom yang dikonfigurasi), serta warnings.

Array laporan respons Kuesioner — selalu berupa array JSON, bukan objek questionnaire tunggal. Bernilai null sampai setidaknya satu langkah kuesioner menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, metadata kuesioner, bagian dengan elemen formulir, serta jawaban pengguna.

Hasil Verifikasi Bank, satu item per langkah Verifikasi Bank, untuk Verifikasi Pengguna dan Bisnis. null sampai suatu langkah menghasilkannya. Kolom method setiap item menyebutkan bagaimana akun diverifikasi: open_banking (masuk ke bank) atau account_lookup (pemeriksaan akun), atau fallback statement atau microdeposits, dan none saat orang tersebut melanjutkan tanpa bank sebelum upaya apa pun dievaluasi (continued_without_bank). Lihat Metode verifikasi bank.

Hasil Tanda Tangan Elektronik, satu item per penandatangan dan langkah tanda tangan, untuk Verifikasi Pengguna dan Verifikasi Bisnis (KYB). Hanya ada jika alur kerja memiliki langkah Tanda Tangan Elektronik; berupa array kosong hingga penandatangan mencapainya. Lihat Laporan Tanda Tangan Elektronik.

Array laporan Skrining AML — selalu berupa array JSON, tidak pernah berupa objek tunggal aml. null hingga setidaknya satu langkah AML menghasilkan data. Setiap item merupakan laporan lengkap, termasuk node_id, status tingkat fitur, total_hits, entity_type, hits[], score, screened_data, is_ongoing_monitoring_enabled, dan warnings[].

Array laporan Analisis Perangkat & IP — selalu berupa array JSON, bukan objek ip_analysis tunggal. Bernilai null sampai setidaknya satu langkah analisis IP menghasilkan data. Setiap item adalah laporan lengkap, termasuk node_id, status tingkat fitur, data IP dan geolokasi, sidik jari perangkat, serta warnings[]. Entri dengan (node_id, ip_address, device_fingerprint) duplikat akan dideduplikasi di sisi server.

Array hasil verifikasi Lokasi, satu per langkah verifikasi Lokasi: upaya yang diterima dari langkah tersebut. Bernilai null sampai langkah verifikasi Lokasi menghasilkan data. Upaya-upaya sebelumnya dari langkah yang sama berada di geolocation_attempts.

Setiap upaya dari setiap langkah verifikasi Lokasi pada sesi ini, yang terlama terlebih dahulu. Upaya yang digantikan oleh pengiriman ulang akan dikecualikan. Alur kerja yang menyembunyikan geolocation_checks melalui atribut responsnya juga akan menyembunyikan daftar ini.

Array laporan Validasi Database — selalu berupa array JSON, tidak pernah berupa objek database_validation tunggal. Bernilai null sampai setidaknya satu langkah validasi DB menghasilkan data. Setiap item merupakan laporan lengkap, termasuk node_id, status tingkat fitur, screened_data, validations[] per layanan (masing-masing dengan source_data registri), dan warnings[]. Kolom screened_data dan source_data bervariasi menurut negara:

ARG (Argentina): screened_data: {document_number, selfie, gender, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, date_of_death, tax_id, tax_id_type, face_match_score, sit_1_since, banks, last_position, highest_position, rejected_checks}. Menggunakan validasi pencocokan wajah biometrik RENAPER. Jenis kelamin disimpulkan secara otomatis dari analisis wajah atau nama depan jika tidak tertera pada dokumen (misalnya, SIM)

BOL (Bolivia): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender}

BRA (Brasil): screened_data: {tax_number, first_name, last_name, date_of_birth}. source_data selalu menyertakan {identification_number, first_name, last_name, date_of_birth, lgpd_minor, minor_under_18, minor_under_16} untuk pencocokan CPF yang berhasil. Pencarian orang dewasa yang berhasil menetapkan penanda tersebut ke false. Layanan Consulta CPF Receita Federal dapat mengembalikan HTTP 422 (anak di bawah 18 tahun) atau 451 (di bawah 16 tahun) dengan data yang ditahan berdasarkan LGPD; dalam kasus tersebut, source_data menetapkan penanda minor ke true sebagaimana mestinya, menyertakan status HTTP dari layanan upstream, dan validasi tingkat kolom bernilai no_match. Lihat bagian Brasil pada referensi Kode Hasil Validasi Database untuk daftar kode selengkapnya.

CHL (Chili): screened_data: {personal_number, first_name, last_name, date_of_birth}. source_data: {identification_number, first_name, last_name, date_of_birth, gender}

COL (Kolombia): screened_data: {document_number, document_type, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, document_type}

CRI (Kosta Rika): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

DOM (Republik Dominika): screened_data: {personal_number}. source_data: {identification_number} (hanya mengembalikan valid/invalid)

ECU (Ekuador): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, street, formatted_address, gender, nationality, education, marital_status, spouse, mother_name, father_name, profession}

ESP (Spanyol): screened_data: {personal_number, document_type, expiration_date, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, document_type, expiration_date}

GTM (Guatemala): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

HND (Honduras): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

MEX (Meksiko): screened_data: {personal_number (CURP), first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender, nationality, curp_status, state_of_birth, doc_probatorio, registration_year, registration_state, registration_municipality, num_acta, crip, issuing_state_code, foreign_registry_number, folio_carta, folio_certificado}. Menggunakan registri sipil RENAPO. Layanan pemeriksaan validitas INE terpisah juga tersedia untuk MEX sebagai validasi satu per satu tambahan.

PAN (Panama): screened_data: {personal_number, selfie}. source_data: {identification_number}. Menggunakan validasi biometrik SIB

PER (Peru): screened_data: {personal_number (DNI), first_name, last_name}. source_data: {identification_number, first_name, last_name, paternal_name, maternal_name, verification_number, verification_letter}

PRY (Paraguay): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

SLV (El Salvador): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

URY (Uruguay): screened_data: {personal_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

VEN (Venezuela): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, gender, date_of_birth, document_type}

Pemeriksaan registri perusahaan. Hanya ada jika session_kind = business. Setiap item membungkus seluruh payload registri perusahaan.

Pemeriksaan pihak kunci agregat. Hanya ada jika session_kind = business. Setiap item menggunakan format dua wadah (registry, submitted, ubo_kyc_summary).

Pemeriksaan verifikasi dokumen dikelompokkan berdasarkan node alur kerja. Hanya ada jika session_kind = business.

Hanya dikembalikan dengan include=resubmissions, untuk sesi pengguna dan bisnis. Satu entri per permintaan pengiriman ulang, terlama terlebih dahulu. Setiap entri memuat hasil yang dikembalikan oleh langkah-langkah yang dikirimkan ulang sebelum permintaan, sehingga pengiriman sebelumnya tetap dapat dibaca. Menghapus sesi akan menghapus setiap pengiriman.