Um fluxo. Uma decisão. Controle total.
O Zoi ID reúne checagem de documentos, prova de vida, triagem e análise especializada e devolve uma resposta clara. Você decide quais dados recebe e quando as pessoas são checadas de novo.
Decisão
decision.rule
- auto_approve_nfcses_8f3kq2v7Aprovado
- auto_approve_walletses_2m9ta4xeAprovado
- auto_resubmit:livenessses_7hc1p0wdReenvio
- review:sanctionsses_4qz8n3rbEm análise
- auto_reject_underageses_9xv5e6ktRejeitado
Conecta direto ao seu produto
Seu backend inicia uma sessão. O usuário conclui o fluxo no seu app ou no navegador. Você recebe um webhook assinado com o resultado.
Hospedado na Alemanha (UE)
O motor de decisão
Toda sessão termina em um de quatro resultados claros. O motivo fica guardado com o caso, e o usuário sempre pode pedir que uma pessoa olhe de novo.
- Aprovado
Todas as checagens obrigatórias passaram com evidência forte.
- Reenviar
Algo não serviu, como uma foto borrada. O usuário refaz só esse passo.
- Rejeitado
Um fato claro exclui a pessoa, como ser menor de idade ou usar um documento que já está em outra conta.
- Análise
Algo exige julgamento. Um analista treinado decide, e possíveis correspondências de sanções passam por dois.
Confiança que se adapta ao canal
Evidências de um app verificado num aparelho genuíno valem mais. Sessões vindas da web ou de aparelhos que não conseguem se comprovar precisam passar por uma exigência maior. Sessões de risco sempre passam por uma pessoa.
Você escolhe o que recebe
Cada parceiro recebe um conjunto de permissões (scopes). Os dados de uma permissão que você não tem nunca são enviados.
| Permissão | O que você recebe |
|---|---|
eligibility | Sempre incluída. Status, nível, válido até e se a pessoa é maior de 18. |
country | Tipo de documento, país emissor, nacionalidade e país de residência. |
birth_year | Ano de nascimento. |
duplicate_link | Em caso de duplicata, o seu próprio identificador de usuário da conta anterior. Só para recuperar contas. |
identity_data | Nome completo e data de nascimento. Só para parceiros com obrigação legal de guardá-los. |
address | As linhas do endereço verificado. Sem ela, você ainda recebe o resultado do endereço: método, nível de evidência e país. |
financial_data | Respostas sobre origem de recursos e patrimônio, detalhes dos documentos e apontamentos. Nunca faz parte da elegibilidade. |
Dois níveis
Padrão
Documento, prova de vida e país de residência.
Ampliado
Tudo do padrão, mais o endereço residencial completo.
Checagens adicionais
Adicione comprovação de endereço ou origem de recursos e patrimônio a qualquer sessão, ou rode depois para um usuário já verificado.
Como funciona a integração
- 1
Crie uma sessão
Seu backend chama a API de parceiros com a sua chave e o seu próprio identificador de usuário. Você recebe um token de cliente de curta duração.
- 2
Rode o fluxo
Use o SDK para React Native no seu app ou envie os usuários para o fluxo hospedado. Nos dois casos, as mesmas checagens rodam.
- 3
Receba webhooks
Enviamos webhooks assinados quando uma sessão ou identidade muda. Perdeu algum? Leia o feed de eventos.
- 4
Use a resposta
Guarde o identificador da identidade e o seu status. Reaja a mudanças como suspensa ou vencida.
Uma identidade sempre atual
Uma verificação não é um evento único. Cada identidade tem um status em que seu backend pode confiar e uma data em que precisa ser checada de novo.
- Ativa
active
Verificada e pronta para uso.
- Suspensa
suspended
Em espera após um novo candidato da triagem ou um sinal de fraude, até que os analistas decidam.
- Expirada
expired
O documento venceu ou passaram 36 meses. Uma nova sessão verifica de novo e mantém o mesmo identificador de identidade quando a pessoa confere.
- Revogada
revoked
Encerrada de vez, por exemplo depois que a pessoa retirou o consentimento.
Válido até é a data de validade do documento ou 36 meses após a verificação, o que vier primeiro.
Quem é responsável pelo quê
Você continua no controle dos dados dos seus usuários. O Zoi ID os trata para você sob um acordo de tratamento de dados. Quando um usuário encerra a conta, uma chamada à API apaga os dados dele, e a resposta diz o que precisamos guardar por lei e até quando.
Uma pessoa real por trás de cada conta
O Zoi ID chega em breve. Parceiros com acesso antecipado recebem chaves de sandbox, contato direto com nossa equipe e uma configuração feita para os seus mercados.
Ou escreva para official@zoi.network