상대방 VASP가 보낸 'TXID로 VASP 찾기' 요청에 응답하기 위해 구현해야 하는 API입니다.
POST
/v1/verification/tx
자산을 이미 받은 VASP 가 특정 TXID가 나의 VASP에서 출고된것인지 확인하기 위하여 'TXID 조회' 요청에 응답하기 위해 구현해야 하는 API 입니다.
API 동작 명세
txid
와vout
를 기준으로 요청된 TXID가 내 VASP에서 출고된것이 맞는지 검색합니다.vout
정보는 Optional 입니다.- Currency에 관계 없이 TXID를 조회 합니다.
- 이 모든 과정은 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"
}