Conheça a linha por trás do número do cadastro
Em breve A venda deste módulo está em preparação: ele ainda não entra num flow.
Receber o código por SMS prova que a pessoa tem o celular na mão naquele minuto. Não conta se a linha é um número virtual comprado para a ocasião, um chip pré-pago descartável ou uma linha já usada em golpe. Este módulo conta a história da linha que acabou de ser confirmada.
Reputação e atributos da linha do número informado: se está ativa, o tipo de linha, a operadora, se é linha virtual, se é pré-paga e o histórico recente de abuso. Exige a Validação de telefone por SMS no mesmo flow, porque o número analisado é o que já teve posse confirmada. Confirma a linha, não a pessoa: não substitui a prova de posse por SMS nem a biometria, e nunca reprova sozinho.
- Risco de telefoneEm breve
"status": "approved"Para quem é
Serve a quem usa o celular como chave da conta: bancos digitais, carteiras, aplicativos de transporte e entrega, operadoras de benefício e varejo com crediário. Quando o telefone recupera senha e recebe código de transação, uma linha virtual ou recém-ativada no cadastro é o primeiro passo de uma tomada de conta futura.
Serve também a quem paga por cadastro novo e vê números em série de operadoras virtuais. A classe da linha e o histórico de abuso separam o cliente com o chip de sempre do cadastro feito com número de aluguel.
Times de cobrança e atendimento também se beneficiam: saber que a linha é fixa, virtual ou estrangeira antes do primeiro contato evita discador em número que nunca atende e mostra quando o canal de voz não serve para aquele cliente.
O que você recebe
O retorno traz valid, active, line_class em vocabulário fechado, de mobile e landline a voip e premium, carrier com a operadora, voip, prepaid, recent_abuse e high_risk. risk_score, level e reasons resumem o quadro para a sua política, e country_code diz de que país é a linha.
O número completo não trafega: vão a máscara e o phone_fp, o mesmo pseudônimo que a confirmação por SMS publica para aquele número, para você cruzar os dois sem guardar o dado em claro. Sem resposta da consulta, o módulo defere, mantém máscara, pseudônimo e país, marca provider_unavailable e sai da cobrança.
high_risk resume em sim ou não o que a sua fila precisa saber primeiro, e reasons detalha códigos como phone_voip e phone_recent_abuse, para quem prefere montar filtro próprio por tipo de ocorrência e acompanhar tendência por canal de aquisição.
Os módulos de risco de IP, de e-mail e de telefone avaliam o contexto da verificação e levam para revisão com a evidência no webhook.
O módulo se chama telefone_risco no flow e no webhook.
Como entra no seu flow
Exige o código por SMS no mesmo flow, e a exigência tem motivo: o número analisado é o que o titular acabou de provar que controla, nunca um campo solto que qualquer um preencheria com o telefone de outra pessoa.
Guarde phone_fp junto do cadastro: com ele, sem armazenar o número, o seu time percebe quando o mesmo telefone reaparece em outra conta, e a Detecção de Rede de Fraude usa o contato como uma das pontes entre titulares.
Na régua, combine line_class com recent_abuse: uma linha móvel sem histórico ruim sustenta um limite inicial mais generoso, e uma linha virtual com abuso recente sugere começar pequeno e ampliar conforme o relacionamento amadurece.
O grupo do módulo
Sinais de risco da sessão, sem passo novo para o usuário.
Preço
-por verificaçãoEm breve
A venda está em preparação e o valor acima é o de catálogo. Módulo marcado como "Em breve" não está à venda e não pode ser adicionado a um flow hoje.
O valor é lido do mesmo catálogo que o painel usa para montar um flow, somando os módulos que este exige, se exigir. Ver preços.
Perguntas frequentes
Ler a documentaçãoLinha pré-paga reprova o cadastro?
Não. Linha pré-paga é comum entre clientes legítimos, e um sinal alto aqui leva o caso para revisão com a evidência no webhook, nunca para recusa automática. O que fazer com cada combinação é escolha da sua política.
Isso substitui a biometria?
Não. O módulo confirma a linha, não a pessoa. Quem diz quem é o titular é o documento com a comparação facial e a prova de vida; este diz se o telefone que ele usa merece confiança como canal da conta.
Como vejo uma linha de risco no sandbox?
Pelo sufixo do documento: 33 devolve abuso recente, 44 linha VOIP e 55 número fora da faixa atribuída. O dado muda conforme o sufixo, e o desfecho segue a tabela geral do ambiente de testes.
Que operadora aparece no retorno?
O nome da operadora que atende a linha, em carrier, junto do código do país. Com ele o seu time distingue a operadora tradicional da operadora virtual que revende linha, informação útil quando o mesmo cadastro aparece com vários números.

Crie a conta, monte um flow com os módulos que já estão à venda e rode a verificação inteira no ambiente de teste, sem consumir saldo.

