Sometimes, a VASP who has been transferred an asset needs to know the status of the blockchain transaction of the VASP who transferred the asset.

This API is not an API to look up the asset transfer details of the counterpart VASP, but the API for the beneficiary VASP to know the blockchain transaction status of the originating VASP. This can be used in the followings.

When the beneficiary VASP wants to check if the txid has been updated in the asset transfer details before an asset transfer transaction occurs on the blockchain and is reflected in the user's asset information, but if the status of its own asset transfer information is not confirmed, or wants to request the transaction status of an asset transfer to the originating VASP.
When a response for an asset transfer authorization request has been sent, but the asset was not transferred, or the VASP wants to request the transaction status of the corresponding asset transfer to the originating VASP.

❗️This API works in a synchronous manner, providing an immediate response upon request.

Path Parameter

Name	Required	Type	Description
OriginatingVaspEntityId	Required	string	This shall be entered as the EntityID of the VASP who sends the asset which is transferred.

Request

Name	Required	Type
transferId	Required	string

transferId: This is UUID assigned to the an asset transfer authorization request. It updates the asset transfer result to the corresponding transaction.

{
  "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002"
}

Response

Name	Required	Type
transferId	Required	string
status	Required	string
txid	Required or Optional	string
vout	Optional	string

transferId: This is an ID to distinguish asset transfer transactions in all APIs.

status: This refers to the status of the 'transferId' managed by the counterparty VASP, please refer to the Transfer Status Management page for further explanation.

-pending: This is a status in which, for some reason, a blockchain transaction has not yet been sent and is waiting.

-processing: A transaction was sent to the blockchain, but it is waiting for mining.

-wait-confirm: It has been checked that the blockchain transactions had been mined, but finality has not yet been obtained.

-confirmed: The blockchain transactions have been mined and finality has been obtained.

-canceled: This is a status where a blockchain transaction has not been sent or canceled after being sent. (If canceled permanently)

txid: This is a transaction ID generated for virtual asset transfer. This is the information generated on each blockchain. Required when status is confirmed.

vout: For the utxo type coin, multiple txids can be created so that vout is required to distinguish unique txids.

Example

200200