> ## 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 Risiko Tanda Tangan Elektronik

> Panduan peringatan Tanda Tangan Elektronik Didit, pemicu, dan aturannya, dari SIGNATURE_DECLINED hingga SIGNATURE_DOCUMENT_CHANGED.

Langkah [Tanda Tangan Elektronik](https://docs.didit.me/id/core-technology/electronic-signature/overview.md) memunculkan peringatan ketika penandatangan tidak dapat atau menolak untuk menandatangani: mereka menolak, kehabisan kode, atau tidak dapat dicocokkan dengan identitas yang terverifikasi, atau dokumen tidak lagi cocok dengan apa yang ditampilkan kepada mereka. Setiap peringatan menghentikan tanda tangan penandatangan tersebut, sehingga tidak ada dokumen bertanda tangan yang diterbitkan untuknya. Apa dampak peringatan tersebut terhadap keputusan akhir terserah kepada Anda.

## Gambaran umum

Peringatan muncul di dua tempat:

* Pada item penandatangan di `signatures[]`, sebagai `{ "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }` dalam `warnings[]`. Lihat [Laporan Tanda Tangan Elektronik](https://docs.didit.me/id/core-technology/electronic-signature/report-electronic-signature.md).
* Dalam aktivitas sesi, ditandai dengan fitur `SIGNATURE`, beserta judul dan deskripsinya. Konsol menampilkannya di tab **Tanda tangan** sesi, dan `additional_data.signature_id` mengarah ke penandatangan tersebut.

Setiap kode dipetakan ke sebuah aturan. Tetapkan aturan sebagai `DECLINE`, `REVIEW`, atau `NO_ACTION` untuk setiap langkah alur kerja, di tab **Aturan** konsol atau dalam [konfigurasi](https://docs.didit.me/id/management-api/workflows/feature-configs.md#tanda-tangan-elektronik) langkah tersebut. Aturan ini menentukan `verdict` penandatangan (`Declined`, `In Review`, atau `Approved`) dan tingkat keparahan peringatan (`error`, `warning`, atau `information`). Aturan status kustom pada langkah tersebut berlaku setelahnya.

> [!WARNING]
>
> Aturan menentukan keputusan akhir, bukan apakah dokumen telah ditandatangani. `NO_ACTION` memungkinkan alur kerja berlanjut, tetapi penandatangan tetap belum menandatangani. Pastikan `status` adalah `signed` sebelum Anda mengandalkan tanda tangan.

## Peringatan yang dihasilkan

| Kode | Kapan dimunculkan | Aturan dan nilai default |
| - | - | - |
| `SIGNATURE_DECLINED` | Penandatangan menolak untuk menandatangani. Salinan bertanda tangan tidak diterbitkan dan tidak ada biaya yang dikenakan. | `signature_declined_action`, nilai default `REVIEW` |
| `SIGNATURE_OTP_FAILED` | Penandatangan memasukkan 3 kode yang salah, atau meminta lebih dari 5 kode. | `signature_otp_failed_action`, nilai default `DECLINE` |
| `SIGNATURE_NAME_MISMATCH` | KYB: nama yang dideklarasikan untuk pihak kunci tidak cocok dengan nama terverifikasinya, mengabaikan huruf besar/kecil dan spasi. | `signature_name_mismatch_action`, nilai default `DECLINE` |
| `SIGNATURE_IDENTITY_NOT_VERIFIED` | Penandatangan tidak memiliki verifikasi identitas yang disetujui dengan nama, pemeriksaan liveness dalam sesi mereka tidak disetujui, atau verifikasi identitas berubah setelah penandatangan memulai. | `signature_identity_not_verified_action`, nilai default `DECLINE` |
| `SIGNATURE_DOCUMENT_CHANGED` | Dokumen tidak lagi cocok dengan SHA-256 yang dicatat saat ditampilkan kepada penandatangan. | `signature_document_changed_action`, nilai default `DECLINE` |

Pemeriksaan identitas dan nama berjalan saat penandatangan meminta kode mereka dan sekali lagi saat mereka memasukkannya, sehingga peringatan ini muncul pada titik tersebut daripada saat langkah dibuka.

## Penolakan dapat dibatalkan dengan membuka kembali

`SIGNATURE_DECLINED` adalah satu-satunya peringatan yang dapat dibatalkan oleh penandatangan. Selama tautan penandatanganan masih valid, penandatangan yang sebelumnya menolak dapat membuka kembali langkah tersebut dan menandatangani. Membuka kembali akan menghapus peringatan penandatangan serta status pembacaan dan persetujuan mereka pada setiap dokumen, sehingga mereka membaca ulang dokumen-dokumen tersebut. Peringatan akan dihapus dari aktivitas sesi setelah tidak ada penandatangan pada langkah tersebut yang masih menolak. Membuka kembali tidak mereset percobaan kode mereka. Peringatan lainnya bersifat final untuk penandatangan tersebut.

## Masalah yang dilihat penandatangan

Masalah ini menghentikan penandatangan tanpa memunculkan peringatan. Alur akan memberi tahu mereka apa yang terjadi.

| Situasi | Apa yang terjadi |
| - | - |
| Tautan penandatanganan kedaluwarsa | Langkah ini tidak dapat dibuka atau diselesaikan setelah `expires_at`. Tautan berlaku selama `signature_link_validity_days` sejak sesi dibuat. |
| Kode kedaluwarsa | Kode berlaku selama 5 menit. Penandatangan meminta kode baru. |
| Kode baru diminta terlalu cepat | Penandatangan menunggu 60 detik di antara permintaan kode. |
| Tidak ada kontak yang terverifikasi | Kode hanya dikirim ke email atau telepon yang diverifikasi sebelumnya dalam sesi tersebut. Tambahkan Verifikasi Email atau Verifikasi Telepon sebelum langkah tanda tangan. |
| Kolom wajib masih kosong | Penandatangan tidak dapat menyelesaikan dokumen sampai setiap kolom wajib di dalamnya memiliki nilai. Alur menampilkan berapa banyak yang tersisa dan langsung menuju ke kolom pertama yang belum diisi. |
| Nilai kolom ditolak | Nilai yang melanggar [validasi](https://docs.didit.me/id/core-technology/electronic-signature/overview.md#validasi) kolomnya, misalnya terlalu panjang atau bukan angka, ditolak dan alur menjelaskan alasannya. |
| Versi aplikasi terlalu lama untuk mendukung kolom | Rilis SDK native tanpa dukungan untuk kolom formulir tidak dapat menampilkan dokumen yang memiliki kolom isian, dan langkah tersebut menampilkan kesalahan. Dokumen tanpa kolom isian tetap berfungsi. Lihat [Pengalaman penandatanganan](https://docs.didit.me/id/core-technology/electronic-signature/overview.md#pengalaman-penandatanganan). |

## Contoh

```json theme={null}
{
  "signatures": [
    {
      "id": "0e6c2a8e-6c2f-4b8e-9a51-3f2f6a7d9b10",
      "node_id": "feature_signature",
      "status": "declined",
      "verdict": "In Review",
      "warnings": [
        { "code": "SIGNATURE_DECLINED", "node_id": "feature_signature" }
      ],
      "declined_at": "2026-11-03T10:41:40.320Z",
      "declined_action": "REVIEW",
      "signed_at": null,
      "certificate": null,
      "timestamp": null,
      "evidence_file": null
    }
  ]
}
```

Contoh ini hanya menampilkan kolom yang berubah. Setiap kolom lain dari [objek tanda tangan](https://docs.didit.me/id/core-technology/electronic-signature/report-electronic-signature.md#objek-tanda-tangan) tetap ada.

## Jenis peringatan

Tingkat keparahan setiap peringatan mengikuti aturan yang Anda tetapkan. Tingkat keparahan dibagi menjadi tiga kategori:

## Terkait

* [Ringkasan Tanda Tangan Elektronik](https://docs.didit.me/id/core-technology/electronic-signature/overview.md)
* [Laporan Tanda Tangan Elektronik](https://docs.didit.me/id/core-technology/electronic-signature/report-electronic-signature.md)
* [Konfigurasi fitur alur kerja](https://docs.didit.me/id/management-api/workflows/feature-configs.md#tanda-tangan-elektronik)


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