For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
HomeAPI Reference
HomeAPI Reference
  • Overview
    • API Overview
  • Vlens API
      • GETList available product types
      • GETGet form fields for a product type
      • GETCheck user eligibility
      • POSTCreate a business request
      • GETGet current business request
      • GETList user's business requests
      • GETList business request IDs and statuses
      • GETGet business request by ID
      • POSTRequest contract activation OTP
      • POSTRe-validate liveness after location change
      • POSTValidate contract activation OTP
      • POSTConfirm payment and activate contract
      • POSTGenerate WebView signing URL
      • GETDownload contract PDF
Dashboard
LogoLogo
Vlens APIBusiness Request

Validate contract activation OTP

||View as Markdown|
POST
https://api.vlenseg.com/api/BusinessRequest/CustomerSign/StepValidateOtp
POST
/api/BusinessRequest/CustomerSign/StepValidateOtp
$curl -X POST https://api.vlenseg.com/api/BusinessRequest/CustomerSign/StepValidateOtp \
>     -H "ApiKey: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "geoLocation": {
>    "latitude": 30.0444,
>    "longitude": 31.2357
>  },
>  "userDeviceUtcTime": "2025-01-15T10:31:00Z",
>  "otpRequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
>  "otpCode": "123456",
>  "requestId": "81f404b3-d7dc-4f08-b4fe-934853c86282"
>}'
200Business Request_customerSignStepValidateOtp_example
1{
2  "data": "string",
3  "error_code": 1,
4  "error_message": "string",
5  "error_descriptions": null
6}
Submit the OTP code to confirm the user's identity and continue the contract activation flow.
Was this page helpful?
Previous

Re-validate liveness after location change

Next

Confirm payment and activate contract

Built with

Authentication

ApiKeystring
Static API key issued to your tenant. Obtain from the Vlens dashboard.
AuthorizationBearer

Short-lived JWT. Obtain via:

  • /api/credentials/Login for admin / service tokens
  • /api/DigitalIdentity/Register or login for end-user tokens

Request

This endpoint expects an object.
geoLocationobjectRequired
Geographic coordinates of the user's device.
userDeviceUtcTimedatetimeRequired
UTC timestamp from the user's device.
otpRequestIdstringRequiredformat: "uuid"

Returned by StepRequestOtp.

otpCodestringRequired
The OTP code entered by the user.
requestIdstringOptionalformat: "uuid"
The business request ID being activated.
contractStorageIdstring or nullOptionalformat: "uuid"
transactionIdstring or nullOptionalformat: "uuid"
The KYC transaction ID associated with this request.
paymentGatewaystring or nullOptional

Payment gateway name (e.g., fawry, kashier).

Response

OTP validated. Proceed to StepValidatePayment.

datastring or null
error_codeinteger or null
error_messagestring or null
error_descriptionsany or null