Mengapa idempotensi penting?

Karena retry dapat membuat transaksi ganda jika permintaan tidak dikenali sebagai operasi yang sama.

Apa yang disimpan dari webhook?

ID peristiwa, waktu, jenis, transaksi, hasil verifikasi, status pemrosesan, dan error.

Bagaimana mengatasi selisih status?

Jalankan rekonsiliasi dengan sumber yang ditetapkan dan simpan koreksi.

Menghubungkan API Tanda Tangan ke Sistem Internal

Pendahuluan

Integrasi API tanda tangan harus menjaga pemisahan antara dokumen, peserta, status, dan peristiwa. Sistem internal tidak boleh menimpa file atau membuat alur ganda ketika webhook dikirim ulang.

Tetapkan model data

Gunakan pengenal unik untuk dokumen, versi, envelope atau transaksi, peserta, dan peristiwa. Simpan status eksternal serta status internal terpisah agar pemetaan dapat diaudit.

Lindungi pengiriman

Autentikasi API, kelola rahasia, batasi hak akses, validasi jenis serta ukuran file, dan hindari data pribadi yang tidak diperlukan. Gunakan idempotency key pada operasi yang dapat diulang.

Proses webhook dengan aman

Verifikasi sumber, simpan ID peristiwa, tangani pengiriman di luar urutan, dan abaikan duplikat tanpa kehilangan log. Jangan mengandalkan satu callback sebagai satu-satunya sumber status; sediakan rekonsiliasi.

Nota Sign API dapat mendukung pembuatan dan pemantauan alur dalam konfigurasi yang tersedia. Implementasi harus mengikuti dokumentasi serta kontrol keamanan organisasi.