메인 콘텐츠로 건너뛰기
GET
curl

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

transaction_id
string<uuid>
필수

Didit 고유 거래 UUID(생성/조회 시 반환된 uuid이며, 귀하의 txn_id가 아님).

응답

전체 거래 세부정보입니다.

GET /v3/transactions/{transaction_id}/ 및 POST /v3/transactions/에서 반환되는 단일 거래에 대한 전체 모니터링 기록입니다.

uuid
string<uuid>

Didit 고유 거래 식별자입니다. 후속 호출 시 {transaction_id}로 사용합니다.

environment
enum<string>

거래를 소유한 애플리케이션의 환경. sandbox 거래는 저장되지만 평가, 스크리닝, 알림 또는 결제가 이루어지지 않으므로, 비어 있는 rule_runs는 "평가되지 않음"을 의미합니다.

사용 가능한 옵션:
live,
sandbox
transaction_number
integer

Console에 표시되는 애플리케이션별 순차 거래 번호(예: 4123)입니다.

txn_id
string

생성 시 제공한 transaction_id입니다(최대 128자). 애플리케이션별로 고유합니다.

txn_date
string<date-time>

거래가 발생한 시점입니다(transaction_at 기준, 기본값은 제출 시간).

zone_id
string | null

생성 시 제공된 IANA 표준 시간대 식별자입니다.

transaction_type
string

저장된 최상위 카테고리: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. 여러 단어로 된 값은 snake_case로 제출하더라도 camelCase로 반환됩니다.

action_type
string

카테고리 내 하위 유형입니다(예: deposit, withdrawal, transfer). 제공되지 않은 경우 카테고리로 기본 설정됩니다.

direction
enum<string>

주체 기준의 방향입니다. 제출된 대소문자에 관계없이 대문자로 저장됩니다(입력 시 in/out/inbound/outbound 허용).

사용 가능한 옵션:
INBOUND,
OUTBOUND
status
enum<string>

현재 모니터링 판정 결과입니다. 거래는 APPROVED 상태로 생성되며, 규칙에 따라 동기식으로 IN_REVIEW/DECLINED 상태로 변경될 수 있습니다.

사용 가능한 옵션:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

기록이 생성된 방식입니다. API 또는 SDK를 통해 제출된 거래는 LIVE, 콘솔 가져오기를 통해 로드된 거래는 IMPORTED입니다.

사용 가능한 옵션:
LIVE,
IMPORTED
amount
string

끝자리의 0이 제거된 십진수 문자열 형태의 거래 금액(예: "1500", "0.5", "0.123456789012345678")입니다. 소수점 이하 최대 18자리입니다.

currency
string

amount의 통화 코드입니다. 암호화폐 자산 심볼(예: BTC)뿐만 아니라 모든 ISO 4217 알파벳 코드(예: EUR, USD, NGN)를 사용할 수 있습니다. 현재 유통 중인 코드를 사용하는 것이 좋습니다. 지원되는 모든 코드에 환율이 제공되는 것은 아닙니다. 해당 코드의 환율을 사용할 수 없는 경우(예: ISO 회계 단위 XSU 또는 Didit에서 가격을 책정하지 않는 암호화폐 심볼), 자동 변환이 실패하며 요청에 사전 변환된 amount_in_default_currency가 제공되지 않는 한 preferred_currency_amount는 null로 반환됩니다.

currency_type
string | null

currency_kind로 제출된 fiat 또는 crypto.

amount_in_default_currency
string | null

사용자가 제공한 사전 환산 금액으로, 뒤따르는 0이 제거된 십진수 문자열입니다.

default_currency_code
string | null
preferred_currency_amount
string | null

제공되는 경우 애플리케이션의 선호 통화로 변환된 amount입니다.

preferred_currency_code
string | null
payment_details
string | null

제출된 자유 형식 결제 참조 또는 메모입니다.

payment_txn_id
string | null

payment_reference_id에서 가져온 외부 결제 시스템 참조(예: 블록체인 거래 해시)입니다.

