Configuração do Tenant

O comportamento da verificação é configurado por tenant pela Inyo. Esta página é a referência do que você pode solicitar — no onboarding, ou como alteração posterior. Não há API de configuração self-service; envie ao seu contato na Inyo as configurações desejadas.

Atualizações de configuração são mescladas ao que já está armazenado, portanto pedir a alteração de uma configuração deixa as demais intactas. Retornar uma configuração ao padrão da plataforma é uma solicitação explícita, não uma omissão.

Cada configuração é nomeada pela chave exata que definimos no seu tenant. Citar a chave em uma solicitação elimina qualquer ambiguidade sobre qual comportamento você quer dizer — várias têm nomes parecidos, e review_threshold e review_verification_declines, em particular, fazem coisas muito diferentes.

A maioria das chaves fica dentro do objeto config do seu tenant, mas webhook_url e branding ficam fora dele, como irmãos de config — marcados abaixo e visíveis no payload de exemplo.

Documentos e Jurisdições

Por exemplo:

{
  "passport": ["SA", "USA"],
  "drivers_license": ["NA"]
}

Esse exemplo aceita passaportes de qualquer país sul-americano mais os EUA, e carteiras de motorista da América do Norte. Omitir um tipo de documento aceita todas as jurisdições para ele.

Restrinja com critério. Limitar tipos de documento simplifica o tratamento de dados a jusante, mas cada restrição é um cliente que não consegue concluir o onboarding com o documento que possui.

Limiares de Decisão

Aumentar o limiar de face-match reduz falsas aceitações e aumenta falsas rejeições — clientes reais sendo recusados. Ambos os limiares são informados no detail da verificação relevante em cada resultado, para que sua integração possa ler o valor efetivo em vez de codificá-lo fixamente.

Roteamento de Revisão

Ambos são explicados em detalhe — incluindo quais verificações contam para a confiança, e por que um limiar igual ou abaixo do seu limiar de face-match nunca pode disparar — em Revisão Manual. Um limiar nessa faixa inerte é rejeitado no momento da configuração em vez de aceito silenciosamente.

Ativar rejeições retidas gera trabalho de analista sem limite de fila. Ative quando um declínio falso for mais custoso que uma decisão atrasada.

Comportamento de Captura

Opções de Enriquecimento

Cada uma delas adiciona sinal a um custo por verificação. Duas ficam desativadas por padrão justamente por isso, e uma acarreta uma obrigação de conformidade.

Descrições de aparência são dados pessoais sensíveis. Elas carregam exposição a GDPR e a leis de privacidade biométrica (por exemplo, BIPA), e a selfie é processada por um serviço de visão externo. Confirme que você tem base legal, um acordo de processamento de dados em vigor e uma justificativa de retenção documentada antes de nos pedir para ativar isso.

Entrega e Apresentação

branding é um objeto próprio:

As cores devem ser hex completo de 6 dígitos — a forma abreviada de 3 dígitos (#0F7) e a de 8 dígitos com alfa (#0F766E80) são rejeitadas.

O rodapé "Powered by Inyo 360" sempre é renderizado e intencionalmente não é configurável.

Os textos do widget — rótulos, botões, telas de resultado, feedback de nova tentativa — são servidos a partir do repositório de textos da Inyo em vez de embutidos no frontend, então alterações de redação por tenant e idiomas adicionais não exigem uma release do seu lado. Inglês, português e espanhol são fornecidos completos; qualquer outro código xx ou xx-XX é aceito, com strings não traduzidas recorrendo individualmente ao inglês.

Uma Configuração Inicial

Se você está em onboarding agora e não sabe o que pedir, esta é uma linha de base sensata para onboarding de consumidores:

Depois, revisite limiares e roteamento de revisão com dados reais, e não no momento da integração.

Enviando-nos uma Configuração

Citar as chaves diretamente é a forma menos ambígua de fazer uma solicitação. Este é o formato que aplicamos ao seu tenant, e ele mostra o aninhamento: webhook_url e branding são irmãos de config, não membros dele.

{
  "webhook_url": "https://acme.example.com/kyc-result",
  "branding": {
    "company_name": "Acme Bank",
    "logo_url": "https://acme.example.com/logo.png",
    "color_primary": "#0F766E",
    "color_background": "#FFFFFF",
    "color_text": "#111827"
  },
  "config": {
    "default_language": "pt-BR",
    "allowed_document_types": ["passport", "drivers_license"],
    "accepted_jurisdictions": {
      "passport": ["SA", "USA"],
      "drivers_license": ["NA"]
    },
    "allow_file_upload": false,
    "max_capture_attempts": 3,
    "review_verification_declines": true
  }
}

Inclua apenas as chaves que quer definir — tudo o que for omitido mantém o valor atual, já que as atualizações são mescladas, não substituídas.

Próximos Passos

• Revisão Manual — limiar de revisão e rejeições retidas em profundidade
• Verificações e Decisões — quais verificações cada configuração afeta
• Entrega do Widget — como identidade visual e idioma aparecem para o cliente