Transaction Status Query

Transaction Status Query API

POST VEGA_VERIFICATION_TRANSACTION_API_PATH

Enclave Environment Variable:

Enter the Transaction Status Query API endpoint in VEGA_VERIFICATION_TRANSACTION_API_PATH field.

VASPs can be both the beneficiary and originating VASP. Once an originating VASP verifies the beneficiary through VerifyVASP 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 NameDescription

Authorization

Bearer <VEGA_VERIFICATION_AUTHORIZATION_TOKEN>

Request Body

Request Body Examples
{
    "verificationUuid": "8557f2b2-985e-431f-8d52-75c2e5a01e46"
}
Field NameData TypeRequiredExampleDescription

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": "8a54d58ca4100112a5430818776d74898f2232770bae03046862575cb851a042",
    "vout": "2"
}
Field NameData TypeRequiredExampleDescription

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

"8a54d58ca4100112a5430818776d74898f2232770bae03046862575cb851a042"

Transaction id (transaction hash), return only when known.

vout

string

false

"2"

An index value indicating which transfer corresponds to within a single transaction, returned only if exist.

  • 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.

PreviousUser VerificationNextCallback API

Last updated