Widget specification

  • Use the contact form to request access to our API and to get your API key
  • Install identification button on your webpage which, by clicking it, sends query form data (POST method)
  • Once the identification process is completed by the user, link is sent to the client (in case of manual confirmation) by email for the review (to confirm or reject identification)
  • After the client’s review:
    • In case of successful identification, user is redirected to the client’s website (return_url parameter)
    • In case of rejected identification, rejection reasons are shown to the user. User is asked to repeat identification process.

Example:

<script type="text/javascript" src="https://markid.eu/js/widget.js"></script>
<script>
  MarkidWidget.init({
    'token': '',
    'name': '',
    'surname': '',
    'personcode': '',
    'birthday': '',
    'mode': '',
    'auto': '',
    'peps': '',
    'sanctions' : '',
    'triger': 'markidwidget-ident-button',
    'url': 'https://markid.eu/identity',
    'params': {
      'is_monitored_pep': '',
      'is_monitored_sanctions': '',
      'x': '1',
      'y': '2',
      'z': '3'
    }
  });
</script>
<button id="markidwidget-ident-button" type="button"></button>

Languages

Form URL (POST method) for the user interface in Lithuanian: https://markid.eu/identity
Form URL (POST method) for the user interface in English: https://markid.eu/en/identity


Parameters and description


Parameter Description
token Your API key
name The user‘s first name (the person who needs to be identified)
surname The user‘s last name
birthday The user‘s date of birth (YYYY-MM-DD)
personcode The user‘s personal code (optional)
mode Identification mode (possible values: min - simple identification, alive - advanced identification, post - identification via Post.lt services. Default - min.)
auto Confirmation (true - automatic confirmation; default - manual confirmation)
peps PEP check data (true / false)
sanctions Sanction check data (true / false)

Answer form

After completing identity verification process user is redirected to “return_url”
In case of a successful identification answers are returned to the callback URL using POST method


Parameter Description
request Unique request ID
name The user‘s first name
surname The user‘s last name
birthday The user‘s date of birth (YYYY-MM-DD)
personcode The user‘s personal code
photo_person Photo of user face
photo_doc Photo of the front of the document
photo_doc_front Photo of the passport cover
photo_doc_back Photo of the identity card cover
ip User’s IP address
status Status (rejected, success)
agent_answer Rejection reasons (JSON array)
valid_till Document expiry date (UTC timestamp)
document_number Document number
document_type Document type (ID, PASSPORT)
ird_check IRD.lt check data (true / false)
ird_info IRD.lt response (JSON array)
pep_check PEP check data (true / false)
pep PEP check data (JSON array)
sanction_check Sanction check data (true / false)
sanction Sanction check data (JSON array)
created_at Request date (UTC timestamp)

Your server response should be:


OK





HTTP specification

  • Use the contact form to request access to our API and to get your API key
  • Install identification button on your webpage which, by clicking it, sends query form data (POST method)
  • Once the identification process is completed by the user, link is sent to the client (in case of manual confirmation) by email for the review (to confirm or reject identification)
  • After the client’s review:
    • In case of successful identification, user is redirected to the client’s website (return_url parameter)
    • In case of rejected identification, rejection reasons are shown to the user. User is asked to repeat identification process.

Languages

Form URL (POST method) for the user interface in Lithuanian: https://markid.eu/identity
Form URL (POST method) for the user interface in English: https://markid.eu/en/identity


Parameters


Parameter Description
token Your API key
name The user‘s first name (the person who needs to be identified)
surname The user‘s last name
birthday The user‘s date of birth (YYYY-MM-DD)
personcode The user‘s personal code
mode Identification mode (possible values: min - simple identification, alive - advanced identification, post - identification via Post.lt services. Default - min.)
auto Confirmation (true - automatic confirmation; default - manual confirmation)
peps PEP check data (true / false)
sanctions Sanction check data (true / false)

Answer form

Answers are returned using POST method with the client (return_url parameter) and in addition separately POST method request to the secure address (callback_url parameter)


Parameter Description
request Unique request ID
name The user‘s first name
surname The user‘s last name
birthday The user‘s date of birth (YYYY-MM-DD)
personcode The user‘s personal code
photo_person Photo of user face
photo_doc Photo of the front of the document
photo_doc_front Photo of the passport cover
photo_doc_back Photo of the identity card back side
ip User’s IP address
status Status (rejected, success)
agent_answer Rejection reasons (JSON array)
valid_till Document expiry date (UTC timestamp)
document_number Document number
document_type Document type (ID, PASSPORT)
ird_check IRD.lt check data (true / false)
ird_info IRD.lt response (JSON array)
pep_check PEP check data (true / false)
pep PEP check data (JSON array)
sanction_check Sanction check data (true / false)
sanction Sanction check data (JSON array)
created_at Request date (UTC timestamp)

Your server response should be:


OK