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

인증

X-Transaction-Token
string
header
필수

백엔드에서 POST /v3/transactions/sdk-token/을 통해 발행한 유효 기간이 짧은 범위 지정 token입니다. 디바이스용 /v1/transactions/ endpoints에서 Didit SDK가 사용합니다.

본문

application/json
txnId
string
필수

귀하가 지정한 해당 거래의 고유 식별자입니다(transaction_id에 매핑되며, 최대 128자).

예시:

"wd-2026-07-07-0042"

type
string
필수

거래 카테고리(transaction_category에 매핑됨)입니다. 예: finance, kyc, travelRule, userPlatformEvent, gamblingBet.

예시:

"travelRule"

info
object
필수

거래의 핵심 금융 세부 정보(transaction_details에 매핑됨).

subject
object
필수

거래의 주체(신청자)입니다. 여기서는 externalUserId가 무시되며, 주체의 신원은 항상 토큰의 vendor_data를 통해 적용됩니다.

txnDate
string<date-time>

거래가 발생한 시점입니다(transaction_at에 매핑됨). 생략 시 현재 시간으로 기본 설정됩니다.

zoneId
string

IANA 표준 시간대 식별자(time_zone에 매핑됨, 예: Europe/Madrid)입니다.

counterparty
object

거래의 거래 상대방(선택 사항)입니다. subject와 동일한 형태이며, 여기서는 externalUserId가 의미를 갖습니다.

props
object

커스텀 키-값 쌍(custom_properties에 매핑됨)입니다. 각 키는 규칙 조건에서 custom_values.<key>로 참조할 수 있습니다.

travelRule
object

Travel Rule 세부 정보(travel_rule_details에 매핑됨). 애플리케이션에 Travel Rule이 활성화되어 있으면 Didit은 전송된 status를 무시하고 직접 정보 교환을 진행합니다.

includeCryptoScreening
boolean | null

암호화폐 블록체인 분석 스크리닝에 대한 거래별 재정의입니다(include_crypto_screening에 매핑됨).

fingerprint_v2
object

didit-fp-v2 기기 지문 payload입니다. SDK에 의해 자동으로 주입되며, wire API를 직접 호출할 때만 관련이 있습니다.

응답

거래가 제출되고 모니터링되었습니다. 최종 사용자가 후속 작업을 완료해야 할 때 포함되는 action_required 블록을 포함하여 GET /v3/transactions/{transaction_id}/와 동일한 세부 정보 형태입니다(SDK는 기본적으로 이를 자동으로 실행합니다).

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일