Pular para o conteúdo principal

Response Errors

Código dos erros e suas possíveis soluções

CreateProcess

Response400

CódigoDescriçãoExplicação
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém a selfie da pessoa.
20004O parâmetro subject não foi informadoFalta o parâmetro subject, que contém os dados da pessoa (cpf, nome).
20005O parâmetro subject.code não foi informadoFalta o parâmetro subject.code, que contém o cpf da pessoa.
20507O parâmetro subject.code é inválidoCPF fora do padrão ou inexistente.
20006O parâmetro subject.name não foi informadoFalta o parâmetro subject.name, que contém o nome da pessoa.
20508O parâmetro subject.gender é inválidoGênero inválido. Os valores possíveis são: M, F ou vazio.
20019O parâmetro birthdate é inválido.A data de nascimento está formatada incorretamente. O formato correto é dd/mm/aaaa.
20048Parâmetro birthdate não permitido. Idade mínima é de 15 anos.Idade não permitida. A idade mínima permitida é de 15 anos.
20047Parâmetro birthdate não permitido. Idade máxima é de 150 anos.Idade não permitida. A idade máxima permitida é de 150 anos.
20811O parâmetro webHookSecret não pode ser passado sem o parâmetro webHookUrl.O parâmetro webHookSecret deve ser informado junto com o parâmetro webHookUrl.
60001O usuário informado não possui uma loja associada a ele.Entrar em contato com o suporte da biometria.
50002Este 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 na fila de processamento de biometria. É preciso aguardar.
40009Este CPF possui uma requisição de envio para Score Suspeito em andamento!Solicitado pelo cliente o envio desse CPF para lista de escore suspeito. É preciso aguardar.
20505O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webpBase64 inválido. Possíveis causas: não é uma imagem válida ou prefixo inválido.
20900O base64 informado não é válidoO parâmetro base64 é inválido. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.
20807A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.A resolução da imagem enviada é muito pequena.
20506O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
500Centralize o rosto na área de captura!Rosto na imagem não identificado. Possíveis causas: qualidade da imagem, posicionamento, iluminação ambiente.
502Aproxime o rosto da câmera!O rosto da pessoa está muito longe da câmera.
503Afaste o rosto da câmera!O rosto da pessoa está muito perto da câmera.
504Iluminaçã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.A iluminação da imagem é muito ruim. No entanto, um rosto foi encontrado. Possíveis causas: muito claro ou muito escuro.
505Imagem 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.Imagem borrada ou qualidade muito baixa.
507Rosto inclinado! Mantenha o rosto reto e olhe para a câmera.O rosto está inclinado. Tire a foto com o rosto em posição reta para a câmera.
508Rosto de lado! Mantenha o rosto reto e olhe para a câmera.O rosto está de lado. Tire a foto com o rosto em posição reta para a câmera.
511Centralize o rosto na área de captura!Não é possível identificar se é uma imagem ao vivo.
512Parece que você está de óculos. Por favor, tire a foto SEM o óculos.Óculos não são permitidos.
514Imagem embaçada ou fora de foco!Imagem embaçada.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no cabeçalho da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no cabeçalho da requisição.
10506O bundle informado é inválido.APIKEY usa um método de segurança e esta solicitação não atende aos requisitos de segurança (SDK).
20003The request body is missing or invalid.Payload nulo ou inválido.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
510Falha interna!Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
20502A URI de biometria não foi definida no banco de dadosDefina a URI de biometria no banco de dados e tente novamente!
20503O token de biometria não foi definido no banco de dadosDefina o token de biometria no banco de dados e tente novamente!
20504A URI do TF não foi definido no banco de dadosDefina a URI do tensor flow no banco de dados e tente novamente!
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

DocumentInsert

Response400

