Langsung ke konten utama
Gem Didit resmi untuk Ruby. Gem ini membutuhkan Ruby 3.1 atau yang lebih baru dan menggunakan net/http dari pustaka standar. Lihat ikhtisar SDK server untuk hal-hal yang dimiliki bersama oleh setiap SDK.

Instalasi

Gem ini tersedia sebagai didit-sdk di RubyGems. Sumber dan log perubahannya ada di didit-protocol/sdk-ruby di GitHub. Atau tambahkan gem "didit-sdk" ke Gemfile Anda, lalu jalankan bundle install. Muat dengan require "didit".

Konfigurasi klien

Didit::Client.new membaca DIDIT_API_KEY dari lingkungan. Berikan keyword untuk menimpanya, atau untuk mengatur ID organisasi dan ID aplikasi yang dibutuhkan panggilan dengan cakupan aplikasi (kasus, jaringan, laporan regulasi). Field permintaan berupa argumen keyword dengan nama yang sama seperti di API; respons berupa objek dengan pembaca untuk setiap kolom, serta dukungan untuk [:field] dan to_h.

Buat sesi

Buat sesi verifikasi untuk sebuah alur kerja, lalu arahkan pengguna Anda ke URL-nya.

Baca keputusan

Saat pengguna menyelesaikan proses (atau saat webhook tiba), baca keputusannya. Setiap hasil fitur berupa daftar dengan satu entri untuk setiap node alur kerja.

Verifikasi webhook

Berikan body mentah persis seperti yang diterima, beserta header permintaan. verify memunculkan Didit::WebhookVerificationError untuk apa pun yang bukan pengiriman valid dan masih baru, dan mengembalikan event bertipe jika pengiriman valid.
Di Rails, panggil handle_webhook(request.raw_post, request.headers). Selama Anda merotasi rahasia, berikan keduanya: [new_secret, old_secret]. Lihat Webhooks untuk daftar event dan skema tanda tangan.

Skrining transaksi

Kirimkan pembayaran, penarikan, atau transfer kripto ke Pemantauan Transaksi; respons berisi status dan skor risikonya.

Verifikasi token Authentication

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

Error

Daftar dan file

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