Peringatan & Kode Risiko Tanda Tangan Elektronik

Langkah Tanda Tangan Elektronik 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.
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 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.

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 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.

Contoh

{
  "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 tetap ada.

Jenis peringatan

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

Autentikasi

Verifikasi

Pemantauan

Platform

Peringatan & Kode Risiko Tanda Tangan Elektronik

Gambaran umum

Peringatan yang dihasilkan

Penolakan dapat dibatalkan dengan membuka kembali

Masalah yang dilihat penandatangan

Contoh

Jenis peringatan

Terkait

​Gambaran umum

​Peringatan yang dihasilkan

​Penolakan dapat dibatalkan dengan membuka kembali

​Masalah yang dilihat penandatangan

​Contoh

​Jenis peringatan

​Terkait

Gambaran umum

Peringatan yang dihasilkan

Penolakan dapat dibatalkan dengan membuka kembali

Masalah yang dilihat penandatangan

Contoh

Jenis peringatan

Terkait