지갑 및 주소 스크리닝 API (KYT) - 암호화폐 AML

​

스크리닝 트리거 방식

1. 거래 세부 정보에 currency_kind: "crypto"가 있어야 합니다.
2. 애플리케이션 설정에서 거래 모니터링이 활성화되어 있어야 합니다.

​

자산 및 네트워크 선택

{
  "transaction_details": {
    "currency": "TOKEN",
    "currency_kind": "crypto",
    "crypto_params": {"crypto_chain": "BASE"}
  }
}

​

수신 및 송신 비교

​

라이트닝 네트워크

​

필수 필드

• transaction_details.direction: INBOUND 또는 OUTBOUND
• transaction_details.currency_kind: crypto
• transaction_details.currency: 자산 심볼(예: BTC, ETH, USDC) 또는 사용자 정의 토큰
• 위의 방향 규칙에 따라 해당 참여자에 속한 지갑 주소

• transaction_details.payment_reference_id: 블록체인 거래 해시

​

예시: 전송 전 송신 스크리닝

{
  "transaction_id": "withdrawal-001",
  "transaction_category": "finance",
  "include_crypto_screening": true,
  "transaction_details": {
    "direction": "OUTBOUND",
    "amount": "0.25",
    "currency": "ETH",
    "currency_kind": "crypto",
    "action_type": "withdrawal"
  },
  "subject": {
    "entity_type": "individual",
    "vendor_data": "user-123",
    "full_name": "John Doe"
  },
  "counterparty": {
    "entity_type": "unhosted_wallet",
    "full_name": "John Doe",
    "payment_method": {
      "method_type": "crypto_wallet",
      "account_id": "0xRecipientWallet..."
    }
  }
}

​

예시: 전송 후 수신 스크리닝

{
  "transaction_id": "deposit-001",
  "transaction_category": "finance",
  "include_crypto_screening": true,
  "transaction_details": {
    "direction": "INBOUND",
    "amount": "0.25",
    "currency": "ETH",
    "currency_kind": "crypto",
    "action_type": "deposit",
    "payment_reference_id": "0xTransactionHash..."
  },
  "subject": {
    "entity_type": "individual",
    "vendor_data": "user-123",
    "full_name": "John Doe",
    "payment_method": {
      "method_type": "crypto_wallet",
      "account_id": "0xYourServiceDepositAddress..."
    }
  },
  "counterparty": {
    "entity_type": "unhosted_wallet",
    "full_name": "John Doe"
  }
}

​

지원되는 제공업체

​

스크리닝 결과

​

스크리닝 상태

​

아직 인덱싱되지 않은 거래 해시

• 생성 응답에는 이미 custom_values.aml_screening_status가 PENDING으로 표시되며, 이유는 custom_values.aml_screening_error에 나옵니다. 승인될 거래는 decision_reason_code aml_screening_pending과 함께 IN_REVIEW로 보류됩니다.
• Didit은 거래가 생성된 후 약 2분, 12분, 42분에 거래 해시를 다시 스크리닝합니다.
• 재시도에서 스크리닝되면, 결과는 다른 스크리닝과 똑같이 저장되고 스크리닝 요금은 한 번만 부과됩니다. 규칙이 스크리닝 데이터에 대해 다시 실행되고, 보류가 해제되며, 상태가 바뀌었는지와 관계없이 규칙 적용 후 거래 상태를 담은 transaction.status.updated webhook이 한 번 전송됩니다. 그 사이에 거부되었거나 검토자가 처리한 거래는 현재 상태를 유지합니다.
• 마지막 재시도 후에도 제공업체가 거래 해시를 인덱싱하지 않았다면, 스크리닝은 처음 생성 시와 같이 FAILED로 끝납니다. 거래는 decision_reason_code aml_screening_failed와 함께 IN_REVIEW 상태로 남으며, 과금은 생성 시 실패와 같은 방식으로 적용됩니다. Didit 관리형 스크리닝에서는 요금이 없고, 마지막 시도가 연결된 제공업체에 도달했다면 제공업체 요청 1건이 집계됩니다. 재시도된 이전 시도에는 요금이 부과되지 않습니다.
• 재시도 실행 시 잔액으로 스크리닝 비용을 더 이상 감당할 수 없으면, 스크리닝은 FAILED로 끝나며 요금이 부과되지 않습니다.

​

위험 점수와 심각도

• 위험 점수(0–100): 점수가 높을수록 위험한 개체에 더 많이 노출되어 있음을 뜻합니다.
• 심각도 수준: 점수에서 도출되며, LOW, MEDIUM, HIGH, CRITICAL 중 하나입니다.

​

자금 출처 분석

​

노출 표

• 개체 이름과 카테고리
• 직접 연결과 간접 연결 구분(홉 거리)
• 수취 및 송금 금액
• 개체별 위험 수준

​

네트워크 그래프

• 노드는 지갑, 거래소, 서비스 및 기타 개체를 나타냅니다.
• 엣지는 노드 사이의 거래를 나타내며, 금액과 거래 해시가 포함됩니다.
• 지표에는 중심성(centrality)과 깊이(depth) 같은 그래프 수준 통계가 포함됩니다.

​

규칙과의 연동

​

규칙용 스크리닝 필드

​

다음 단계