> ## 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 Bisnis: Riwayat KYT

> Ambil riwayat transaksi entitas bisnis Didit dan lihat bagaimana aktivitas berkelanjutan memengaruhi aturan Pemantauan Transaksi Didit.

Setiap transaksi yang Anda kirim dengan pengenal `vendor_data` yang cocok dengan entitas Bisnis, baik sebagai pemohon, pengirim, penerima, maupun pihak lawan, akan ditautkan ke profil Bisnis tersebut. Bisnis menjadi buku besar yang terus diperbarui untuk aktivitasnya, dan Pemantauan Transaksi menggunakan riwayat ini untuk memberi masukan pada aturan velocity, perilaku, dan skrining di tingkat bisnis.

## Mengambil transaksi sebuah bisnis

Filter daftar Transaksi berdasarkan `vendor_data` bisnis:

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

Hasilnya memuat setiap transaksi yang bisnis tersebut muncul sebagai pemohon. Untuk riwayat dari sisi pihak lawan, filter di Business Console (endpoint daftar publik hanya memfilter berdasarkan pemohon).

## Cara transaksi ditautkan ke bisnis

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

Setiap transaksi memuat hingga empat pihak (`applicant`, `remitter`, `beneficiary`, `counterparty`). Ketika sebuah pihak menyertakan `vendor_data` yang cocok dengan entitas Bisnis di aplikasi Anda, Didit mengaitkan pihak tersebut dengan Bisnis itu. Pihak tanpa `vendor_data` disimpan sebagai cuplikan eksternal (tanpa tautan ke entitas).

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

## Jenis pihak campuran

Satu transaksi dapat mencampur Pengguna dan Bisnis di antara para pihak, misalnya seorang pengguna perseorangan yang membayar sebuah bisnis:

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

Atau transfer B2B antara dua bisnis:

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

Didit menentukan keterkaitan setiap pihak secara independen berdasarkan `vendor_data`, sehingga transaksi yang sama masuk ke profil setiap entitas yang cocok.

## Sinyal risiko agregat

Transaksi menjadi masukan bagi sinyal tingkat bisnis berikut:

| Sinyal | Digunakan oleh |
| - | - |
| Total volume masuk / keluar | Aturan velocity, penerapan ambang batas |
| Jumlah transaksi dalam rentang waktu | Aturan velocity |
| Pihak lawan unik | Aturan perilaku |
| Yurisdiksi berisiko tinggi yang terlibat | Aturan geografi |
| Paparan pihak lawan yang terkena sanksi | Aturan skrining |
| 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) yang aktif. Ketika sebuah aturan cocok, Bisnis dapat dipindahkan ke `FLAGGED` atau `BLOCKED` secara otomatis, bergantung pada tindakan aturan tersebut.

## Cara aturan bertindak terhadap bisnis

`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` bisnis ke daftar blokir atau daftar kustom.

Ketika sebuah aturan menambahkan bisnis ke daftar blokir, entitas Bisnis berpindah ke `BLOCKED` dan webhook `business.status.updated` dipicu.

## Memantau perilaku bisnis

Gunakan tab Transaksi pada halaman detail Bisnis di Business Console untuk:

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

## Metode pembayaran yang dimiliki bisnis

Setiap transaksi dapat melampirkan satu atau beberapa metode pembayaran (kartu bank, rekening bank, dompet elektronik, dompet kripto). Ketika metode pembayaran dimiliki oleh sebuah bisnis, metode tersebut ditautkan kembali melalui `vendor_data`, sehingga Anda dapat melihat setiap metode pembayaran yang pernah digunakan bisnis tersebut langsung di halaman detail Bisnis.

## Ingesti historis

Untuk mengisi data transaksi historis pada Bisnis yang sudah ada, teruskan `txn_date` dengan tanggal 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": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

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

## 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 bertindak terhadap bisnis.

> [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.