{"id":5873,"date":"2026-11-20T07:52:35","date_gmt":"2026-11-20T00:52:35","guid":{"rendered":"https:\/\/dtisolution.id\/blog\/?p=5873"},"modified":"2026-11-20T07:52:35","modified_gmt":"2026-11-20T00:52:35","slug":"api-tanda-tangan-digital-integrasi-tte-psre","status":"publish","type":"post","link":"https:\/\/dtisolution.id\/blog\/api-tanda-tangan-digital-integrasi-tte-psre\/","title":{"rendered":"API Tanda Tangan Digital: Cara Integrasi TTE ke Aplikasi"},"content":{"rendered":"<div class=\"dti-snippet-answer\" style=\"margin:0 0 24px;padding:16px 20px;border-left:4px solid #E85A5A;background:#fdf6f6;border-radius:6px\"><strong>Jawaban singkat:<\/strong> API tanda tangan digital menghubungkan aplikasi bisnis Anda dengan Penyelenggara Sertifikasi Elektronik (PSrE). Aplikasi menyiapkan dokumen dan meminta otorisasi. Kunci privat penanda tangan tetap disimpan PSrE, lalu dokumen bertanda tangan elektronik tersertifikasi dikirim kembali. Integrasinya mencakup verifikasi identitas, penempatan tanda tangan, otorisasi penanda tangan, callback, dan penyimpanan bukti audit.<\/div>\n<p>Kebutuhan akan API tanda tangan digital biasanya baru terasa ketika satu langkah di proses yang sudah berjalan mulai menghambat. Dokumen dicetak, ditandatangani basah, dipindai, lalu diunggah lagi ke sistem. Pada aplikasi pembukaan rekening, perjanjian kredit, atau formulir persetujuan tindakan medis, putaran ini bisa memakan dua sampai tiga hari dan kerap meninggalkan berkas yang tercecer di meja cabang. Dengan mengintegrasikan tanda tangan elektronik (TTE) tersertifikasi lewat API, seluruh langkah itu pindah ke dalam aplikasi Anda, dan kekuatan pembuktiannya tetap diakui hukum.<\/p>\n<figure style=\"margin:20px 0\"><img decoding=\"async\" src=\"https:\/\/dtisolution.id\/blog\/wp-content\/uploads\/2026\/11\/dti-weekly-1794967294-dti-weekly-cover.jpg\" alt=\"Ilustrasi Tilaka \u2014 API Tanda Tangan Digital: Cara Integrasi TTE ke Aplikasi\" style=\"max-width:100%;height:auto;border-radius:8px\" title=\"\"><figcaption style=\"font-size:13px;color:#5B6B85;margin-top:6px\">Tilaka dari DTI.<\/figcaption><\/figure>\n<p>Artikel ini membahas sisi teknisnya: alur integrasi yang umum dipakai, keputusan arsitektur yang sebaiknya diambil sejak awal, dan kewajiban regulasi yang ikut terbawa begitu aplikasi Anda memproses data identitas penanda tangan. Landasan hukumnya secara umum sudah kami bahas di <a href=\"\/blog\/tanda-tangan-elektronik-tersertifikasi-panduan-lengkap\/\">panduan lengkap tanda tangan elektronik tersertifikasi<\/a>.<\/p>\n<h2>Apa yang sebenarnya dikerjakan API tanda tangan digital<\/h2>\n<p>API ini adalah jembatan antara aplikasi bisnis Anda dan Penyelenggara Sertifikasi Elektronik (PSrE). Aplikasi Anda tidak menerbitkan sertifikat dan tidak menyimpan kunci privat milik penanda tangan. Keduanya tetap menjadi tanggung jawab PSrE yang terdaftar di Kementerian Komunikasi dan Digital. Aplikasi Anda bertugas menyiapkan dokumen, meminta penanda tangan memberi otorisasi, lalu menerima kembali berkas yang sudah ditandatangani.<\/p>\n<p>Pembagian peran ini berakar pada PP 71\/2019, yang membedakan TTE tersertifikasi dan tidak tersertifikasi. TTE tersertifikasi wajib dibuat dengan sertifikat elektronik dari PSrE Indonesia. Gambar tanda tangan yang ditempel di PDF atau kotak centang \u201csaya setuju\u201d tidak termasuk kategori ini. Untuk sektor perbankan, dampak perbedaan itu kami uraikan di artikel <a href=\"\/blog\/tte-tersertifikasi-vs-tidak-tersertifikasi\/\">TTE tersertifikasi vs tidak tersertifikasi untuk bank<\/a>.<\/p>\n<p>Tilaka adalah salah satu PSrE yang terdaftar. Melalui <a href=\"https:\/\/dtisolution.id\/id\/produk\/tilaka-digital-signature\">layanan tanda tangan digital Tilaka<\/a>, proses penerbitan sertifikat, penyimpanan kunci, dan pembubuhan tanda tangan bisa dipanggil langsung dari sistem Anda. Sebagai system integrator, DTI biasanya mengerjakan bagian yang menghubungkan API tersebut dengan core banking, sistem informasi rumah sakit, atau aplikasi pengadaan milik klien.<\/p>\n<h2>Alur integrasi TTE tersertifikasi, langkah demi langkah<\/h2>\n<h3>1. Registrasi dan verifikasi identitas<\/h3>\n<p>Sebelum seseorang bisa menandatangani, PSrE harus memastikan orang itu memang pemilik identitas yang diakuinya. Umumnya prosesnya berupa input NIK, swafoto dengan uji liveness, dan pencocokan ke data kependudukan. Langkah ini cukup dilakukan sekali. Hasilnya adalah sertifikat elektronik yang terikat pada identitas tersebut dan berlaku untuk jangka waktu tertentu.<\/p>\n<p>Keputusan pertama yang perlu Anda ambil: apakah registrasi berlangsung di dalam layar aplikasi Anda, atau pengguna diarahkan ke halaman milik PSrE. Pilihan pertama terasa lebih menyatu bagi pengguna, tetapi aplikasi Anda ikut memegang foto wajah dan NIK, sehingga beban kepatuhan perlindungan datanya bertambah.<\/p>\n<h3>2. Penyiapan dokumen dan posisi tanda tangan<\/h3>\n<p>Dokumen harus final sebelum dikirim. Perubahan sekecil apa pun setelah penandatanganan, termasuk mengganti satu angka di lampiran, akan membuat tanda tangan terbaca tidak valid saat diverifikasi. Karena itu, hasilkan PDF di sisi server dari templat yang terkunci, catat hash-nya untuk jejak audit internal, lalu tentukan koordinat halaman dan posisi tampilan visual tanda tangan.<\/p>\n<h3>3. Otorisasi oleh penanda tangan<\/h3>\n<p>Pada model remote signing, kunci privat disimpan di modul keamanan perangkat keras (HSM) milik PSrE. Penanda tangan memberi otorisasi dengan OTP, PIN, atau verifikasi wajah. Bagian ini tidak boleh diambil alih oleh aplikasi Anda. Pasal 11 UU ITE mensyaratkan bahwa data pembuatan tanda tangan, pada saat penandatanganan, hanya berada dalam kuasa penanda tangan. Jika aplikasi Anda menyimpan PIN pengguna lalu mengirimkannya otomatis, persyaratan itu sulit dipertahankan ketika terjadi sengketa.<\/p>\n<h3>4. Callback, penyimpanan, dan verifikasi<\/h3>\n<p>Penandatanganan sering bersifat asinkron, terutama bila ada beberapa penanda tangan. Siapkan endpoint webhook yang idempoten, karena callback yang sama bisa terkirim lebih dari sekali. Simpan dokumen asli, dokumen yang sudah ditandatangani, serta log otorisasi. Untuk arsip berumur panjang seperti perjanjian kredit sepuluh tahun, pastikan tanda tangan dilengkapi stempel waktu dan informasi validasi jangka panjang agar tetap bisa diverifikasi setelah sertifikat penanda tangan kedaluwarsa.<\/p>\n<h2>Keputusan arsitektur dalam integrasi API tanda tangan digital<\/h2>\n<p>Sebagian besar masalah yang kami temui di proyek integrasi tidak berasal dari API itu sendiri, melainkan dari keputusan desain yang diambil terlambat. Tabel berikut merangkum titik keputusan yang paling sering muncul.<\/p>\n<table>\n<thead>\n<tr>\n<th>Aspek<\/th>\n<th>Opsi umum<\/th>\n<th>Pertimbangan<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Alur registrasi<\/td>\n<td>Tertanam di aplikasi atau dialihkan ke halaman PSrE<\/td>\n<td>Tertanam lebih mulus bagi pengguna, tetapi Anda ikut memproses data biometrik<\/td>\n<\/tr>\n<tr>\n<td>Mode penandatanganan<\/td>\n<td>Sinkron atau asinkron dengan webhook<\/td>\n<td>Banyak penanda tangan dan urutan tertentu hampir selalu butuh asinkron<\/td>\n<\/tr>\n<tr>\n<td>Volume<\/td>\n<td>Per dokumen atau batch<\/td>\n<td>Pejabat yang meneken ratusan surat per hari butuh alur batch, bila PSrE mendukungnya<\/td>\n<\/tr>\n<tr>\n<td>Penyimpanan<\/td>\n<td>Disimpan di sistem Anda atau diambil ulang dari PSrE<\/td>\n<td>Kebijakan retensi dan lokasi data mengikuti aturan sektor Anda, bukan default vendor<\/td>\n<\/tr>\n<tr>\n<td>Lingkungan<\/td>\n<td>Sandbox dan production terpisah<\/td>\n<td>Sertifikat sandbox tidak sah secara hukum, jangan sampai bocor ke dokumen nasabah<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Satu hal lagi yang sering terlupa: dokumen yang juga wajib bermeterai. Urutan pembubuhan e-Meterai dan TTE perlu diputuskan di awal dan diuji bersama penyedia keduanya, karena setiap pembubuhan menambah lapisan pada berkas PDF. Mekanismenya dijelaskan di artikel <a href=\"\/blog\/cara-kerja-e-meterai\/\">cara kerja e-Meterai<\/a>.<\/p>\n<h2>Kewajiban regulasi yang ikut terbawa<\/h2>\n<p>Integrasi TTE bukan sekadar urusan teknis. Begitu NIK dan foto wajah melewati server Anda, UU 27\/2022 tentang Pelindungan Data Pribadi berlaku penuh. Data biometrik masuk kategori data pribadi yang bersifat spesifik, sehingga Anda perlu dasar pemrosesan yang jelas, pembatasan akses, dan perjanjian yang menetapkan peran masing-masing pihak dengan PSrE. Prinsip praktisnya sederhana: jangan simpan swafoto jika aplikasi Anda tidak membutuhkannya setelah verifikasi selesai.<\/p>\n<p>Bagi bank umum, POJK 11\/POJK.03\/2022 tentang Penyelenggaraan Teknologi Informasi oleh Bank Umum mengatur penggunaan pihak penyedia jasa TI. Hubungan dengan PSrE perlu masuk kerangka manajemen risiko TI bank, lengkap dengan perjanjian layanan dan rencana kontinjensi bila layanan tanda tangan tidak tersedia. Di fasilitas kesehatan, Permenkes 24\/2022 tentang Rekam Medis membuka penggunaan tanda tangan elektronik pada rekam medis elektronik, sehingga integrasi dengan sistem informasi rumah sakit menjadi jalur yang wajar. Bila Anda masih menimbang penyedia, kriteria memilih PSrE kami bahas di <a href=\"\/blog\/psre-pengertian-penyelenggara-dan-pentingnya\/\">artikel tentang PSrE dan penyelenggaranya<\/a>.<\/p>\n<h2>Skenario yang wajib diuji sebelum go-live<\/h2>\n<p>Uji jalur normal saja tidak cukup. Sengketa dan keluhan pengguna hampir selalu berasal dari kondisi pinggiran. Sebelum rilis, pastikan skenario berikut sudah dicoba:<\/p>\n<ul>\n<li>Sertifikat penanda tangan kedaluwarsa atau dicabut di tengah proses.<\/li>\n<li>OTP salah tiga kali, atau pengguna menutup aplikasi sebelum otorisasi selesai.<\/li>\n<li>Webhook terkirim ganda atau terlambat beberapa menit.<\/li>\n<li>Dokumen diubah setelah ditandatangani, lalu dibuka di Adobe Acrobat Reader untuk memastikan status tidak valid muncul.<\/li>\n<li>Urutan penanda tangan dilanggar, misalnya direktur meneken sebelum pejabat pemeriksa.<\/li>\n<li>Layanan PSrE tidak bisa diakses, dan antrean dokumen harus diproses ulang tanpa duplikasi.<\/li>\n<\/ul>\n<p>Integrasi yang matang terlihat dari hal-hal kecil seperti ini: pesan galat yang dipahami pengguna, log yang cukup untuk menjawab pertanyaan auditor, dan dokumen yang tetap bisa diverifikasi bertahun-tahun kemudian.<\/p>\n<h3>Pertanyaan yang sering diajukan<\/h3>\n<p><strong>Apakah aplikasi kami harus menyimpan kunci privat pengguna?<\/strong><\/p>\n<p>Tidak. Pada model remote signing, kunci privat disimpan di HSM milik PSrE. Aplikasi Anda hanya mengirim dokumen dan meneruskan permintaan otorisasi yang dijalankan sendiri oleh penanda tangan.<\/p>\n<p><strong>Berapa lama integrasi API tanda tangan digital biasanya berlangsung?<\/strong><\/p>\n<p>Untuk satu alur dokumen dengan satu penanda tangan, integrasi teknis bisa selesai dalam hitungan minggu. Waktu yang lebih panjang biasanya habis untuk kajian risiko, perjanjian dengan PSrE, dan penyesuaian dengan sistem lama seperti core banking.<\/p>\n<p><strong>Apakah dokumen yang ditandatangani lewat API sah sebagai alat bukti?<\/strong><\/p>\n<p>TTE yang dibuat dengan sertifikat elektronik dari PSrE Indonesia termasuk TTE tersertifikasi menurut PP 71\/2019 dan memiliki kekuatan hukum sesuai Pasal 11 UU ITE, selama persyaratannya terpenuhi, termasuk keterkaitan dengan identitas penanda tangan dan deteksi perubahan dokumen.<\/p>\n<p><strong>Bisakah satu dokumen ditandatangani beberapa orang secara berurutan?<\/strong><\/p>\n<p>Bisa. Urutannya diatur di sisi aplikasi Anda atau melalui fitur alur kerja PSrE. Pada kasus ini, mode asinkron dengan webhook lebih andal dibanding menunggu respons sinkron.<\/p>\n<div class=\"dti-product-cta\" style=\"margin:28px 0;padding:18px 20px;border-left:4px solid #2C4A7E;background:#f4f6fa;border-radius:6px\"><strong>Butuh tanda tangan elektronik yang sah secara hukum?<\/strong><br \/>Pelajari <a href=\"https:\/\/dtisolution.id\/id\/produk\/tilaka-digital-signature\"><strong>tanda tangan elektronik tersertifikasi PSrE Tilaka<\/strong><\/a>.<\/div>\n","protected":false},"excerpt":{"rendered":"<p>API tanda tangan digital memungkinkan aplikasi Anda memakai TTE tersertifikasi PSrE. Pelajari alur integrasi, keputusan arsitektur, dan regulasinya.<\/p>\n","protected":false},"author":19941,"featured_media":5872,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1448],"tags":[],"coauthors":[1470],"class_list":["post-5873","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-digital-signature"],"_links":{"self":[{"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/posts\/5873","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/users\/19941"}],"replies":[{"embeddable":true,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/comments?post=5873"}],"version-history":[{"count":1,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/posts\/5873\/revisions"}],"predecessor-version":[{"id":5876,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/posts\/5873\/revisions\/5876"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/media\/5872"}],"wp:attachment":[{"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/media?parent=5873"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/categories?post=5873"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/tags?post=5873"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/dtisolution.id\/blog\/wp-json\/wp\/v2\/coauthors?post=5873"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}