Tovanix
Tovanix

Usar verificação e risco de transações

Verificação e risco de transações serve para verificar seus clientes e as transações deles, com cobrança por verificação no saldo da conta:

  • Seis tipos de verificação: verificação individual, verificação empresarial, monitoramento de transações, análise de carteira, triagem AML e risco no cadastro
  • Clique em “Ativar” no Painel para começar; a ativação é gratuita, sem mensalidade e sem consumo mínimo
  • Solicitações não aceitas ou com falha confirmada pela verificação do sistema são reembolsadas automaticamente; verificações expiradas ou que já têm resultado não são reembolsadas
  • O Histórico de verificações permite filtrar, buscar e exportar, e os detalhes mostram os resultados de cada etapa e o status da cobrança
  • Você pode configurar callbacks de resultado ou usar uma chave de API da plataforma para iniciar verificações pelo seu próprio sistema

O que este serviço faz

Verificação e risco de transações serve para verificar seus clientes e as transações deles: fazer a verificação de identidade de pessoas ou empresas, avaliar o risco de uma transação antes ou depois da transferência, analisar endereços de carteira e listas e avaliar o risco do e-mail, do telefone ou do IP no cadastro do cliente.

  • Verificação individual — O titular usa o celular para fotografar o documento e fazer a prova de vida e a correspondência facial.
  • Verificação empresarial — Verifica o registro da empresa, os documentos da empresa e as pessoas-chave.
  • Monitoramento de transações — Separado em transações fiduciárias e de criptomoedas, avalia o risco de uma transação; nas de criptomoedas, também analisa os endereços na blockchain.
  • Análise de carteira — Analisa isoladamente o risco de um endereço de carteira e se ele aparece em listas de sanções.
  • Triagem AML — Busca o nome de uma pessoa ou empresa em listas de PEP, sanções e alertas regulatórios, com resultado na hora.
  • Risco no cadastro — Avalia o risco de um e-mail, telefone ou IP — por exemplo, e-mail descartável, número virtual, VPN e IP de data center.

O resultado é apenas uma referência: a plataforma nunca congela nem recusa fundos automaticamente com base nele. A plataforma guarda só o resultado, a pontuação e as correspondências de cada etapa — não guarda nomes, números de documento nem imagens de documentos. Este serviço não tem ambiente de testes: toda verificação é real e cobrada de verdade.

Ativação

Em Verificação e risco de transações → Painel, clique em “Ativar”. A ativação é gratuita e não exige nenhuma conta ou chave. O cartão de ativação lista o preço de cada tipo de verificação; os tipos marcados como “Ainda indisponível” ainda não podem ser usados.

  • Depois de ativar, você pode configurar, conforme a necessidade, a página de acesso, o callback de resultado e a API aberta em Configurações de integração, como explicado abaixo.
  • Cada verificação é cobrada do saldo da conta; antes de iniciar, confirme que o saldo é suficiente.

Cobrança e reembolso

A cobrança é feita por verificação, com o saldo da conta, sem mensalidade e sem consumo mínimo. O preço unitário aparece no cartão de acesso do Painel, na página de início e na janela de confirmação da cobrança — vale o que a página mostrar; o monitoramento de transações tem dois preços, fiduciário e cripto, e o risco no cadastro tem preços separados para e-mail, telefone e IP.

  • A solicitação não foi aceita — Reembolso automático; o registro mostra “Falhou”.
  • O registro mostra “Verificando resultado” — O sistema verifica automaticamente e faz o reembolso automático se a falha for confirmada.
  • O titular não concluiu, ou a verificação expirou — Sem reembolso.
  • Já há resultado (incluindo “Recusado”, “Em análise” e “Não avaliado”) — Sem reembolso.
  • Nova solicitação para uma referência que ainda tem uma verificação não concluída — Não há nova cobrança; a verificação anterior é aberta diretamente.

A verificação empresarial é acertada em duas etapas: no início, é feita uma cobrança prévia pelo número de beneficiários finais informado na página; quando sai o resultado, o valor é acertado pelo número real de pessoas e pelo país de registro da empresa, com devolução do excedente ou cobrança da diferença. Os detalhes do registro trazem o detalhamento da cobrança.

