API Verifikasi dan risiko transaksi

Gunakan kunci API platform untuk memulai verifikasi individu (KYC), verifikasi bisnis (KYB), pemantauan transaksi, dan penyaringan alamat dompet dari sistem Anda sendiri, serta mengkueri catatan pemeriksaan. API terbuka dan konsol menjalankan proses pemeriksaan yang sama: harga satuan sama, dan aturan hasil, pengembalian dana, serta rekonsiliasi juga sama.

Pertama, klik “Aktifkan” di “Verifikasi dan risiko transaksi” pada konsol, lalu buat kunci di “Pengelolaan API” dan centang izin “Verifikasi & risiko”: verification.read untuk mengkueri harga satuan dan catatan, verification.write untuk memulai pemeriksaan. Setiap pemeriksaan ditagih dari saldo akun.

Endpoint API

• GET /api/v1/verification/info: Mengembalikan apakah akun ini sudah diaktifkan, apakah keempat jenis pemeriksaan tersedia beserta harga satuannya (USD), serta jaringan dan aset yang dapat dipilih untuk pemantauan transaksi dan penyaringan dompet. Jenis yang belum tersedia tidak diberi harga.
• POST /api/v1/verification/checks: Memulai satu pemeriksaan; penagihan dan pembuatan catatan terjadi dalam permintaan yang sama. Verifikasi identitas mengembalikan tautan pengalihan handoff_url yang cukup Anda kirimkan kepada pihak yang diverifikasi; pemantauan transaksi dan penyaringan dompet biasanya langsung mengembalikan hasil.
• GET /api/v1/verification/checks: Daftar diurutkan menurut waktu mulai, terbaru lebih dulu, dan dapat difilter dengan kind, status, verdict, serta keyword (referensi / alamat / nomor tagihan), dengan page dan page_size untuk paginasi (maksimal 100 per halaman). Kueri satu catatan menyertakan handoff_url selama sesi masih berada di tangan pihak yang diverifikasi. Pembaruan membaca ulang hasil dari penyedia (penyaringan dompet tidak dapat diperbarui; memeriksa lagi akan ditagih lagi).

Mengulang dengan idempotency_key yang sama dan isi yang sama mengembalikan catatan semula tanpa penagihan lagi; memakai kunci yang sama dengan isi berbeda akan ditolak (400). Memulai lagi verifikasi identitas untuk referensi pihak yang sesinya belum selesai mengembalikan sesi semula (reused bernilai true), juga tanpa penagihan.

Callback hasil

Isi URL callback https di “Pengaturan integrasi” pada konsol lalu aktifkan. Saat status atau hasil catatan pemeriksaan berubah secara asinkron (verifikasi identitas selesai, peninjauan manual mengubah hasil, hasil transaksi diperbarui, gagal dan dananya dikembalikan), platform mengirim satu peristiwa melalui POST. Panggilan yang Anda mulai sendiri tidak dikirimkan, karena respons sinkronnya sudah berisi hasil.

Header X-Tovanix-Event adalah jenis peristiwa (check.updated, atau ping untuk uji), X-Tovanix-Delivery adalah event_id, X-Tovanix-Timestamp adalah detik Unix, dan X-Tovanix-Signature adalah sha256= diikuti nilai heksadesimal HMAC-SHA256(kunci rahasia tanda tangan, stempel waktu + "." + body permintaan mentah).

Respons 2xx dianggap terkirim; selain itu (termasuk timeout) dicoba ulang dengan jeda bertahap 1 menit, 5 menit, 15 menit, 1 jam, 3 jam, 6 jam, dan 12 jam, maksimal 8 kali, lalu tidak dikirim lagi. Percobaan ulang mengirim event_id yang sama dan isi peristiwa yang sama, jadi lakukan deduplikasi berdasarkan event_id. Peristiwa dapat tiba tidak berurutan: pakai yang memiliki data.updated_at lebih baru, atau panggil endpoint kueri setelah menerimanya untuk mengambil status terbaru. Setelah callback dinonaktifkan, peristiwa yang belum terkirim tidak dikirim lagi.

Halaman terkait: Verifikasi dan risiko transaksi · Verifikasi identitas: individu dan bisnis · Risiko transaksi: pemantauan dan penyaringan dompet · Dokumentasi API