Step 6) oVASP updates KYC template with signature details and encrypted KYC/IVMS
If preferred, the oVASP could wait to receive the bVASP’s KYC/IVMS data first. In this example, the oVASP includes their encrypted KYC/IVMS data in their first response back to the bVASP. |
Example 1. endpoint
`POST` {{baseUrl}}/api/v1/server/create_kyc_template
Example 2. params
TODO
Example 3. response (200 OK)
{
"id": 7,
"attestation_hash": "0x4752a9f25760aa20c83857bce4672e967685755821e627bbbdc68c58d20fa5eb",
"beneficiary_ta_address": "0xCCCe743f18a58180A9353aD878893B9BEC55592e",
"beneficiary_ta_public_key": "07ac1fdf688d34f0c1564e131be6b10edb223f606305cfdf4d057208745340cb5951f84cffcc798539b1f421bba83d810266cde22de36bb979db80d44b39ab58",
"beneficiary_user_address": "0xb74647814c640c3adf9695c0293b2122178d517a",
"beneficiary_user_public_key": "0x04b3549cd59d458cbcdd0572ea15560ca8aefca8b383361076454464d0f24f9434bbbd331d0b75958b6ee99054a51708abe673f3f63ab2c049e61bcc2434cd7752",
"beneficiary_ta_signature_hash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f",
"beneficiary_ta_signature": "{\"r\":\"0x54c382817a9360698a9a342d776184baa3e5f6cbc0a86a70c34b49f1fa0b1411\",\"s\":\"0x1648e70ea20ff4bc2582b0d2f03b2ae3ae1d7a0ce5d329fcde54f40b24ee8920\",\"v\":\"0x25\"}",
"crypto_address_type": null,
"crypto_address": null,
"crypto_public_key": null,
"crypto_signature_hash": null,
"crypto_signature": null,
"sender_ta_address": "0x5dF773edfCd625A7705bE05541AAC3762E82d6F5",
"sender_ta_public_key": "072243dfe34348d310d37861c0b0889a2aacb81ab7f8f6cb59a6a6588e0c748970f9f0de9c7f4c160b767d1a03d214e330f4cdabdce11f892af164dd9c6e1dab",
"sender_user_address": "0x4b2eaf716f285d881460c366085f15d5c6c98e58",
"sender_user_public_key": "0x047ab1478284f44dde151313160dc297c71afe9846acad94981081dd6049ef61a82f87d7734385754ba9625747f1bf758219362b03e5991748774b06c435f67ac4",
"sender_ta_signature_hash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f",
"sender_ta_signature": "{\"r\":\"0x66d4e799d17912db43da48b3bfc234c581a8454682431527db6dd4f8a2f9ea5f\",\"s\":\"0x5a8691eab26cf650761198d4b191bebf7579d35b6157288c2a5db4f183643f42\",\"v\":\"0x25\"}",
"payload": null,
"beneficiary_kyc": null,
"sender_kyc": "BD1jCMLjET4BWFm/t2oA1lR4KTuG1Zc6LCK3Li130VLKNYWTqV2tbpDnBTB9/B1c+FJvNBJZ+qgrcpLkWP4YrI2Q8cKJzNdpCUWuvr7dCkFXyGiXwPHkq6KorL/yoJFfqyNwBRGjkigPxKbMUQBvIEufG0901NKjm7bCtM0unEaC",
"created_at": "2022-11-09T14:19:45.000000Z",
"updated_at": "2022-11-09T14:27:23.000000Z",
"kyc_template_state_id": null,
"beneficiary_user_signature_hash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549",
"beneficiary_user_signature": "{\"r\":\"0x27e3f972b4ddb5d39698055e374a04a4170485ec6c258dafc5fd5dec03c2a51a\",\"s\":\"0x52a311627c0b20360294d2aff6f35aa5cbeedcf4b507899d8b5662b72f1e977e\",\"v\":\"0x25\"}",
"sender_user_signature_hash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549",
"sender_user_signature": "{\"r\":\"0xac9e3ee4cdaf4bed0ca99843494609f686fff071bcbdf3b70b5dc10f5481d2a8\",\"s\":\"0x58d8def32c091d030469f6b0a31ac991c6497080477384d561cab548a912685f\",\"v\":\"0x26\"}",
"beneficiary_ta_url": "https://jl-test-ap-2.holmesmind.com/kyc-template",
"sender_ta_url": "https://jamessandbox001.holmesmind.com/kyc-template",
"beneficiary_kyc_decrypt": null,
"sender_kyc_decrypt": null,
"coin_blockchain": "BTC",
"coin_token": "BTC",
"coin_address": "1GfYCdni4jKeWtCrauEP5hfReZLsAL9VXP",
"coin_memo": "11/09 tes addressproofs with kevin 0002",
"coin_transaction_hash": "",
"coin_transaction_value": "",
"status": "OR_TA_VERIFIED",
"webhook_status": "OR_DATA_REQ_RECEIVED",
"ivms_status": "START",
"test_vars": "ivms_state_code=0202",
"beneficiary_user_address_crypto_proof": "{\"chain\":\"BTC-mainnet\",\"asset\":\"BTC\",\"address_type\":\"P2PKH\",\"address\":\"1GfYCdni4jKeWtCrauEP5hfReZLsAL9VXP\",\"trust_anchor_pubkey\":\"07ac1fdf688d34f0c1564e131be6b10edb223f606305cfdf4d057208745340cb5951f84cffcc798539b1f421bba83d810266cde22de36bb979db80d44b39ab58\",\"pubkey\":\"03f5aca000344d65c4508333783c06b3ced05c1b9dd4497ecd4b47b851701e3708\",\"signature\":\"IGbpjQuCFykisxFKj+NLIPy87J7SRjArGYeUmZ0J7CIoBRrpu8EmaXpZkHe4DXoSjoDEp+K5nnfp\\/VX400oPbmI=\"}",
"beneficiary_user_address_crypto_proof_status": true
}
sender_kyc contains the ivms_encrypt from the earlier step.
|
Corresponding webhook events
Example 4. eventType
"eventType": "BE_KYC_REQ"
Example 5. params
{
"root":
"eventType": "BE_KYC_REQ"
"kycTemplate":
"AttestationHash": "0x4752a9f25760aa20c83857bce4672e967685755821e627bbbdc68c58d20fa5eb"
"BeneficiaryTAAddress": "0xCCCe743f18a58180A9353aD878893B9BEC55592e"
"BeneficiaryTAPublicKey": "07ac1fdf688d34f0c1564e131be6b10edb223f606305cfdf4d057208745340cb5951f84cffcc798539b1f421bba83d810266cde22de36bb979db80d44b39ab58"
"BeneficiaryUserAddress": "0xb74647814c640c3adf9695c0293b2122178d517a"
"BeneficiaryUserPublicKey": "0x04b3549cd59d458cbcdd0572ea15560ca8aefca8b383361076454464d0f24f9434bbbd331d0b75958b6ee99054a51708abe673f3f63ab2c049e61bcc2434cd7752"
"BeneficiaryTASignatureHash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f"
"BeneficiaryTASignature":
"r": "0x54c382817a9360698a9a342d776184baa3e5f6cbc0a86a70c34b49f1fa0b1411"
"s": "0x1648e70ea20ff4bc2582b0d2f03b2ae3ae1d7a0ce5d329fcde54f40b24ee8920"
"v": "0x25"
"BeneficiaryUserSignatureHash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549"
"BeneficiaryUserSignature":
"r": "0x27e3f972b4ddb5d39698055e374a04a4170485ec6c258dafc5fd5dec03c2a51a"
"s": "0x52a311627c0b20360294d2aff6f35aa5cbeedcf4b507899d8b5662b72f1e977e"
"v": "0x25"
"BeneficiaryUserAddressCryptoProof":
"chain": "BTC-mainnet"
"asset": "BTC"
"address_type": "P2PKH"
"address": "1GfYCdni4jKeWtCrauEP5hfReZLsAL9VXP"
"trust_anchor_pubkey": "07ac1fdf688d34f0c1564e131be6b10edb223f606305cfdf4d057208745340cb5951f84cffcc798539b1f421bba83d810266cde22de36bb979db80d44b39ab58"
"pubkey": "03f5aca000344d65c4508333783c06b3ced05c1b9dd4497ecd4b47b851701e3708"
"signature": "IGbpjQuCFykisxFKj+NLIPy87J7SRjArGYeUmZ0J7CIoBRrpu8EmaXpZkHe4DXoSjoDEp+K5nnfp/VX400oPbmI="
"BeneficiaryUserAddressCryptoProofStatus": true
"CoinBlockchain": "BTC"
"CoinToken": "BTC"
"CoinAddress": "1GfYCdni4jKeWtCrauEP5hfReZLsAL9VXP"
"CoinMemo": "11/09 tes addressproofs with kevin 0002"
"CoinTransactionHash": null
"CoinTransactionValue": null
"SenderTAAddress": "0x5df773edfcd625a7705be05541aac3762e82d6f5"
"SenderTAPublicKey": "072243dfe34348d310d37861c0b0889a2aacb81ab7f8f6cb59a6a6588e0c748970f9f0de9c7f4c160b767d1a03d214e330f4cdabdce11f892af164dd9c6e1dab"
"SenderUserAddress": "0x4b2eaf716f285d881460c366085f15d5c6c98e58"
"SenderUserPublicKey": "0x047ab1478284f44dde151313160dc297c71afe9846acad94981081dd6049ef61a82f87d7734385754ba9625747f1bf758219362b03e5991748774b06c435f67ac4"
"SenderTASignatureHash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f"
"SenderTASignature":
"r": "0x66d4e799d17912db43da48b3bfc234c581a8454682431527db6dd4f8a2f9ea5f"
"s": "0x5a8691eab26cf650761198d4b191bebf7579d35b6157288c2a5db4f183643f42"
"v": "0x25"
"SenderUserSignatureHash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549"
"SenderUserSignature":
"r": "0xac9e3ee4cdaf4bed0ca99843494609f686fff071bcbdf3b70b5dc10f5481d2a8"
"s": "0x58d8def32c091d030469f6b0a31ac991c6497080477384d561cab548a912685f"
"v": "0x26"
"BeneficiaryKYC": null
"SenderKYC": "BD1jCMLjET4BWFm/t2oA1lR4KTuG1Zc6LCK3Li130VLKNYWTqV2tbpDnBTB9/B1c+FJvNBJZ+qgrcpLkWP4YrI2Q8cKJzNdpCUWuvr7dCkFXyGiXwPHkq6KorL/yoJFfqyNwBRGjkigPxKbMUQBvIEufG0901NKjm7bCtM0unEaC"
"BeneficiaryTAUrl": "https://jl-test-ap-2.holmesmind.com/kyc-template"
"SenderTAUrl": "https://jamessandbox001.holmesmind.com/kyc-template"
}
Example 6. eventType
"eventType": "OR_ENC"
Example 7. params
{
"root":
"eventType": "OR_ENC"
"kycTemplate":
"AttestationHash": "0x4752a9f25760aa20c83857bce4672e967685755821e627bbbdc68c58d20fa5eb"
"BeneficiaryTAAddress": "0xCCCe743f18a58180A9353aD878893B9BEC55592e"
"BeneficiaryTAPublicKey": "07ac1fdf688d34f0c1564e131be6b10edb223f606305cfdf4d057208745340cb5951f84cffcc798539b1f421bba83d810266cde22de36bb979db80d44b39ab58"
"BeneficiaryUserAddress": "0xb74647814c640c3adf9695c0293b2122178d517a"
"BeneficiaryUserPublicKey": "0x04b3549cd59d458cbcdd0572ea15560ca8aefca8b383361076454464d0f24f9434bbbd331d0b75958b6ee99054a51708abe673f3f63ab2c049e61bcc2434cd7752"
"BeneficiaryTASignatureHash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f"
"BeneficiaryTASignature":
"r": "0x54c382817a9360698a9a342d776184baa3e5f6cbc0a86a70c34b49f1fa0b1411"
"s": "0x1648e70ea20ff4bc2582b0d2f03b2ae3ae1d7a0ce5d329fcde54f40b24ee8920"
"v": "0x25"
"BeneficiaryUserSignatureHash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549"
"BeneficiaryUserSignature":
"r": "0x27e3f972b4ddb5d39698055e374a04a4170485ec6c258dafc5fd5dec03c2a51a"
"s": "0x52a311627c0b20360294d2aff6f35aa5cbeedcf4b507899d8b5662b72f1e977e"
"v": "0x25"
"BeneficiaryUserAddressCryptoProof":
"chain": "BTC-mainnet"
"asset": "BTC"
"address_type": "P2PKH"
"address": "1GfYCdni4jKeWtCrauEP5hfReZLsAL9VXP"
"trust_anchor_pubkey": "07ac1fdf688d34f0c1564e131be6b10edb223f606305cfdf4d057208745340cb5951f84cffcc798539b1f421bba83d810266cde22de36bb979db80d44b39ab58"
"pubkey": "03f5aca000344d65c4508333783c06b3ced05c1b9dd4497ecd4b47b851701e3708"
"signature": "IGbpjQuCFykisxFKj+NLIPy87J7SRjArGYeUmZ0J7CIoBRrpu8EmaXpZkHe4DXoSjoDEp+K5nnfp/VX400oPbmI="
"BeneficiaryUserAddressCryptoProofStatus": true
"CoinBlockchain": "BTC"
"CoinToken": "BTC"
"CoinAddress": "1GfYCdni4jKeWtCrauEP5hfReZLsAL9VXP"
"CoinMemo": "11/09 tes addressproofs with kevin 0002"
"CoinTransactionHash": null
"CoinTransactionValue": null
"SenderTAAddress": "0x5df773edfcd625a7705be05541aac3762e82d6f5"
"SenderTAPublicKey": "072243dfe34348d310d37861c0b0889a2aacb81ab7f8f6cb59a6a6588e0c748970f9f0de9c7f4c160b767d1a03d214e330f4cdabdce11f892af164dd9c6e1dab"
"SenderUserAddress": "0x4b2eaf716f285d881460c366085f15d5c6c98e58"
"SenderUserPublicKey": "0x047ab1478284f44dde151313160dc297c71afe9846acad94981081dd6049ef61a82f87d7734385754ba9625747f1bf758219362b03e5991748774b06c435f67ac4"
"SenderTASignatureHash": "0x0b709dd4809f36a22fe48250b24a5e41e8aea491bace26627f5c68ea9b4fad3f"
"SenderTASignature":
"r": "0x66d4e799d17912db43da48b3bfc234c581a8454682431527db6dd4f8a2f9ea5f"
"s": "0x5a8691eab26cf650761198d4b191bebf7579d35b6157288c2a5db4f183643f42"
"v": "0x25"
"SenderUserSignatureHash": "0x7ec005c40fadb64f4180dcc14d9f5927f649096a08478a4a5a112a3aa77ca549"
"SenderUserSignature":
"r": "0xac9e3ee4cdaf4bed0ca99843494609f686fff071bcbdf3b70b5dc10f5481d2a8"
"s": "0x58d8def32c091d030469f6b0a31ac991c6497080477384d561cab548a912685f"
"v": "0x26"
"BeneficiaryKYC": null
"SenderKYC": "BD1jCMLjET4BWFm/t2oA1lR4KTuG1Zc6LCK3Li130VLKNYWTqV2tbpDnBTB9/B1c+FJvNBJZ+qgrcpLkWP4YrI2Q8cKJzNdpCUWuvr7dCkFXyGiXwPHkq6KorL/yoJFfqyNwBRGjkigPxKbMUQBvIEufG0901NKjm7bCtM0unEaC"
"BeneficiaryTAUrl": "https://jl-test-ap-2.holmesmind.com/kyc-template"
"SenderTAUrl": "https://jamessandbox001.holmesmind.com/kyc-template"
}
Given the oVASP responded with KYC/IVMS data included, the OR_KYC_REQ webhook event is not fired at the oVASP.
|