---
title: Como realizar um onboarding utilizando as SDKs (Software Development Kit)
description: Neste artigo, você entenderá como atrelar a uma requisição de Onboarding via API, informações obtidas nas SDKs de Face Recognition, OCR e Device Scan
---

[Pular para o conteúdo](https://lp.qitech.com.br/pt-br/help-center-qi-tech/como-realizar-um-onboarding-utilizando-as-sdks#main-content)

[Envie sua dúvida aqui](https://lp.qitech.com.br/pt-br/help-center-qi-tech/kb-tickets/new?hsLang=pt-br) [Portal do cliente](https://lp.qitech.com.br/cliente?hsLang=pt-br)

[![Logo\_QI\_Tech\_RGB\_versao\_preferencial-cut.png\]](https://lp.qitech.com.br/hs-fs/hubfs/Logo_QI_Tech_RGB_versao_preferencial-cut.png?height=40&name=Logo_QI_Tech_RGB_versao_preferencial-cut.png)](https://lp.qitech.com.br/pt-br/help-center-qi-tech?hsLang=pt-br)

Abrir navegação principal

Fechar navegação principal

- [Envie sua dúvida aqui](https://lp.qitech.com.br/pt-br/help-center-qi-tech/kb-tickets/new)
- [Portal do cliente](https://lp.qitech.com.br/cliente)
- [Ir para qitech.com.br](https://qitech.com.br/)

[Ir para qitech.com.br](https://qitech.com.br/)

 Olá! Como podemos ajudar?

- Não há sugestões porque o campo de pesquisa está em branco.

1. [Central de conhecimento](https://lp.qitech.com.br/pt-br/help-center-qi-tech?hsLang=pt-br)
2. [Casos de uso](https://lp.qitech.com.br/pt-br/help-center-qi-tech/casos-de-uso?hsLang=pt-br)
3. [Risk Solutions](https://lp.qitech.com.br/pt-br/help-center-qi-tech/casos-de-uso?hsLang=pt-br#risk-solutions)

# Como realizar um onboarding utilizando as SDKs (Software Development Kit)

## Neste artigo, você entenderá como atrelar a uma requisição de Onboarding via API, informações obtidas nas SDKs de Face Recognition, OCR e Device Scan

Como forma de potencializar a segurança do Onboarding, podemos atrelar essa análise, com as informações cadastrais submetidas pelo usuário em sua aplicação, às informações obtidas em nossas SDKs, sendo elas:

- Device Scan - Informações do dispositivo do usuário que está realizando o onboarding;
- Face Recognition - Foto do usuário que está realizando o onboarding;
- OCR - Fotos dos documentos do usuário que está realizando o onboarding.

Ao utilizar as SDKs com o Onboarding, podemos aproveitar os resultados delas para também definir o comportamento da nossa regra no Motor de Regras. Lá em "Variáveis do Processador", quando se tem contratadas as SDKs, existem opções que podem ser adicionadas para as mais variadas validações, como o exemplo na imagem abaixo:

![](https://lp.qitech.com.br/hs-fs/hubfs/image-png-Oct-01-2024-08-27-26-3655-PM.png?width=688&height=141&name=image-png-Oct-01-2024-08-27-26-3655-PM.png)

Essas novas validações, permitem uma regra mais robusta, a fim de validar se a pessoa é quem realmente diz ser. Os dados de device\_scan são muito relevantes também, com eles podemos por exemplo, verificar se a pessoa não está tentando fazer o onboarding em uma região que não deveria, isso de acordo com a sua regra de negócio, utilizando-se das coordenadas e outras informações do dispositivo que coletamos.

Falando sobre o Motor de Regras, abaixo tem-se um exemplo de como utilizar algumas dessas validações:

- Validando prova de vida e match entre selfie e foto do documento

![](https://lp.qitech.com.br/hs-fs/hubfs/image-png-Oct-01-2024-08-32-50-1320-PM.png?width=633&height=689&name=image-png-Oct-01-2024-08-32-50-1320-PM.png)

- Verificando se a selfie corresponde ao documento informado em base de rostos própria

![](https://lp.qitech.com.br/hs-fs/hubfs/image-png-Oct-01-2024-08-42-33-8106-PM.png?width=688&height=682&name=image-png-Oct-01-2024-08-42-33-8106-PM.png)

Sabendo da relevância dessas validações e, tendo visão de como implementá-las dentro da sua política de antifraude, vale descrever como é feito o processo padrão de integração entre essas SDKs e o Onboarding.

O fluxo abaixo, descreve a comunicação que deve ocorrer entre a sua aplicação e cada uma de nossas SDKs.

![onboarding\_sdk.drawio](https://lp.qitech.com.br/hs-fs/hubfs/onboarding_sdk.drawio.png?width=688&height=1063&name=onboarding_sdk.drawio.png)

Em nossa [documentação](https://docs.qitech.com.br/documentation/caas/ocr/api/introduction), é possível analisar de maneira mais detalhada as exigências para cada uma das requisições, desde o body a headers necessários. Em resumo, nossas SDKs devolverão algumas keys que devem ser armazenadas para a construção do payload de Onboarding, incluindo os dados de Face Recognition no objeto ***face***, os dados de ***ocr*** no objeto documents e os dados de device\_scan no objeto ***source***. Neste [link](https://docs.qitech.com.br/documentation/caas/onboarding/natural_person) da documentação, existe um exemplo de request body com todos esses pontos preenchidos.

**💬 Dúvidas frequentes:**

- O session\_id da chamada na device\_scan é definido por você e deve ser o mesmo enviado no POST da Onboarding;
- No fluxograma, a segunda chamada na device\_scan é apenas para garantir um retorno caso haja falha na primeira tentativa;
- A OCR vai sempre retornar uma ocr\_key para cada template de imagem do documento enviado, ou seja, se for enviado uma imagem de cnh\_front e outra de cnh\_back, serão necessárias duas chamadas na OCR, cada uma retornará a ocr\_key relativa àquele template. Na construção do payload de Onboarding, é preciso diferenciar a ocr\_key, de acordo com o template do qual ela foi obtida (assim como consta o exemplo na documentação);
- Outra opção, além de usar as SDKs embedadas em sua aplicação, é chamá-las via API para realização do POST das imagens previamente obtidas por você, nesse caso, basta seguir as recomendações via API da documentação, caso contrário, ao chamá-las em seu código para que o usuário as utilize, via android, web ou iOS, os retornos serão dados logo após os inputs do usuário (tirar as fotos);
- Caso tenha dúvidas sobre como incluir o código das SDKs em sua aplicação, temos algumas *bridges* desenvolvidas em **React Native**, **Flutter**, **Capacitor**, **Ionic** e **iOS** para te auxiliar. Para ter acesso a essas *bridges*, basta entrar em contato com o nosso suporte.

Ficou com dúvidas? É só enviar um e-mail para **suporte.caas@qitech.com.br** que te ajudamos!

O que achou do artigo? **Deixe seu feedback abaixo 👇**

- [Antifraude e Análise de riscos](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#main-content)

    - [Overview geral da plataforma](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#overview-geral-da-plataforma)
    - [Onboarding](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#onboarding)
    - [Motor de Crédito](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#motor-de-cr%C3%A9dito)
    - [Transacional](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#transacional)
    - [Motor de Regras](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#motor-de-regras)
    - [Exemplos de Regras na prática](https://lp.qitech.com.br/pt-br/help-center-qi-tech/antifraude-e-an%C3%A1lise-de-riscos?hsLang=pt-br#exemplos-de-regras-na-pr%C3%A1tica)
- [Certificadora](https://lp.qitech.com.br/pt-br/help-center-qi-tech/certificadora?hsLang=pt-br#main-content)

    - [Portal FIDC](https://lp.qitech.com.br/pt-br/help-center-qi-tech/certificadora?hsLang=pt-br#portal-fidc)
- [Assinatura](https://lp.qitech.com.br/pt-br/help-center-qi-tech/assinatura?hsLang=pt-br#main-content)

    - [Antifraude](https://lp.qitech.com.br/pt-br/help-center-qi-tech/assinatura?hsLang=pt-br#antifraude)
- [Plataformas](https://lp.qitech.com.br/pt-br/help-center-qi-tech/plataformas?hsLang=pt-br#main-content)

    - [Internet Banking - White Label](https://lp.qitech.com.br/pt-br/help-center-qi-tech/plataformas?hsLang=pt-br#internet-banking-white-label)
    - [Backoffice - White Label](https://lp.qitech.com.br/pt-br/help-center-qi-tech/plataformas?hsLang=pt-br#backoffice-white-label)
- [Emissão](https://lp.qitech.com.br/pt-br/help-center-qi-tech/emiss%C3%A3o?hsLang=pt-br#main-content)

    - [FGTS](https://lp.qitech.com.br/pt-br/help-center-qi-tech/emiss%C3%A3o?hsLang=pt-br#fgts)
- [Casos de uso](https://lp.qitech.com.br/pt-br/help-center-qi-tech/casos-de-uso?hsLang=pt-br#main-content)

    - [Risk Solutions](https://lp.qitech.com.br/pt-br/help-center-qi-tech/casos-de-uso?hsLang=pt-br#risk-solutions)
- [Novidades de Produto](https://lp.qitech.com.br/pt-br/help-center-qi-tech/novidades-de-produto?hsLang=pt-br#main-content)

    - [Atualizações das Integrações Híbridas](https://lp.qitech.com.br/pt-br/help-center-qi-tech/novidades-de-produto?hsLang=pt-br#atualiza%C3%A7%C3%B5es-das-integra%C3%A7%C3%B5es-h%C3%ADbridas)
    - [Atualizações das SDKs](https://lp.qitech.com.br/pt-br/help-center-qi-tech/novidades-de-produto?hsLang=pt-br#atualiza%C3%A7%C3%B5es-das-sdks)
    - [Novidades na plataforma Risk Solutions](https://lp.qitech.com.br/pt-br/help-center-qi-tech/novidades-de-produto?hsLang=pt-br#novidades-na-plataforma-risk-solutions)
- [Perguntas frequentes](https://lp.qitech.com.br/pt-br/help-center-qi-tech/perguntas-frequentes?hsLang=pt-br)

[![Chill listening crop-3](https://lp.qitech.com.br/hs-fs/hubfs/Logo_QI_Tech_RGB_versao_horizontal_azulescuro-2.png?width=125&height=24&name=Logo_QI_Tech_RGB_versao_horizontal_azulescuro-2.png "Chill listening crop-3")](http://qitech.com.br)

Tudo o que você precisa para oferecer serviços financeiros

<https://www.instagram.com/qitech/> <https://www.linkedin.com/company/qi-tech/posts/?feedView=all> <https://www.youtube.com/@qitechoficial/videos>

Copyright © 2026, As comunicações oficiais da QI Tech são realizadas exclusivamente pelos domínios qitech.com.br, qitech.co e qitech.blog.