Crie uma política de risco

O que ele faz

O Designer de políticas de fluxo de trabalho permite que você decida como uma verificação é aprovada, rejeitada ou enviada para revisão manual — de forma visual, sem código. Você arrasta blocos de regras para uma tela, define condições sobre os sinais que cada verificação produz (pontuação de confiança, correspondência em sanções, verificações do documento, país do solicitante, risco de rede, prova de câmera ao vivo e mais) e as conecta aos resultados Aprovar, Rejeitar, Encaminhar para revisão ou Exigir verificação ao vivo.

Toda organização começa com uma política padrão integrada que reproduz exatamente a decisão padrão do Certivant com pontuação de confiança de 17 fatores. Portanto, ativar o recurso não muda nada até que você decida personalizá-lo — seus resultados atuais continuam idênticos.

Antes de começar

• Seu plano precisa incluir o Designer de políticas de fluxo de trabalho (Pro ou superior). Se o item Políticas de fluxo de trabalho no menu Desenvolvedor mostrar um selo “Requer Pro”, peça ao proprietário da sua conta que faça o upgrade — veja Faturamento e créditos.
• Você deve entender como uma verificação é pontuada, para saber quais sinais usar nas suas regras. Veja Revise as solicitações de verificação.
• Publicar uma política muda a forma como as verificações futuras são decididas em toda a sua organização. Ela não decide novamente as solicitações anteriores.

Conceitos principais

• Nós — os blocos na tela. Um nó Início começa o fluxo; os nós Condição guardam as regras; os nós Fim são os resultados (Aprovado / Rejeitado / Encaminhado / Revisão manual / Exigir verificação ao vivo / Transferir para outra política). Os nós de ação (Formulário, Validação de ID, E-mail, SMS, Webhook, Conferência ao vivo) documentam etapas de orquestração em torno da decisão — para executar etapas, use os Fluxos de automação.
• Condições — um nó Condição testa os sinais da verificação, por exemplo overallScore >= 75, sanctions.isMatch = true, applicant.country IN ["IR","KP","SY"] ou redFlags CONTAINS "network_vpn_detected". Você pode combinar testes com AND / OR / NOT e aninhar grupos — inclusive condições encadeadas após outras condições na tela.
• A primeira correspondência vence — as regras são avaliadas de cima para baixo a partir do Início; a primeira Condição cujo teste for verdadeiro fornece a decisão. Uma saída final captura todo o resto (ela falha de forma segura para Encaminhar para revisão, nunca para uma aprovação silenciosa).
• Motivos — dê a uma condição um motivo (por exemplo, "País de alto risco"). Ele é registrado junto com a decisão, de modo que o revisor vê por que a solicitação foi encaminhada, e não apenas qual regra foi acionada.
• Versões — toda política salva é um rascunho até que você a publique. Publicar congela essa versão (ela se torna imutável) e a torna ativa; a versão anteriormente ativa dessa política é arquivada. Para alterar uma política publicada, clique em Nova versão — assim você sempre tem um histórico completo e auditável.
• Onde ela se aplica — uma política publicada decide as solicitações de todo formulário que a fixa. Defina uma política como padrão da organização para que ela decida todas as outras solicitações também, inclusive as criadas pela API. Sem nenhuma das duas, vale o padrão integrado do Certivant.

Passo a passo

O que aciona a sua política

Uma política de fluxo de trabalho é executada automaticamente — não existe um botão "executar" separado, e você não a aciona manualmente. Duas coisas a armam e a disparam:

1. Publicar a arma. Quando você publica uma política, essa versão se torna ativa (uma versão ativa por política; publicar arquiva a anterior). Ela decide as solicitações de todo formulário que a fixa — e de todas as outras solicitações também, quando você a define como padrão da organização.
2. Cada nova verificação a dispara. Sempre que uma verificação é executada — um solicitante envia seus documentos, você envia uma solicitação de verificação ou um revisor clica em Verificar novamente — o Certivant executa todo o pipeline de verificações (OCR, biometria, sanções, fraude, rede e captura, a pontuação de confiança de 17 fatores) e depois entrega os resultados à política decisória. O veredito da política (Aprovar / Rejeitar / Encaminhar para revisão / Exigir verificação ao vivo) passa a ser o status final da solicitação.

