Langsung ke konten utama
Tanda Tangan Elektronik memungkinkan seseorang menandatangani dokumen Anda dalam alur yang sama. Mereka memeriksa setiap dokumen, menambahkan tanda tangan, inisial, dan data apa pun yang Anda minta, serta, pada tingkat Lanjut (AES), mengonfirmasi dengan kode sekali pakai yang dikirimkan ke email atau telepon yang telah mereka verifikasi sebelumnya. Didit mengembalikan setiap dokumen yang telah ditandatangani, ditambah PDF bukti yang mencatat siapa yang menandatangani dan bagaimana caranya. Tanda Tangan Elektronik memiliki tiga tingkat. Sederhana adalah bawaan dan tidak memerlukan Verifikasi Identitas, email, atau telepon. Tingkat lanjut (AES) memerlukan Verifikasi Identitas yang disetujui serta email atau telepon yang terverifikasi, dan mengikat tanda tangan tersebut dengan identitas yang terverifikasi. Berkualifikasi (QES) adalah tambahan yang belum tersedia. Lihat Tingkat tanda tangan. Fitur ini berfungsi untuk Verifikasi Pengguna (KYC), tempat orang yang terverifikasi menandatangani, dan untuk Verifikasi Bisnis (KYB), tempat perwakilan hukum atau pihak kunci perusahaan menandatangani atas namanya.

Tingkat tanda tangan

Pada tingkat lanjut (AES), tanda tangan hanya menggunakan PAdES. Nilai signature_format xades dan cades ditolak untuk AES dengan signature_format_not_supported. Periksa signature_availability pada alur kerja sebelum Anda menyimpan langkah AES: selama aes bernilai false, menyimpan langkah baru akan mengembalikan 400 dengan aes_not_available.

Cara kerjanya

1

Untuk Tingkat lanjut (AES), alur kerja memverifikasi penandatangan terlebih dahulu

Pada tingkat Lanjut (AES), langkah tanda tangan berjalan setelah langkah-langkah yang menetapkan siapa yang menandatangani: Verifikasi Identitas, serta Verifikasi Email atau Telepon untuk kontak yang dituju oleh kode tersebut. Lihat Sebelum memulai. Tingkat Sederhana tidak memerlukan langkah sebelumnya.
2

Didit menyiapkan dokumen

Saat penandatangan mencapai langkah ini, Didit menyalin dokumen dan kolomnya ke dalam sesi serta mencatat SHA-256 dari setiap dokumen. Perubahan pada alur kerja di kemudian hari tidak dapat mengubah apa yang dilihat oleh penandatangan ini.
3

Penandatangan memeriksa setiap dokumen

Untuk dokumen yang memiliki kolom, penandatangan dipandu dari satu kolom ke kolom lainnya. Mereka membuat tanda tangan satu kali dan tanda tangan tersebut diterapkan ke setiap kolom tanda tangan dan inisial, serta mereka mengisi kolom teks dan kotak centang. Nilai yang diambil Didit dari identitas terverifikasi, sesi, atau sistem Anda sudah ada di halaman tersebut. Untuk dokumen tanpa kolom, mereka membaca dan menyetujuinya.
4

Untuk Tingkat lanjut (AES), penandatangan mengonfirmasi dengan kode

Jika ada dokumen yang memiliki kolom, penandatangan terlebih dahulu setuju untuk menandatangani dokumen secara elektronik. Pada tingkat Lanjut (AES), Didit kemudian mengirimkan kode enam digit ke email atau telepon yang telah mereka verifikasi sebelumnya dalam sesi, dan tindakan memasukkan kode tersebut mengotorisasi tanda tangan pada setiap dokumen dalam langkah tersebut. Pada tingkat Sederhana, tidak ada kode: memberikan persetujuan adalah hal yang mengotorisasi tanda tangan.
5

Didit menandatangani dan menyegel

Didit mengisi tanggal penandatanganan, mencantumkan setiap nilai kolom dalam setiap PDF, dan menambahkan halaman bukti. Pada tingkat Lanjut (AES), Didit kemudian menerapkan tanda tangan PAdES dan stempel waktu, sehingga tanda tangan mencakup semua hal yang ada di halaman tersebut. Pada tingkat Sederhana, file berupa PDF dengan halaman bukti dan tanpa tanda tangan digital, segel, atau stempel waktu.
6

