Guia de tratamento de retornos
Apresenta as informações necessárias sobre os diferentes tipos de retornos da biblioteca em React Native.
Os parâmetros onSuccess
e onError
são responsáveis por receber os retornos do componente para o devido tratamento.
Liveness 3D
1. Sucesso
O parâmetro onSuccess
é uma função que recebe um objeto do tipo OnLivenessSuccess
, que possui as seguintes propriedades:
Propriedade | Descrição |
---|---|
valid | Indica a autenticidade das informações verificadas na prova de vida. |
cause | Código identificador do tipo da transação. |
codId | Indica por qual motivo o processo finalizou sem sucesso. |
protocol | Protocolo da transação de prova de vida. |
scanResultBlob | É um blob criptografado para uso do SDK no tratamento do retorno. |
Tabela codeId
codeId | Descrição |
---|---|
1.0 | Prova de Vida Aprovada |
300.1 | Prova de Vida Reprovada (face não identificada; necessário retentativa) |
300.2 | Prova de Vida Reprovada (usuário bloqueado; retentativa não disponível) |
2. Erro
O parâmetro onError
é uma função que recebe um objeto indicando o erro ocorrido.
As propriedades encontradas no objeto estão listadas na tabela abaixo:
Atributo | Descrição |
---|---|
code | Representação do erro em valor numérico. |
message | Texto que contém uma mensagem explicativa sobre o erro. |
Os casos de erro encontrados no objeto recebido por este método estão listado na tabela abaixo:
Code | Message |
---|---|
0 | App Key inválido. |
1 | Não foi concedida permissão de acesso à câmera do aparelho. |
2 | Sem conexão à Internet. |
3 | Prova de vida não foi completada. |
4 | Liveness não foi inicializado corretamente. |
3. Exemplo de uso
Após efetuar a importação da biblioteca, deve ser aplicada a App Key gerada dentro do parâmetro da função desejada, no exemplo abaixo chamamos a função quando clicamos no botão "Liveness 3D".
<Liveness3dView
options={options}
navigation={navigation}
loading={loading}
callbackView="Home"
/* CustomInstructionView={<InstructionsView navigation={navigation} />} */
/* CustomPermissionView={<PermissionView navigation={navigation} />} */
onSuccess={onSuccess} // <--------
onError={onError} // <----------
/>
Liveness 2D
1. Sucesso
O parâmetro onSuccess
é uma função que recebe um objeto do tipo LivenessSuccessResult
que possui as seguintes propriedades:
O objeto recebido por este método possui as seguintes propriedades:
Propriedade | Descrição |
---|---|
valid | Indica a autenticidade das informações verificadas na prova de vida. |
codID | Código identificador do tipo da transação. |
cause | Indica por qual motivo o processo finalizou sem sucesso. |
uidProtocol | Protocolo da transação de prova de vida. |
codID | Descrição |
---|---|
1.1 | Cadastro com sucesso. |
1.2 | Certificação positiva. (Conhecido = True) |
200.1 | Cadastro com alerta. |
200.2 | Certificação negativa. (Conhecido = True) |
200.3 | Certificação positiva. (Conhecido = False) |
200.4 | Certificação negativa. (Conhecido = False) |
200.5 | Validação na Base da Serpro |
300.1 | Prova de vida inválida. |
300.2 | Usuário foi bloqueado. |
2. Erro
O parâmetro onError
é uma função que recebe um objeto indicando o erro ocorrido.
As propriedades encontradas no objeto estão listadas na tabela abaixo:
Erro | Descrição |
---|---|
invalidAppKey | App Key inválido. |
certifaceOff | Certiface offline. |
noCameraPermission | Não foi concedida permissão de acesso à câmera do aparelho. |
noInternetConnection | Dispositivo sem conexão à Internet. |
phoneCallInProgress | Chamada telefônica em andamento. Não é possível iniciar o desafio durante uma chamada telefônica. |
validationError | Erro na requisição de validação dos desafios. |
challengeInterrupted | App foi minimizado durante o uso do FaceCaptcha, isso faz com que o desafio seja encerrado. |
requestError | Erro na comunicação com o servidor. |
errorCameraSetup | Erro ao configurar câmera |
errorCapturePicture | Erro ao capturar foto. |
<Liveness2dView
options={options}
navigation={navigation}
loading={loading}
callbackView="Home"
/* CustomInstructionView={<InstructionsView navigation={navigation} />} */
/* CustomPermissionView={<PermissionView navigation={navigation} />} */
onSuccess={onSuccess} // <--------
onError={onError} // <----------
/>
Doc Core
1. Sucesso
O parâmetro onSuccess
é uma função que recebe um objeto do tipo DocSuccessResult
que possui as seguintes propriedades:
2. Erro
Os casos de erro encontrados no objeto recebido por este método estão listados na tabela abaixo:
Erro | Descrição |
---|---|
invalidAppKey | App Key inválido. |
certifaceOff | Certiface offline. |
cameraSetupFailed | Erro ao configurar a câmera. |
noCameraPermission | Não foi concedida permissão de acesso à câmera do aparelho. |
errorCapturePicture | Erro ao capturar foto. |
noInternetConnection | Dispositivo sem conexão à Internet. |
validationError | Erro na requisição de validação dos desafios. |
faceCaptchaNotExecuted | FaceCaptcha não foi realizada. |
<DocumentsCopyView
options={options}
navigation={navigation}
loading={loading}
callbackView="Home"
/* CustomInstructionView={<InstructionsView navigation={navigation} />} */
/* CustomPermissionView={<PermissionView navigation={navigation} />} */
onSuccess={onSuccess} // <--------
onError={onError} // <----------
/>
Updated 3 months ago