Iniciar uma verificação de pessoa ou de empresa

  • Informe a referência: Em Verificação e risco de transações → Verificação de identidade → Verificação de pessoa física ou Verificação de empresa, informe a referência única desse titular no seu sistema, ou clique em “Selecionar no diretório”. A referência só pode conter letras, números e . _ : @ + -, ter de 1 a 128 caracteres e começar com letra ou número.
  • Confirme a cobrança: Clique em “Iniciar verificação”, confira o tipo de verificação e o preço unitário na janela de confirmação e clique em “Confirmar e cobrar”.
  • Entregue o link ao titular: A página mostra o link de verificação e um código QR: use “Copiar link” para enviá-lo ao titular ou peça que ele use “Leia com um telefone”. O link serve só para esta verificação e deixa de funcionar quando ela é concluída ou expira.
  • Aguarde o resultado: O titular lê e aceita o aviso e depois faz a coleta no celular. A página mostra o andamento — “Criado em”, “Consentimento fornecido”, “Verificando” e “Resultado” — e se atualiza sozinha.

Ao abrir o link, o titular vê primeiro a página de acesso: quem pediu a verificação e quais documentos ele precisa ler e aceitar. Em Configurações de integração → Página de acesso, você pode definir o nome do solicitante exibido na página (até 60 caracteres) e os links da sua própria política de privacidade e dos seus termos de serviço (os dois links devem ser informados juntos e usar https); as páginas seguintes, de foto do documento e selfie, têm o visual padrão da plataforma.

Análise de transações

Verificação e risco de transações → Análise de transações tem cinco abas. Preencha os dados e clique em “Executar verificação”; a página mostra o relatório da verificação: pontuação de risco, resultado e regras acionadas.

  • Transação fiduciária — Referência e nome da parte, direção (entrada ou saída), valor e moeda. O nome da parte é usado só na análise; a plataforma não o guarda em texto simples.
  • Transação de criptomoedas — Parte, direção, rede e ativo, valor e endereço da contraparte; para entradas já registradas na blockchain, você pode informar o hash da transação e o seu endereço de recebimento. Redes aceitas: TRON, Ethereum, BNB Chain, Polygon, Solana e Bitcoin.
  • Endereço de carteira — Rede e endereço de carteira, para analisar isoladamente o risco desse endereço e as correspondências em listas de sanções.
  • Triagem AML — Pessoa ou empresa e o nome completo ou o nome da empresa; data de nascimento e nacionalidade são opcionais, e informá-las reduz os falsos positivos causados por nomes iguais. A plataforma não guarda esse nome.
  • Risco no cadastro — Um entre e-mail, telefone ou endereço IP. Você pode informar o identificador que deu a esse cliente: se o mesmo e-mail ou número aparecer em outro cliente seu, você é avisado; o registro guarda apenas o valor mascarado.

A análise de carteira, a triagem AML e o risco no cadastro dão o resultado na hora, e consultar de novo gera nova cobrança. Na triagem AML e no risco no cadastro, “Requer revisão” indica uma possível correspondência em listas ou sinais de risco; o resultado não muda mais, e cabe a você avaliar conforme o seu negócio.

Ver os resultados e o histórico de verificações

O Histórico de verificações lista todas as verificações, com filtros por tipo, status e resultado, busca por referência, endereço ou número da cobrança e a opção “Exportar” em CSV conforme os filtros atuais (até 5000 registros). Ao abrir um registro, você vê os resultados de cada etapa, a pontuação de risco, o número da cobrança e o status da cobrança. Em Diretório, as páginas Usuários e Empresas agrupam por referência as verificações que você iniciou.

  • Aceito / Aguardando dados do titular / Processando — A verificação ainda está em andamento.
  • Verificando resultado — O resultado não está claro e o sistema está verificando; se a falha for confirmada, o reembolso é automático.
  • Falhou — A verificação não foi concluída, e a tarifa foi devolvida.
  • Aprovado / Recusado / Em análise — Resultado da verificação. “Em análise” significa que há uma revisão manual em andamento; o resultado pode mudar e é atualizado automaticamente quando ela termina.
  • Não avaliado — Não há dados utilizáveis sobre esse titular, e nenhuma avaliação de risco foi feita — isso não significa que seja seguro.
  • Expirado — O titular não concluiu a verificação dentro do prazo.
  • O reembolso aparece em três lugares: a coluna “Tarifa” do histórico mostra “Reembolsado”, o “Status da cobrança” nos detalhes fica como “Reembolsado”, e as faturas de Finanças têm o registro correspondente do reembolso.
  • As verificações e os gastos do mês no Painel seguem o mês do calendário em UTC e não incluem as verificações reembolsadas.
  • Na verificação individual, na verificação empresarial e no monitoramento de transações, você pode atualizar o resultado nos detalhes do registro; a atualização não é cobrada.