CódigoDescriçãoExplicação
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém a selfie da pessoa.
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20010O parâmetro documenttype não foi informadoFalta o parâmetro de tipo de documento.
20506O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no cabeçalho da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no cabeçalho da requisição.
50004Não é possível executar o processo! O processo foi canceladoProcesso cancelado e não pode ser alterado.
20403O base64 é inválido para o tipo de documento informadoA base64 é inválida para o tipo de documento fornecido.
50005Não é possível executar o processo! Este processo já foi concluídoProcesso concluído e não pode ser alterado.
50006Não é possível executar um processo! Ele está com erro.Erro de processo.
50009Foto do cliente já existente.A foto do cliente não pode ser adicionada mais de uma vez no mesmo processo.
50016Não conseguimos identificar o documento. Verifique a iluminação e se a foto está bem nítidaNão foi possível realizar a tipificação do documento. Possíveis causas: documento inválido ou documento fora do padrão. Para obter mais detalhes sobre padronização, consulte a seção Padrão de Captura.
50019Não conseguimos verificar a qualidade do documento. Verifique a iluminação e se a foto está bem nítidaBaixa qualidade da foto. Melhore a iluminação e o ângulo da foto. Para obter mais detalhes sobre padronização, consulte a seção Padrão de Captura.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

ExecuteProcess

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
50003Não é possível executar o processo! Informe um documento para prosseguirFaltando alguma etapa de integração. Aguardando a selfie.
50004Não é possível executar o processo! O processo foi canceladoProcesso cancelado e não pode ser alterado.
50005Não é possível executar o processo! Este processo já foi concluídoProcesso concluído e não pode ser alterado.
50006Não é possível executar um processo! Ele está com erro.Erro de processo.
50014O processo informado não teve a foto capturada.Faltando a foto no processo.
50016Não conseguimos identificar o documento. Verifique a iluminação e se a foto está bem nítidaBaixa qualidade da foto. Melhorar a iluminação e o ângulo da foto.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetProcess

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetDocuments

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.
20403O base64 é inválido para o tipo de documento informadobase64 inválido para o tipo de documento.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

CancelProcess

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.
50008Este processo já está na fila de processamento ou foi concluído e não pode ser mais cancelado.Processo concluído, não pode ser cancelado.
50020Não é possível cancelar processos desse tipo.Cancelamento negado. Apenas os processos de mensagens podem ser cancelados.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

CreateMessage

Response400

CódigoDescriçãoExplicação
20004O parâmetro subject não foi informadoFalta o parâmetro subject, que contém os dados da pessoa (cpf, nome).
20005O parâmetro subject.code não foi informadoFalta o parâmetro subject.code, que contém o cpf da pessoa.
20507O parâmetro subject.code é inválidoCPF fora do padrão ou inexistente.
20006O parâmetro subject.name não foi informadoFalta o parâmetro subject.name, que contém o nome da pessoa.
20508O parâmetro subject.gender é inválidoGênero inválido. Os valores possíveis são: M, F ou vazio.
20509O parâmetro subject.name é inválidoNome não é válido.
20019O parâmetro birthdate é inválido.A data de nascimento está formatada incorretamente. O formato correto é dd/mm/aaaa.
20048Parâmetro birthdate não permitido. Idade mínima é de 15 anos.Idade não permitida. A idade mínima permitida é de 150 anos.
20047Parâmetro birthdate não permitido. Idade máxima é de 150 anos.Idade não permitida. A idade máxima permitida é de 150 anos.
60001O usuário informado não possui uma loja associada a ele.Entrar em contato com o suporte da biometria.
20037O template escolhido está inativo.O template está inativo na instância.
20038O template informado não existeO template não existe.
20020O parâmetro phone não foi informadoFaltando o parâmetro phone que contém o celular da pessoa.
20021O parâmetro phone não está no formato correto. Deve ter o código do pais seguido do codigo de área e o telefone do cliente (EX: 0011333333333)O número do celular está no formato errado. Siga o formato de exemplo: 0011333333333.
40006Informe o e-mail do cliente.Faltando e-mail do cliente. E-mail é um campo obrigatório.
40007O e-mail do cliente é muito grande.O e-mail informado é muito grande.
40008O e-mail do cliente é inválido.O e-mail informado é inválido.
50012O valor do índice número do pedido é muito grande.O número do pedido é muito grande. Máximo de 20 caracteres permitidos.
50013O índice número do pedido é inválido.O número do pedido possui caracteres inválidos.
20033Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazioFalta o parâmetro índice key.
20034Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazioFalta o parâmetro de índice value.
20035Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazioFalta o parâmetro de índice da página.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99998Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

DocumentMessageInsert

Response400

