> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaksi Pengguna: Riwayat KYT & Risiko

> Didit: ambil riwayat transaksi Pengguna dan lihat cara masuk ke aturan Pemantauan Transaksi. 1,000 per bulan termasuk, lalu $0.001 tiap panggilan.

Setiap transaksi yang Anda kirim dengan pengidentifikasi `vendor_data` (baik sebagai pemohon maupun pihak lawan) ditautkan ke entitas User yang sesuai. Profil User menjadi buku besar aktivitas orang tersebut secara berkelanjutan, dan Pemantauan Transaksi menggunakan riwayat ini untuk aturan kecepatan transaksi dan perilaku.

## Mengambil transaksi seorang pengguna

Filter daftar Transactions menggunakan `vendor_data`:

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42" \
  --data-urlencode "page_size=50"
```

Mengembalikan setiap transaksi yang penggunanya merupakan pemohon. Untuk riwayat dari sisi counterparty, lakukan filter di Business Console (endpoint daftar publik hanya memfilter berdasarkan applicant).

## Cara transaksi ditautkan ke pengguna

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

Setiap transaksi memuat hingga empat pihak (pemohon, pengirim, penerima, pihak lawan). Ketika sebuah pihak menyertakan `vendor_data`, Didit mengikatnya ke User tersebut. Pihak tanpa `vendor_data` disimpan sebagai snapshot eksternal (tanpa tautan ke entitas).

Lihat [mengirim transaksi](https://docs.didit.me/id/transaction-monitoring/transactions.md) untuk model pihak secara lengkap.

## Sinyal risiko agregat

Transaksi menjadi sumber sinyal tingkat pengguna berikut:

| Sinyal | Digunakan oleh |
| - | - |
| Total volume masuk / keluar | Aturan kecepatan transaksi, penerapan ambang batas |
| Jumlah transaksi dalam jendela waktu | Aturan kecepatan transaksi |
| Pihak lawan unik | Aturan perilaku |
| Yurisdiksi berisiko tinggi yang terkait | Aturan geografi |
| Paparan terhadap pihak lawan yang terkena sanksi | Aturan penyaringan |
| Variasi metode pembayaran | Aturan penipuan |

Sinyal ini dihitung secara waktu nyata dan dievaluasi terhadap [aturan transaksi](https://docs.didit.me/id/transaction-monitoring/rules.md) Anda yang aktif. Ketika sebuah aturan terpenuhi, pengguna dapat dipindahkan ke `FLAGGED` atau `BLOCKED` secara otomatis, bergantung pada tindakan aturan tersebut.

## Cara aturan memengaruhi pengguna

`actions` pada aturan transaksi dapat berisi:

* `add_score` — menambah skor risiko transaksi.
* `change_status` — menetapkan status transaksi (`IN_REVIEW`, `DECLINED`, `AWAITING_USER`).
* `add_tags` — memberi tag pada transaksi.
* `add_to_list` — menambahkan `vendor_data` pengguna ke daftar blokir atau daftar kustom.

Ketika sebuah aturan menambahkan pengguna ke daftar blokir, entitas User-nya beralih ke `BLOCKED` dan webhook `user.status.updated` dipicu.

## Memantau perilaku pengguna

Gunakan tab Transactions pada halaman detail User di Business Console untuk:

* Melihat setiap transaksi secara berurutan menurut waktu.
* Memfilter berdasarkan status, jumlah, arah, pihak lawan.
* Membuka transaksi mana pun untuk memeriksa eksekusi aturan, pengayaan IP, dan hasil skrining kripto.
* Membuka kasus terhadap pengguna untuk melacak investigasi.

## Sesi remediasi

Ketika sebuah transaksi masuk ke `AWAITING_USER`, Didit membuat **sesi remediasi** yang terhubung dan mengharuskan pengguna menyelesaikan verifikasi tambahan (misalnya, dokumentasi sumber dana, atau ID yang diperbarui). Sesi remediasi terikat ke `vendor_data` yang sama. Setelah selesai, status transaksi diperbarui secara otomatis.

Lihat [status transaksi](https://docs.didit.me/id/transaction-monitoring/statuses.md) untuk mesin status secara lengkap.

## Memasukkan riwayat

Untuk mengisi ulang transaksi historis pada entitas User yang sudah ada, kirimkan `txn_date` di masa lalu:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> Transaksi historis tetap diproses melalui mesin aturan. Jika Anda ingin memasukkan riwayat **tanpa** memicu aturan, gunakan alur impor di konsol, yang mendukung mode "dry ingest".

## Langkah selanjutnya

> [card] [Kirim transaksi](https://docs.didit.me/id/transaction-monitoring/transactions.md)
>
> Referensi payload lengkap.

> [card] [Aturan](https://docs.didit.me/id/transaction-monitoring/rules.md)
>
> Cara aturan mengevaluasi transaksi dan memengaruhi pengguna.

> [card] [Status](https://docs.didit.me/id/transaction-monitoring/statuses.md)
>
> Referensi status transaksi dan remediasi.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.