Veriff

How does it work?

By using this integration, you will get result of person verification based on checking their identity document and face image. Those data will be used to check if document and face of verifing person is real and valid.

In addition to the verification result, you will also receive personal data and identity document data.

More about this service you can find here

Response Content

veriff

Attribute	Type	Description
status	string	The status of the identity verification. Possible values are APPROVED, PENDING, or REJECTED.
reason	string	The reason for the verification status, if applicable.
identity	object	An object containing personal information of the individual being verified. This field represents another table.
document	object	An object containing information about the identity document used for verification. This field represents another table.
highRisk	boolean	Whether the verification result is deemed to be high risk.
riskLabels	array of objects	An array of objects that describe the type and category of risk factors associated with the verification result. Each object represents another table.

identity

Attribute	Type	Description
lastName	string	The last name of the individual.
firstName	string	The first name of the individual.
idNumber	string	The national ID number of the individual.
dateOfBirth	string	The date of birth of the individual in the format YYYY-MM-DD.
nationality	string	The nationality of the individual.
citizenship	string	The citizenship of the individual.
gender	string	The gender of the individual. Possible values are M (male), F (female), X (indeterminate/intersex/unspecified), or N (not applicable).
yearOfBirth	string	The year of birth of the individual.
placeOfBirth	string	The place of birth of the individual.

document

Field	Type	Description
number	string	The document number.
type	string	The type of the document. Possible values are PASSPORT, ID_CARD, DRIVERS_LICENSE, or RESIDENCE_PERMIT.
country	string	The country of issuance of the document.
validFrom	string	The start date of the validity period of the document in the format YYYY-MM-DD.
validUntil	string	The end date of the validity period of the document in the format YYYY-MM-DD.

riskLabels

Field	Type	Description
label	string	The label of the risk factor.
category	string	The category of the risk factor. Possible values are DEVICE, NETWORK, or OTHER.

Reason and Decision codes

Decline veriff.idVerification.reasonCode

Code	Description
102	Suspected document tampering.
103	Person showing the document does not appear to match document photo.
105	Suspicious behaviour.
106	Known fraud.
108	Velocity/abuse duplicated user.
109	Velocity/abuse duplicated device.
110	Velocity/abuse duplicated ID.
112	Restricted IP location
113	Suspicious behaviour - Identity Farming
502	Multiple parties present in session
503	Attempted deceit
504	Attempted deceit, device screen used
505	Attempted deceit, printout used
507	Presented document tampered, data cross reference
508	Presented document tampered, document similarity to specimen
509	Person showing the document does not match document photo
515	Attempted deceit, device screen used for face image
526	Attempted deceit, photos streamed
527	Unable to collect proof of address data
528	Proof of address issue date too old

Resubmit veriff.idVerification.reasonCode

Code	Description
201	Video and/or photos missing.
204	Poor image quality.
205	Document damaged.
206	Document type not supported.
602	Presented document type not supported.
603	Video missing.
605	Face image missing.
606	Face is not clearly visible.
608	Document front missing.
609	Document back missing.
614	Document front not fully in frame.
615	Document back not fully in frame.
619	Document data not visible.
620	Presented document expired.
621	Document annulled or damaged.
625	Unable to collect surname.
626	Unable to collect first names.
627	Unable to collect date of birth.
628	Unable to collect issue date.
629	Unable to collect expiry date.
630	Unable to collect gender.
631	Unable to collect document number.
632	Unable to collect personal number.
633	Unable to collect nationality.
634	Unable to collect home address.
635	Document and face image missing.

Decision veriff.idVerification.code

Code	Description
9001	Positive: Person was verified. The verification process is complete. Accessing the sessionURL again will show the client that nothing is to be done here.
9102	Negative: Person has not been verified. The verification process is complete. Either it was a fraud case or some other severe reason that the person can not be verified. You should investigate the session further and read the "reason". If you decide to give the client another try you need to create a new session.
9103	Resubmitted: Resubmission has been requested. The verification process is not completed. Something was missing from the client and she or he needs to go through the flow once more. The same sessionURL can and should be used for this purpose.
9104	Negative: Verification has been expired. The verification process is complete. After 7 days the session gets expired. If the client started the verification process we reply "abandoned" here, otherwise if the client never arrived in our environment the status will be "expired"
9121	Review: Review status is issued whenever automation engine could not issue a conclusive decision and the verification session needs to be reviewed by a human. This status will be sent depending on service agreement.

Example response

{
  "veriff": {
    "idVerification": {
      "status": "APPROVED",
      "reason": "",
      "identity": {
        "lastName": "Lewis",
        "firstName": "Adam",
        "idNumber": "73112388122",
        "dateOfBirth": "2020-03-03",
        "nationality": "GB",
        "citizenship": "Poland",
        "gender": "M",
        "yearOfBirth": "2020",
        "placeOfBirth": "Warsav"
      },
      "document": {
        "number": "DAC6723467",
        "type": "ID_CARD",
        "country": "PL",
        "validFrom": "2020-04-05",
        "validUntil": "2030-04-05"
      },
      "highRisk": true,
      "riskLabels": [
        {
          "label": "network risk",
          "category": "NETWORK"
        },
        {
          "label": "device risk",
          "category": "DEVICE"
        }
      ]
    }
  }
}