KYC Service API

  • Users create accounts in mobile application using a phone number. They fill personal data (full name, birthday etc.)
  • After this, each of the fields undergoes the verification procedure. We have three stage of verification:
    • Self verification. User uploads their document and photo.
    • Video verification. User receives a random code, which he must pronounce on video instead of the data written in applications. For example `John Went one three zero six` The code serves as proof that the user has recorded the video himself..
    • Agent verification. Using our second application, the agent personally meets with user and checks documents the entered data. Passing such a check, the data become the most dare.
  • Each stage is fixed in the smart-contract on Ethereum as a hash sum.
  • On the service site, a button is installed `Auth with KYC.Legal`. When the button is clicked, the user receives the QR code.
  • If the user already has KYC.Legal application, he scans the QR code and confirms the access rights to the data. After that, he pressed `ready` button.
  • If he does not have an application, the service must provides him with links to download it. App Store
    Play Market.

You can check the operation of the application here.
To do this, you must download the application and have a completed account:

App Store
Play Market
  • In our system we create authorization token for your service.
  • To receive user data, an inquiry is first created to receive them with list of properties. In response, you will get the QR-код. you want to show to the user and personal authorization code
  • Personal authorization code used to retrieve data from a particular user. The code is available no more than 40 minutes.
  • The user must scan the QR code. Thus, it will get a list of requested fields from inquiry.
  • If the user agrees with the requirements of the service and its data meet the requirements, he sends data to our server, where their hash sum is checked.
  • Now to get the data you need to make another request for data from our service withauthorization code

Inquiry for data.

The following properties are currently available:

  • full_name - Full name,
  • birthday - Birthday,
  • citizenship - Citizenship.
  • id_card - ID Card.
  • address - user address.

verification - status of verification (self, video, agent).

Request

POST https://v1.api.kyc.legal/service/{token}/inquiry
{
    "property_codes": [
        "full_name",
        "citizenship"
    ],
    "verification":"self|video|agent"
}

Response

{
    "data": {
        "qr_path":\http://v1.api.kyc.legal/upload/path_to_qr.png",
        "code":"f41add664eeb132a94bf6e48fed3a51f588ce2973a51f588ce2971"
    },
    "status":"ok"
}

To get the data to the URL, the code is added:

Request

GET https://v1.api.kyc.legal/service/{token}/inquiry/{code}

Response

{
    "data": [
      {
        "code": "full_name",
        "values": {
          "name":"Ivan",
          "surname":"Ivanov",
          "patronymic":"Ivanovich",
        },
        "verification": "self|video|agent",
      },
      {
        "code": "birthday",
        "values": {
          "date":"1529590524"
        },
        "verification": "self|video|agent",
      }
    ],
    "status":"ok"
}