📘
POST
/v1/verification/tx

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

API 동작 명세

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

Request

이름	필수 여부	타입
txid	필수	string
beneficiaryAddress	필수	string

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

beneficiaryAddress: 자산을 수신하는 가상자산 주소로 tag 나 memo 같은 2차 주소는 ':' 구분자로 병합됩니다.

{
  "txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
  "beneficiaryAddress": "address:tag"
}

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

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

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

-valid: 'txid'와 'beneficiaryAddress'가 일치하는 데이터가 있을 때 반환합니다.

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

{
  "result": "valid"
}