메인 콘텐츠로 건너뛰기
PUT
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 를 참고하십시오.

본문

application/json

모든 필드는 선택 사항이며, PUT은 부분 업데이트를 적용합니다.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS는 한 이름의 단어가 모두 다른 이름에 나타나는 경우를 허용합니다.

사용 가능한 옵션:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
필수 범위: x >= 1
timeout_outcome
enum<string>
사용 가능한 옵션:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

VASP 프로필의 컴플라이언스 담당자 연락처 이메일입니다. 이 주소가 이메일로 발송된 링크(POST /v3/travel-rule/settings/compliance-email/confirmation/)를 통해 확인된 경우에만 Didit 네트워크에 프로필이 등록됩니다. 주소를 변경하면 새로 확인해야 합니다.

is_discoverable
boolean

귀하의 VASP 프로필이 Didit 네트워크에 등록될 수 있는지 여부입니다. 다른 Didit 고객이 GET /v3/travel-rule/vasps/에서 찾을 수 있으며 INTERNAL 레일을 통해 연결됩니다. 등록하려면 프로덕션 애플리케이션, Travel Rule 활성화, 법인명 및 확인된 컴플라이언스 이메일도 필요합니다. didit_network에 누락된 항목이 표시됩니다. 기본값은 true입니다.

threshold_amount
string

애플리케이션의 기본 통화로 표시된 0 이상의 십진수 문자열입니다. 관리형 교환을 트리거하는 최소 거래 금액입니다.

ownership_validation_mode
enum<string>

동일한 이름의 응답 필드를 참조하세요.

사용 가능한 옵션:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

0 이상의 십진수 문자열입니다.

data_sharing_fields
object

엔터티 유형별로 병합됩니다. 생략된 엔터티 유형은 현재 선택 항목을 유지합니다. 빈 목록을 포함하여 해당 jurisdiction 규정 체계(EU TFR 또는 FATF 권고안 16)의 송금인 의무를 충족할 수 없는 선택 항목은 400으로 거부됩니다.

matching_rules
object

엔터티 유형별, 그리고 그 내부의 필드별로 병합됩니다. 해당 엔터티 유형에서 비교하지 않는 필드(예: company의 date_of_birth)는 400으로 거부됩니다.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

true인 경우, 지갑 소유권 위젯에서 소유권 증빙 방법으로 스크린샷 업로드를 제공합니다. 기본값은 true입니다.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

거래 상대방 VASP에 대한 선택적 제재 및 부정적 언론 보도 스크리닝으로, 기업 AML 스크리닝 가격에 따라 스크리닝 건당 청구됩니다. 활성화하면 Didit은 발신 거래가 도달하는 거래 상대방을 스크리닝하며(30일 미만의 스크리닝 결과 재사용), POST /v3/travel-rule/vasps/{vasp_id}/screening/을 통해 직접 스크리닝할 수도 있습니다. 기본값은 false이며, 스크리닝되거나 결제되지 않습니다.

sunrise_policy
enum<string>

HOLD, REJECT, PROCEED 또는 timeout_outcome을 따르기 위한 빈 값입니다. 동일한 이름의 응답 필드를 참조하십시오.

사용 가능한 옵션:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD, REJECT, PROCEED 또는 timeout_outcome을 따르기 위한 빈 값입니다. 동일한 이름의 응답 필드를 참조하십시오.

사용 가능한 옵션:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

플랫폼 멤버십에 참여하지 않기로 한 네트워크입니다. 연결된 자체 멤버십을 비활성화하거나 사용할 수 없는 네트워크를 프로비저닝하지 않습니다.

사용 가능한 옵션:
GTR,
TRUST,
VERIFYVASP,
SYGNA

응답

GET과 동일한 형태의 업데이트된 설정 및 프로필입니다.

is_enabled
boolean

이 애플리케이션에서 아웃바운드 travelRule 거래에 대한 관리형 Travel Rule 협상 플로우가 활성화되어 있는지 여부입니다.

jurisdiction
string

귀하 VASP의 운영 관할권 코드입니다. 기본값은 "EU"입니다. Didit은 이를 귀하의 Travel Rule 거래에 travel_rule_regime으로 표기하는 규제 체제(예: EU 또는 EU 회원국 코드는 eu가 됨)에 매핑하며, 거래 규칙에서 이를 기준으로 활용할 수 있습니다. Didit 네트워크에 귀하의 프로필이 등록되면 다른 Didit 고객에게 귀하의 관할권으로 표시됩니다.

Maximum string length: 8
name_matching_strictness
enum<string>

이체가 COMPLETED 상태에 도달하기 위해 수취인 이름이 얼마나 엄격하게 일치해야 하는지를 나타냅니다. CONTAINS는 한 이름의 단어가 다른 이름에 모두 포함되어 있는 경우를 허용합니다.

