Transaction Status Query
post
http://<enclave-endpoint>
/v1/verifications/tx/inquiry
Transaction status query API
A VASP can check a transaction status if it has not received a transaction ID (txHash) report from an originating VASP in a duration.
Policy
- When the beneficiary VASP detects a deposit transaction, the VASP can do txHash filtering to find candidates and call the verification result checking API to find a matched verification history.
- If there is no exact matching txHash found in filtering, the VASP can wait for the transaction result report from the originating VASP.
- When there is no report in a while, the beneficiary VASP can call the verification result checking API to filter out the candidates.
- Setting the originator account number to 'from address' and beneficiary account number to 'to address' can narrow down the candidates.
- Comparison of the transaction amounts is also helpful for filtering out.
- You can find the final candidate of verification history by checking the transaction status for each of the candidates.
Field Name | Data Type | Required | Example | Description |
---|---|---|---|---|
verificationUuid | string | true | “8557f2b2-985e-431f-8d52-75c2e5a01e46” | UUID of completed verification. UUID which was used as a key during /verification process before sending Transaction to the blockchain. |
Field Name | Data Type | Example | Required | Description |
---|---|---|---|---|
verificationUuid | string | "8557f2b2-985e-431f-8d52-75c2e5a01e46" | true | UUID of completed verification. |
transactionStatus | string | "PROCESSING" | true | Transaction Status. |
txHash | string | "0xb966123f0f7fc226f93688f77cfa4993d675ac9847049ad2d8bc56d64eaf06d5” | false | TxHash (Transaction ID), Returned only in available. |
- transactionStatus field specification is as follows.
- 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 state transition diagram
Last modified 7mo ago