Analysis Result - Onboarding

The onboarding result is described as follows:

{
    "applicant_id": "ap-...",
    "reasons": [],
    "customer_data": {},
    "document": {}
}

Parameter	Type / default	Note
applicant_id	string	The same applicant_id you receive when getting a token
reasons	list[string] | null	If the onboarding is rejected, this will indicate the reasons of the rejection
customer_data	object / {}	When using the callback, ShareID can return the customer_data you provided. This information is for your internal use and will only be included in the callback
document	object	The document field contains the details avec information extracted from the user ID document see below for details

Reasons

doc_expired	document expired
no_doc	document blurry, occluded or poorly illuminated
doc_spoof	document printed or shown on screen (spoofing)
doc_inject	document injected or digitally modified
doc_mismatch	document front and back do not match
doc_fraud	fraud suspicion on document
no_face	face detection problem: blurry, occluded or poorly illuminated
face_spoof	face printed or shown on screen (spoofing)
face_inject	face injected or DeepFake
face_fraud	fraud on document ownership
multiple_faces	Multiple faces present in the video
analysis_failed	Analysis has failed
operator_failed	Operator has failed

Document field

{
    "type": {
        "doc_type": "",
        "doc_model": "",
        "country_code": "",
    },
    "ocr": {
        "doc_num": "",
        "surname": "",
        "alternate_name": "",
        "widow_of": "",
        "mariage_name": "",
        "name": "",
        "height": "",
        "birth_place": "",
        "birth_date": "",
        "address": "",
        "expiration_date": "",
        "issuance_date": "",
        "issuance_place": "",
    },
    "doc_front": "",
    "doc_back": "",
    "face_face": "",
    "face_doc": ""
}

Field	Type
doc_type	string	one of "id_card" "passport" "driver_permit" "residency_permit"
doc_model	string	internal model reference detected
country_code	string	country code ISO 3166-1.alpha-2
doc_front	string | null	base64 encoded image of document front page
doc_back	string | null	base64 encoded image of document back page
face_face	string | null	base64 encoded image of face from liveness
face_doc	string | null	base64 encoded image of face from document

Document capture

For the onboarding you can choose to receive also the document captures. It contains at most 4 images, one the front of the the document and one of the back (in the case of passport, only one image is included) + two of the user face (one from the liveness and one from the document, if provided).

As you'll receive those images in a json document they will be encoded in base64. So you will need to decode them on your side.

Note that those images are not sent by default because it makes the json document largely heavier.