사용 가능한 옵션:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

주기적 청소 작업(sweeper)이 만료 처리하기 전까지 AWAITING_COUNTERPARTY 전송이 미확인 상태로 유지될 수 있는 시간입니다. 기본값은 48입니다.

필수 범위: x >= 1
timeout_outcome
enum<string>

전송이 만료될 때 해당 거래에 수행되는 작업입니다. 기본값은 HOLD입니다. sunrise_policy 및 non_responsive_policy가 적용되고 설정된 경우 해당 정책이 우선합니다.

사용 가능한 옵션:
HOLD,
REJECT,
PROCEED
threshold_amount
string

애플리케이션의 기본 통화로 표시된 십진수 문자열입니다. 관리형 교환을 트리거하는 최소 거래 금액이며, 이 금액 미만의 거래는 NOT_APPLICABLE로 바로 처리됩니다. Didit은 기본 통화로 환산된 거래 금액 또는 사용자가 전송한 amount_in_default_currency를 비교합니다. 환산된 금액을 사용할 수 없는 경우 임계값이 적용되지 않습니다. 기본값은 "0.00"입니다(EU TFR은 최소 금액을 적용하지 않음).

ownership_validation_mode
enum<string>

지갑 소유권에 필요한 증명의 수준입니다. FULL은 항상 증명(서명된 메시지, 테스트 입금 또는 검토된 스크린샷)이 필요하며 최종 사용자의 구두 진술만으로는 불가합니다. SIMPLIFIED는 simplified_validation_threshold 미만에서는 자체 선언을 허용하고 그 이상에서는 증명을 요구합니다. AUTOMATED는 주소록 및 이전 증명을 통해 자체적으로 판별하며, allow_self_declaration이 true인 동안에는 자체 선언도 포함됩니다. 기본값은 AUTOMATED입니다.

사용 가능한 옵션:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

십진수 문자열이며 기본값은 "0.00"입니다. SIMPLIFIED 모드에서는 이 금액(임계값 통화 기준) 미만의 거래에 대해 자체 신고를 허용합니다. 해당 통화 기준 금액이 없는 거래는 이 금액을 초과하는 것으로 간주됩니다.

data_sharing_fields
object

엔터티 유형별로 Didit이 귀하의 사용자에 대해 거래 상대방 VASP로 전송하는 필드입니다. 목록의 내용과 관계없이 name 및 wallet_address는 항상 전송됩니다. 선택하지 않은 엔터티 유형은 모든 필드를 공유합니다. 빈 목록도 하나의 선택 항목이며, 이 경우 이름과 지갑만 공유합니다.

matching_rules
object

엔티티 유형별로 거래 상대방의 각 데이터 필드를 보유 중인 데이터와 얼마나 엄격하게 비교할지 여부입니다. 생략된 필드는 기본값을 유지합니다. NONE은 비교를 건너뛰고, STRICT는 정확히 일치하는 단어를 요구하며, CONTAINS는 한 값의 단어가 다른 값에 모두 포함된 경우를 허용하고, DEFAULT는 표준 하위 집합 일치이며, FUZZY는 유사한 철자(생년월일의 경우 일과 월이 바뀐 경우 포함)를 허용합니다.

귀하의 VASP의 법인명입니다. is_enabled를 true로 설정하려면 필수(공백 불가)입니다.

lei
string

VASP 디렉터리에 노출되는 법인 식별자(LEI)입니다.

compliance_email
string<email>

VASP 프로필의 컴플라이언스 담당자 연락처 이메일입니다. 이 주소가 이메일로 발송된 링크(POST /v3/travel-rule/settings/compliance-email/confirmation/)를 통해 확인된 경우에만 Didit 네트워크에 프로필이 등록됩니다. 주소를 변경하면 새로 확인해야 합니다.

is_discoverable
boolean

귀하의 VASP 프로필이 Didit 네트워크에 등록될 수 있는지 여부입니다. 다른 Didit 고객이 GET /v3/travel-rule/vasps/에서 찾을 수 있으며 INTERNAL 레일을 통해 연결됩니다. 등록하려면 프로덕션 애플리케이션, Travel Rule 활성화, 법인명 및 확인된 컴플라이언스 이메일도 필요합니다. didit_network에 누락된 항목이 표시됩니다. 기본값은 true입니다.

inbound_auto_accept
boolean

true인 경우, 수취인 지갑이 이름이 일치하는 인증된 주소록 항목인 수신 TRP 문의가 자동으로 승인됩니다. false인 경우, 해당 문의는 ON_HOLD 상태로 대기하며 소유권 endpoint를 통해 승인하거나 거부해야 합니다. INTERNAL 레일 및 입금 후 이체는 영향을 받지 않습니다. 기본값은 true입니다.

