> ## 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이 사용자 엔티티의 거래 내역을 거래 모니터링 규칙에 반영하는 방식을 확인하고 내역을 조회하세요. 월 1,000건 포함, 이후 건당 $0.001.

`vendor_data`를 포함한 거래(신청자 또는 거래 상대방으로 제출된 거래)는 모두 해당하는 User 엔터티에 연결됩니다. User 프로필은 해당 개인의 활동을 누적하는 원장이 되며, 거래 모니터링은 이 이력을 거래 속도 및 행동 규칙의 입력값으로 사용합니다.

## 사용자의 거래 조회

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

사용자가 신청자인 모든 거래를 반환합니다. 거래 상대방 측 이력은 Business Console에서 필터링하십시오(공개 목록 엔드포인트는 신청자 기준으로만 필터링합니다).

## 거래와 사용자의 연결 방식

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

각 거래에는 최대 네 개의 당사자(신청자, 송금자, 수취인, 거래 상대방)가 포함될 수 있습니다. 당사자에 `vendor_data`가 포함되면 Didit은 해당 당사자를 그 User에 연결합니다. `vendor_data`가 없는 당사자는 엔터티 연결 없이 외부 스냅샷으로 저장됩니다.

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

## 집계된 위험 신호

거래는 다음과 같은 사용자 단위 신호를 생성합니다:

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

이 신호는 실시간으로 계산되며, 활성 [거래 규칙](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`를 차단 목록 또는 사용자 지정 목록에 추가합니다.

규칙이 사용자를 차단 목록에 추가하면 해당 User 엔터티가 `BLOCKED`로 전환되고 `user.status.updated` webhook이 발생합니다.

## 사용자 행동 모니터링

Business Console의 사용자 상세 페이지에 있는 거래 탭에서 다음을 수행합니다:

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

## 보완 세션

거래가 `AWAITING_USER` 상태로 전환되면 Didit은 연결된 **보완 세션**을 생성합니다. 사용자는 이 세션에서 추가 인증(예: 자금 출처 증빙, 갱신된 신분증)을 완료해야 합니다. 보완 세션은 동일한 `vendor_data`에 연결되며, 완료되면 거래 상태가 자동으로 업데이트됩니다.

전체 상태 머신은 [거래 상태](https://docs.didit.me/ko/transaction-monitoring/statuses.md)를 참조하십시오.

## 과거 거래 수집

기존 User 엔터티에 과거 거래를 추가하려면 과거 날짜의 `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": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> 과거 거래도 규칙 엔진을 거칩니다. 규칙을 트리거하지 않고 이력만 수집하려면 콘솔 가져오기 흐름의 "dry ingest" 모드를 사용하십시오.

## 다음 단계

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

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