Response Errors

Error code and possible solutions

CreateProcess

Response400

Code	Description	Explanation
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
20004	O parâmetro subject não foi informado	Missing the subject parameter, which contains the data of the person (cpf, name).
20005	O parâmetro subject.code não foi informado	Missing the subject.code parameter, which contains the cpf of the person.
20507	O parâmetro subject.code é inválido	Non-standard cpf or does not exist.
20006	O parâmetro subject.name não foi informado	Missing the subject.name parameter, which contains the name of the person.
20505	O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp	Invalid base64. Possible causes: not a valid image or invalid prefix.
20900	O base64 informado não é válido	The base64 parameter is invalid. Possible causes: It is not an image or it is an injection attempt.
20807	A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.	The image resolution is too small.
20506	O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.	The picture is too large. The image can be compressed to JPEG92 without losing quality.
20002	O parâmetro APIKey não foi informado	Missing the APIKEY parameter in the request header.
20001	O parâmetro authtoken não foi informado	Missing the integration token parameter in the request header.
10506	O bundle informado é inválido.	APIKEY uses a security method and this request does not meet the security requirements (SDK).
10507	The JWT with the captured face is expired	JWT expired. The .jwt must be sent within 10 minutes.
10508	The JWT with the captured face has already been used	The .jwt can only be used once.
20003	The request body is missing or invalid.	Null or invalid payload.

Response403

Code	Description	Explanation
30017	O usuário não tem permissão para executar está ação	Without permission to use the method, please contact Unico.
10201	O AppKey informado é inválido	The APIKEY parameter is not informed or does not exist.
10501	O token informado é inválido	The authentication token is invalid.
10502	O token informado está expirado	The authentication token is expired.

Response500

Code	Description	Explanation
510	Falha interna!	Unexpected error. Possible causes: Internal error or parameter issue.
10700	Falha Interna!	Generic Token Validation Error. Possible causes: Expired or invalid token.
20502	A URI de biometria não foi definida no banco de dados	Set the biometry URI in the database and try again!
20503	O token de biometria não foi definido no banco de dados	Set the biometry token in the database and try again!
99999	Falha Interna! Tente novamente em alguns minutos	Unexpected error. Possible causes: Internal error or parameter issue.

GetProcess

Response400

Code	Description	Explanation
20023	O parâmetro processId não foi informado	Missing the process id parameter.
20002	O parâmetro APIKey não foi informado	Missing the APIKEY parameter in the request header.
20001	O parâmetro authtoken não foi informado	Missing the integration token parameter in the request header

Response403

Code	Description	Explanation
30017	O usuário não tem permissão para executar está ação	Without permission to use the method, please contact Unico.
10201	O AppKey informado é inválido	The APIKEY parameter is not informed or does not exist.
10501	O token informado é inválido	The authentication token is invalid.
10502	O token informado está expirado	The authentication token is expired.

Response404

Code	Description	Explanation
50001	O processo informado não foi encontrado	The process does not exist in the database.

Response500

Code	Description	Explanation
10700	Falha Interna! Erro ao validar o token informado	Generic Token Validation Error. Possible causes: Expired or invalid token.
99999	Falha Interna! Tente novamente em alguns minutos	Unexpected error. Possible causes: Internal error or parameter issue.

BiometryToken

Response400

Code	Description	Explanation
20009	The selfie parameter was not informed.	Missing the imagebase64 parameter, which contains the selfie of the person.
20023	The processId parameter was not informed.	Missing the process id parameter.
20505	The selfie is not of a supported format. Accepted formats are png and jpeg.	Invalid base64. Possible causes: not a valid image or invalid prefix.
20506	The selfie is too large. The maximum supported size is up to 800kb.	The picture is too large. The image can be compressed to JPEG92 without losing quality.
20900	The selfie is invalid.	The base64 parameter is invalid. Possible causes: It is not an image or it is an injection attempt.
20807	The image must be in the HD standard or have a resolution greater than 640x480.	The image resolution is too small.
20903	The processId has expired.	The processId provided has expired and cannot be used in new calls. Use another processId or create a new process.
500	Centralize o rosto na área de captura!	Face in image unidentified. Possible causes: image quality, positioning, ambient lighting.
502	Aproxime o rosto da câmera!	The face is too far from the camera
503	Afaste o rosto da câmera!	The face is too close to the camera
504	Iluminação não satisfatória! Verifique se o ambiente não está muito escuro e se a câmera não está direcionada contra uma fonte de iluminação.	Image lighting is very bad. However, a face was found. Possible causes: too bright or too dark.
505	Imagem embaçada ou fora de foco! Aproxime o rosto da câmera. Se ainda assim o foco estiver ruim, entre em contato com a equipe de suporte e solicite o ajuste da câmera.	Blurry picture or very low quality.
507	Rosto inclinado! Mantenha o rosto reto e olhe para a câmera.	The face is tilted. Take the photo with the face in a straight position for the camera.
508	Rosto de lado! Mantenha o rosto reto e olhe para a câmera.	The face is to the side. Take the photo with your face in a straight position for the camera.
511	Centralize o rosto na área de captura!	Unable to identify if it is a live picture.
512	The selfie must be taken without glasses.	Glasses are not allowed.
514	Image blurred or out of focus.	Blurry picture.
20002	O parâmetro APIKey não foi informado	Missing the APIKEY parameter in the request header.
20001	O parâmetro authtoken não foi informado	Missing the integration token parameter in the request header.
10506	The bundle is invalid.	APIKEY uses a security method and this request does not meet the security requirements (SDK).

Response403

Code	Description	Explanation
30017	The user is not allowed to perform this action.	Without permission to use the method, please contact Unico.
10201	The APIKEY is invalid.	The APIKEY parameter is not informed or does not exist.
10501	The authentication token is invalid.	The authentication token is invalid.
10502	The authentication token has expired.	The authentication token is expired.

Response404

Code	Description	Explanation
50001	The processId was not found.	The process does not exist in the database. Possible causes: process timed out, process id that does not exist. This error can also occasionally occur if the Biometric Token call was made in a very short time after the process was created.

Response500

Code	Description	Explanation
510	Internal failure!	Unexpected error. Possible causes: Internal error or parameter issue.
99999	Internal failure! Try again later.	Unexpected error. Possible causes: Internal error or parameter issue.

Any concerns?

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