트랜잭션 결과 리포트 API

트랜잭션 결과 리포트

POST http://<enclave-endpoint>/v1/verifications/tx

VerifyVASP를 통해 Beneficiary(가상 자산 수령자)를 확인한 후 블록체인을 통해 발생한 실제 가상 자산 거래의 txHash 값을 보고합니다.

호출 정책

• 송신 VASP는 실제 가상 자산 거래의 transaction ID 또는 transaction hash 값을 알아내자마자 이 API를 통해 VerifyVASP에 보고해야 합니다.

• 그래야 수신 VASP에서 감지한 가상 자산 거래가 어떤 사용자 검증(verification)에 대응되는 거래인지 즉각 파악할 수 있습니다.

• 추후 해당 전송이 최종성(finality)를 확보하지 못하고 최종 실패한 경우에는 에러 상황 리포트 API를 통해 에러 상황을 다시 VerifyVASP에 보고해야 합니다.

Request Body

Request Body Examples

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

Field Name	Data Type	Required	Example	Description
verificationUuid	string	true	"8557f2b2-985e-431f-8d52-75c2e5a01e46"	UUID of completed verification. 실제 Transaction을 블록체인에 보내기 전에, 수행했던 검증(/verifications) 과정에서 키로 사용하였던 UUID.
txHash	string	true	"8a54d58ca4100112a5430818776d74898f2232770bae03046862575cb851a042"	검증에 해당하는 VA 트랜잭션을 인식할 수 있는 고유값입니다.
vout	string	false	"2"	Bitcoin과 같이 UTXO 모델을 사용하는 경우 트랜잭션 내에서 몇 번째 거래에 해당하는지 구별할 수 있는 인덱스 값

• txHash 값은 블록체인 Node Output 형식을 따라야 합니다. txHash 형식에 대한 자세한 내용은 지갑 주소 및 트랜잭션 ID 표준 가이드를 확인하세요.

Response Body

성공 케이스

Response Body Examples

• 200 OK

{
  "result": true
}

Field Name	Data Type	Required	Description
result	boolean	true	Transaction Hash 값을 리포트 요청에 대한 결과.

실패 케이스

필수 파라미터를 입력하지 않은 경우

Response Body Examples

• 400 Bad Request

{
  "code": "MISSING-VERIFICATION-UUID",
  "message": "`verificationUuid` is required."
}

존재하지 않는 verification uuid를 입력한 경우

Response Body Examples

• 400 Bad Request

{
  "code": "VERIFICATION-NOT-FOUND",
  "message": "Verification(9faab87c-54a6-4145-baa9-7a3a42d7410c) is not found"
}