signatures[] di:
GET /v3/session/{sessionId}/decision/, untuk sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB).decisiondari webhook sesi V3, yang dikirim saat sesi berstatusApproved,Declined,In Review, atauAbandoned.- Tab Tanda tangan sesi di konsol, dan bagian tanda tangan pada laporan PDF.
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 daridocuments[].fields[] adalah satu kolom dokumen, beserta nilainya pada salinan penanda tangan ini:
Unduh dokumen yang ditandatangani
Gunakan path dalamsigned_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:- Halaman dokumen yang ditampilkan kepada penanda tangan, dengan setiap nilai kolom dicap di tempat yang Anda tentukan.
- Halaman bukti, kecuali jika Anda menonaktifkan
signature_evidence_page. - 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.
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.
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. Kirimpages=signature untuk mencetak bagian itu saja.