상대방 VASP가 보낸 'TXID로 VASP 찾기' 요청에 응답하기 위해 구현해야 하는 API입니다.

📘

POST

/v1/verification/tx

자산을 이미 받은 VASP 가 특정 TXID가 나의 VASP에서 출고된것인지 확인하기 위하여 'TXID 조회' 요청에 응답하기 위해 구현해야 하는 API 입니다.

API 동작 명세

  1. txidvout를 기준으로 요청된 TXID가 내 VASP에서 출고된것이 맞는지 검색합니다.
    1. vout 정보는 Optional 입니다.
    2. Currency에 관계 없이 TXID를 조회 합니다.
  2. 이 모든 과정은 1초를 초과하지 않도록 구현해야 합니다.

Request

이름필수 여부타입
txid필수string
vout옵션string

txid: 이미 On-Chain 트랜잭션이 발생한 TXID 입니다. 가상자산 이전을 위해 블록체인 상에 실행된 특정한 트랜잭션을 식별하기 위한 고유한 값입니다. 블록체인 API 에 의해서 생성되며 유일한 값입니다.


vout: utxo타입 코인의 경우 복수의 블록체인 트랜잭션이 하나의 txid 를 공유하면서 그룹을 형성할 수 있습니다. 이때, 고유한 트랜잭션을 식별하기 위해 이 값을 사용합니다.

vout란? https://learnmeabitcoin.com/technical/transaction/input/vout/

{
  "txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
  "vout": ""
}

Response

'가상자산 주소 조회' 요청에 대해 아래와 같이 응답해주세요.

이름필수 여부타입
result필수string

result: 가상자산 주소 검증 결과입니다.

-valid: 발견된 정상적인 TXID일 때 반환합니다.

-invalid : 해당 TXID 가 VASP에서 출고되지 않아 검색되지 않은 경우 입니다.

{
  "result": "valid"
}