VerifyVASP
Search
K

Transaction Status Query

post
VEGA_VERIFICATION_TRANSACTION_API_PATH
Transaction Status Query API
Enclave Environment Variable:
Explicate the transaction process status inquiry API endpoint in VEGA_VERIFICATION_TRANSACTION_API_PATH .
VASPs can be both the beneficiary and originating VASP. Once an originating VASP verifies the beneficiary through VeifyVASP and sends virtual assets to the actual blockchain, it must send the transaction id (transaction hash) value to VerifyVASP. However, if this fails for whatever reason, the beneficiary VASP must be able to know which verification matches the deposit.
This API is called to the Originating VASP by the beneficiary VASP to enquire about the transaction status on the actual blockchain via VerifyVASP.
Response Time standard
This API must respond in 1 second.

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 to inquire transaction process status

Response Body

Response Body Examples
  • 200 OK
{
"verificationUuid": "8557f2b2-985e-431f-8d52-75c2e5a01e46",
"transactionStatus": "PROCESSING",
"txHash": "0xb966123f0f7fc226f93688f77cfa4993d675ac9847049ad2d8bc56d64eaf06d5"
}
Field Name
Data Type
Required
Example
Description
verificationUuid
string
true
"8557f2b2-985e-431f-8d52-75c2e5a01e46"
Verification uuid which inquired transaction process status
transactionStatus
string
true
"PROCESSING"
Transaction process status, refer to the explanation below.
txHash
string
false
"0xb966123f0f7fc226f93688f77cfa4993d675ac9847049ad2d8bc56d64eaf06d5”
Transaction id (transaction hash), return only when known.
  • In the transactionStatus field can be included the values below.
    • PENDING: Blockchain transaction transmission is blocked for some reason.
    • PROCESSING: Waiting to be mined after transaction transmission.
    • WAIT-CONFIRM: The transaction is mined to block but not finalized yet.
    • CONFIRMED: The finality of the transaction is confirmed after being mined to block.
    • CANCELED: Blockchain transaction is canceled with or without starting transmission.
Transaction Status Transition Diagram