Why does your service only support the asynchronous method?
To ensure the best service, we don't use the asynchronous method. Certain databases can cause delays, and therefore, take a longer time to process the result. Additionally, if there is a tricky case, it's reviewed by our compliance officer to give you the best possible result. This way, regardless of the external circumstances, we can guarantee the best possible answer/result for you. Our priority is quality and coverage, while still meeting our SLA times.
Why should we make endpoint for getting webhooks from your service?
Your service should accept webhooks from our service in order to automatically receive information about the results of applicant verification and change the account status in real time. If you think that the result of verification has not been received by your service, you can make a request at any time to obtain the applicant status.
When I receive a webhook, where is the answer?
It's in the field reviewResult.reviewAnswer. Supported values are GREEN (applicant passed verification) and RED (applicant failed verification - but in most cases, he can fix the problem by uploading new documents).
How can I get the result of an applicant's document recognition?
After verification is complete, we will send a webhook to your endpoint. If "reviewAnswer":" GREEN", then you can accept the result of the applicant's document recognition. See this article for more information.
How can I get the result of checked documents?
After verification is complete, we will send you a webhook to your endpoint. You can then make a request to get the verification results of each document.
What's the format of document recognition results?
Different types of documents have different sets of fields that you can get using this method after verification is complete.
"idDocs": [
{
"idDocType": "PASSPORT",
"country": "ALB",
"firstName": "JOHN",
"firstNameEn": "JOHN",
"lastName": "DOE",
"lastNameEn": "DOE",
"issuedDate": "2019-06-05",
"validUntil": "2020-08-08",
"number": "87988779P",
"dob": "1990-01-01"
},
{
"idDocType": "ID_CARD",
"country": "GBR",
"firstName": "JOHN",
"firstNameEn": "JOHN",
"lastName": "DOE",
"lastNameEn": "DOE",
"issuedDate": "2018-06-05",
"validUntil": "2021-08-08",
"number": "87988779ID",
"dob": "1990-01-01"
},
{
"idDocType": "DRIVERS",
"country": "GBR",
"firstName": "JOHN",
"firstNameEn": "JOHN",
"lastName": "DOE",
"lastNameEn": "DOE",
"issuedDate": "2015-09-09",
"validUntil": "2021-08-08",
"firstIssuedDate": "2010-09-09",
"number": "87988779DR",
"dob": "1990-01-01"
},
{
"idDocType": "UTILITY_BILL",
"country": "GBR",
"firstName": "JOHN",
"firstNameEn": "JOHN",
"lastName": "DOE",
"lastNameEn": "DOE",
"issuedDate": "2019-10-15",
"address": {
"subStreet": "15A APT 9",
"subStreetEn": "15A APT 9",
"street": "GENERIC STREET",
"streetEn": "GENERIC STREET",
"state": "STATE",
"stateEn": "STATE",
"town": "GENCITY",
"townEn": "GENCITY",
"postCode": "987",
"country": "GBR"
}
},
{
"idDocType": "RESIDENCE_PERMIT",
"country": "GBR",
"firstName": "JOHN",
"firstNameEn": "JOHN",
"lastName": "DOE",
"lastNameEn": "DOE",
"issuedDate": "2015-08-08",
"validUntil": "2020-08-08",
"number": "87988779RP",
"dob": "1990-01-01"
},
{
"idDocType": "VEHICLE_REGISTRATION_CERTIFICATE",
"country": "GBR",
"firstName": "TOYOTA",
"firstNameEn": "TOYOTA",
"lastName": "RX871",
"lastNameEn": "RX871",
"number": "9876312475Q",
"additionalNumber": "A21235BB",
"dob": "2010-01-01"
}
]
How to notify users about verification result?
After verification is complete, we can send the user an email with the results.
The email contains the result of verification and a link for the user to re-upload their documents if the verification was unsuccessful. To enable us send emails with verification results, make sure to check the Email notifications checkbox under verification level settings.
It is possible to customize letters in Dashboard. You can change the company logo, redirection link and signature. Email texts can be changed on the SDK Translations tab.