'%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M6.99935%2012.8327C10.221%2012.8327%2012.8327%2010.221%2012.8327%206.99935C12.8327%203.77769%2010.221%201.16602%206.99935%201.16602C3.77769%201.16602%201.16602%203.77769%201.16602%206.99935C1.16602%2010.221%203.77769%2012.8327%206.99935%2012.8327Z'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M1.16602%207H12.8327'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M6.99935%2012.8327C8.28802%2012.8327%209.33268%2010.221%209.33268%206.99935C9.33268%203.77769%208.28802%201.16602%206.99935%201.16602C5.71068%201.16602%204.66602%203.77769%204.66602%206.99935C4.66602%2010.221%205.71068%2012.8327%206.99935%2012.8327Z'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M2.875%202.95898C3.93063%204.01461%205.38896%204.66754%206.99978%204.66754C8.61062%204.66754%2010.069%204.01461%2011.1246%202.95898'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M11.1246%2011.0425C10.069%209.98691%208.61062%209.33398%206.99978%209.33398C5.38896%209.33398%203.93063%209.98691%202.875%2011.0425'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_1267_9109'%3e%3crect%20width='14'%20height='14'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
If your product already has a workflow where contracts are generated (e.g. HR onboarding, loan origination, vendor registration), embedding signing eliminates the redirect and keeps users in flow.
Why embed signing instead of redirecting?
Redirecting users to a third-party signing page creates friction: context switching, branding discontinuity, and drop-off. Embedded signing keeps the user inside your application throughout the signing process. The signing UI appears within an iframe or native component, branded with your look and feel, while the signature engine runs on the provider's backend.
Three embedding approaches compared
| Dev effort | Brand control | |
|---|---|---|
| Iframe embed | Low (frontend only) | Moderate — styled iframe |
| API + custom UI | High (full stack) | Full — build your own UI |
| Mobile SDK | Medium (platform-specific) | Full native experience |
When to embed signing
Embedded signing is not always the right choice. Here are the scenarios where it delivers the most value.
Enterprise portals that serve employees or customers can embed signing for policy acknowledgements, internal approvals, and self-service agreements without sending users to an external tool.
When signing volume is high (thousands per day), each redirect costs conversion. Embedded signing reduces drop-off and improves completion rates, directly impacting revenue.
Pemindaian tanda tangan memberikan kawalan sepenuhnya bagi perjalanan pengguna, membuatnya lebih mudah untuk melaksanakan jalur audit khusus, pengumuman peraturan, dan penangkapan persetujuan di dalam konteks aplikasi sendiri.
Aliran API pemindaian tanda tangan
Pemindaian tanda tangan biasa dijalankan mengikuti urutan ini.
Buat surat melalui API
Backend anda memanggil API pemindaian tanda tangan untuk membuat surat: muat naik dokumen, tentukan medan tanda tangan, tetapkan peranan penanda tangan, dan konfigurasi keperluan pengesahan. API mengembalikan ID surat.
Buatkan URL pemindaian tanda tangan
Untuk setiap penanda tangan, minta URL pemindaian tanda tangan daripada API. URL itu termasuk token sekali-hanya yang mengesahkan penanda tangan untuk surat ini. Pilihan untuk melengkapkan pengesahan penerima (kata laluan akses, SMS OTP, eID).
Sisipkan di iframe atau SDK
Tampilkan URL pemindaian tanda tangan di dalam iframe (web) atau SDK ponsel (iOS/Android). UI pemindaian tanda tangan dimuat di dalam aplikasi anda. Suaikan penampilannya untuk sepadan warna, fon, dan logo merek anda.
Tangani webhook penyelesaian
Apabila penanda tangan selesai (atau menolak), platform pemindaian tanda tangan menghantar webhook ke backend anda. Gunakan ini untuk mengemaskini keadaan aplikasi anda, triggar langkah berikutnya, atau memberitahu pihak lain.
Ambil dokumen yang ditandatangani
Muat turun dokumen yang ditandatangani dan paket bukti (sertifikat penyelesaian, jalur audit) melalui API. Simpan di sistem anda atau storan awan.
Perhatian teknikal bagi pemindaian tanda tangan
Lintasan asal dan CSP
Pengegotohan iframe memerlukan domain pemindaian tanda tangan untuk diizinkan di Polisi Keselamatan Konten. Konfigurasi frame-ancestors dan header child-src. Sebagian besar platform pemindaian tanda tangan menyediakan mekanisme senarai putih untuk domain anda.
Kebolehpercayaan webhook
Webhook boleh gagal disebabkan oleh masalah jaringan. Melaksanakan penangan webhook yang idempotent dan pengembalian polling yang memeriksa status surat secara berkala. Jangan bergantung sepenuhnya kepada webhook untuk transisi keadaan penting.
Tanggapan paksi
UI penandatanganan mesti berfungsi di peranti paksi. Uji penandatanganan berdasarkan iframe di iOS Safari dan Android Chrome. Beberapa pengerjaan pad penandatanganan menghadapi masalah acara sentuhan di peranti paksi. Gunakan SDK untuk aplikasi paksi asal.
Had kadar dan pengumpulan
Penandatanganan yang berjumlah tinggi boleh menabrak had kadar API. Implementasi antrian permintaan dan pengerjaan bungkus batch di mana disokong. Monitor penggunaan API dan tetapkan pemberitahuan untuk had mendekati.
Bagaimana penandatanganan eSign.AI beroperasi
eSign.AI menyediakan penandatanganan semulajadi untuk produk SaaS yang memerlukan penandatanganan di dalam antaramuka sendiri.
iframe dan komponen SDK
Sertakan pengalaman penandatanganan eSign.AI di dalam produk anda melalui iframe atau komponen React/Vue. Penandatangan tidak keluar dari aplikasi anda. Penandatanganan semulajadi menyokong semua fitur eSign.AI: aliran berparti, pengesahan identiti, QES, jejak audit.
Webhook untuk keadaan sebenar masa
Konfigur webhook untuk menerima acara penandatanganan: bungkus dihantar, dilihat, ditandatangani, selesai, ditolak. Aplikasi anda boleh triggar aliran kerja bawahan (aktifasi kontrak, pemberitahuan, pengurusan bayaran) segera selepas penandatanganan selesai.
API penandatanganan semulajadi: latensi, SLA, dan webhook
Spesifikasi prestasi untuk perancangan penggabungan API.
Penilaian kadar latensi API
eSign.AI: cipta bungkus 200-400 ms, dapatkan status 50-100 ms, muat turun PDF ditandatangani 300-800 ms. DocuSign: cipta bungkus 300-600 ms, dapatkan status 80-150 ms. Adobe Sign: cipta bungkus 400-800 ms. Muat turun iframe penandatanganan semulajadi: eSign.AI 1-2 saat, DocuSign 2-4 saat.
Kepercayaan webhook
Webhook eSign.AI: masa tamat 30 saat, 3 pengulangan dengan penurunan eksponensial (5 minit, 30 minit, 2 jam), tanda tangan HMAC untuk pengesahan muatan. DocuSign: masa tamat 10 saat, jendela pengulangan 24 jam. Adobe Sign: masa tamat 3 saat, 6 pengulangan dalam tempoh 72 jam. Untuk aliran kerja bawahan masa sebenar, eSign.AI mempunyai penghantaran webhook yang paling kepercayaan.
Soalan yang sering ditanya
Tidak. Keberlakuan undang-undang tandatangan tergantung kepada kaedah tandatangan (SES, AES, QES), pengesahan identiti, dan paket bukti — bukan kepada sama ada UI tandatangan disertakan atau dialihkan. Penandatanganan semulajadi menghasilkan bukti undang-undang yang sama seperti penandatanganan berasingan.
