post https://trapi-dev.codevasp.com/v1/code/verification/tx
이미 발생한 Transaction에 대해 TXID를 기준으로 어느 거래소에서 출고 되었는지 검색을 요청합니다.
이미 On-Chain 트랜잭션이 발생하여 익명의 입고건이 발생한 경우, 해당 TXID 기준으로 어떤 VASP가 출고했는지 확인하고 해당 VASP의 entityId를 찾는 요청입니다.
CODE와 일부 프로토콜 소속 VASP 외에는 검색이 불가능하며, NOT_FOUND_TXID
결과의 경우 현재 검색이 불가능한 VASP이거나 혹은 일시적으로 회원사의 서버 문제로 TXID가 검색되지 않았을 것으로 추측할 수 있습니다.
❗️Txid 또는 tx hash는 반드시 블록체인 Node Output 데이터를 그대로 사용해야 합니다. '0x'를 tx hash 앞에 추가하여 사용하는 경우 tx hash 불일치가 발생할 수 있습니다. 따라서 Node Output에 없는 '0x'가 포함하지 않도록 주의해 주세요.
❗️비동기 방식으로 작동하는 API로 요청 후 Callback URL을 사용해 결과를 수신하거나 'TXID로 VASP 찾기 결과 조회' API를 통해 결과를 확인할 수 있습니다. 두 가지 방법의 결과 데이터는 동일합니다.
❗️
currency
,network
파라미터를 입력한 경우 GTR회원사도 검색을 하게 됩니다. 더 많은 검색 결과를 위해 입력을 권장 드립니다. 코인별 네트워크 정보는 타 프로토콜과의 상호운용 페이지를 참고해주세요.
Request
이름 | 필수 여부 | 설명 |
---|---|---|
txid | 필수 | 입고된 TXID |
vout | 옵션 | utxo타입 코인의 경우 복수의 블록체인 트랜잭션이 하나의 txid 를 공유하면서 그룹을 형성할 수 있기 때문에, 고유한 트랜잭션을 식별하기 위해 사용하는 값 |
currency | 옵션 | 코인 티커, GTR 소속 VASP 검색 시 필수(Binance) |
network | 옵션 | -하나의 코인이 여러 네트워크 위에 존재 할 때 구분을 위해 작성. -타 솔루션사와 연동되어 있는 VASP는 필수로 요청할 수 있으니 타 프로토콜과의 상호운용 페이지 참고 -입력이 된 경우 GTR소속의 VASP도 검색(Binance) |
requestId | 필수 | 결과 조회를 하기 위한 고유한 요청 ID |
callbackUrl | 옵션 | 검색 결과 Callback URL은 https:// 형식으로 작성, 해당 URL에 CODE의 IP 접근 허용 필요 |
{
"txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
"vout": "",
"requestId": "b09c8d00-8da9-11ec-b909-0242ac120002",
"currency": "xrp",
"network": "xrp",
"callbackUrl": "https://endpoint.com"
}
Response
이름 | 필수 여부 | 설명 |
---|---|---|
result | 필수 | 요청 결과 |
requestId | 필수 | 결과 조회를 하기 위한 고유한 요청 ID |
result: TXID 검증 결과입니다.
-SUCCESS
: 정상적인 TXID일 때 반환됩니다.