Integração ONP

Visão geral

A Onboarding Platform (ONP) é o módulo da Suíte Guardline responsável por conduzir jornadas de onboarding de clientes. A integração com a ONP permite que o sistema da instituição inicie jornadas de forma programática, acompanhe o progresso e receba o resultado final com score e decisão.

Fluxo de integração

O fluxo típico de integração com a ONP segue estas etapas:

1. O sistema da instituição solicita a criação de um onboarding, informando os dados iniciais do cliente.
2. A ONP retorna um identificador e uma URL de jornada para o cliente.
3. O cliente percorre a jornada (captura de documentos, biometria, preenchimento de dados).
4. A ONP aciona os parceiros de verificação configurados para a jornada (documentoscopia, liveness, facematch, antecedentes, entre outros).
5. Com os resultados das verificações, o motor de scoring calcula a pontuação e aplica as regras definidas pela instituição.
6. A ONP notifica o sistema da instituição sobre a conclusão via webhook.
7. O sistema da instituição consulta o resultado (status, score, decisão).

Tipos de jornada

A ONP suporta três tipos de jornada de onboarding:

• kyc: verificação de identidade para pessoas físicas (adultos). Inclui coleta de dados pessoais, captura de documentos, biometria facial e análise de risco.
• kyb: verificação empresarial para pessoas jurídicas. Inclui validação societária, identificação de beneficiários finais e verificação de representantes legais.
• kyc_minor: verificação para menores de idade (14 a 17 anos) com representante legal. O menor completa a jornada primeiro, e em seguida o representante legal recebe um link via SMS ou WhatsApp para completar uma verificação simplificada. A decisão final considera os dados de ambos.

Verificações e parceiros

A ONP aciona parceiros de verificação de acordo com a configuração da jornada. Cada jornada pode incluir combinações diferentes de verificações (biometria facial, documentoscopia, liveness, facematch, device fingerprint, antecedentes, OCR) conforme a política da instituição.

Quando uma verificação falha ou o parceiro está indisponível, a plataforma aplica um mecanismo de fallback com três níveis:

• Retry automático: a requisição é reenviada ao mesmo parceiro após intervalo configurável.
• Parceiro alternativo: se o retry falhar, a verificação é redirecionada para um parceiro equivalente pré-configurado.
• Aprovação condicional: se nenhum parceiro responder, o onboarding pode ser encaminhado para mesa de análise com status condicional, evitando bloqueio do fluxo.

Mais detalhes sobre a arquitetura de conectores estão na página de parceiros e conectores.

Notificações

A instituição recebe notificações via webhook sobre os principais eventos do ciclo de vida de um onboarding: início da jornada, conclusão de etapas, resultado de verificações, decisão final e expiração. A configuração de quais eventos receber é feita durante o setup da integração.

Todas as notificações incluem assinatura HMAC para validação de autenticidade, conforme descrito nos conceitos de integração.