Step 4) oVASP receives initial KYC template

endpoint
`GET` {{baseUrl}}/api/v1/server/get_kyc_templates
?page={{startPage}}
&perPage={{resultsPerPage}}
&searchTerm={{kycTemplateSearchTerm}}
params
"startPage": {{startPage}}
"perPage": {{resultsPerPage}}
"searchTerm": {{kycTemplateSearchTerm}}
// use trust anchor account, user account, attestation hash or wallet address
variables
"startPage": "1"
"resultsPerPage": "10"
"kycTemplateSearchTerm": "0xff447fc35f7eee4245c8c4028aa67c86e225f30864a1dab3f0ac011e6e919f43"
// i.e. attestation hash
response (200 OK)
{
    "serverParams": {
        "page": 1,
        "perPage": 10
    },
    "totalRecords": 1,
    "rows": [
        {
            "id": 13,
            "attestation_hash": "0xff447fc35f7eee4245c8c4028aa67c86e225f30864a1dab3f0ac011e6e919f43",
            "beneficiary_ta_address": "0x1358D8FF6bF65002d051c059b95E60f54007516e",
            "beneficiary_ta_public_key": "0e67d158116a7c330953bde9d53dac5db35a7af64337f5b3de5246ab576d98e4d2f32cb96e0b291332573eed2884edb0a626e58525e7d89ce1ecb1dd50d9ee89",
            "beneficiary_user_address": "0x279623a9378725fe271dccd8a390228f81c87a5e",
            "beneficiary_user_public_key": "0x0409e8d4a705e9dff75c5d082b601a8326b77c61b763df76ec242f24b85abd070fcada35335033ec0bfe8308dfcf0ea551b0193836219bbb535f059ade08140772",
            "beneficiary_ta_signature_hash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f",
            "beneficiary_ta_signature": "{\"r\":\"0x221ad084d6a3eaa93446508033ed746a831d5fd31748dfb5a8eb1c850555218e\",\"s\":\"0x0e731078734180087e61fcd7c9248e8172608c2a645a438c379fc08aedbbaa70\",\"v\":\"0x26\"}",
            "crypto_address_type": null,
            "crypto_address": null,
            "crypto_public_key": null,
            "crypto_signature_hash": null,
            "crypto_signature": null,
            "sender_ta_address": "0xF937c412e7172c2c8978cEdD850DDD08e0D95e60",
            "sender_ta_public_key": null,
            "sender_user_address": "0x96Ee3769a2422215626b8A32594e8fBD5Dd1b61a",
            "sender_user_public_key": null,
            "sender_ta_signature_hash": null,
            "sender_ta_signature": null,
            "payload": null,
            "beneficiary_kyc": null,
            "sender_kyc": null,
            "created_at": "2022-06-27T07:44:55.000000Z",
            "updated_at": "2022-06-27T07:44:58.000000Z",
            "kyc_template_state_id": null,
            "beneficiary_user_signature_hash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549",
            "beneficiary_user_signature": "{\"r\":\"0x8edb489caf90ea1ec47b185099825b763b0dbfee72cf0685c0662fe96b178dd5\",\"s\":\"0x3eb2f91b549512aeb8438fac961cca34c47873c11ce17f383f54c4346458b149\",\"v\":\"0x26\"}",
            "sender_user_signature_hash": null,
            "sender_user_signature": null,
            "beneficiary_ta_url": "https://ks-node-4.veriscope.network/kyc-template",
            "sender_ta_url": "https://ks-node-3.veriscope.network/kyc-template",
            "beneficiary_kyc_decrypt": null,
            "sender_kyc_decrypt": null,
            "coin_blockchain": "ETH",
            "coin_token": "USDC",
            "coin_address": "0x5481fabc980af705c556517426c81a963af5657d",
            "coin_memo": "end-to-end walkthrough",
            "coin_transaction_hash": null,
            "coin_transaction_value": null,
            "status": "BE_TA_VERIFIED",
            "webhook_status": "OR_DATA_REQ_RECEIVED",
            "ivms_status": "START"
        }
    ]
}

Check that the bUser public key is included as this will be needed to encrypt your KYC/IVMS data.

Corresponding webhook event

Handling tips
  • This event indicates to oVASPs that a VASP has responded to one of their attestations.

  • Provided the VASP status is BE_TA_VERIFIED oVASPs should respond with their signature data

  • oVASPs can also included encrypted IVMS in the reponse or wait for the bVASP to send encrypted IVMS data first.

eventType
"eventType": "OR_DATA_REQ"
body
{
    "eventType": "OR_DATA_REQ",
    "kycTemplate": {
        "AttestationHash": "0xff447fc35f7eee4245c8c4028aa67c86e225f30864a1dab3f0ac011e6e919f43",
        "BeneficiaryTAAddress": "0x1358D8FF6bF65002d051c059b95E60f54007516e",
        "BeneficiaryTAPublicKey": "0e67d158116a7c330953bde9d53dac5db35a7af64337f5b3de5246ab576d98e4d2f32cb96e0b291332573eed2884edb0a626e58525e7d89ce1ecb1dd50d9ee89",
        "BeneficiaryUserAddress": "0x279623a9378725fe271dccd8a390228f81c87a5e",
        "BeneficiaryUserPublicKey": "0x0409e8d4a705e9dff75c5d082b601a8326b77c61b763df76ec242f24b85abd070fcada35335033ec0bfe8308dfcf0ea551b0193836219bbb535f059ade08140772",
        "BeneficiaryTASignatureHash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f",
        "BeneficiaryTASignature": {
            "r": "0x221ad084d6a3eaa93446508033ed746a831d5fd31748dfb5a8eb1c850555218e",
            "s": "0x0e731078734180087e61fcd7c9248e8172608c2a645a438c379fc08aedbbaa70",
            "v": "0x26"
        },
        "BeneficiaryUserSignatureHash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549",
        "BeneficiaryUserSignature": {
            "r": "0x8edb489caf90ea1ec47b185099825b763b0dbfee72cf0685c0662fe96b178dd5",
            "s": "0x3eb2f91b549512aeb8438fac961cca34c47873c11ce17f383f54c4346458b149",
            "v": "0x26"
        },
        "CoinBlockchain": "ETH",
        "CoinToken": "USDC",
        "CoinAddress": "0x5481fabc980af705c556517426c81a963af5657d",
        "CoinMemo": "end-to-end walkthrough",
        "CoinTransactionHash": null,
        "CoinTransactionValue": null,
        "SenderTAAddress": "0xf937c412e7172c2c8978cedd850ddd08e0d95e60",
        "SenderTAPublicKey": null,
        "SenderUserAddress": "0x96ee3769a2422215626b8a32594e8fbd5dd1b61a",
        "SenderUserPublicKey": null,
        "SenderTASignatureHash": null,
        "SenderTASignature": null,
        "SenderUserSignatureHash": null,
        "SenderUserSignature": null,
        "BeneficiaryKYC": null,
        "SenderKYC": null,
        "BeneficiaryTAUrl": "https://ks-node-4.veriscope.network/kyc-template",
        "SenderTAUrl": "https://ks-node-3.veriscope.network/kyc-template"
    }
}