Langsung ke konten utama
POST
curl

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Body

application/json
wallet_address
string

Alamat dompet yang akan diverifikasi. Opsional; jika kosong, alamat harus diberikan saat proses pembuktian dimulai.

Maximum string length: 128
chain
string

Token chain untuk alamat, misalnya ETH, BTC, atau SOL. Gunakan token yang sama seperti di buku alamat dompet Anda. Penandatanganan pesan dan pengujian Satoshi hanya ditawarkan untuk chain yang didukung. Entri buku alamat yang diverifikasi oleh bukti menyimpannya di bawah pengidentifikasi kanonisnya (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nama pemegang dompet, digunakan untuk pencocokan nama penerima.

Maximum string length: 255
vendor_data
string

Pengenal internal Anda untuk pemegang, diteruskan ke entri buku alamat yang dibuat.

Maximum string length: 255
transaction_id
string<uuid> | null

Opsional. UUID transaksi Didit dari transfer Travel Rule yang akan dilanjutkan saat bukti terverifikasi.

satoshi_deposit_address
string

Opsional. Alamat deposit yang Anda kendalikan; menyediakannya akan mengaktifkan metode pembuktian SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Opsional. URL http(s) absolut tempat widget mengembalikan pelanggan setelah selesai.

Maximum string length: 512
expires_in_minutes
integer
default:60

Opsional. Masa berlaku tautan yang dibuat, dalam hitungan menit. Diperpanjang secara otomatis untuk mencakup jendela uji Satoshi saat SATOSHI_TEST ditawarkan.

Rentang yang diperlukan: 5 <= x <= 10080

Respons

Sesi widget yang diterbitkan.

widget_session_id
string<uuid>
token
string

Token sesi opaque yang disematkan dalam URL widget.

url
string

URL widget kepemilikan dompet yang di-hosting. Buka secara persis di browser sistem (jangan pernah di dalam webview SDK seluler).

expires_at
string<date-time>
Terakhir diubah pada 7 November 2026