Pedoman Pengembang: Aturan Kecepatan & Deteksi Penataan Transaksi (ID)

Lihatlah satu pembayaran saja dan biasanya tidak akan memberi tahu Anda apa pun. €9.700 kepada pihak lawan tidak luar biasa. Tetapi sepuluh pembayaran €9.700 kepada pihak lawan yang sama selama tiga hari, atau dua puluh transfer masuk dari dua puluh akun berbeda dalam satu sore, adalah tanda-tanda aktivitas penataan dan mule. Untuk menangkapnya, Anda perlu melihat transaksi sebagai aliran — sepanjang waktu, dengan penghitungan dan penjumlahan — bukan satu per satu.

Itulah yang dilakukan aturan kecepatan, dan itu adalah bagian tersulit dari pemantauan transaksi untuk Anda bangun sendiri. Anda memerlukan prosesor aliran yang mempertahankan jendela bergulir per pengguna, menghitung dan menjumlahkan serta menghilangkan duplikasi pihak lawan di dalam jendela tersebut, dan mengevaluasi ambang batas secara real time. API Pemantauan Transaksi Didit memberi Anda mesin itu secara langsung: tentukan jendela, pilih agregasi — hitung, jumlah, atau unik — tetapkan ambang batas, dan aturan berjalan terhadap setiap transaksi dengan biaya $0,02 per transaksi.

Ini adalah panduan pengembang untuk membangun aturan kecepatan dan menggunakannya untuk mendeteksi penataan.

Poin-poin penting

• Aturan kecepatan mengevaluasi selama periode waktu — "dalam 24 jam terakhir", "selama 7 hari" — alih-alih menilai satu transaksi secara terpisah.
• Tiga agregasi: count (berapa banyak), sum (jumlah kumulatif), dan distinct (pihak lawan atau atribut unik) — blok bangunan deteksi penataan dan mule.
• Penataan — banyak pembayaran tepat di bawah ambang batas pelaporan — ditangkap dengan menggabungkan jendela jumlah dengan kondisi ambang batas-kedekatan.
• Pola mule dan smurfing ditangkap dengan jumlah pihak lawan unik di dalam jendela.
• Tidak diperlukan prosesor aliran — mesin menjaga jendela; Anda mendeklarasikan aturan di Konsol.
• $0,02 per transaksi, tanpa minimum. Penyaringan AML pada pihak yang ditandai ditagih secara terpisah seharga $0,20.

Apa itu aturan kecepatan

Aturan kecepatan memiliki tiga bagian: jendela (periode tinjauan — 1 jam, 24 jam, 7 hari), agregasi atas transaksi di jendela tersebut, dan ambang batas yang, ketika dilampaui, memicu tindakan. Agregasi adalah inti ekspresif:

• count — berapa banyak transaksi yang cocok dengan kondisi aturan di jendela. "Lebih dari 5 transfer masuk dalam 24 jam."
• sum — nilai kumulatif transaksi yang cocok. "Volume kumulatif lebih dari €10.000 dalam 7 hari."
• distinct — jumlah nilai unik dari suatu atribut, biasanya pihak lawan. "Transfer dari lebih dari 8 pengirim berbeda dalam 24 jam."

Jendela dikunci per subjek secara default — setiap pengguna memiliki penghitung bergulirnya sendiri — sehingga hari yang sibuk untuk seluruh platform Anda tidak menenggelamkan sinyal pengguna individu.

Mengapa itu penting

Penataan (juga disebut smurfing) adalah salah satu teknik pencucian uang tertua dan salah satu yang paling diatur secara eksplisit. Ambang batas pelaporan — €10.000 di sebagian besar UE, $10.000 di AS — menciptakan insentif untuk memecah jumlah besar menjadi pembayaran yang lebih kecil yang masing-masing tetap di bawah batas. Aturan titik-waktu yang hanya memeriksa jumlah tunggal tidak akan pernah melihatnya; seluruh pola hidup dalam agregat.

Hal yang sama berlaku untuk jaringan mule. Tanda mule uang bukanlah satu transfer pun — ini adalah masuknya dana dari banyak akun berbeda diikuti oleh keluarnya dana yang cepat. Anda hanya melihatnya dengan jumlah pihak lawan yang berbeda selama jendela. Regulator mengharapkan perusahaan untuk mendeteksi tipologi ini, dan aturan kecepatan adalah cara Anda melakukannya tanpa membangun tumpukan analitik streaming Anda sendiri.

Detail teknis

Transaksi dibuat terhadap API /v3/ terpadu, idempoten pada transaction_id yang Anda kontrol:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_a19f04",
    "category": "finance",
    "amount": 9600,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T13:18:00Z",
    "subject": { "vendor_data": "user_3310", "role": "SENDER", "entity_type": "INDIVIDUAL" },
    "counterparty": { "role": "RECEIVER", "entity_type": "INDIVIDUAL" },
    "payment_method": "BANK_TRANSFER"
  }'

Ketika transaksi melengkapi pola penataan, aturan kecepatan menyala dan respons menamainya:

{
  "transaction_id": "txn_a19f04",
  "status": "IN_REVIEW",
  "risk_score": 66,
  "triggered_rules": [
    {
      "name": "Penataan — jumlah kumulatif mendekati ambang batas",
      "bundle": "Keuangan",
      "aggregation": "sum",
      "window": "7d",
      "action": "CHANGE_STATUS"
    }
  ],
  "alert_id": "alrt_b4d8e1"
}

Webhook. Berlangganan transaction.created dan transaction.status.updated untuk menjaga buku besar Anda tetap sinkron saat peringatan terselesaikan.

