메인 콘텐츠로 건너뛰기
POST
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
chain
string
필수

입금이 정산된 체인(예: ETH). 소문자로 저장되며 지갑 주소록 항목과 대소문자를 구분하지 않고 비교되므로, 주소록에서도 동일한 체인 token을 사용하십시오.

Maximum string length: 32
txid
string
필수

온체인 거래 해시입니다. wallet_address와 함께 중복 제거됩니다.

Maximum string length: 128
wallet_address
string
필수

입금을 수령한 대상 지갑입니다. XRP X-address는 기본 클래식 주소와 태그로 분리됩니다.

Maximum string length: 128
amount
string
필수

0 이상, 소수점 이하 최대 18자리의 10진수 문자열로 표시된 입금 금액입니다.

currency
string
필수

입금 자산(예: "USDC")입니다.

Maximum string length: 16
originator_data
object

알려진 경우 발송 VASP의 송금인 세부 정보이며, {"name": "..."}와 같은 평면 객체입니다. Didit은 여기에서 name(또는 full_name), first_name, last_name 및 vendor_data를 읽습니다.

beneficiary_data
object

{"name": "..."}와 같은 단일 계층 객체 형태의 수취인 세부 정보(귀사 고객)입니다. Didit은 일치하는 주소록 항목의 holder_name과 name을 대조하고, 요청에 따라 wallet_address 및 chain을 설정합니다.

originating_vasp
object

송금 VASP에 대한 선택적 설명입니다. 이 전송에만 유지되며(metadata.originating_vasp, 그리고 GET /v3/travel-rule/transfers/의 해당 전송의 송금인 VASP), 공유 VASP 디렉터리 항목을 생성, 수정 또는 연결하지 않습니다.

memo
string

선택 사항입니다. 메모 네트워크에서의 입금 대상 데스티네이션 태그 또는 메모입니다. 공유 입금 주소에서 고객을 구분하는 기준이 되며, 해당 메모에 대한 주소록 항목과 일치합니다. XRP: 데스티네이션 태그, 0에서 4294967295 사이의 정수(JSON 숫자 허용). XLM: 최대 28바이트의 텍스트 메모, 64비트 ID 또는 16진수 32바이트 해시. EOS: 최대 256바이트. ATOM: 최대 256자. HBAR: 최대 100바이트. Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin 및 Lightning 지갑은 메모를 받지 않으며, 입력 시 400이 반환됩니다. 별칭: destinationTag 또는 destination_tag.

Maximum string length: 256
utxo
object

선택 사항이며 UTXO 체인 전용입니다. 입금 거래의 입력 및 출력입니다. 보낸 사람의 지갑은 선언된 originator_data.wallet_address이며, 그렇지 않은 경우 가장 큰 입력입니다.

응답

이 txid 및 wallet_address에 대한 이체가 이미 등록되어 있습니다. 기존 이체가 변경 없이 반환됩니다(created는 false입니다).

transaction_id
string<uuid>

인바운드 입금에 대한 Didit 거래 UUID입니다.

txn_id
string

인바운드 거래의 txn_id: Didit이 거래를 생성했을 때는 Didit 생성 ID, 클레임되지 않은 입금이 재사용되었을 때는 자체 ID입니다.

created
boolean

이 호출로 이체가 등록된 경우(HTTP 201) true, 동일한 txid 및 wallet_address에 대한 이체가 이미 존재하는 경우(HTTP 200) false입니다.

travel_rule
object

소유권 확인 및 완료/취소 endpoint에서 반환되는 전체 전송 객체입니다. 인바운드 전송의 지갑 소유권이 확인되지 않은 동안에는 상대방의 originator_data 및 beneficiary_data가 마스킹되어 반환되며(각 단어의 첫 글자만 유지되고 지갑, 체인 및 VASP 라우팅은 읽을 수 있는 상태로 유지됨), data_masked는 true가 됩니다.

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