이미 On-Chain 트랜잭션이 발생하여 익명의 입고건이 발생한 경우, 해당 TXID 기준으로 CODE 회원사가 출고했는지 확인하고, 만약 CODE 회원사에서 출고한 트랜잭션의 경우에 해당 회원사의 entityId를 찾는 요청입니다.

CODE 회원사 외에는 검색이 불가능하며, NOT_FOUND_TXID 결과의 경우 CODE 회원사가 아닌 경우 이거나 혹은 일시적으로 회원사의 서버 문제로 TXID가 검색되지 않았을 것으로 추측할 수 있습니다.

❗️Txid 조회는 코드의 회원사 VASP가 출고한 기록만을 검색합니다. 코드 회원사 외 VASP의 Txid는 검색되지 않습니다.

❗️Txid 또는 tx hash는 반드시 블록체인 Node Output 데이터를 그대로 사용해야 합니다. '0x'를 tx hash 앞에 추가하여 사용하는 경우 tx hash 불일치가 발생할 수 있습니다. 따라서 Node Output에 없는 '0x'가 포함하지 않도록 주의해 주세요.

❗️비동기 방식으로 작동하는 API로 요청 후 Callback URL을 사용해 결과를 수신하거나 'TXID로 VASP 찾기 결과 조회' API를 통해 결과를 확인할 수 있습니다. 두 가지 방법의 결과 데이터는 동일합니다.

Request

이름	필수 여부	설명
txid	필수	입고된 TXID
vout	옵션	utxo타입 코인의 경우 복수의 블록체인 트랜잭션이 하나의 txid 를 공유하면서 그룹을 형성할 수 있기 때문에, 고유한 트랜잭션을 식별하기 위해 사용하는 값
requestId	필수	결과 조회를 하기 위한 고유한 요청 ID
callbackUrl	옵션	검색 결과 Callback URL은 https:// 형식으로 작성, 해당 URL에 CODE의 IP 접근 허용 필요

{
  "txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
  "vout": "",
  "requestId": "b09c8d00-8da9-11ec-b909-0242ac120002",
  "callbackUrl": "https://endpoint.com"
}

Response

이름	필수 여부	설명
result	필수	요청 결과
requestId	필수	결과 조회를 하기 위한 고유한 요청 ID

result: TXID 검증 결과입니다.

-SUCCESS: 정상적인 TXID일 때 반환됩니다.

TXID로 VASP 찾기 요청

Request

Response

Example