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

Generate WebView signing URL

||View as Markdown|
POST
https://api.vlenseg.com/api/BusinessRequest/GenerateSignContractLink
POST
/api/BusinessRequest/GenerateSignContractLink
$curl -X POST https://api.vlenseg.com/api/BusinessRequest/GenerateSignContractLink \
>     -H "ApiKey: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "geoLocation": {
>    "latitude": 30.0444,
>    "longitude": 31.2357
>  },
>  "userDeviceUtcTime": "2025-01-15T10:30:00Z",
>  "requestId": "81f404b3-d7dc-4f08-b4fe-934853c86282"
>}'
200Business Request_generateSignContractLink_example
1{
2  "data": "https://api.vlenseg.com/sign?RequestId=81f404b3...&SecurityHash=a428fd4b...",
3  "error_code": null
4}
Generate a secure, time-limited URL for signing a contract in a WebView or web browser. The user can open this URL to review and sign the contract document without native app code. Use `ViewContractPdf` with the `SecurityHash` embedded in the returned URL to download the PDF directly. > **Note:** This is an experimental alternative to the native signing steps. For production use, prefer the `StepRequestOtp` → `StepValidateOtp` → `StepValidatePayment` flow.
Was this page helpful?
Previous

Confirm payment and activate contract

Next

Download contract PDF

Built with

Generate a secure, time-limited URL for signing a contract in a WebView or web browser. The user can open this URL to review and sign the contract document without native app code.

Use ViewContractPdf with the SecurityHash embedded in the returned URL to download the PDF directly.

Note: This is an experimental alternative to the native signing steps. For production use, prefer the StepRequestOtp → StepValidateOtp → StepValidatePayment flow.

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.
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

Signing URL.
datastring or null
error_codeinteger or null
error_messagestring or null
error_descriptionsany or null