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…