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.
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:
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; ataupattern.min_length: dari0hinggamax_length.max_length: dari1hingga500. Bawaan120.pattern: wajib jika menggunakankind: "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.
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
- Buka Alur kerja, lalu buka alur kerja dan tambahkan langkah Tanda Tangan Elektronik setelah langkah-langkah yang memverifikasi penanda tangan.
- 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.
- 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 (
keydari 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. - 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.
- 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).
- Di Aturan, tetapkan pengaruh masing-masing peringatan terhadap keputusan akhir.
- 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.
- Simpan alur kerja.
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.- Pengantar. Penandatangan melihat dokumen yang akan mereka tanda tangani.
- 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. - Peninjauan. Penandatangan melihat dokumen kembali dan, jika salah satu dokumen memiliki kolom, menyetujui untuk menandatanganinya secara elektronik.
- 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. - Ditandatangani. Setelah menandatangani, penandatangan dapat mengunduh dokumen yang telah mereka tanda tangani. Jika Anda mengaktifkannya, Didit juga mengirimkan salinannya melalui email kepada mereka.
- 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.
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.
Hasil
Hasil setiap penandatangan merupakan item darisignatures[] 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
- Laporan Tanda Tangan Elektronik:
signatures[], PDF yang ditandatangani, PDF bukti, dan unduhan. - Peringatan Tanda Tangan Elektronik: setiap peringatan dan aturan yang mengontrolnya.
- Buat sesi: kirim dokumen, kolom, dan nilai kolom per sesi.
- Konfigurasi fitur alur kerja: setiap pengaturan langkah.