Harga. $0,02 per transaksi, ditagih per panggilan, tanpa minimum. Penyaringan AML pada pihak yang ditandai ditagih secara terpisah seharga $0,20.

Membangun aturan penataan dan mule

Penataan (jendela jumlah). Gabungkan agregasi sum selama jendela 7 hari dengan kondisi per transaksi bahwa jumlahnya berada tepat di bawah ambang batas pelaporan Anda. Aturan menyala ketika kumulatif pembayaran yang tepat di bawah ambang batas pengguna bertambah melewati batas yang Anda tetapkan — transaksi besar agregat yang dimaksudkan untuk disembunyikan oleh penataan. Sesuaikan kedekatan ambang batas (seberapa dekat dengan batas pelaporan yang dihitung sebagai "tepat di bawah") dan pemicu kumulatif.

Smurfing (jendela hitungan). Agregasi count selama jendela pendek menangkap ledakan pembayaran kecil. "Lebih dari 10 transfer keluar di bawah €1.000 dalam 24 jam" memunculkan pola fragmentasi bahkan ketika tidak ada pembayaran tunggal yang besar.

Mule fan-in (jendela unik). Agregasi distinct pada pihak lawan menangkap fan-in: "Transfer masuk dari lebih dari 8 pengirim berbeda dalam 24 jam." Pasangkan dengan aturan hitungan fan-out cepat dan Anda telah menjelaskan tanda mule lengkap.

Ini memetakan ke bundel yang diunggulkan — penataan dan penghindaran ambang batas berada di Keuangan, volume kumulatif dan masuk/keluar cepat di AML/CTF, lonjakan kecepatan di Deteksi anomali — dan Anda dapat memperluas salah satunya, atau membangun sendiri, di bundel Kustom. Tindakan setiap aturan dapat menambah skor risiko, mengubah status, menambahkan tag, atau menambahkan pihak ke daftar.

Kasus penggunaan

• Fintech — aturan penataan jumlah kumulatif pada transfer dan penarikan; aturan mule pihak lawan yang berbeda pada setoran masuk.
• Kripto — jendela hitungan pada aktivitas dompet masuk dan keluar yang cepat; aturan berbeda pada dana yang tiba dari banyak alamat sebelum satu aliran keluar besar.
• Pinjaman — aturan kecepatan pada pola pencairan dan pembayaran kembali untuk menangkap penipuan kebangkrutan.
• Pasar — aturan hitungan pembeli berbeda untuk menangkap cincin transaksi kolusif yang meningkatkan volume penjual.
• iGaming — jendela hitungan kecepatan setoran yang berfungsi ganda sebagai sinyal permainan yang bertanggung jawab.

Bagaimana cara berintegrasi dengan Didit

1. Tentukan jendela. Di Konsol Bisnis, bangun aturan kecepatan dengan jendela, agregasi (hitung/jumlah/unik), dan ambang batas yang disyaratkan oleh kebijakan Anda.
2. Kirim transaksi. POST /v3/transactions/ dari backend Anda saat uang bergerak, dengan transaction_id dan vendor_data yang stabil sehingga mesin mengunci jendela ke subjek yang tepat.
3. Tangani webhook. Dengarkan transaction.status.updated untuk bereaksi ketika aturan kecepatan terpicu dan seorang analis menyelesaikan peringatan.
4. Sesuaikan seiring waktu. Sesuaikan ambang batas di Konsol saat Anda mempelajari tingkat positif-nyata dan positif-palsu Anda — tidak diperlukan penerapan.

Karena semuanya ada di API /v3/ terpadu, pengguna yang di-onboarding dengan alur KYC langsung masuk ke mesin yang sama yang menjalankan aturan kecepatan ini — satu platform identitas-dan-penipuan, dari awal hingga akhir.

Pertanyaan yang sering diajukan

Agregasi apa yang dapat digunakan aturan kecepatan?

Tiga: count (jumlah transaksi yang cocok), sum (jumlah kumulatif), dan distinct (pihak lawan atau atribut unik), masing-masing dievaluasi selama jendela waktu yang Anda tentukan.

Bagaimana cara mendeteksi penataan secara spesifik?

Gabungkan agregasi sum selama jendela dengan kondisi bahwa setiap pembayaran berada tepat di bawah ambang batas pelaporan Anda. Aturan menyala ketika total kumulatif melewati batas yang dimaksudkan untuk disembunyikan oleh penataan.

Apakah saya memerlukan prosesor aliran sendiri?

Tidak. Mesin mempertahankan jendela bergulir per subjek. Anda mendeklarasikan jendela, agregasi, dan ambang batas di Konsol.

Berapa biayanya?

$0,02 per transaksi, ditagih per panggilan tanpa minimum. Penyaringan AML pada pihak yang ditandai ditagih secara terpisah seharga $0,20.

Bisakah saya membangun aturan kecepatan yang tidak tercakup oleh bundel yang diunggulkan?

Ya. Bundel Kustom mendukung kondisi, jendela kecepatan, dan agregasi untuk tipologi apa pun yang unik untuk produk Anda.

Siap untuk memulai?

Baca Ikhtisar Pemantauan Transaksi di dokumen, lihat bagaimana itu sesuai dengan sisa platform di halaman produk Pemantauan Transaksi, dan periksa harga transparan per panggilan di halaman harga. Saat Anda siap, mulai gratis — 500 pemeriksaan KYC gratis setiap bulan, dan pemantauan transaksi dengan biaya $0,02 per panggilan.