Skip to main content

Face authentication

Body​

The webhook body contains the following information:

AttributeDescription
applicant_idID of the applicant, useful to recognize them
external_applicant_idYour applicant ID, only if you updated it in the applicant object
user_journey_idID of the user journey
face_authentication_idID of the face authentication
statusstatus of the identity verification
response_codeslist of response codes

Example

{
"specversion": "2.0",
"type": "face_authentication_checks_completed",
"subject": "fav_01hr7269mkxva7msc443jz4jbf",
"id": "evnt_01hr7269ry3g8skc630q4ec75g",
"time": "2024-03-05T10:22:48Z",
"datacontenttype": "application/json",
"data": {
"external_applicant_id": "87ydky4g6eq144zkcvpoi54mtj"
"applicant_id": "aplt_01jdky4g6eq144zkcv16vtymx7",
"status": "declined",
"face_authentication_id": "fav_01je8cdhrk5fwa5j5nb701sah7",
"response_codes": [{"code": "62321", "summary": "face_face_mismatch"],
"user_journey_id": "usj_01hyzdts3zxqjm8bvvne2a2qb3"
}
}

Events​

EventsDescription
face_authentication_createdYou created an face authentication
face_authentication_openedYou created a first attempt and the verification URL is available
face_authentication_startedThe applicant has been redirected to the web application
face_authentication_resetYou created a new attempt while the status was pending or capture_in_progress
face_authentication_capture_completedThe applicant completed the capture
face_authentication_checks_completedWe completed the checks
face_authentication_link_expiredThe link expired without applicant being redirected to the web application, please note the default expiration time is 15 minutes
face_authentication_capture_refusedThe applicant explicitly refused to perform the face authentication
face_authentication_capture_abortedThe applicant terminated the capture without completing it
face_authentication_checks_inconclusiveThe applicant did not provide the assets required to perform the checks
face_authentication_retry_requestedYou requested a retry for this face authentication
face_authentication_closedThe face authentication has been forcibly closed
face_authentication_anonymizedThe face authentication has been anonymized
face_authentication_audit_completedThe face authentication has been audited and the status may have been updated