> ## 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. # Peringatan & Kode Error Verifikasi NFC > Daftar peringatan Verifikasi NFC Didit mencakup chip tidak terbaca, ketidakcocokan OCR, sertifikat kedaluwarsa, serta penyebab dan perbaikannya. ## Gambaran Umum Peringatan pada laporan NFC menandai setiap kondisi yang diamati Didit saat membaca dan memvalidasi chip. Peringatan ini masuk ke dalam array `warnings[]` pada setiap item `nfc_verifications[]` (lihat [laporan NFC](https://docs.didit.me/id/core-technology/nfc-verification/report-nfc-verification.md)), dengan `feature` yang diatur ke `"NFC"`. Setiap entri mengikuti struktur [objek peringatan](https://docs.didit.me/id/reference/data-models.md#objek-peringatan) umum: `feature`, `risk`, `additional_data`, `log_type`, `short_description`, `long_description`, `node_id`. Setiap peringatan memiliki tiga lapisan: 1. **Kode `risk`** — pengidentifikasi stabil yang dapat Anda cocokkan di kode Anda (kode-kode yang tercantum di bawah ini). 2. **`log_type`** — salah satu dari `information`, `warning`, atau `error`. Nilai ini ditentukan oleh tindakan yang dikonfigurasi untuk risiko tersebut di alur kerja Anda: **Tidak ada tindakan** → `information`, **Peninjauan** → `warning`, **Tolak** → `error`. 3. **Dampak keputusan** — tindakan terkonfigurasi yang sama juga menentukan `status` laporan NFC: tindakan Peninjauan mengubah statusnya menjadi `In Review`, sedangkan tindakan Tolak mengubahnya menjadi `Declined`. Empat risiko NFC dapat dikonfigurasi dengan cara ini (`SKIPPED_NFC_VALIDATION`, `NFC_CHIP_NOT_VERIFIED`, `NFC_TRUST_ANCHOR_MISSING`, `NFC_AND_OCR_DATA_NOT_SAME`), ditambah lima risiko [Japan My Number Card](#japan-my-number-card-jpki), masing-masing dengan pengaturannya sendiri. Dua risiko sertifikat (`DSC_CERTIFICATE_REVOKED`, `DSC_CERTIFICATE_EXPIRED`) bersifat **informasional saja**: keduanya selalu membawa `log_type: "information"` dan tidak pernah mengubah status NFC dengan sendirinya. Rangkaian lengkap kode risiko yang dihasilkan modul NFC tercantum di bawah ini. Tidak ada kode risiko NFC lainnya. ## Peringatan yang dihasilkan | `risk` | Penyebab | Tingkat Keparahan (`log_type`) | Memengaruhi status? | Remediasi | | - | - | - | - | - | | `SKIPPED_NFC_VALIDATION` | Pembacaan chip dilewati — alur kerja mengizinkan pelewatan (`allow_nfc_skip`) dan pengguna mengetuk opsi lewati, atau klien melewati karena tidak dapat membaca NFC. Alasan pastinya dicatat dalam `additional_data.skip_reason` (lihat [Alasan pelewatan](#alasan-pelewatan)) dan menentukan `long_description` peringatan tersebut. | Mengikuti pengaturan **tindakan lewati NFC** (`skip_nfc_action`): information / warning / error. | Dapat dikonfigurasi — No action, Review, atau Decline. | Jika kebijakan Anda mewajibkan NFC, atur tindakan lewati ke Decline (atau larang pelewatan sama sekali) dan instruksikan pengguna untuk mencoba lagi dari perangkat berkemampuan NFC. Jika tidak, biarkan pada No action untuk beralih kembali ke verifikasi yang hanya menggunakan OCR. | | `NFC_CHIP_NOT_VERIFIED` | Chip berhasil dibaca tetapi gagal dalam verifikasi kriptografis karena alasan selain jangkar kepercayaan yang hilang dan teridentifikasi secara eksplisit. Hash Data Group, tanda tangan SOD, atau pemeriksaan autentikasi pasif lainnya tidak terverifikasi. | Mengikuti pengaturan **tindakan chip yang belum diverifikasi** (`unverified_chip_action`). | Dapat dikonfigurasi — No action, Review, atau Decline. | Perlakukan ini sebagai chip yang berpotensi tidak valid atau telah diubah. Periksa `authenticity` dan `certificate_summary.validation` untuk melihat pemeriksaan mana yang gagal. | | `NFC_TRUST_ANCHOR_MISSING` | Document Signer Certificate (DSC) milik chip termasuk dalam generasi Country Signing Certification Authority (CSCA) yang tidak tersedia di penyimpanan kepercayaan Didit (`certificate_summary.validation.csca_missing` bernilai `true`). Oleh karena itu, Didit tidak dapat menetapkan rantai kepercayaan SOD. | Mengikuti pengaturan **tindakan chip yang belum diverifikasi** (`unverified_chip_action`). | Dapat dikonfigurasi — No action, Review, atau Decline. | Ini merupakan celah cakupan penyimpanan kepercayaan, bukan bukti bahwa chip telah diubah. Tinjau dokumen melalui pemeriksaan cadangan Anda dan hubungi dukungan Didit dengan menyertakan negara penerbit agar CSCA yang hilang dapat diselidiki. | | `NFC_AND_OCR_DATA_NOT_SAME` | MRZ yang dibaca dari chip tidak cocok dengan MRZ hasil OCR dari sisi dokumen yang terlihat (dibandingkan setelah normalisasi, mengabaikan pengisi `<`). Sinyal kuat adanya manipulasi. | Mengikuti pengaturan **tindakan inkonsistensi data** (`inconsistent_data_action`) — pengaturan yang sama yang mengatur pemeriksaan konsistensi data verifikasi identitas. | Dapat dikonfigurasi — No action, Review, atau Decline. | Perlakukan sebagai manipulasi kecuali terbukti sebaliknya; Decline adalah pengaturan umum. Payload `additional_data` mencakup baris MRZ OCR (`ocr_mrz`, array) dan MRZ chip (`nfc_mrz`, string tunggal) untuk perbandingan manual. | | `DSC_CERTIFICATE_REVOKED` | Document Signer Certificate yang menandatangani chip ini tercantum dalam Certificate Revocation List (CRL) negara penerbit. | Selalu `information`. | Tidak — tidak pernah mengubah status NFC dengan sendirinya. | Sinyal kuat bahwa kunci penandatanganan mungkin telah disusupi; arahkan sesi ini ke peninjauan manual melalui logika Anda sendiri jika diperlukan. Perhatikan bahwa chip biasanya juga akan memicu `NFC_CHIP_NOT_VERIFIED`, yang dapat dikonfigurasi. | | `DSC_CERTIFICATE_EXPIRED` | Masa berlaku DSC telah lewat (`certificate_summary.validation.dsc_expired` bernilai `true`). | Selalu `information`. | Tidak — tidak pernah mengubah status NFC dengan sendirinya. | Umum terjadi pada dokumen yang lebih lama. Seperti halnya pencabutan, DSC yang kedaluwarsa juga gagal dalam validasi SOD penuh, sehingga `NFC_CHIP_NOT_VERIFIED` dipicu bersamaan dan menjalankan tindakan yang Anda konfigurasikan. | | `JPKI_CERTIFICATE_INVALID` | Japan My Number Card: sertifikat yang dibaca dari kartu tidak membentuk rantai ke otoritas sertifikasi JPKI untuk jenisnya, berada di luar masa berlakunya, atau bukan sertifikat My Number Card dari jenis tersebut. `additional_data.certificate_types` mencantumkan sertifikat yang gagal; `jpki.certificates[].failure` menjelaskan penyebabnya. | Mengikuti `jpki_certificate_invalid_action` (nilai bawaan: Decline). | Dapat dikonfigurasi: No action, Review, atau Decline. | Perlakukan sebagai kartu yang tidak valid atau telah diubah. Sertifikat kartu yang kedaluwarsa juga masuk ke sini: pemegang kartu memperbaruinya di pemerintah daerah tempat tinggalnya. | | `JPKI_SIGNATURE_INVALID` | Japan My Number Card: tanda tangan kartu atas tantangan sekali pakai tidak terverifikasi terhadap sertifikatnya, sehingga kepemilikan kartu dan pengetahuan tentang PIN-nya tidak terbukti. Juga dimunculkan ketika langkah NFC ditutup tanpa ada pembacaan kartu (`additional_data.certificate_types` saat itu kosong). | Mengikuti `jpki_signature_invalid_action` (nilai bawaan: Decline). | Dapat dikonfigurasi: No action, Review, atau Decline. | Jangan menerima pembacaan kartu sebagai bukti. Minta orang tersebut untuk mencoba lagi dengan kartu fisik. | | `JPKI_CERTIFICATE_REVOKED` | Japan My Number Card: pemeriksaan pencabutan melaporkan sertifikat telah dicabut, misalnya karena kartu dilaporkan hilang atau pendaftaran pemegang kartu berubah (`jpki.revocation_status` bernilai `revoked`). | Mengikuti `jpki_certificate_revoked_action` (nilai bawaan: Decline). | Dapat dikonfigurasi: No action, Review, atau Decline. | Jangan menerima kartu. | | `JPKI_REVOCATION_UNCHECKED` | Japan My Number Card: sertifikat dan tanda tangan berhasil diverifikasi, tetapi tidak ada jawaban pencabutan yang tersedia (`jpki.revocation_status` bernilai `unchecked`), sehingga kartu yang dicabut tidak dapat dikesampingkan. Tidak dimunculkan ketika rantai atau tanda tangan sudah gagal. | Mengikuti `jpki_revocation_unchecked_action` (nilai bawaan: Review). | Dapat dikonfigurasi: No action, Review, atau Decline. | Tentukan seberapa bernilai kartu yang terverifikasi tanpa jawaban pencabutan bagi Anda, dan atur tindakannya sesuai kebutuhan. | | `JPKI_AND_OCR_DATA_NOT_SAME` | Japan My Number Card: nama, tanggal lahir, jenis kelamin, atau alamat dalam sertifikat tanda tangan berbeda dari data yang dibaca dari foto kartu yang sama. `additional_data.fields` menyebutkan atribut yang berbeda, bukan nilainya. | Mengikuti `jpki_inconsistent_data_action` (nilai bawaan: Review). | Dapat dikonfigurasi: No action, Review, atau Decline. | Bandingkan `jpki.attributes` dengan data verifikasi identitas sebelum mengambil keputusan. Nama dengan karakter yang tidak umum dapat berbeda karena sertifikat memuat karakter pengganti (`jpki.attributes.name_substitute_characters`). | > [!NOTE] > > `SKIPPED_NFC_VALIDATION` bersifat saling eksklusif dengan `NFC_CHIP_NOT_VERIFIED` dan `NFC_TRUST_ANCHOR_MISSING`: peringatan verifikasi chip hanya dievaluasi ketika pembacaan chip tidak dilewati. Kedua peringatan verifikasi chip tersebut juga bersifat saling eksklusif. ## String deskripsi yang persis API mengembalikan string `short_description` dan `long_description` persis berikut untuk setiap risiko: | `risk` | `short_description` | `long_description` | | - | - | - | | `SKIPPED_NFC_VALIDATION` | Validasi NFC dilewati | Bergantung pada alasan — lihat [Alasan dilewati](#alasan-pelewatan). Beralih ke "Proses validasi chip Near Field Communication (NFC) tidak selesai, kemungkinan karena masalah teknis atau ketiadaan dukungan NFC." pada sesi lawas yang dicatat sebelum alasan dilewati tersedia. | | `NFC_CHIP_NOT_VERIFIED` | Chip NFC tidak diverifikasi | Chip Near Field Communication (NFC) gagal dalam autentikasi pasif karena alasan selain trust anchor yang teridentifikasi hilang secara eksplisit. Data chip atau tanda tangan mungkin tidak valid atau diubah. | | `NFC_TRUST_ANCHOR_MISSING` | Trust anchor NFC tidak tersedia | Chip Near Field Communication (NFC) tidak dapat diverifikasi karena trust anchor Country Signing Certification Authority (CSCA) negara penerbit tidak tersedia. Ini merupakan kesenjangan cakupan trust store, bukan bukti bahwa chip telah diubah. | | `NFC_AND_OCR_DATA_NOT_SAME` | Data NFC dan OCR tidak sama | Data chip Near Field Communication (NFC) dan data OCR tidak cocok, mengindikasikan potensi manipulasi dokumen atau inkonsistensi data. | | `DSC_CERTIFICATE_REVOKED` | Sertifikat Document Signer dicabut | Document Signer Certificate (DSC) yang digunakan untuk menandatangani data chip ePassport telah dicabut oleh Certificate Revocation List (CRL) negara penerbit, mengindikasikan bahwa kunci penandatanganan mungkin telah disusupi. | | `DSC_CERTIFICATE_EXPIRED` | Sertifikat Document Signer kedaluwarsa | Document Signer Certificate (DSC) yang digunakan untuk menandatangani data chip ePassport telah kedaluwarsa, yang berarti masa berlaku sertifikat telah lewat. | | `JPKI_CERTIFICATE_INVALID` | Sertifikat My Number Card tidak valid | Sertifikat yang dibaca dari chip My Number Card tidak valid: sertifikat tidak membentuk rantai ke otoritas sertifikasi infrastruktur kunci publik Jepang (JPKI), berada di luar masa berlakunya, atau bukan sertifikat My Number Card dari tipe yang diminta. | | `JPKI_SIGNATURE_INVALID` | Tanda tangan My Number Card tidak valid | Tanda tangan yang dibuat My Number Card atas tantangan verifikasi satu kali tidak terverifikasi terhadap sertifikat kartu, sehingga kepemilikan kartu dan pengetahuan tentang PIN-nya tidak terbukti. | | `JPKI_CERTIFICATE_REVOKED` | Sertifikat My Number Card dicabut | Hasil pemeriksaan pencabutan menunjukkan bahwa sertifikat yang dibaca dari My Number Card telah dicabut, misalnya karena kartu dilaporkan hilang atau registrasi pemegangnya berubah. | | `JPKI_REVOCATION_UNCHECKED` | Status pencabutan My Number Card tidak diperiksa | Sertifikat dan tanda tangan My Number Card telah diverifikasi, tetapi status pencabutannya tidak dapat diperiksa, sehingga kemungkinan kartu yang dicabut tidak dapat dikesampingkan. | | `JPKI_AND_OCR_DATA_NOT_SAME` | Data chip My Number Card dan OCR tidak sama | Nama, tanggal lahir, jenis kelamin, atau alamat dalam sertifikat tanda tangan My Number Card tidak cocok dengan data yang dibaca dari gambar kartu (OCR), mengindikasikan kemungkinan penggantian atau inkonsistensi data. | ## Alasan pelewatan Peringatan `SKIPPED_NFC_VALIDATION` memuat `additional_data.skip_reason`, salah satu dari tujuh kode stabil yang menyatakan secara tepat alasan NFC tidak dijalankan (pada sesi yang direkam sebelum alasan pelewatan tersedia, `additional_data` mungkin bernilai `null` — perlakukan kolom ini sebagai opsional saat memproses keputusan historis). Taksonomi yang sama muncul pada tingkat sesi sebagai `nfc_skip_reason` pada payload keputusan — termasuk untuk sesi di mana NFC sama sekali tidak dapat dijalankan (dokumen tanpa chip, integrasi web) sehingga tidak ada laporan atau peringatan NFC yang dibuat. | `skip_reason` | Arti | `long_description` | | - | - | - | | `USER_SKIPPED` | NFC ditawarkan pada perangkat yang kompatibel dan pengguna memilih untuk melewatinya. | Langkah pembacaan chip NFC ditawarkan pada perangkat yang kompatibel, namun pengguna memilih untuk melewatinya (pelewatan diizinkan oleh konfigurasi alur kerja). | | `DOCUMENT_WITHOUT_CHIP` | Desain dokumen tidak memiliki chip NFC yang dapat dibaca (bukan dokumen elektronik ICAO 9303). | Verifikasi NFC tidak dapat dilakukan karena dokumen ini tidak memiliki chip NFC yang dapat dibaca: dokumen ini bukan dokumen elektronik ICAO 9303. | | `CHIP_CERTIFICATE_UNAVAILABLE` | Chip tersebut ada, tetapi tidak ada sertifikat penandatanganan negara penerbit (CSCA) yang mencakup periode penerbitan dokumen, sehingga tanda tangan tidak dapat diverifikasi. | Verifikasi NFC tidak dapat dilakukan karena sertifikat penandatanganan negara penerbit (CSCA) yang mencakup periode penerbitan dokumen ini tidak tersedia, sehingga tanda tangan chip tidak dapat diverifikasi. | | `DEVICE_WITHOUT_NFC` | SDK native melaporkan bahwa ponsel tidak memiliki pembaca NFC. | Verifikasi NFC tidak dapat dilakukan karena perangkat pengguna melaporkan bahwa perangkat tersebut tidak memiliki pembaca NFC. | | `INTEGRATION_WITHOUT_NFC_ACCESS` | Verifikasi dijalankan tanpa SDK native (misalnya di browser web), yang tidak memiliki akses ke pembaca NFC ponsel. | Verifikasi NFC tidak dapat dilakukan karena verifikasi tidak dijalankan melalui SDK seluler native, sehingga tidak ada akses ke pembaca NFC ponsel (browser web tidak dapat membaca chip NFC). | | `MRZ_KEY_UNAVAILABLE` | Kunci akses chip (seed BAC/PACE) tidak dapat diturunkan dari MRZ dokumen. | Verifikasi NFC tidak dapat dilakukan karena kunci akses chip tidak dapat diturunkan dari zona yang dapat dibaca mesin (MRZ) dokumen. | | `JPKI_UNAVAILABLE` | Dokumen tersebut adalah Japan My Number Card, yang chip-nya dibaca melalui JPKI, dan JPKI tidak tersedia untuk verifikasi ini: fitur ini tidak diaktifkan, atau rilis SDK native aplikasi tidak dapat membaca My Number Card. My Number Card yang diverifikasi di browser menerima `INTEGRATION_WITHOUT_NFC_ACCESS`, dan di ponsel tanpa NFC menerima `DEVICE_WITHOUT_NFC`, seperti halnya chip lainnya. | Verifikasi NFC tidak dapat dilakukan karena My Number Card ini dibaca melalui JPKI, yang tidak tersedia untuk verifikasi ini: fitur ini tidak diaktifkan, atau SDK aplikasi tidak dapat membaca My Number Card. | > [!NOTE] > > Laporan NFC dan peringatan `SKIPPED_NFC_VALIDATION` hanya ada jika klien mencapai langkah NFC dan secara eksplisit melewatinya (biasanya `USER_SKIPPED`, atau `DEVICE_WITHOUT_NFC` saat pembaca ternyata tidak tersedia pada waktu pemindaian). Ketika langkah NFC dilewati sebelum sempat ditawarkan — dokumen tanpa chip, sertifikat tidak tersedia, kapabilitas NFC tidak dilaporkan, kunci MRZ tidak terbaca, JPKI tidak tersedia — tidak ada laporan atau peringatan yang dibuat dan alasannya hanya muncul di kolom `nfc_skip_reason` tingkat sesi, tanpa memengaruhi status sesi. ## Konfigurasi Tiga pengaturan alur kerja mengontrol cara peringatan NFC ditangani. Masing-masing dapat diatur ke **Tidak ada tindakan**, **Tinjauan**, atau **Tolak**: 1. **Tindakan lewati NFC** (`skip_nfc_action`) — berlaku untuk `SKIPPED_NFC_VALIDATION`. Opsi lewati hanya ditawarkan kepada pengguna jika `allow_nfc_skip` diaktifkan. 2. **Tindakan chip tidak terverifikasi** (`unverified_chip_action`) — berlaku untuk `NFC_CHIP_NOT_VERIFIED` dan `NFC_TRUST_ANCHOR_MISSING`, sehingga perilaku status sesi tetap sama sementara kode risiko menjelaskan alasan verifikasi gagal. 3. **Tindakan inkonsistensi data** (`inconsistent_data_action`) — berlaku untuk `NFC_AND_OCR_DATA_NOT_SAME`. Ini adalah pengaturan inkonsistensi data yang sama dengan yang digunakan oleh Verifikasi Identitas. Kedua risiko `DSC_CERTIFICATE_*` tidak memiliki pengaturan tindakan — keduanya selalu bersifat informatif. Risiko Japan My Number Card memiliki lima pengaturan tambahan, yang tercantum di bagian berikutnya. ## Japan My Number Card (JPKI) Japan My Number Card dibaca melalui JPKI, bukan ICAO 9303 (`chip_protocol: "jpki"`), sehingga risiko ICAO di atas tidak pernah dipicu untuk kartu ini. Pembacaan kartu ini memicu lima risiko berikut, masing-masing dengan pengaturannya sendiri pada node NFC: | Pengaturan | Risiko | Bawaan | | - | - | - | | `jpki_certificate_invalid_action` | `JPKI_CERTIFICATE_INVALID` | Tolak | | `jpki_signature_invalid_action` | `JPKI_SIGNATURE_INVALID` | Tolak | | `jpki_certificate_revoked_action` | `JPKI_CERTIFICATE_REVOKED` | Tolak | | `jpki_revocation_unchecked_action` | `JPKI_REVOCATION_UNCHECKED` | Tinjauan | | `jpki_inconsistent_data_action` | `JPKI_AND_OCR_DATA_NOT_SAME` | Tinjauan | Pembacaan My Number Card yang dilewati akan memicu `SKIPPED_NFC_VALIDATION` dan mengikuti `skip_nfc_action`, seperti chip lainnya. Lihat [Japan My Number Card (JPKI)](https://docs.didit.me/id/core-technology/nfc-verification/overview.md#japan-my-number-card-jpki) untuk informasi tentang cara kerja pembacaannya. > [!WARNING] > > Pembacaan My Number Card melalui JPKI belum diaktifkan di produksi. Hingga fitur ini aktif, My Number Card akan melewati langkah NFC dengan alasan lewati `JPKI_UNAVAILABLE` dan tidak satu pun risiko ini dipicu. ## Contoh ### Dalam peninjauan — chip tidak dapat diverifikasi ```json theme={null} { "warnings": [ { "feature": "NFC", "risk": "NFC_CHIP_NOT_VERIFIED", "additional_data": null, "log_type": "warning", "short_description": "NFC chip not verified", "long_description": "The Near Field Communication (NFC) chip failed passive authentication for a reason other than an explicitly identified missing trust anchor. The chip data or signature could be invalid or altered.", "node_id": "nfc_primary" }, { "feature": "NFC", "risk": "DSC_CERTIFICATE_EXPIRED", "additional_data": null, "log_type": "information", "short_description": "Document Signer Certificate expired", "long_description": "The Document Signer Certificate (DSC) used to sign the ePassport chip data has expired, meaning the certificate's validity period has passed.", "node_id": "nfc_primary" } ] } ``` Di sini tindakan chip yang belum diverifikasi diatur ke Review, sehingga `NFC_CHIP_NOT_VERIFIED` membawa `log_type: "warning"` dan status laporan NFC adalah `In Review`. Entri DSC yang kedaluwarsa murni bersifat informasi. ### Ditolak — ketidakcocokan chip / OCR ```json theme={null} { "warnings": [ { "feature": "NFC", "risk": "NFC_AND_OCR_DATA_NOT_SAME", "additional_data": { "ocr_mrz": ["P