Qual política decide uma solicitação, em ordem:

1. a política que o formulário fixa;
2. caso contrário, a política padrão da organização;
3. caso contrário, o padrão integrado do Certivant.

Uma política fixada ou padrão sem versão ativa (por exemplo, você a arquivou) recorre ao padrão integrado — nunca a alguma outra política.

flowchart LR
    A[Applicant submits<br/>verification] --> B[Checks run:<br/>OCR · biometrics ·<br/>sanctions · fraud]
    B --> C[17-factor<br/>trust score]
    C --> D{Active policy<br/>evaluates the<br/>score + signals}
    D -->|first matching rule| E[Approve]
    D --> F[Reject]
    D --> G[Escalate to<br/>manual review]

Como isso muda as suas verificações

Depois que você publica, toda nova verificação é decidida pela sua política ativa em vez do padrão integrado. Para cada solicitação, o Certivant registra:

• o id, o nome e a versão da política que a decidiu, e
• a lista de regras que foram acionadas —

tanto na trilha de auditoria da solicitação quanto no payload do webhook (data.policy em kyc.request.approved / rejected / escalated). Isso permite que seus sistemas downstream vejam qual política e quais regras motivaram cada decisão. Veja Webhooks.

Quando uma proteção posterior altera o resultado da política — uma solicitação KYB que ainda aguarda a consulta ao registro, ou uma solicitação em modo de teste —, a trilha de auditoria registra essa substituição e o status final, de modo que a trilha nunca mostra uma decisão que não prevaleceu.

Exigir verificação ao vivo

Escolha Exigir verificação ao vivo como resultado de um nó Fim para enviar uma solicitação a uma chamada de vídeo em vez de decidi-la apenas pelos documentos — por exemplo, quando a pontuação está no limite, o solicitante está em uma VPN ou não ficou comprovado que a selfie veio da câmera ao vivo:

overallScore >= 60 AND overallScore < 80 → Require live verification
network.vpn = true OR capture.tokenMismatch = true → Require live verification

A solicitação vai para Encaminhado, e a página dela mostra um banner Verificação de identidade ao vivo necessária com o motivo da regra, para que a sua equipe saiba que deve agendar a chamada. O webhook traz data.policy.decision = "live_verification" e liveVerificationRequired: true.

Para agendar a chamada automaticamente, adicione um Fluxo de automação no gatilho Verificação ao vivo necessária com a ação Agendar uma verificação de identidade ao vivo. Quando o anfitrião registra uma decisão na chamada, a solicitação é aprovada ou rejeitada e os eventos habituais de aprovação / rejeição são disparados. Ao verificar novamente depois, a política pode ler o resultado da chamada — por exemplo, liveVerification.hostDecision = "approved" — de modo que uma regra pode aprovar uma solicitação que passou na verificação ao vivo.

Sinais que você pode testar

Além da pontuação de confiança e dos resultados de cada verificação (checks.*, sanctions.*, document.*, applicant.*), uma condição pode ler:

Um campo que a solicitação não tem (nenhuma chamada realizada, nenhum código de barras lido…) nunca corresponde — nem mesmo com !=, NOT IN ou NOT CONTAINS. Assim, document.issuingCountry != "US" é falso quando nenhum documento foi lido, em vez de ser verdadeiro sem aviso.

Opções e campos

Solução de problemas

Não vejo "Políticas de fluxo de trabalho" no menu

Ele fica no menu Desenvolvedor e é um recurso Pro. Se o item Políticas de fluxo de trabalho mostrar um selo “Requer Pro”, seu plano não o inclui — peça ao proprietário que faça o upgrade em Faturamento e créditos. Se o menu Desenvolvedor não aparecer de jeito nenhum, você pode não ser administrador/proprietário; se o item simplesmente sumiu, atualize a página — a verificação do plano fica em cache por alguns minutos.

Não consigo editar uma política — os campos estão bloqueados

As versões publicadas são imutáveis por design. Abra a versão e clique em Nova versão na barra de ferramentas: ela copia a política para o próximo rascunho editável. Faça suas alterações e publique — a versão anterior continua decidindo até que você o faça.

O botão Simular está desabilitado

O Simular exige que a política tenha sido salva uma vez. Clique em Salvar rascunho; a partir daí, o Simular executa o que está na tela, incluindo edições não salvas.

