Comment on page
Verification Result by UUID
get
http://<enclave-endpoint>
/v1/verifications/:UUID
Get verification result by UUID
You can get a single result of verification with UUID.
- 200 OK
{
"verificationId": "10",
"verificationUuid": "5c9f6f44-1e09-483b-a9f5-5950b1cbae08",
"result": "VERIFIED",
"reason": "OK",
"message": "",
"assetInfo": {
"symbol": "BTC",
"amount": "100123",
"isExceedingThreshold": 1,
"tradeCurrency": "123",
"tradePrice": "100",
"tradeISODatetime": "2022-02-02T10:00:00.000Z"
},
"txHash": null,
"originatingVaspId": "15952089931162058999",
"originatorAccountNumber": "0xtest001506550d8356a215be229c15b6ef371a9a",
"ivms101Originator": "{\"originatorPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"nameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"test\",\"buildingName\":\"123\",\"townName\":\"Yeoksam-dong\",\"country\":\"KR\"}]}}]}",
"ivms101OriginatingVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest1\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Yeoksam-dong\",\"addressLine\":[\"Gangnam-gu, Gangbuck-do\",\"abc\"],\"country\":\"AF\"}],\"nationalIdentification\":{\"nationalIdentifier\":\"983746561\",\"nationalIdentifierType\":\"RAID\",\"registrationAuthority\":\"RA000025\"}}}",
"beneficiaryVaspId": "15952089931162059995",
"beneficiaryAccountNumber": "1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb",
"ivms101Beneficiary": "{\"beneficiaryPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"secondaryIdentifier\":\"Robbins\",\"nameIdentifierType\":\"LEGL\"}]}}}],\"accountNumber\":[\"1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb\"]}",
"ivms101BeneficiaryVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest2\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Yeoksam-dong\",\"addressLine\":[\"14, Teheran-ro 4-gil\",\"Gangnam-gu\"],\"country\":\"AF\"}],\"nationalIdentification\":{\"nationalIdentifier\":\"7612873123\",\"nationalIdentifierType\":\"RAID\",\"registrationAuthority\":\"RA000073\"}}}",
"verifiedAt": "2022-02-22T05:12:41.000Z",
"orderedAt": null,
"createdAt": "2022-02-22T05:12:40.000Z"
}
Field Name | Data Type | Required | Example | Description |
---|---|---|---|---|
verificationUuid | string | true | "4615aa9d-ac64-4997-a9e6-0e772c57c7ef" | Verification request ID |
result | string | false | "VERIFIED" | Verification result code |
reason | string | false | "OK" | Error code in case of verification failure, OK in case of success. |
assetInfo | object | true | - | Virtual asset description object |
assetInfo.symbol | string | true | “ETH” | A symbol of virtual asset |
assetInfo.amount | string | true | “0.024” | Amount of asset to transfer |
assetInfo.isExceedingThreshold | boolean | true | true | Whether the amount is over the legal threshold in fiat currency conversion of virtual assets to be transferred |
assetInfo.tradePrice | string | true | “2439800” | The amount of virtual assets to be transferred converted to fiat currency |
assetInfo.tradeCurrency | string | true | “KRW” | A symbol of fiat currency |
assetInfo.tradeISODatetime | string | true | “2022-02-06T23:13:43.513Z” | Application time of currency conversion price to fiat money in ISO format |
txHash | string | true | “0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28” | Transaction ID (Transaction hash, txHash). |
originatingVaspId | string | true | "15952089931162058999" | Originating VASP ID |
originatorAccountNumber | string | true | [”0xtest001506550d8356a215be229c15b6ef371a9a”] | Originator's wallet address |
ivms101Originator | string | true | "{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'Taylor','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}" | IVMS101 format of originator information |
ivms101OriginatingVasp | string | true | "{'legalPerson':{'name':{'nameIdentifier':[{'legalPersonName':'A Exchange','legalPersonNameIdentifierType':'LEGL'}]},'geographicAddress':[{'addressType':'GEOG','postcode':'12345','townName':'Yeoksam-dong','addressLine':['Gangnam-gu, Gangbuck-do'],'country':'KR'}],'nationalIdentification':{'nationalIdentifier':'KR001','nationalIdentifierType':'RAID','registrationAuthority':'RA001'}}}" | IVMS101 format of originating VASP information |
beneficiaryVaspId | string | true | "15952089931162058777" | Beneficiary VASP ID |
beneficiaryAccountNumber | string | true | [”0xtest001506550d8356a215be229c15b6ef371a9b”] | Beneficiary account number |
ivms101Beneficiary | string | true | "{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'James','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}" | IVMS101 format of Beneficiary information |
ivms101BeneficiaryVasp | string | true | "{'legalPerson':{'name':{'nameIdentifier':[{'legalPersonName':'B Exchange','legalPersonNameIdentifierType':'LEGL'}]},'geographicAddress':[{'addressType':'GEOG','postcode':'12345','townName':'Yeoksam-dong','addressLine':['Gangnam-gu, Gangbuck-do'],'country':'KR'}],'nationalIdentification':{'nationalIdentifier':'KR002','nationalIdentifierType':'RAID','registrationAuthority':'RA001'}}}" | IVMS101 format of Beneficiary VASP information |
verifiedAt | string | true | "2022-02-22T14:41:50.000Z" | Verification datetime |
orderedAt | Date | true | "2022-02-22T14:42:12.000Z" | Transaction ID reporting datetime |
createdAt | Date | true | "2022-02-22T14:41:49.000Z" | Verification request datetime |
- result field specification is as follows.
- The field value is one of "VERIFIED","DENIED","UNKNOWN","ERROR"
- VERIFIED: The user is successfully verified without any doubt or problem.
- DENIED: The wallet address is valid but the requested action is not allowed from the user's unexpected problems. (e.g. lack of KYC credential)
- UNKNOWN: The wallet address is unknown to the VASP.
- ERROR: Any other exceptional cases.\
- reason field specification is as follows.
- The field is valid only when
result
the field is DENIED. - Refer to the below table for the
message
field value.
reason (string)result (string)message (string)DescriptionUNKNOWN-SYMBOL
DENIEDThe value of symbol name (which is not supported in VASP)Unknown or not supported asset symbolUNKNOWN-ADDRESS
DENIEDThe unknown wallet addressUnknown wallet address to the VASPLACK-OF-INFORMATION
DENIEDA comma(,) separated required but missing personal information fields listVerification denied due to lack of personal informationUNAVAILABLE-INFORMATION
DENIEDA comma(,) separated undeliverable personal information field listRequested personal information cannot be transferred for processingBLACKLISTED
DENIED-Verification denied having probloems in sanction screeningUNVERIFIED-KYC
DENIED-User KYC requiredMISMATCHED-NAME
DENIED-Name mismatchUNDEFINED-ERROR
DENIEDError descriptionUnexpected exceptional case happensBENEFICIARY-ACCOUNT-NOT-MATCHED
ERROR-Beneficiary address is mismatched by VASPREQUEST-TIMEOUT
ERROR-Verification processing exceeds the timeout limit - assetInfo.isExceedingThreshold field specification
- If the amount of virtual asset transfer is over or equal to the legal threshold for verification requirement, use true.
- Or, the field returns false.
Last modified 1mo ago