Langsung ke konten utama
Pustaka resmi Didit untuk Node.js dan TypeScript. Pustaka ini berjalan di Node.js 18 atau yang lebih baru, Bun, Deno, dan runtime edge dengan fetch. Pustaka ini menyediakan build ES module dan CommonJS, serta tidak memiliki dependensi runtime. Lihat ikhtisar SDK server untuk hal-hal yang dimiliki bersama oleh setiap SDK.

Instalasi

Paket ini tersedia di @didit-protocol/sdk-node di npm. Sumber dan catatan perubahannya ada di didit-protocol/sdk-node di GitHub.

Mengonfigurasi klien

new Didit() membaca DIDIT_API_KEY dari lingkungan di Node.js, Bun, dan Deno (dengan --allow-env). Runtime edge tidak memiliki lingkungan proses, jadi di sana kunci API harus diteruskan sebagai opsi: new Didit({ apiKey: env.DIDIT_API_KEY }). Teruskan opsi untuk menimpa nilai tersebut, atau untuk mengatur ID organisasi dan aplikasi yang dibutuhkan panggilan berlingkup aplikasi (kasus, jaringan, laporan regulasi). Timeout dinyatakan dalam milidetik.
Dengan CommonJS, gunakan const { Didit } = require("@didit-protocol/sdk-node");.

Membuat sesi

Buat sesi verifikasi untuk sebuah alur kerja, lalu arahkan pengguna Anda ke URL-nya. Nama kolom permintaan mengikuti nama yang digunakan API.

Membaca keputusan

Ketika pengguna menyelesaikan proses (atau ketika webhook tiba), baca keputusannya. Setiap hasil fitur berupa daftar dengan satu entri per node alur kerja, dan nilai tanggal-waktu berupa objek Date.

Memverifikasi webhook

Teruskan body mentah (bukan JSON yang sudah diuraikan) dan header permintaan: objek req.headers dari Node.js atau Express, objek Headers dari Fetch, atau pasangan [name, value] (tipe WebhookHeaders). verify mengembalikan promise dan menolak dengan WebhookVerificationError untuk setiap pengiriman yang tidak valid atau sudah kedaluwarsa.
Dengan Express, baca body menggunakan express.raw({ type: "application/json" }) lalu panggil handleWebhook(req.body, req.headers). Selama Anda merotasi rahasia, teruskan keduanya: [newSecret, oldSecret]. Lihat Webhook untuk event webhook dan skema tanda tangan.

Skrining transaksi

Kirimkan pembayaran, penarikan, atau transfer kripto ke pemantauan transaksi; respons memuat status dan skor risikonya.

Memverifikasi token Authentication

Authentication memeriksa token akses yang ditandatangani oleh penerbit Authentication Anda, di backend Anda, tanpa memanggil Didit untuk setiap permintaan. Modul ini juga menukar kode, menyegarkan token, memeriksa dan mencabut sesi, serta menjalankan peningkatan autentikasi.
Verifikasi token melakukan pemeriksaan yang dijelaskan di Verifikasi token di server Anda, terhadap penerbit dan kunci penandatanganan aplikasi Anda.

Kesalahan

Daftar dan file

Halaman endpoint server dalam referensi API memiliki contoh Node.js untuk operasinya, kecuali endpoint dan kolom yang belum ada di rilis 1.0.1 mana pun, yang disebutkan di ikhtisar.
Terakhir diubah pada 7 November 2026