Minha política publicada não decide nada

Uma política publicada decide apenas as solicitações dos formulários que a fixam. Fixe-a no formulário (configurações do formulário → Política de decisão) ou clique em Usar para todas as solicitações no editor para torná-la o padrão da organização.

Uma solicitação foi encaminhada com "Verificação de identidade ao vivo necessária"

Sua política correspondeu a uma regra Exigir verificação ao vivo — o banner na solicitação mostra o motivo da regra. Agende uma chamada ao vivo pela página da solicitação ou automatize isso com um fluxo de trabalho (veja Exigir verificação ao vivo).

Uma condição mostra um selo vermelho de "inválida"

A expressão não pôde ser interpretada. Abra a condição, confira o nome do campo e o operador e verifique se os valores de lista estão separados por vírgulas. A aba DSL bruta mostra a mensagem exata do analisador.

Como aciono meu fluxo de trabalho / quando ele é executado?

Você não o aciona manualmente. Depois de publicado e fixado em um formulário (ou definido como padrão da organização), ele é executado automaticamente em cada nova verificação que ele cobre — quando um solicitante envia documentos, quando você envia uma solicitação de verificação ou quando um revisor clica em Verificar novamente. Veja O que aciona a sua política.

Publiquei, mas parece que nada acontece

Há três causas comuns. Primeira: uma política só decide as verificações executadas depois que ela se tornou ativa — as solicitações existentes e já concluídas não são afetadas (veja abaixo). Inicie uma nova verificação (ou use Verificar novamente em uma existente) para ver sua política decidi-la. Segunda: confirme que a versão que você editou realmente mostra o status ativa na tabela do painel — salvar um rascunho não o ativa; é preciso Publicar. Terceira: verifique se o formulário da solicitação fixa a política, ou se a política é o padrão da organização.

A publicação não mudou nada para uma solicitação em andamento

As políticas decidem apenas verificações novas. Uma solicitação que já foi enviada mantém a decisão tomada pela política ativa na época. Execute-a novamente somente se pretende decidi-la de novo — abra a solicitação e use Verificar novamente.

Histórico de versões, restauração e testes A/B

Cada salvamento de uma política publicada inicia uma nova versão em rascunho; Publicar a congela como uma versão imutável e arquiva a que ela substitui. Cada decisão registra o id e a versão exatos da política que a tomou (na solicitação, no registro de auditoria e no bloco policy do payload do webhook), de modo que você sempre pode ver qual versão decidiu uma verificação.

Clique em Versões e teste A/B no cabeçalho do editor para:

• Ver todas as versões da política — rascunho, ativa e arquivada — e abrir qualquer uma delas somente para leitura.
• Restaurar como novo rascunho — copia uma versão mais antiga para um novo rascunho com o mesmo nome. Publique-o quando quiser que entre em produção. Nada do que foi publicado é alterado.
• Executar um teste A/B — compare a versão ativa (variante A) com um desafiante (variante B, um rascunho ou uma versão mais antiga da mesma política). Escolha a parcela das verificações novas que vai para B (0–100%); o restante permanece em A. A divisão é automática e estável: uma verificação sempre cai na mesma variante, mesmo que seja executada novamente.

Enquanto um teste está em andamento, o rascunho desafiante fica congelado (editá-lo invalidaria a comparação). A tabela de Resultados mostra, por variante, quantas verificações foram direcionadas, a parcela aprovada, rejeitada e encaminhada, e quantas chegaram a uma decisão. A comparação da taxa de aprovação só indica "significativa" depois que cada variante tem pelo menos 30 verificações decididas. Para adotar B, publique o desafiante — o teste termina automaticamente. Para abandoná-lo, clique em Interromper teste; toda nova verificação volta para a versão ativa.

Relacionados

• Revise as solicitações de verificação — os sinais que suas regras testam vêm daqui.
• Webhooks — o bloco policy adicionado aos eventos de decisão.
• Fluxos de automação — reaja à decisão: agende a chamada ao vivo, notifique, direcione.
• Verificação de identidade ao vivo — a chamada de vídeo que uma regra Exigir verificação ao vivo solicita.
• Faturamento e créditos — faça o upgrade para liberar o Designer de políticas de fluxo de trabalho.