Anda mendapatkan hasilnya

Keputusan dan webhook sesi memuat signatures[] beserta penandatangan, konfirmasi, sertifikat, stempel waktu, hash setiap dokumen, dan nilai setiap kolom. Anda mengunduh PDF yang telah ditandatangani serta PDF bukti, dan Didit dapat mengirimkan salinannya melalui email kepada penandatangan.

Sebelum Anda mulai

Pada tingkat Advanced (AES), penandatangan harus diverifikasi sebelum mereka dapat menandatangani. Didit mengambil nama dan kontak mereka dari rekaman terverifikasi milik sesi itu sendiri, tidak pernah dari apa yang Anda atau penandatangan ketikkan. Tingkat Simple tidak memerlukan semua ini: tingkat ini tidak memiliki Verifikasi Identitas, email, telepon, atau kode, dan ditolak untuk penandatangan KYB. Untuk Verifikasi Pengguna (KYC), tempatkan langkah-langkah ini sebelum Tanda Tangan Elektronik di dalam alur kerja:
  • Verifikasi Identitas, disetujui, dengan nama yang dapat dibaca. Tanpanya, langkah ini mencatat SIGNATURE_IDENTITY_NOT_VERIFIED.
  • Verifikasi Email saat kode dikirim melalui email (default), atau Verifikasi Telepon saat dikirim melalui SMS. Kode hanya dikirim ke kontak yang diverifikasi dalam sesi yang sama.
  • Jika alur kerja juga memiliki Deteksi Liveness, langkah tersebut harus disetujui.
Untuk mengirimkan salinan dokumen yang telah ditandatangani ke email penandatangan, sesi ini juga memerlukan email terverifikasi, bahkan ketika kode dikirim melalui SMS. Untuk Verifikasi Bisnis (KYB), penandatangan adalah pihak kunci perusahaan, masing-masing dengan KYC mereka sendiri yang telah disetujui: Langkah KYB memiliki antara 1 hingga 20 penandatangan, dan masing-masing memerlukan KYC yang disetujui pada saat mereka menandatangani. Masing-masing menandatangani salinan dokumen mereka sendiri dan mengonfirmasi dengan kode yang dikirim ke kontak yang diverifikasi dalam sesi KYC mereka sendiri. Nama yang dideklarasikan untuk pihak kunci harus cocok dengan nama terverifikasi mereka, mengabaikan huruf besar/kecil dan spasi, atau langkah tersebut mencatat SIGNATURE_NAME_MISMATCH. Langkah ini selesai setelah setiap penandatangan telah menandatangani atau menolak.

Dokumen

Dari mana dokumen berasal

signature_documents_source menentukan dari mana sebuah langkah mendapatkan dokumennya: Dokumen per sesi adalah cara agar seseorang dapat menandatangani kontrak dengan nama, jumlah, atau ketentuan mereka sendiri yang telah diisi sebelumnya oleh sistem Anda.

File yang didukung

Saat Anda mengunggah dokumen Word, Didit mengonversinya ke PDF selama proses pengunggahan, dalam waktu paling lama 60 detik. Halaman hasil konversi adalah halaman yang dilihat dan ditandatangani oleh penandatangan, jadi periksalah sebelum Anda menempatkan kolom: pemisah baris dapat sedikit berbeda dari Word. File Word dan PDF-nya merupakan bagian dari dokumen yang sama dan dihapus bersamanya. PDF bukti mencatat konversi dan SHA-256 dari kedua file tersebut. Didit menolak file Word dengan signature_document_not_supported dan reason ketika hal yang akan ditandatangani bersifat ambigu: memiliki makro (macros), perubahan terlacak yang belum disetujui (tracked_changes), tautan ke konten eksternal (external_links), atau objek tersemat (embedded_objects). Terima atau tolak perubahan terlacak sebelum Anda mengunggah, sehingga PDF menampilkan teks yang Anda setujui. File yang tidak dapat dikonversi ditolak dengan signature_document_conversion_failed dan salah satu alasan berikut:

Kolom pada dokumen

