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 as a result of the session opening
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	See below

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": "",
}

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

Reason

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 capture

For the onboarding you can choose to receive also the document captures. Those images are the onboarding documents extraction of the user face: it contains 2 docs, one for the back and one for the front.

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 than without the images.