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

# 기업 거래 내역 조회 (KYT 이력)

> Didit 기업 엔터티의 거래 내역을 조회하고, 지속적인 활동이 거래 모니터링의 속도, 행동, 스크리닝 규칙에 어떻게 반영되는지 확인하세요.

`vendor_data` 식별자가 기업 엔티티와 일치하고 신청자, 송금인, 수취인 또는 거래 상대방으로 등장하는 거래는 모두 해당 기업 프로필에 연결됩니다. 기업은 활동을 누적 기록하는 원장이 되며, 거래 모니터링은 이 이력을 활용해 기업 수준의 거래 빈도, 행동 및 스크리닝 규칙을 적용합니다.

## 기업의 거래 조회

`vendor_data`로 거래 목록을 필터링하십시오:

```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"
```

기업이 신청자로 등장하는 모든 거래를 반환합니다. 거래 상대방 측 이력은 Business Console에서 필터링하십시오(공개 목록 endpoint는 신청자 기준으로만 필터링합니다).

## 거래가 기업과 연결되는 방식

```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
```

각 거래에는 최대 네 개의 당사자(`applicant`, `remitter`, `beneficiary`, `counterparty`)가 포함될 수 있습니다. 당사자에 애플리케이션 내 기업 엔티티와 일치하는 `vendor_data`가 포함되어 있으면 Didit은 해당 당사자를 그 기업에 연결합니다. `vendor_data`가 없는 당사자는 엔티티 연결 없이 외부 스냅샷으로 저장됩니다.

전체 당사자 모델은 [거래 제출](https://docs.didit.me/ko/transaction-monitoring/transactions.md)을 참조하십시오.

## 혼합 당사자 유형

하나의 거래에서 여러 당사자에 걸쳐 사용자와 기업이 섞일 수 있습니다. 예를 들어 개인 사용자가 기업에 결제하는 경우는 다음과 같습니다:

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

두 기업 간의 B2B 이체도 가능합니다:

```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은 `vendor_data`를 기준으로 각 당사자를 독립적으로 해석하며, 같은 거래가 일치하는 모든 엔티티의 프로필에 반영됩니다.

## 집계된 위험 신호

거래는 다음 기업 수준 신호를 생성합니다:

| 신호 | 사용처 |
| - | - |
| 총 유입 / 유출 거래액 | 거래 빈도 규칙, 임계값 설정 |
| 시간 범위 내 거래 건수 | 거래 빈도 규칙 |
| 고유 거래 상대방 수 | 행동 규칙 |
| 관련된 고위험 관할권 | 지역 규칙 |
| 제재 대상 거래 상대방 노출 | 스크리닝 규칙 |
| 결제 수단 다양성 | 사기 규칙 |

이 신호는 실시간으로 계산되며, 활성 [거래 규칙](https://docs.didit.me/ko/transaction-monitoring/rules.md)에 따라 평가됩니다. 규칙이 일치하면 규칙의 작업에 따라 기업이 `FLAGGED` 또는 `BLOCKED` 상태로 자동 전환될 수 있습니다.

## 규칙이 기업에 작용하는 방식

거래 규칙의 `actions`에는 다음이 포함될 수 있습니다:

* `add_score` — 거래의 위험 점수를 높입니다.
* `change_status` — 거래의 상태(`IN_REVIEW`, `DECLINED`, `AWAITING_USER`)를 설정합니다.
* `add_tags` — 거래에 태그를 추가합니다.
* `add_to_list` — 기업의 `vendor_data`를 차단 목록 또는 사용자 지정 목록에 추가합니다.

규칙이 기업을 차단 목록에 추가하면 기업 엔티티는 `BLOCKED` 상태로 전환되고 `business.status.updated` webhook이 발생합니다.

## 기업 행동 모니터링

Business Console의 기업 상세 페이지에 있는 Transactions 탭에서 다음 작업을 수행할 수 있습니다:

* 모든 거래를 시간순으로 확인합니다.
* 상태, 금액, 방향, 거래 상대방으로 필터링합니다.
* 거래를 열어 규칙 실행 내역, IP 정보 보강 결과, 암호화폐 스크리닝 결과를 확인합니다.
* 기업을 대상으로 케이스를 열어 조사 진행 상황을 추적합니다.

## 기업이 보유한 결제 수단

각 거래에는 하나 이상의 결제 수단(은행 카드, 은행 계좌, 전자 지갑, 암호화폐 지갑)이 연결될 수 있습니다. 결제 수단이 기업의 소유인 경우 `vendor_data`를 통해 해당 기업에 연결되므로, 기업 상세 페이지에서 기업이 과거에 사용한 모든 결제 수단을 바로 확인할 수 있습니다.

## 과거 데이터 수집

기존 기업에 과거 거래를 소급 입력하려면 과거 날짜의 `txn_date`를 전달하십시오:

```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]
>
> 과거 거래도 여전히 규칙 엔진을 거칩니다. 규칙을 **트리거하지 않고** 이력만 수집하려면 "dry ingest" 모드를 지원하는 콘솔 가져오기 흐름을 사용하십시오.

## 다음 단계

> [card] [거래 제출](https://docs.didit.me/ko/transaction-monitoring/transactions.md)
>
> 전체 payload 참조.

> [card] [규칙](https://docs.didit.me/ko/transaction-monitoring/rules.md)
>
> 규칙이 거래를 평가하고 기업에 작용하는 방식.

> [card] [상태](https://docs.didit.me/ko/transaction-monitoring/statuses.md)
>
> 거래 및 시정 조치 상태 참조.


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