CódigoDescriçãoExplicação
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém a selfie da pessoa.
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20010O parâmetro documenttype não foi informadoFalta o parâmetro de tipo de documento.
20506O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20027O parâmetro signature não foi informadoFalta o parâmetro de assinatura.
20028O parâmetro signature.proposalResume não foi informadoFalta o parâmetro signature.proposalResume que contém o resumo da proposta.
20029O parâmetro signature.signaturesPositions não foi informadoFalta o parâmetro signature.signaturesPositions que contém as posições de assinatura.
20030O parâmetro signature.signaturesPositions[].X não foi informadoFalta o parâmetro signature.signaturesPositions[].X que contém as posições de assinatura.
20031O parâmetro signature.signaturesPositions[].Y não foi informadoFalta o parâmetro signature.signaturesPositions[].Y que contém as posições de assinatura.
20032O parâmetro signature.signaturesPositions[].Page não foi informadoFalta o parâmetro signature.signaturesPositions[].Page que contém as posições de assinatura.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.
50004Não é possível executar o processo! O processo foi canceladoProcesso cancelado e não pode ser alterado.
50005Não é possível executar o processo! Este processo já foi concluídoProcesso concluído e não pode ser alterado.
50006Não é possível executar um processo! Ele está com erro.Erro de processo.
20041A página informada para assinatura não existe no pdf.Faltando a página para assinatura no PDF.
20042O ponto X deve ser menor que '252' para que a assinatura caiba no documento.Eixo inválido para assinatura.
20043O ponto Y deve ser menor que '566' para que a assinatura caiba no documento.Eixo inválido para assinatura.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

ResumeMessageInsert

Response400

CódigoDescriçãoExplicação
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20023O parâmetro processoId não foi informadoFalta o parâmetro id do processo.
20056O parâmetro processoId é inválidoO id do processo é inválido.
20059O parâmetro resumes não foi informadoFalta o parâmetro resumes.
20060O parâmetro resumes é inválidoO resumo enviado é inválido.
50004Não é possível executar o processo! O processo foi canceladoProcesso cancelado e não pode ser alterado.
50005Não é possível executar o processo! Este processo já foi concluídoProcesso concluído e não pode ser alterado.
50006Não é possível executar um processo! Ele está com erro.Erro de processo.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

ExecuteMessage

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.
50004Não é possível executar o processo! O processo foi canceladoProcesso cancelado e não pode ser alterado.
50005Não é possível executar o processo! Este processo já foi concluídoProcesso concluído e não pode ser alterado.
20036Um processo que contêm um passo de proposta deve ter no mínimo uma proposta anexada ao processoFalta proposta. A proposta deve ser anexada ao processo.
20061Um processo que contêm um passo de resumo deve ter no mínimo um resumo anexado ao processoFalta resumo. O resumo deve ser anexado ao processo.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetMessage

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001O processo informado não foi encontradoO processo não existe na base de dados.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetSentMessage

Response400

CódigoDescriçãoExplicação
20023O parâmetro processId não foi informadoFalta o parâmetro id do processo.
20056O parâmetro processId é inválidoO id do processo é inválido.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetSubject

Response400

CódigoDescriçãoExplicação
20507O parâmetro subject.code é inválidoCPF fora do padrão ou inexistente.
20005O parâmetro subject.code não foi informadoFalta o parâmetro subject.code, que contém o cpf da pessoa.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
40001O subject informado não foi encontradoA pessoa não existe na base de dados. Possíveis causas: pode ter sido removida por alguém ou por alguma divergência.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

OCRCode

Response400

CódigoDescriçãoExplicação
20507O parâmetro subject.code é inválidoCPF fora do padrão ou inexistente.
20005O parâmetro subject.code não foi informadoFalta o parâmetro subject.code, que contém o cpf da pessoa.
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém o documento.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

OCR

Response400

CódigoDescriçãoExplicação
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém o documento.
20010O parâmetro type não foi informadoFalta o parâmetro de tipo de documento.
99992Tipo de documento inválidoO parâmetro type é inválido.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

DocumentConfirmation

Response400

CódigoDescriçãoExplicação
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém o documento.
20010O parâmetro type não foi informadoFalta o parâmetro de tipo de documento.
20506O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20505O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webpBase64 inválida. Possíveis causas: não é uma imagem válida ou prefixo inválido.
20900O base64 informado não é válidoO parâmetro base64 é inválido. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

FaceMatch

