Langsung ke konten utama
Setiap langkah Tanda Tangan Elektronik menghasilkan satu hasil per penandatangan. Anda dapat menemukannya sebagai item dalam signatures[] di: signatures hanya ada di dalam keputusan ketika alur kerja memiliki langkah Tanda Tangan Elektronik. Kolom ini berupa array kosong sampai penandatangan mencapai langkah tersebut. Langkah KYC memiliki satu item; langkah KYB memiliki satu item per penandatangan.

Contoh

Objek tanda tangan

Jangan pernah menganggap penandatangan telah menandatangani sampai status bernilai signed. Pada tanda tangan Advanced (AES), sertifikat, stempel waktu, atau signed_file yang bernilai null berarti belum ada tanda tangan. Tanda tangan Simple yang telah ditandatangani memiliki signed_file tetapi selalu memiliki sertifikat dan stempel waktu yang bernilai null.

Penandatangan

Dokumen

Kolom

Setiap item dari documents[].fields[] adalah satu kolom dokumen, beserta nilainya pada salinan penanda tangan ini:

Unduh dokumen yang ditandatangani

Gunakan path dalam signed_file dan evidence_file dengan kunci API Anda. Setiap rute mengembalikan PDF itu sendiri.
Sebelum merespons, Didit memeriksa file yang disimpan terhadap SHA-256 yang tercatat. Jika berbeda, rute PDF yang ditandatangani dan rute bukti mengembalikan 409 dan rute gambar mengembalikan 400, masing-masing dengan signature_document_changed. Selalu berikan signature_id ke rute bukti ketika langkah KYB memiliki beberapa penanda tangan.

PDF yang ditandatangani

PDF yang ditandatangani memuat, secara berurutan:
  1. Halaman dokumen yang ditampilkan kepada penanda tangan, dengan setiap nilai kolom dicap di tempat yang Anda tentukan.
  2. Halaman bukti, kecuali jika Anda menonaktifkan signature_evidence_page.
  3. Hanya untuk Advanced (AES), tanda tangan PAdES, dengan stempel waktu RFC 3161 yang diterbitkan oleh Didit dan data pencabutan yang diperlukan untuk memvalidasinya di masa mendatang. PDF Simple berakhir setelah halaman bukti dan tidak memiliki tanda tangan digital, segel, atau stempel waktu.
Pada PDF Advanced (AES), tanda tangan mencakup setiap bita sebelumnya, termasuk nilai kolom dan halaman bukti. Mengubah apa pun dalam file setelahnya akan membatalkannya, dan validator berkemampuan PAdES mana pun akan menunjukkannya. Detail tanda tangan menyebutkan nama penanda tangan dan merujuk ke sesi identitas terverifikasi serta konfirmasi kode mereka. Nilai kolom menjadi bagian dari konten halaman, bukan kolom formulir, sehingga tidak dapat diedit nantinya dan setiap penampil PDF menampilkannya. Kotak centang yang dicentang menampilkan tanda centang, dan yang tidak dicentang dibiarkan sebagaimana dokumen menggambarkannya. Kotak tanda tangan yang tingginya lebih dari 24 poin juga mendapatkan keterangan kecil di bawah tanda tangan: Signed with Didit · diikuti dengan 8 karakter pertama dari id tanda tangan. Didit menambahkan nilai kolom, halaman bukti, dan tanda tangan setelah bita dokumen yang ditampilkan kepada penanda tangan. Dokumen tersebut merupakan prefiks persis dari file yang ditandatangani, sehingga sha256_original masih dapat diperiksa terhadap PDF yang ditandatangani.

PDF bukti

PDF bukti mencatat, untuk satu penanda tangan:
  • Tingkat dan format.
  • Nama penanda tangan, kapasitas penandatanganan mereka, dan, untuk KYB, perusahaannya.
  • Sesi verifikasi identitas (hanya Advanced (AES)).
  • Konfirmasi: saluran, tujuan yang disamarkan, dan waktu (hanya Advanced (AES)).
  • Alamat IP penanda tangan.
  • Setiap dokumen: judul, jumlah halaman, dan SHA-256 dari dokumen asli. Untuk dokumen Word, nama dan SHA-256 file Word, versi konverter, dan SHA-256 PDF.
  • Tanda tangan yang diadopsi: diketik (dengan gaya tulisan tangannya) atau digambar, kapan tanda tangan tersebut diadopsi, serta gambar tanda tangan dan inisial.
  • Setiap kolom, per dokumen: label, halaman, dan tipenya, nilainya (gambar untuk tanda tangan atau inisial), asal nilai tersebut (misalnya Diketik oleh penanda tangan, ID terverifikasi, atau API Anda), kapan kolom tersebut diisi (UTC) dan, untuk nilai yang diketik penanda tangan, alamat IP mereka pada saat itu.
  • Persetujuan akhir: teks yang disetujui oleh penanda tangan pada layar peninjauan, dan waktunya.
  • SHA-256 dari setiap file yang ditandatangani dan, untuk Advanced (AES), sertifikat (diterbitkan untuk, penerbit, nomor seri, dan masa berlaku) serta stempel waktu.
Halaman yang ditambahkan ke setiap PDF yang ditandatangani memiliki konten yang sama tanpa bagian sertifikat, karena halaman tersebut ditambahkan sebelum tanda tangan dibubuhkan.

Validasi ulang tanda tangan

POST /v3/session/{session_id}/signatures/{node_id}/validate/ membaca ulang setiap PDF yang ditandatangani pada langkah tersebut dan memeriksa SHA-256 miliknya. Untuk tanda tangan Advanced (AES), endpoint ini juga memvalidasi tanda tangan PAdES, sertifikatnya, data pencabutan, dan stempel waktu. Tanda tangan Simple tidak memiliki tanda tangan digital, sehingga pemeriksaan hanya berupa integritas file saja. Tindakan ini menyimpan hasilnya di validation dan mengembalikan signatures[] yang telah diperbarui. Kirim signature_id untuk memeriksa satu penandatangan. Ini memerlukan write:sessions, dan di konsol berupa tombol Validasi ulang. PDF bertanda tangan yang tersimpan dan tidak lagi cocok dengan sha256_signed miliknya akan mengembalikan 400 dengan signature_document_changed. Hingga dokumen ditandatangani, validation bernilai null. Jika Didit tidak dapat mengonfirmasi hasil penandatanganan, validation bernilai { "valid": null, "reason": "signature_provider_outcome_unknown", "checked_at" } dan status tetap signing sampai masalah ini terselesaikan: perlakukan ini sebagai belum ditandatangani.

Di laporan PDF

Laporan PDF mencetak bagian tanda tangan yang berisi penandatangan, konfirmasi, sertifikat, stempel waktu, dan dokumen beserta hash-nya. Ketika dokumen memiliki kolom, halaman Tanda Tangan Elektronik · kolom mengikuti, dengan satu tabel per dokumen: setiap nilai kolom, gambar tanda tangan dan inisial, waktu, serta sumbernya. Bagian tanda tangan berada setelah Verifikasi bank di laporan KYC dan setelah Dokumen di laporan KYB. Kirim pages=signature untuk mencetak bagian itu saja.

Terkait

Terakhir diubah pada 7 November 2026