score
integer

규칙에 의해 누적된 위험 점수(일반적으로 0–100). 높을수록 위험합니다.

severity
enum<string> | null

규칙/제공업체에서 설정한 범주형 위험 심각도(UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). 설정되기 전까지는 null입니다.

사용 가능한 옵션:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

현재 status에 대한 기계 판독 가능한 사유.

decision_reason_label
string | null

decision_reason_code에 대한 사람이 읽기 쉬운 라벨입니다.

vendor_data
string | null

신청자의 vendor_data에 대한 편의 사본입니다.

metadata
object

생성 시점에 제출된 subject 및 counterparty payload의 스냅샷입니다.

props
object

생성 시 제공한 custom_properties입니다. 각 키는 규칙 조건에서 custom_values.<key>로 참조할 수 있습니다.

tags
object[]

거래에 연결된 태그(수동 또는 규칙에 의해)입니다.

parties
object[]

거래 당사자(신청인, 거래 상대방)입니다.

payment_methods
object[]

거래에 연결된 결제 수단입니다.

documents
object[]

콘솔에서 거래에 첨부된 파일입니다. 없는 경우 []입니다.

activities
object[]

활동 로그 항목입니다(생성, 메모, 수동 검토, 상태 변경).

alerts
object[]

현재는 항상 비어 있습니다. 미해결 알림은 상태가 IN_REVIEW 또는 AWAITING_USER인 거래입니다.

rule_runs
object[]

규칙별 실행 결과 — 어떤 규칙이 실행되었는지와 점수에 미친 영향입니다.

provider_results
object[]

원시 제공자 payload(AML 스크리닝, 블록체인 분석 등)입니다.

travel_rule
object | null

Travel Rule 이체 또는 확인입니다. travel_rule_details가 제출되었을 때, 그리고 Travel Rule이 활성화되어 있고 transaction_category: travelRule로 거래가 생성되었을 때 채워집니다(Didit은 travel_rule_details 없이도 정보 교환을 직접 시작합니다). 이체 또는 확인이 존재하지 않는 경우 null입니다. 인바운드 이체에서는 지갑 소유권이 확인될 때까지 거래 상대방의 originator_data 및 beneficiary_data가 마스킹된 상태(data_masked: true)로 유지됩니다.

network_snapshot
object | null

규칙 엔진에서 사용하는 관련 거래/당사자의 그래프 스냅샷입니다. 거래와 함께 제출된 network_snapshot 또는 Didit이 성공한 AML 지갑 스크리닝에서 빌드하는 그래프(제출된 그래프를 대체함) 중 하나입니다. 둘 다 존재하지 않는 경우 null입니다.

remediation
object | null

재인증이 필요할 때 사용자에게 제공되는 개선 세션입니다. 표준 블록인 action_required로 대체되었으며, 이전 버전과의 호환성을 위해 유지됩니다.

action_required
Verification session · object

이 거래를 완료하는 데 필요한 대기 중인 최종 사용자 작업이며, 없는 경우 null입니다. Didit SDK는 기본적으로 작업을 자동으로 실행하고 완료 시 거래를 새로고침합니다. type으로 구분되는 두 가지 변형이 있습니다. verification_session(규칙 작업에 의해 생성된 호스팅 인증 세션)과 wallet_ownership(지갑 제어 증명이 필요한 Travel Rule 이체에 대해 자동 생성되는 지갑 소유권 위젯 세션으로, auto_wallet_verification Travel Rule 설정에 따라 제어됨)입니다. 둘 다 적용될 수 있는 경우 Travel Rule 교환을 차단하므로 wallet_ownership이 우선 적용됩니다.

cost_breakdown
object | null

이 거래의 비용입니다. total_price와 청구 항목별 usage_type, price, details, created_at이 포함된 items로 구성됩니다. 동일한 거래를 다시 스크리닝하면 새 항목이 생성됩니다.

마지막 수정일 2026년 11월 7일