Response Errors

Error codes 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.
20508	O parâmetro subject.gender é inválido	Invalid gender. Possible values are: M, F or empty.
20019	O parâmetro birthdate é inválido.	The birth date is incorrectly formatted. The correct format is dd/mm/yyyy
20048	Parâmetro birthdate não permitido. Idade mínima é de 15 anos.	Age not allowed. Minimum age allowed is 15 years old.
20047	Parâmetro birthdate não permitido. Idade máxima é de 150 anos.	Age not allowed. Maximum age allowed is 150 years old.
20811	O parâmetro webHookSecret não pode ser passado sem o parâmetro webHookUrl.	The webHookSecret parameter must be informed along with the webHookUrl parameter.
60001	O usuário informado não possui uma loja associada a ele.	Contact the biometry support team.
50002	Este cadastro foi enviado para a fila de análise biométrica e não pode ser modificado neste momento! Aguarde alguns instantes e tente novamente.	CPF in the biometry processing queue. It is necessary to wait.
40009	Este CPF possui uma requisição de envio para Score Suspeito em andamento!	Requested by the customer to send this CPF to the list of suspects. It is necessary to wait.
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.
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	Parece que você está de óculos. Por favor, tire a foto SEM o óculos.	Glasses are not allowed.
514	Imagem embaçada ou fora de foco!	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	O bundle informado é inválido.	APIKEY uses a security method and this request does not meet the security requirements (SDK).

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.

Response429

Code	Description	Explanation
42900	O limite de requisições nos últimos 2 minutos foi excedido.	The request limit in the last 2 minutes was exceeded.

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!
20504	A URI do TF não foi definido no banco de dados	Set the TensorFlow URI in the database and try again!
99999	Falha Interna! Tente novamente em alguns minutos	Unexpected error. Possible causes: Internal error or parameter issue.

DocumentInsert

Response400

Code	Description	Explanation
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
20023	O parâmetro processId não foi informado	Missing the process id parameter.
20010	O parâmetro documenttype não foi informado	Missing the document type parameter.
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
50004	Não é possível executar o processo! O processo foi cancelado	Process canceled and cannot be changed.
20403	O base64 é inválido para o tipo de documento informado	The base64 is invalid for the given document type.
50005	Não é possível executar o processo! Este processo já foi concluído	Process completed and cannot be changed.
50006	Não é possível executar um processo! Ele está com erro.	Process error.
50009	Foto do cliente já existente.	Customer picture cannot be added more than once in the same process.
50016	Não conseguimos identificar o documento. Verifique a iluminação e se a foto está bem nítida	Unable to perform the document classification. Possible causes: invalid document or non-standard document. For more details on standardization, see Capture Pattern section.
50019	Não conseguimos verificar a qualidade do documento. Verifique a iluminação e se a foto está bem nítida	Low photo quality. Improve lighting and photo angle. For more details on standardization, see Capture Pattern section.

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.

ExecuteProcess

Response400

Code	Description	Explanation
20023	O parâmetro processId não foi informado	Missing the process id parameter.
50003	Não é possível executar o processo! Informe um documento para prosseguir	Missing some integration step. Waiting for the selfie.
50004	Não é possível executar o processo! O processo foi cancelado	Process canceled and cannot be changed.
50005	Não é possível executar o processo! Este processo já foi concluído	Process completed and cannot be changed.
50006	Não é possível executar um processo! Ele está com erro.	Process error.
50014	O processo informado não teve a foto capturada.	Missing the picture in the process.
50016	Não conseguimos identificar o documento. Verifique a iluminação e se a foto está bem nítida	Low photo quality. Improve lighting and photo angle.
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.

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.

GetDocuments

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
20403	O base64 é inválido para o tipo de documento informado	The base64 is invalid for the given document type.

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.

CancelProcess

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
50008	Este processo já está na fila de processamento ou foi concluído e não pode ser mais cancelado.	Process completed, cannot be canceled.
50020	Não é possível cancelar processos desse tipo.	Cancelation Denied. Only message processes can be canceled.

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.

CreateMessage

Response400

Code	Description	Explanation
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.
20508	O parâmetro subject.gender é inválido	Invalid gender. Possible values are: M, F or empty.
20019	O parâmetro birthdate é inválido.	The birth date is incorrectly formatted. The correct format is dd/mm/yyyy
20048	Parâmetro birthdate não permitido. Idade mínima é de 15 anos.	Age not allowed. Minimum age allowed is 15 years old.
20047	Parâmetro birthdate não permitido. Idade máxima é de 150 anos.	Age not allowed. Maximum age allowed is 150 years old.
60001	O usuário informado não possui uma loja associada a ele.	Contact the biometry support team.
20037	O template escolhido está inativo.	The inactive template.
20038	O template informado não existe	The template does not exist.
20020	O parâmetro phone não foi informado	Missing the cellphone number parameter.
20021	O parâmetro phone não está no formato correto. Deve ter o Code do pais seguido do codigo de área e o telefone do cliente (EX: 0011333333333)	The cellphone number is in the wrong format. Follow the example format: 0011333333333.
40006	Informe o e-mail do cliente.	Missing customer email. Email is a required field.
40007	O e-mail do cliente é muito grande.	Email is too large.
40008	O e-mail do cliente é inválido.	Invalid email.
50012	O valor do índice número do pedido é muito grande.	Order number too large. Maximum 20 characters allowed.
50013	O índice número do pedido é inválido.	Order number with invalid characters.
20033	Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazio	Missing the key index parameter.
20034	Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazio	Missing the value index parameter.
20035	Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazio	Missing the page index 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.

