트랜잭션 처리 상태 조회 API

트랜잭션 처리 상태 조회

POST VEGA_VERIFICATION_TRANSACTION_API_PATH

Enclave 환경 변수:

VEGA_VERIFICATION_TRANSACTION_API_PATH 변수에, 트랜잭션 처리 상태 조회 API 엔드포인트를 명시합니다.

VASP는 송신 VASP, 수신 VASP 두 역할을 모두 수행해야 합니다. 이 API는 VASP가 송신 VASP 역할을 할 때 호출되는 API입니다.

송신 VASP에서 VerifyVASP를 통해 수신자 검증을 끝내고 실제 블록체인으로 가상 자산을 전송하면, 해당 트랜잭션의 id (transaction hash) 값을 VerifyVASP로 리포트해야 합니다.

하지만, 어떤 이유에서든 해당 리포트가 정상적으로 수행되지 못했을 때, 수신 VASP 입장에서 입금이 감지된 건에 대해서 어느 verification과 매칭되는 입금인지를 알 수 있어야 합니다.

이를 위해 수신 VASP에서 VerifyVASP에 특정 verification에 대한 실제 블록체인의 트랜잭션 처리 상태를 조회할 수 있으며, VerifyVASP는 다시 송신 VASP에게 해당 요청을 전달하는데 그때 호출되는 API입니다.

응답 시간:

이 트랜잭션 처리 상태 조회 API는 1초 이내에 응답해야 합니다.

Request Header

Field Name	Description
Authorization	Bearer <VEGA_VERIFICATION_AUTHORIZATION_TOKEN>

Request Body

Request Body Examples

{
  "verificationUuid": "8557f2b2-985e-431f-8d52-75c2e5a01e46"
}

Field Name	Data Type	Required	Example	Description
verificationUuid	string	true	“8557f2b2-985e-431f-8d52-75c2e5a01e46”	트랜잭션 처리 상태를 조회할 verification의 UUID. 실제 Transaction을 블록체인에 보내기 전에, 수행했던 검증(/verifications) 과정에서 키로 사용하였던 UUID입니다.

Response Body

Response Body Examples

• 200 OK

{
  "verificationUuid": "8557f2b2-985e-431f-8d52-75c2e5a01e46",
  "transactionStatus": "PROCESSING",
  "txHash": "8a54d58ca4100112a5430818776d74898f2232770bae03046862575cb851a042",
  "vout": "2"
}

Field Name	Data Type	Required	Example	Description
verificationUuid	string	true	"8557f2b2-985e-431f-8d52-75c2e5a01e46"	트랜잭션 처리 상태를 조회한 verification의 uuid
transactionStatus	string	true	"PROCESSING"	트랜잭션의 처리 상태. (하단 설명 참조)
txHash	string	false	"8a54d58ca4100112a5430818776d74898f2232770bae03046862575cb851a042"	트랜잭션의 id (transaction hash), 알 수 있는 경우에만 반환
vout	string	false	"2"	트랜잭션 내에서 몇 번째 거래에 해당하는지를 나타내는 인덱스 값, 알 수 있는 경우에만 반환

• transactionStatus 필드에는 다음과 같은 값이 들어갈 수 있습니다.

  • PENDING: 어떤 이유에서든 아직 블록체인 트랜잭션을 보내지 않고 대기하고 있는 상태

  • PROCESSING: 블록체인에 트랜잭션을 전송했고 채굴 대기 중인 상태

  • WAIT-CONFIRM: 블록체인 트랜잭션이 채굴이 된 것을 확인했지만 아직 finality를 확보하지 못한 상태

  • CONFIRMED: 블록체인 트랜잭션이 채굴되었고 finality도 확보된 상태

  • CANCELED: 블록체인 트랜잭션을 보내지 않고 취소한 상태 혹은 보냈는데 취소한 상태 (영구히 취소된 경우)