Callbacks de resultado e API aberta

  • Em Configurações de integração → Callback de resultado, informe uma URL de callback https e ative. Quando o status ou o resultado de um registro muda, a plataforma faz um POST com um evento assinado para esse endereço; se a resposta não for 2xx, há novas tentativas com intervalos crescentes, até 8 vezes.
  • O segredo de assinatura só aparece uma vez, no momento em que é gerado. Use-o para verificar o cabeçalho X-Tovanix-Signature: o valor é sha256= seguido do hexadecimal de HMAC-SHA256(segredo de assinatura, timestamp + "." + corpo bruto da requisição), e o timestamp vem em X-Tovanix-Timestamp. Ao clicar em “Gerar um novo segredo”, o segredo antigo deixa de funcionar na hora.
  • Clique em “Enviar evento de teste” para conferir a conexão; “Entregas recentes” mostra o resultado de cada entrega.
  • API aberta: ao criar uma chave em Minha conta → Gerenciamento de APIs, marque a permissão “Verificação e risco” para iniciar verificações e consultar registros a partir do seu próprio sistema. O preço unitário é o mesmo do console, e toda verificação iniciada pela API precisa de uma chave de idempotência.

Diagnóstico

  • Aviso de saldo insuficiente ao iniciar — O saldo da conta não cobre o preço desta verificação — Nada foi cobrado desta vez; recarregue e tente de novo.
  • Aviso, ao iniciar, de que o serviço de verificação recusou a solicitação — A solicitação não foi aceita — A tarifa é devolvida automaticamente, e a coluna “Tarifa” do histórico mostra “Reembolsado”. Confira os dados informados e inicie de novo.
  • O registro continua em “Verificando resultado” — O resultado não está claro, e o sistema continua verificando — Aguarde a verificação automática; se ficar muito tempo sem mudar, fale com o suporte e informe o ID do registro.
  • Ao abrir o link, o titular vê “Link de verificação indisponível” — O link expirou, ou esta verificação já terminou — Inicie uma nova verificação e envie o novo link; iniciar de novo gera nova cobrança.
  • A verificação da assinatura do callback falha — A assinatura não foi calculada com o corpo bruto da requisição, ou o segredo de assinatura foi gerado de novo — Calcule a assinatura com o corpo bruto recebido, sem convertê-lo e serializá-lo de novo antes; depois de gerar um novo segredo, atualize-o também no seu sistema.

Perguntas frequentes

Se a verificação expirar ou o resultado for “Recusado”, a tarifa é devolvida?

Não. A verificação é cobrada no início; se o titular não concluir, se a verificação expirar ou se o resultado for “Recusado”, não há reembolso. O reembolso automático só acontece quando a solicitação não é aceita ou quando a falha é confirmada pela verificação do sistema.

Se o resultado for “Recusado”, a plataforma congela os fundos?

Não. O resultado é apenas uma referência: a plataforma nunca congela nem recusa fundos automaticamente com base nele, e cabe a você decidir se libera a operação.

Posso integrar pela API?

Sim. Crie uma chave em Minha conta → Gerenciamento de APIs e marque a permissão “Verificação e risco”; o callback de resultado é configurado em Configurações de integração.

Páginas relacionadas: Central de Ajuda · Guias e perguntas frequentes · Verificação e risco de transações · API de verificação e risco de transações

Carregando…