Kolom mengubah dokumen menjadi templat yang diisi oleh penandatangan, sama seperti saat Anda menyiapkan amplop di alat penandatanganan desktop. Dokumen tanpa kolom mempertahankan alur yang lebih sederhana: penandatangan membacanya dan menyetujuinya. Belum ada pemilih tanggal dalam versi ini. Gunakan kolom text untuk tanggal yang dimasukkan oleh penandatangan. Kolom memiliki properti berikut:
Sebuah dokumen dapat memuat hingga 200 kolom, dan satu penandatangan hingga 500 kolom di seluruh dokumen mereka. Suatu langkah hanya mengisi dan membubuhkan stempel pada kolom milik penandatangannya sendiri. Dokumen dapat memuat kolom untuk beberapa peran hanya jika beberapa langkah Tanda Tangan dari alur kerja menggunakannya: setiap langkah mengisi kolom dari perannya masing-masing dan membiarkan kolom lainnya kosong pada salinannya. Kolom untuk peran yang tidak digunakan oleh langkah Tanda Tangan mana pun dalam alur kerja akan ditolak dengan role_not_used. Setiap peran yang memiliki kolom pada sebuah dokumen memerlukan setidaknya satu kolom signature atau initials di dokumen tersebut, atau versi alur kerja tidak dapat dipublikasikan (signature_field_missing).

Validasi

validation berlaku untuk kolom text:
  • kind: any; letters (huruf dalam aksara apa pun, spasi, tanda hubung, dan apostrof); number (digit dengan pemisah desimal opsional); email; atau pattern.
  • min_length: dari 0 hingga max_length.
  • max_length: dari 1 hingga 500. Bawaan 120.
  • pattern: wajib jika menggunakan kind: "pattern". Ekspresi reguler hingga 200 karakter yang harus cocok dengan keseluruhan nilai. Lookaround dan referensi balik tidak didukung.
  • message: hingga 120 karakter, ditampilkan sebagai pengganti kesalahan bawaan.
Pratinjau konsol, alur penandatanganan, dan API menerapkan aturan yang sama.

Nilai yang diisi sebelumnya

prefill menentukan sumber nilai untuk suatu kolom: Kolom data harus memiliki prefill. Kolom full_name selalu menggunakan identity.full_name dan kolom email menggunakan contact.email, serta kolom text juga dapat memilikinya. Nilai kolom data, full_name, dan email terverifikasi ditetapkan secara permanen saat penanda tangan mulai menandatangani: perubahan sesi setelahnya tidak memengaruhinya. Kolom text atau email yang diisi sebelumnya bersifat hanya-baca kecuali Anda menetapkan editable_when_prefilled. Jika sumber untuk kolom wajib tidak memiliki nilai pada saat itu, misalnya sesi tanpa alamat, kolom tersebut tetap kosong dan penanda tangan tetap dapat menandatangani. Tidak ada peringatan yang dimunculkan, dan value_unavailable_reason dalam laporan menjelaskan penyebabnya.

Konfigurasikan di konsol

  1. Buka Alur kerja, lalu buka alur kerja dan tambahkan langkah Tanda Tangan Elektronik setelah langkah-langkah yang memverifikasi penanda tangan.
  2. Di Dokumen, pilih Unggah untuk menambahkan file PDF atau Word, lalu seret untuk menyusun urutan tampilan bagi penanda tangan. File Word dikonversi menjadi PDF: periksa halaman hasil konversi sebelum Anda meletakkan bidang. Ganti menukar file dokumen dan mempertahankan bidangnya, kecuali bidang pada halaman yang tidak ada lagi di file baru.
  3. Di bagian Letakkan bidang di dokumen, pilih Buka editor. Seret bidang dari palet ke halaman, atau pilih bidang tersebut dan klik posisi penempatannya, lalu pindahkan dan sesuaikan ukurannya. Untuk setiap bidang, atur Siapa yang mengisi, labelnya, apakah bersifat Wajib, apa yang dapat diterimanya, dari mana nilainya berasal, dan kunci API-nya (key dari bidang tersebut). Pratinjau sebagai penanda tangan menampilkan dokumen seperti yang dilihat penanda tangan di ponsel atau desktop. Editor menyimpan perubahan secara otomatis (Tersimpan ke draf) dan mencantumkan hal-hal yang perlu diperbaiki sebelum Anda memilih Selesai.
  4. Masih di Dokumen, pilih asal dokumen: Alur kerja ini, Setiap sesi, atau Keduanya. Untuk dokumen tanpa bidang, pilih apakah penanda tangan harus Baca sampai akhir sebelum menandatangani dan memberikan Satu persetujuan per dokumen.
  5. Di Tanda tangan, pilih Penanda tangan, Tingkat (Sederhana, bawaan, atau Tingkat lanjut (AES); Berkualifikasi (QES) berstatus Segera hadir), Format, dan tujuan pengiriman kode (Kode sekali pakai melalui).
  6. Di Aturan, tetapkan pengaruh masing-masing peringatan terhadap keputusan akhir.
  7. Di Lanjutan, pilih apakah ingin Kirim salinan bertanda tangan melalui email dan Tambahkan halaman bukti, serta berapa hari tautan penandatanganan tetap valid. Anda juga dapat menambahkan aturan status kustom.
  8. Simpan alur kerja.
