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.

object

An object containing personal information of the individual being verified. This field represents another table.

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.

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"
        }
      ]
    }
  }
}

Last updated