Response500

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

DocumentMessageInsert

Response400

Code	Description	Explanation
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
20023	O parâmetro processId não foi informado	Missing the process id parameter.
20010	O parâmetro documenttype não foi informado	Missing the document type parameter.
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.
20027	O parâmetro signature não foi informado	Missing the signature parameter.
20028	O parâmetro signature.proposalResume não foi informado	Missing the signature.proposalResume parameter which contains the summary of the proposal.
20029	O parâmetro signature.signaturesPositions não foi informado	Missing the signature.signaturesPositions parameter which contains the signature positions.
20030	O parâmetro signature.signaturesPositions[].X não foi informado	Missing the signature.signaturesPositions[].X parameter which contains the signature positions.
20031	O parâmetro signature.signaturesPositions[].Y não foi informado	Missing the signature.signaturesPositions[].Y parameter which contains the signature positions.
20032	O parâmetro signature.signaturesPositions[].Page não foi informado	Missing the signature.signaturesPositions[].Page parameter which contains the signature positions.
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
50004	Não é possível executar o processo! O processo foi cancelado	Process canceled and cannot be changed.
50005	Não é possível executar o processo! Este processo já foi concluído	Process completed and cannot be changed.
50006	Não é possível executar um processo! Ele está com erro.	Process error.
20041	A página informada para assinatura não existe no pdf.	The PDF signature page is missing.
20042	O ponto X deve ser menor que '252' para que a assinatura caiba no documento.	Invalid axis for signature.
20043	O ponto Y deve ser menor que '566' para que a assinatura caiba no documento.	Invalid axis for signature.

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.

ResumeMessageInsert

Response400

Code	Description	Explanation
20001	O parâmetro authtoken não foi informado	Missing the integration token parameter in the request header
20002	O parâmetro APIKey não foi informado	Missing the APIKEY parameter in the request header.
20023	O parâmetro processoId não foi informado	Missing the process id parameter.
20056	O parâmetro processoId é inválido	Invalid process id.
20059	O parâmetro resumes não foi informado	Missing the resume parameter.
20060	O parâmetro resumes é inválido	Invalid resumes parameter.
50004	Não é possível executar o processo! O processo foi cancelado	Process canceled and cannot be changed.
50005	Não é possível executar o processo! Este processo já foi concluído	Process completed and cannot be changed.
50006	Não é possível executar um processo! Ele está com erro.	Process error.

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.

ExecuteMessage

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
50004	Não é possível executar o processo! O processo foi cancelado	Process canceled and cannot be changed.
50005	Não é possível executar o processo! Este processo já foi concluído	Process completed and cannot be changed.
20036	Um processo que contêm um passo de proposta deve ter no mínimo uma proposta anexada ao processo	Missing proposal. The proposal must be attached to the process.
20061	Um processo que contêm um passo de resumo deve ter no mínimo um resumo anexado ao processo	Missing summary. The summary must be attached to the process.

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.

GetMessage

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.

GetSentMessage

Response400

Code	Description	Explanation
20023	O parâmetro processId não foi informado	Missing the process id parameter.
20056	O parâmetro processId é inválido	Invalid process id.
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.

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.

GetSubject

Response400

Code	Description	Explanation
20507	O parâmetro subject.code é inválido	Non-standard cpf or does not exist.
20005	O parâmetro subject.code não foi informado	Missing the subject.code parameter, which contains the cpf of the person.
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
40001	O subject informado não foi encontrado	The person does not exist in the database. Possible causes: it may have been removed by someone or due to some disagreement.

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.

OCRCode

Response400

Code	Description	Explanation
20507	O parâmetro subject.code é inválido	Non-standard cpf or does not exist.
20005	O parâmetro subject.code não foi informado	Missing the subject.code parameter, which contains the cpf of the person.
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
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.

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.

OCR

Response400

Code	Description	Explanation
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
20010	O parâmetro type não foi informado	Missing the document type parameter.
99992	Tipo de documento inválido	Invalid type 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.

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.

DocumentConfirmation

Response400

Code	Description	Explanation
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
20010	O parâmetro type não foi informado	Missing the document type parameter.
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.
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.
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.

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.

FaceMatch

Response400

Code	Description	Explanation
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
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.

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.

AuthenticateSubject

Response400

Code	Description	Explanation
20005	O parâmetro subject.code não foi informado	Missing the subject.code parameter, which contains the cpf of the person.
20009	O parâmetro imagebase64 não foi informado	Missing the imagebase64 parameter, which contains the selfie of the person.
40005	Este cadastro não tem uma biometria cadastrada	Missing valid biometry to perform the 1:1 comparison. It is necessary to make a new registration (1:N).
20502	A URI de biometria não foi definida no banco de dados	Missing to set the biometry URI in the database.
20503	O token de biometria não foi definido no banco de dados	Missing to set the biometry token in the database.
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.
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.
10506	O bundle informado é inválido.	APIKEY uses a security method and this request does not meet the security requirements (SDK).

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
40001	O subject informado não foi encontrado	The person does not exist in the database. Possible causes: it may have been removed by someone or due to some disagreement.

Response500

Code	Description	Explanation
510	Falha interna!	Unexpected error. Possible causes: Internal error or parameter issue.
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.