Panduan Cepat Pemantauan Transaksi: Setup 10 Menit

Siapkan Pemantauan Transaksi dalam waktu kurang dari 10 menit. Anda akan mengirim transaksi uji, memeriksa skornya, mengaktifkan aturan preset, mengirim ulang untuk melihat aturan terpicu, lalu memastikan webhook diterima.

Prasyarat

Aplikasi Didit dengan Pemantauan Transaksi aktif (Settings → Transaction Monitoring → Enable).
Kunci API.
Endpoint webhook yang dapat dijangkau dari internet.

Langkah-langkah

Kirim transaksi dasar

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'

Respons menyertakan:

status: APPROVED jika tidak ada aturan yang terpicu, IN_REVIEW / DECLINED jika ada aturan yang terpicu.
score: bilangan bulat 0–100+.
rule_runs: array berisi setiap aturan yang mengevaluasi transaksi ini.

Aktifkan aturan preset

Buka Transactions → Rules → Library di Business Console. Pilih preset, misalnya Structuring (outbound): terpicu ketika pengguna yang sama mengirim 20+ transfer keluar di bawah €10,000 dalam 30 hari. Aktifkan aturan tersebut lalu simpan.

Kirim transaksi yang memicu aturan

Kirim 20 transaksi dengan cepat untuk pengguna yang sama, masing-masing di bawah €10,000:

for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done

Pada pengiriman ke-20, aturan Structuring terpicu. Transaksi mengembalikan status: IN_REVIEW, dan score mencerminkan score_delta aturan tersebut.

Berlangganan webhook transaksi

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'

Respons menyertakan secret_shared_key. Simpan segera sebagai DIDIT_WEBHOOK_SECRET di .env Anda:

DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration

Kemudian verifikasi HMAC X-Signature-V2 pada setiap webhook yang masuk sebelum mempercayainya (hitung ulang HMAC-SHA256 atas body yang dikanonikalisasi, lakukan perbandingan dalam waktu konstan, dan tolak timestamp yang sudah usang). Lihat webhook TM untuk payload dan kode verifikasi lengkap.Setiap transaksi berikutnya dikirim ke endpoint Anda secara real-time.

Periksa di konsol

Buka Transactions di konsol:

Tampilan daftar: transaksi terbaru, filter, dan tindakan massal.
Detail transaksi: eksekusi aturan, pengayaan IP, detail pihak, graf jaringan (untuk kripto), serta alert dan kasus yang terhubung.

Ambil transaksi melalui API

curl https://verification.didit.me/v3/transactions/{transaction_id}/ \
  -H "x-api-key: YOUR_API_KEY"

Mengembalikan skema respons lengkap: skor, aturan yang cocok, pengayaan pihak, skrining AML, dan lainnya.

Yang baru saja Anda atur

Penilaian real-time: setiap transaksi dievaluasi oleh setiap aturan aktif.
Skrining AML: pihak lawan diperiksa secara otomatis terhadap daftar sanksi dan media negatif.
Pengayaan IP: setiap transaksi diperkaya dengan negara IP, ASN, serta flag VPN/Tor.
Webhook: notifikasi real-time untuk setiap transaksi.
Jejak audit: eksekusi aturan, alert, dan transisi status dapat dikuerikan di konsol.

Langkah berikutnya yang umum

Panduan integrasi

Arsitektur dan pola lengkap.

Pendalaman aturan

Cara kerja aturan, kondisi, agregasi, dan tindakan.

Penilaian risiko

Cara skor digabungkan menjadi status.

Payload transaksi

Skema pengiriman transaksi lengkap.

Status

Status transaksi, alert, dan kasus.

Kasus

Selidiki dan selesaikan.

Memulai

Fitur

Referensi

Konsol

Panduan Cepat Pemantauan Transaksi: Setup 10 Menit

Prasyarat

Langkah-langkah

Yang baru saja Anda atur

Langkah berikutnya yang umum

Panduan integrasi

Pendalaman aturan

Penilaian risiko

Payload transaksi

Status

Kasus

​Prasyarat

​Langkah-langkah

​Yang baru saja Anda atur

​Langkah berikutnya yang umum

Panduan integrasi

Pendalaman aturan

Penilaian risiko

Payload transaksi

Status

Kasus

Prasyarat

Langkah-langkah

Yang baru saja Anda atur

Langkah berikutnya yang umum