Virtual Asset Address Search

post https://trapi-dev.codevasp.com/v1/code/VerifyAddress/

The virtual asset address, which will transfer an asset, requests to confirm whether the asset is owned by the VASP within the CODE or not.

A VASP who wants to transfer assets need to know which VASP owns the address (address + tag(optional)) of a virtual asset to which a user wants to transfer his or her asset by using this API in the first step of the entire process.

Path Parameter

NameRequiredTypeDescription
BeneficiaryVaspEntityIdRequiredstringThis is the EntityID of the VASP which owns the address to which the asset is transferred.

Request

NameRequiredType
currencyRequiredstring
payloadRequiredstring

currency: This is a symbol of the virtual asset you want to transfer. (This is case insensitive.)

payload: This is an object containing the ivms101 message with personal information. Because verification of the wallet address is conducted using a string encrypted from the IVMS101 object, it's not necessary to input the entire IVMS101 object. As in the sample payload below, within the Beneficiary object, the array<accountNumber> is mandatory, while beneficiaryPersons is optional.


{
  "currency": "XRP",
  "payload": "encrypted ivms101 payload"
}

{
   "ivms101": {
      "Beneficiary": {
        "beneficiaryPersons": [],
        "accountNumber": ["rHcFoo6a9qT5NHiVn1THQRhsEGcxtYCV4d:memo or tag"]
      }
   }
}

Response

NameRequiredType
resultRequiredstring
reasonTypeOptionalstring
reasonMsgOptionalstring
beneficiaryVaspEntityIdRequiredstring

result: This is a virtual asset address verification result.

-valid: This is a normal address

-invalid: This is the result of virtual asset address search. You can classify the details by the reasonType value.

reasonType: If the result field value is invalid, you need to add this field to send error details.

-NOT_FOUND_ADDRESS: This is a case where a virtual asset address cannot be found.

-NOT_SUPPORTED_SYMBOL: This is a currency symbol which cannot be traded.

-NOT_KYC_USER: This is a case where the owner did not process KYC verification.

-INPUT_NAME_MISMATCHED: The name of the addressee included in the request message is different from the name of the actual owner.

-SANCTION_LIST: Virtual asset addresses or owners are subject to the sanction of the beneficiary VASP.

-LACK_OF_INFORMATION: This is a case where there is no the information necessary to make an asset transfer decision.

-UNKNOWN: This refers to other reasons.

reasonMsg: It defines a detailed message if invalid.

beneficiaryVaspEntityId: If there is a VASP that owns a virtual asset address to be looked up, this is the Entity ID of the corresponding VASP.

Example

Language