Response400

CódigoDescriçãoExplicação
20009O parâmetro imagebase64 não foi informadoFalta o parâmetro imagebase64, que contém o documento.
20002O parâmetro APIKey não foi informadoFalta o parâmetro APIKEY no header da requisição.
20001O parâmetro authtoken não foi informadoFalta o parâmetro do token de integração no header da requisição.

Response403

CódigoDescriçãoExplicação
30017O usuário não tem permissão para executar está açãoSem permissão para utilizar este método, entrar em contato com a Unico.
10201O AppKey informado é inválidoO parâmetro APIKEY não foi informado ou não existe.
10501O token informado é inválidoO token de autenticação é inválido.
10502O token informado está expiradoO token de autenticação expirou.

Response429

CódigoDescriçãoExplicação
42900O limite de requisições nos últimos 2 minutos foi excedido.O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

CódigoDescriçãoExplicação
10700Falha Interna! Erro ao validar o token informadoErro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999Falha Interna! Tente novamente em alguns minutosErro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

BiometryToken

Response400

CódigoDescriçãoExplicação
20009The selfie parameter was not informed.Falta o parâmetro imagebase64, que contém a selfie da pessoa.
20023The processId parameter was not informed.O id do processo não foi enviado por parâmetro.
20505The selfie is not of a supported format. Accepted formats are png and jpeg.A selfie enviada é inválida. Possíveis causas: não é uma imagem válida ou prefixo inválido.
20506The selfie is too large. The maximum supported size is up to 800kb.A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20900The selfie is invalid.A selfie enviada é inválida. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.
20807The image must be in the HD standard or have a resolution greater than 640x480.A resolução da imagem é muito pequena.
20903The processId has expired.O processId fornecido expirou e não pode ser usado em novas chamadas. Use outro processId ou crie um novo processo.
500The face must be centered in the capture area.Rosto na imagem não identificado. Possíveis causas: qualidade da imagem, posicionamento, iluminação ambiente).
502The face must be closer to the camera.O rosto da pessoa está muito longe da câmera.
503The face must be further away from the camera.O rosto da pessoa está muito perto da câmera.
504Bad lighting! Make sure the environment is not too dark and that the camera is not pointed against a light source.A iluminação da imagem é muito ruim. No entanto, um rosto foi encontrado. Possíveis causas: muito claro ou muito escuro).
505Image blurred or out of focus! The face must be brought closer to the camera. If the focus is still poor, contact the support team and ask for the camera to be adjusted.Imagem embaçada ou a qualidade está muito baixa.
507Tilted face! The face must be straight and looking at the camera.O rosto está inclinado, deve estar com o rosto reto em comparação a câmera.
508Side face! The face must be straight and looking at the camera.O rosto está de lado. Tire a foto com o rosto em posição reta para a câmera.
511The face must be centered in the capture area.Não é possível identificar se é uma imagem ao vivo.
512The selfie must be taken without glasses.Óculos não são permitidos.
514Image blurred or out of focus.Imagem embaçada.
20002The APIKEY parameter was not informed.Falta o parâmetro APIKEY no cabeçalho da requisição.
20001The authorization token was not informed.Falta o parâmetro do token de integração no cabeçalho da requisição.
10506The bundle is invalid.O APIKEY utiliza um método de segurança via bundle, e essa requisição não atende aos requisitos de segurança (via SDK)

Response403

CódigoDescriçãoExplicação
30017The user is not allowed to perform this action.Sem permissão para utilizar este método, entrar em contato com a Unico.
10201The APIKEY is invalid.O parâmetro APIKEY não foi informado ou não existe.
10501The authentication token is invalid.O token de autenticação é inválido.
10502The authentication token has expired.O token de autenticação expirou.

Response404

CódigoDescriçãoExplicação
50001The processId was not found.O processo não foi encontrado na base de dados. Isso pode ter acontecido porque ele expirou, ou por ser um id de processo que realmente não existe. Este erro também pode ocorrer eventualmente caso a chamada do Token Biométrico tenha sido feita em um espaço muito curto de tempo após o processo ter sido criado.

Response500

CódigoDescriçãoExplicação
510Internal failure!Erro interno no processamento da biometria não esperado pela aplicação.
99999Internal failure! Try again later.Erro interno não esperado pela aplicação.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.