allow_self_declaration
boolean

true인 경우, 지갑 소유권 위젯에서 대체 증명 방법으로 자체 선언을 제공합니다. 기본값은 true입니다.

allow_screenshot_proof
boolean

true인 경우, 지갑 소유권 위젯에서 소유권 증빙 방법으로 스크린샷 업로드를 제공합니다. 기본값은 true입니다.

auto_wallet_verification
boolean

true인 경우, 최종 사용자의 지갑 제어 증명이 필요한 발신 Travel Rule 이체를 제출하면 해당 거래에 바인딩된 지갑 소유권 위젯 세션이 자동으로 발행되어 거래의 action_required 블록에 노출됩니다. 기본값은 true입니다.

vasp_attribution_enabled
boolean

true인 경우, 어떤 레일로도 라우팅할 수 없는 발신 Travel Rule 이체는 블록체인 분석을 통해 귀속 처리됩니다. 목적지 지갑이 소유 VASP로 식별되고, 해당 엔티티가 이체 기록 및 VASP 디렉터리에 기록되며, 귀속된 이름을 사용하여 레일이 한 번 더 다시 실행됩니다. 기본값은 true입니다.

counterparty_screening_enabled
boolean

거래 상대방 VASP에 대한 선택적 제재 및 부정적 언론 보도 스크리닝으로, 기업 AML 스크리닝 가격에 따라 스크리닝 건당 청구됩니다. 활성화하면 Didit은 발신 거래가 도달하는 거래 상대방을 스크리닝하며(30일 미만의 스크리닝 결과 재사용), POST /v3/travel-rule/vasps/{vasp_id}/screening/을 통해 직접 스크리닝할 수도 있습니다. 기본값은 false이며, 스크리닝되거나 결제되지 않습니다.

sunrise_policy
enum<string>

거래 상대방이 아직 Travel Rule을 시행하지 않는 sunrise_jurisdictions 관할 구역의 디렉터리 항목일 때 만료된 전송이 해당 거래에 미치는 영향: HOLD는 검토 중으로 이동하고, REJECT는 거부하며, PROCEED는 상태를 변경하지 않고 그대로 둡니다. 비어 있는 경우(기본값) timeout_outcome을 따릅니다. non_responsive_policy보다 먼저 적용됩니다.

사용 가능한 옵션:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

읽기 전용입니다. Didit이 sunrise_policy가 적용되는 Travel Rule sunrise 기간(일출 기간)에 있는 것으로 처리하는 국가(ISO 3166 alpha-2) 목록입니다. 현재 CO, KH, VN이 해당됩니다. 그 외의 모든 관할 구역이나 비어 있거나 알 수 없는 관할 구역은 timeout_outcome을 따릅니다.

non_responsive_policy
enum<string>

거래 상대방의 응답 상태가 UNRESPONSIVE인 디렉터리 항목일 때 만료된 전송이 해당 거래에 미치는 영향: timeout_outcome과 마찬가지로 HOLD, REJECT 또는 PROCEED입니다. 비어 있는 경우(기본값) timeout_outcome을 따릅니다. 둘 다 해당하는 경우 sunrise_policy가 먼저 적용됩니다.

사용 가능한 옵션:
,
HOLD,
REJECT,
PROCEED
travel_address
string

읽기 전용입니다. 귀사 VASP의 자체 Travel Address입니다. 다른 VASP가 귀사에 접근하는 데 사용하는 인코딩된 인바운드 TRP 문의 endpoint입니다. is_enabled가 false인 동안에는 비어 있습니다.

disabled_networks
enum<string>[]

플랫폼 멤버십에 참여하지 않기로 한 네트워크입니다. 연결된 자체 멤버십을 비활성화하거나 사용할 수 없는 네트워크를 프로비저닝하지 않습니다.

사용 가능한 옵션:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

네트워크별로 이 애플리케이션이 전송하는 방식과 전송할 수 없는 이유를 나타냅니다. GTR을 포함한 어떤 네트워크도 기본으로 포함되지 않습니다. 네트워크는 연결된 자체 멤버십을 통해 도달하거나, 해당 네트워크에 대한 Didit의 멤버십이 활성화되고 자체 참가자가 활성 상태가 되면 Didit 멤버십을 통해 도달할 수 있습니다. 실시간 상태 또는 전송 확인 검사가 아닙니다.

didit_network
object
read-only

Didit 네트워크가 귀하의 VASP 프로필을 나열하여 다른 Didit 고객이 디렉터리에서 이를 찾고 INTERNAL 레일로 도달할 수 있는지 여부 및 아직 충족되지 않은 각 조건입니다.

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