Untuk mengonfigurasi langkah yang sama melalui API, lihat Konfigurasi fitur alur kerja. Dokumen alur kerja dan bidangnya dikelola di konsol; melalui API, kirimkan dokumen dan bidang per sesi.

Pengalaman penandatanganan

Langkah penandatanganan berjalan di halaman verifikasi yang di-hosting, Web SDK, dan SDK native, di desktop maupun di ponsel. Anda tidak perlu membangun UI penandatanganan apa pun.
  1. Pengantar. Penandatangan melihat dokumen yang akan mereka tanda tangani.
  2. Setiap dokumen, secara berurutan. Untuk dokumen yang memiliki kolom, penandatangan dipandu melalui kolom-kolomnya sesuai urutan position. Kolom tanda tangan atau paraf pertama membuka lembar tempat mereka mengadopsi tanda tangan. Kolom opsional ditandai Opsional. Nilai yang diisi oleh Didit ditampilkan pada halaman dengan ikon gembok dan bukan merupakan langkah. Mengetuk kolom pada halaman akan langsung melompat ke kolom tersebut. Di ponsel, satu kolom ditampilkan pada satu waktu di panel yang tetap berada di atas keyboard. Pada layar dengan lebar minimal 1200 px, halaman diletakkan di samping daftar kolom. Menyelesaikan dokumen dengan kolom wajib yang masih kosong akan menampilkan berapa banyak kolom yang tersisa dan melompat ke kolom pertama. Dokumen tanpa kolom dibaca dan disetujui, sesuai konfigurasi Anda.
  3. Peninjauan. Penandatangan melihat dokumen kembali dan, jika salah satu dokumen memiliki kolom, menyetujui untuk menandatanganinya secara elektronik.
  4. Kode (hanya Tingkat Lanjut (AES)). Penandatangan meminta kode mereka. Kode ini berlaku selama 5 menit, kode baru dapat dikirim setelah 60 detik, dan penandatangan mendapatkan hingga 5 kode dan 3 kali percobaan salah. Jika jatah kode atau percobaan tersebut habis, sistem mencatat SIGNATURE_OTP_FAILED. Pada tingkat Sederhana tidak ada kode: penandatangan langsung beralih dari peninjauan ke penandatanganan.
  5. Ditandatangani. Setelah menandatangani, penandatangan dapat mengunduh dokumen yang telah mereka tanda tangani. Jika Anda mengaktifkannya, Didit juga mengirimkan salinannya melalui email kepada mereka.
  6. Tolak. Penandatangan dapat menolak alih-alih menandatangani. Tindakan ini mencatat SIGNATURE_DECLINED. Penolakan dapat dibuka kembali selama tautan penandatanganan masih valid, sehingga penandatangan tetap dapat menandatangani jika mereka berubah pikiran.
Alur ini memberi tahu penandatangan ketika kode mereka kedaluwarsa, dokumen berubah, penandatanganan gagal, atau tautan penandatanganan kedaluwarsa. Tautan penandatanganan tetap valid selama signature_link_validity_days (1 hingga 30, nilai default 7), dihitung sejak sesi dibuat. Sesi tetap terbuka setidaknya selama jangka waktu tersebut.
SDK native menampilkan langkah penandatanganan mulai dari rilis yang menambahkannya, tercantum dalam ringkasan SDK native saat dirilis. Dokumen dengan kolom memerlukan rilis yang mendukung kolom: rilis yang lebih lama tidak dapat menampilkannya, dan langkah tersebut akan menampilkan kesalahan. Dokumen tanpa kolom berfungsi di setiap rilis yang memiliki langkah penandatanganan. Hingga aplikasi Anda menjalankan rilis yang mendukung fitur yang digunakan alur kerja Anda, arahkan pengguna ke halaman yang di-hosting atau Web SDK.

