Dummy session for developers

You can generate a token with dummy auto status and add dummy manual status for verification in the development environment.

Dummy session for developers is used to test the API with various statuses and receive a webhook without the need to go through the process in the UI. If you want to test the flow in the UI, please use the redirection methods - Redirection to WEB UI or Redirection using iframe without the dummyStatus parameter.

Dummy auto result

You can generate a token with dummy auto status and receive a webhook with auto results.

Sending request

Send a HTTP POST request to: https://ivs.markid.eu/api/v2/token

The request must contain basic auth headers where username is API key and password is API secret.

You should have a development environment, otherwise neither a simple token, nor token with dummy auto status will be created.

The request must contain the same parameters as token generation and dummyStatus, which defines dummy session’s auto result.

Example request

{
    "dummyStatus":"APPROVED",
    "clientId":"100000",
    "firstName":"John Tom",
    "lastName":"Smith",
    "successUrl":"https://www.my-company.com/markid/success",
    "errorUrl":"https://www.my-company.com/markid/fail",
    "locale":"en",
    "showInstructions":true,
    "expiryTime":600,
    "sessionLength":600,
    "country":"lt",
    "documents":["PASSPORT", "OTHER"],
    "dateOfBirth": "1990-12-20",
    "dateOfExpiry": "1990-12-20",
    "dateOfIssue": "1990-12-20",
    "nationality": "lt",
    "personalNumber": "123456789",
    "documentNumber": "123456",
    "sex": "M",
    "address": "Address",
    "tokenType": "IDENTIFICATION",
    "videoCallQuestions": ["Question 1", "Question 2"],
    "externalRef": "reference"
}

Example responses

Successful API call returns a JSON response with scanRef, that can be used to add dummy manual status.

An example response with all fields provided:

{
   "message": "Dummy token and verification created successfully",
   "authToken": "pgYQX0z2T8mtcpNj9I20uWVCLKNuG0vgr12f0wAC",
   "scanRef": "ec6a7108-8c26-11e9-9758-309c231b1bac",
   "clientId": "100000",
   "firstName": "JOHN TOM",
   "lastName": "SMITH",
   "successUrl": "https://www.my-company.com/markid/success",
   "errorUrl": "https://www.my-company.com/markid/fail",
   "locale": "en",
   "showInstructions":true,
   "country": "lt",
   "expiryTime": 600,
   "sessionLength": 600,
   "documents": ["PASSPORT",  "OTHER"],
   "dateOfBirth": "1990-12-20",
   "dateOfExpiry": "1990-12-20",
   "dateOfIssue": "1990-12-20",
   "nationality": "lt",
   "personalNumber": "123456789",
   "documentNumber": "123456",
   "sex": "M",   
   "digitString": "4823657",
   "address": "Address",
   "tokenType": "IDENTIFICATION",
   "videoCallQuestions": ["Question 1", "Question 2"],
   "externalRef": "reference"
}

Dummy manual approve

You can add a dummy manual status for the verification in development environment and receive the same webhook as it would after the manual review.

Sending request

Send a HTTP POST request to: https://ivs.markid.eu/api/v2/add-dummy-status

The request must contain basic auth headers where username is API key and password is API secret.

Client’s verification should be already created, otherwise, generate a new token with dummyStatus

The request must contain JSON with these parameters:

For approved verification you need to give FACE_MATCH and DOC_VALIDATED statuses.

Example request

{
    "scanRef": "unique_scan_ref",
    "manualDocumentValidity": "DOC_ERROR",
    "manualFaceMatchResult": "FACE_MATCH"
}

Example responses

A successful API call returns a HTTP response with 200 status.