Migrar de QI Tech para a UNIFOKAL
O que muda no código
| Ponto | Hoje, em QI Tech | Na UNIFOKAL |
|---|---|---|
| Criação da sessão | POST /onboarding/natural_person (pessoa) ou POST /onboarding/legal_person (empresa), que envia o cadastro para análise.Fonte: docs.qitech.com.br, lida em 26/09/2026 | POST https://api.unifokal.com/v1/verification-sessions, com flow_id e reference_id obrigatórios. O reference_id é a chave de idempotência: repetir a chamada com ele devolve a mesma sessão enquanto ela viver, sem criar a segunda.Na documentação |
| Autenticação da chamada | Authorization com a chave da API, sem prefixo.Fonte: docs.qitech.com.br, lida em 26/09/2026 | Authorization: Bearer com a chave secreta sk_, que fica só no seu servidor.Na documentação |
| Verificação do webhook | Cabeçalho Signature: HMAC-SHA1 com a chave do webhook sobre a URL do endpoint, o método e o corpo, concatenados, em hexadecimal.Fonte: docs.qitech.com.br, lida em 26/09/2026 | Cabeçalho X-IDSAAS-Signature no formato t=<epoch>,v1=<hex>: HMAC-SHA256 do instante e do corpo cru, com janela de 5 minutos contra reenvio de corpo capturado.Na documentação |
| Desfechos | As decisões finais do campo analysis_status.automatically_approvedautomatically_reprovedmanually_approvedmanually_reprovedapproved_by_timereproved_by_timeFonte: docs.qitech.com.br, lida em 26/09/2026 | O status da verificação no corpo do webhook, que é a fonte da verdade.Na documentaçãoapproveddeniedpendingblockedfailedreviewconsent_declined |
A coluna de QI Tech descreve a documentação pública lida na data indicada; ela pode ter mudado desde então. QI Tech é marca do respectivo dono e aparece aqui apenas para identificar o fornecedor.
O passo a passo da troca
Crie a conta, monte o flow com os módulos que você usa hoje e gere a chave de sandbox.
Troque a chamada de criação e mande o seu identificador de cliente como
reference_id.Troque a conferência do webhook pela assinatura HMAC-SHA256 sobre o corpo cru, com a janela de tempo.
Ligue cada desfecho à ação do seu sistema. A decisão vale pelo webhook, nunca pela resposta da criação.
Rode os desfechos no sandbox, com os dois fornecedores de pé, e só então vire a chave de produção.
O que você encontra na chegada
Ambiente de teste completo
O fluxo inteiro roda no sandbox com resultado determinístico, sem consumir saldo, até 500 sessões por mês. Dá para trocar o código com os dois fornecedores de pé.
Reenvio do webhook pela API
GET /webhook-eventsePOST /webhook-events/replay: o seu servidor lista e pede de novo o que perdeu, sem abrir chamado.Preço publicado
O preço de cada módulo está na página de preços, e o de um flow é a soma dos módulos que ele usa.
A comparação capacidade por capacidade está em UNIFOKAL e QI Tech, e os outros guias, em migrar para a UNIFOKAL.
Crie a conta, monte o flow e rode cada desfecho no ambiente de teste, sem consumir saldo e sem falar com vendas.
