Skip to main content

Response scenarios

This article exemplifies possible response scenarios for the CreateProcess and GetProcess methods.

ID Flow

Scenario: Process created

Occurs when the process has been created but has not yet been finalized by the user.

State = PROCESS_STATE_CREATED

Result = PROCESS_RESULT_UNSPECIFIED

CreateProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}
GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}

Scenario: Process created with error

Occurs when the process has been created, but there has been an error in the service.

State = PROCESS_STATE_FAILED

Result = PROCESS_RESULT_ERROR

CreateProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}
GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}

Scenario: Process finalized and approved in IDUnico

Occurs when the process has been created, finalized by the user and had POSITIVE feedback from IDUnico.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_OK

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_POSITIVE",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_FALSE",
"score": 0
},
"authenticationId": "652f8864-c364-4cc7-9abb-d38a86d21d66",
"livenessResult": "LIVENESS_RESULT_LIVE"
}

Scenario: Process finalized and inconclusive in IDUnico

Occurs when the process was created, finalized by the user, but had an INCONCLUSIVE return from IDUnico.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_OK

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_INCONCLUSIVE",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_FALSE",
"score": 0
},
"authenticationId": "652f8864-c364-4cc7-9abb-d38a86d21d66",
"livenessResult": "LIVENESS_RESULT_LIVE"
}

Scenario: Process finalized and failed Proof of Life

Occurs when the process has been created, finalized by the user, but has returned a failure in the proof of life.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_INVALID_IDENTITY

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_NOT_LIVE"
}

IDCheck flow

Scenario: Process created

Occurs when the process has been created but has not yet been finalized by the user.

State = PROCESS_STATE_CREATED

Result = PROCESS_RESULT_UNSPECIFIED

CreateProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}
GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}

Scenario: Process created with error

Occurs when the process has been created, but there has been an error in the service.

State = PROCESS_STATE_FAILED

Result = PROCESS_RESULT_ERROR

CreateProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}
GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}

Scenario: Process finalized and approved in IDUnico

Occurs when the process has been created, finalized by the user and had POSITIVE feedback from IDUnico.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_OK

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_POSITIVE",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_TRUE",
"score": 0
},
"authenticationId": "8b2516fa-0c83-44ef-a365-3269e425166d",
"livenessResult": "LIVENESS_RESULT_LIVE"
}

Scenario: Process completed successfully, inconclusive in IDUnico and with a score in IDCheck

Occurs when the process was created, finalized by the user, had an INCONCLUSIVE return from IDUnico and had a valid IDCheck Score.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_OK

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_INCONCLUSIVE",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_TRUE",
"score": 10
},
"authenticationId": "09f14518-e083-44c2-bd32-2d0a56426711",
"livenessResult": "LIVENESS_RESULT_LIVE"
}

Scenario: Process completed successfully, inconclusive in IDUnico and discarded due to divergence in IDCheck

Occurs when the process was created, finalized by the user, had an INCONCLUSIVE return from IDUnico and generated a divergence in IDCheck, which in turn took longer than 60s to be resolved by the divergence engines.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_INVALID_IDENTITY

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_UNSPECIFIED"
}

Scenario: Process completed successfully but fails Proof of Life

Occurs when the process has been created, completed by the user, but it has not been possible to validate that the user who captured the face was live at the time of capture.

State = PROCESS_STATE_FINISHED

Result = PROCESS_RESULT_INVALID_IDENTITY

GetProcess
"authenticationInfo": {
"authenticationResult": "AUTHENTICATION_RESULT_UNSPECIFIED",
"scoreEngineResult": {
"scoreEnabled": "SCORE_ENABLED_UNSPECIFIED",
"score": 0
},
"authenticationId": "",
"livenessResult": "LIVENESS_RESULT_NOT_LIVE"
}

Any concerns?

Missing something or still need help? If you are already a customer or partner, you can contact us through the Help Center.