Quick Start

Welcome to Vlens Digital Identity API documentation!

This quick start guide will help you understand our framework to be able toverify your first Digital Identity and sign your first contract

Using the API

VLens provides a REST API to process OCR requests.

To authenticate your API requests, you need a valid API key. If you don't have one, create an account and access your API key in the "API Credentials" section of your Dashboard.

The main goal is to replace identity verification and physical signature with legally authorized digital alternative.

1

Digital Identity

In order to be able to sign E-contracts digitally, you need to verify your digital identity first.

  1. Create user using phone number and email address.

  2. Validate digital identity by scanning the National ID, automatically storing user's information extracted from the National ID.

  3. Verifying the correctness and legality of the information by inquiring Civil Status Organization (CSO) authority (الأحوال المدنية), in addition to National Telecom Regulatory Authority (NTRA) confirmation that the phone number is owned by the same National ID owner.

Digital Identity has three different stages

  1. Registered

  2. Validated

  3. Verified

2

e-Contracting

The contract is to be signed from both parties, customer and service provider.

  1. Customer selects a product, answers Know-Your-Customer (KYC) questions, then submits for approval.

  2. Service provider can approve manually through VLens portal or using an API call. Optional: service provider can add any additional information to the current request (contract).

  3. Once the request is approved, the contract is generated, and the customer can review and sign.

  4. Finally, the service provider can review and sign the contract.

e-Contract has four different stages

  1. Pending approval

  2. Approved

  3. Customer signed

  4. Service provider signed

  5. Rejected

  6. Customer partially signed

  7. Service provider partially signed

  8. Completed

The end-user automatically receives an Email with a copy of the contract once it is signed from either side!

PreviousVLens Digital Identity & e-Contracting flowNextAPI Reference

Last updated