Mengadopsi tanda tangan

Penandatangan mengadopsi tanda tangan dan paraf mereka satu kali, dalam satu lembar, saat pertama kali dokumen meminta salah satunya:
  • Diketik: nama terverifikasi mereka dalam gaya tulisan tangan yang mereka pilih, ditandai Dari ID Anda. Mereka tidak dapat mengetikkan nama yang berbeda. Paraf yang diketik adalah huruf-huruf pertama dari nama tersebut.
  • Digambar: digambar dengan jari atau mouse, baik tanda tangan maupun paraf.
Setiap kolom tanda tangan atau paraf berikutnya diterapkan hanya dengan satu ketukan, dan mengetuk tanda tangan atau paraf yang telah diterapkan akan menghapusnya kembali.

Hasil

Hasil setiap penandatangan merupakan item dari signatures[] dalam keputusan sesi dan di dalam decision pada webhook sesi. Tidak ada webhook tanda tangan terpisah: event status.updated dari sesi memberi tahu Anda kapan harus mengambil hasil keputusan. Anda mendapatkan PDF yang ditandatangani dari setiap dokumen, PDF bukti untuk setiap penandatangan, serta SHA-256 dari setiap file asli dan yang telah ditandatangani, sehingga Anda dapat membuktikan nantinya bahwa tidak ada yang berubah. Untuk dokumen dengan kolom, Anda juga mendapatkan nilai setiap kolom, dari mana asalnya dan kapan diisi, ditambah tanda tangan yang diadopsi serta waktu penandatangan menyetujui penandatanganan secara elektronik. Lihat Laporan Tanda Tangan Elektronik untuk setiap kolom, unduhan, dan cara memvalidasi ulang tanda tangan. Di konsol, tab Tanda tangan pada sesi menampilkan dokumen, kemudian blok Kolom dengan pratinjau setiap halaman, tanda tangan dan paraf yang diadopsi, serta nilai, waktu, dan sumber setiap kolom. Laporan PDF menyertakan bagian tanda tangan, dan halaman Tanda Tangan Elektronik · kolom ketika dokumen memiliki kolom.

Harga

Tanda Tangan Elektronik dikenai biaya $0.10 per sesi yang ditandatangani, termasuk dalam kredit gratis Anda, berapa pun jumlah dokumen dalam satu penandatanganan dan baik pada tingkat Sederhana maupun Tingkat Lanjut (AES). Tanda tangan yang ditolak, gagal, atau kedaluwarsa tidak dikenakan biaya. Berkualifikasi (QES) adalah fitur tambahan yang belum tersedia dan belum memiliki harga.

Menghapus data tanda tangan

Saat Anda menghapus sesi, data tanda tangannya ikut dihapus bersamanya: dokumen yang dikirim bersama sesi dan file Word aslinya, salinan yang disiapkan untuk setiap penandatangan, PDF yang ditandatangani, PDF bukti, gambar tanda tangan dan paraf yang diadopsi, serta setiap nilai kolom. Tautan unduhannya berhenti berfungsi. Hal yang sama terjadi ketika sesi dihapus pada akhir periode retensi data Anda. Penghapusan tidak dapat dibatalkan, jadi unduh apa pun yang perlu Anda simpan terlebih dahulu.
  • Dokumen yang ditandatangani dari Verifikasi Bisnis (KYB) dimiliki oleh sesi perusahaan tersebut. Menghapus sesi tersebut akan menghapus dokumen-dokumennya.
  • Menghapus dokumen dari alur kerja akan menghapusnya, beserta kolom-kolomnya dan file Word aslinya. Penandatangan yang telah mulai menandatangani tetap menyimpan salinan yang diperlihatkan kepada mereka, sebagai bagian dari sesi mereka, sampai Anda menghapus sesi tersebut. Hapus dokumen hanya dari alur kerja yang tidak memiliki sesi yang sedang menunggu untuk ditandatangani.
  • Salinan yang telah dikirimkan Didit melalui email kepada penandatangan berada di kotak masuk mereka dan tidak terpengaruh.

Terkait

Terakhir diubah pada 7 November 2026