API de verificação de telefone por SMS e voz para empresas e desenvolvedores
O ProValidPhone é a camada de confiança do seu cadastro: valida o número brasileiro na hora (DDD, tipo de linha, E.164) e confirma a posse com código OTP por SMS ou por ligação, em quatro chamadas REST. Limites por número e por conta protegem sua fatura contra SMS pumping. Em ativação: o lookup de operadora e portabilidade, para saber a linha antes de gastar um envio.
Criar conta e gerar API key Ler a documentação Ver preços
Teste grátis de 14 dias, com 100 verificações no período de teste. Planos a partir de R$ 49/mês. Validação estrutural nunca consome cota.
Uma verificação, duas camadas, um só contrato
Validação barata antes, verificação de posse depois. Você só paga o envio para números que realmente podem receber o código.
Validação estrutural
DDD, quantidade de dígitos, celular ou fixo e normalização para E.164, em milissegundos e sem consumir cota. Filtre o lixo antes de gastar.
OTP por SMS
Código de 6 dígitos entregue por mensagem, com o nome do seu projeto como remetente. Validade de 5 minutos e até 5 tentativas de conferência.
OTP por ligação com voz
Chamada automática que dita o código. Cobre telefone fixo, celular sem dados e usuários que não conseguem ler o SMS. Mesmo endpoint de conferência.
Limites antifraude
Até 3 envios por hora por número em cada canal (SMS e voz), cota mensal por conta e bloqueio determinístico ao estourar. Sem cobrança surpresa por tráfego inflado.
Como integrar em quatro chamadas
- Autentique com a API key gerada no painel:
Authorization: Bearer pvp_live_… - Valide com
POST /v1/validate. Recebevalid,e164,typeeddd. Não consome cota. - Envie o código com
POST /v1/verify/smsouPOST /v1/verify/call. Recebe oidda sessão. - Confira com
POST /v1/verify/checkpassandoidecode. Recebeverified.
# 1. validar (não consome cota) curl -X POST https://api.provalidphone.com.br/v1/validate \ -H "Authorization: Bearer pvp_live_SUACHAVE" \ -H "Content-Type: application/json" \ -d '{"phone":"(11) 99999-8888"}' # 2. enviar o código por SMS (ou /v1/verify/call) curl -X POST https://api.provalidphone.com.br/v1/verify/sms \ -H "Authorization: Bearer pvp_live_SUACHAVE" \ -H "Content-Type: application/json" \ -d '{"phone":"+5511999998888"}' # 3. conferir o código digitado pelo usuário curl -X POST https://api.provalidphone.com.br/v1/verify/check \ -H "Authorization: Bearer pvp_live_SUACHAVE" \ -H "Content-Type: application/json" \ -d '{"id":"ID_DA_SESSAO","code":"123456"}'
Arquitetura em camadas: comece pelo que não custa nada
O mercado de verificação de telefone se organiza em quatro camadas. O ProValidPhone entrega as duas primeiras hoje, está ativando a terceira e foi desenhado para plugar a última sem reescrever sua integração.
Formato, DDD, tipo de linha, E.164. Regras locais, resposta instantânea.
disponível hojeCódigo por SMS ou ligação com voz confirma que o usuário controla o número.
disponível hojeCamada antifraude antes do OTP: operadora, portabilidade e situação da linha via provedor externo, sob demanda, em POST /v1/lookup com escopo próprio na API key.
Sinais de fraude, SIM swap e vínculo com cadastro para operações sensíveis.
roadmapPara quem o ProValidPhone foi feito
Fintechs e cobrança
Segundo fator por SMS ou voz em login, troca de senha e confirmação de operações. Telefone confirmado antes de qualquer contato de cobrança.
Marketplaces e delivery
Cadastro de compradores, vendedores e entregadores com número real. Menos contas duplicadas, menos entrega perdida por telefone errado.
SaaS e plataformas
Integração em horas com uma API pequena e previsível. API key por hash, erros HTTP claros e o nome do seu produto no código enviado.
Preços transparentes
Planos mensais pré-pagos com franquia de verificações. Você sabe quanto custa cada envio antes de integrar e, ao atingir a franquia, os envios pausam até você trocar de plano ou o ciclo virar. Nenhuma cobrança extra.
Teste
R$ 0
14 dias · 100 verificações no período de teste
Para integrar e avaliar. Nada é cobrado durante o teste.
Starter
R$ 49/mês
300 verificações por mês
≈ R$ 0,16 por verificação
Pro
R$ 149/mês
1.000 verificações por mês
≈ R$ 0,15 por verificação
Business
R$ 399/mês
3.500 verificações por mês
≈ R$ 0,11 por verificação
O que já está no produto e o que vem depois
Disponível hoje
- Validação estrutural de números brasileiros (DDD, tipo, E.164), sem consumir cota
- OTP por SMS e por ligação com voz, com o nome do projeto no envio
- Webhooks de resultado assinados com HMAC-SHA256 (
verification.verified,failed,expired), com reenvio automático e backoff Idempotency-Keypara repetir uma chamada sem enviar dois códigos- API keys guardadas apenas como hash, com revogação e escopos por chave (
validate,sms,callelookup) - Rate limit por número e por conta com
Retry-After, cota mensal e trial como gate determinístico - Código nunca armazenado em claro (hash SHA-256), expiração e limite de tentativas
- Painel com "Verificar número" manual e extrato de uso
- Especificação OpenAPI 3 pública em https://api.provalidphone.com.br/v1/openapi.json, com Redoc em https://api.provalidphone.com.br/v1/docs/
- Preços publicados, com franquia clara e modelo pré-pago
Em ativação e no roadmap público
- Em ativação: Lookup de operadora e portabilidade sob demanda (
POST /v1/lookup), opt-in por escopo da API key, como camada antifraude antes do OTP - Tratamento de números especiais (0800, 3003/4004)
- Identidade e risco: sinais de SIM swap para operações sensíveis
- Canal SMS via agregador para alto volume
Perguntas frequentes sobre a API
O que a API do ProValidPhone faz exatamente?
O fluxo principal usa quatro endpoints REST: validar um número brasileiro (DDD, tipo de linha e E.164), enviar um código OTP por SMS, enviar o mesmo código por ligação com voz e conferir o código digitado. Há ainda GET /v1/verify/status (última verificação de um número na conta) e POST /v1/lookup (operadora e portabilidade, em ativação). A validação e a conferência não consomem cota; os envios consomem.
O que é o lookup de operadora e portabilidade e para que serve?
É uma consulta, sem enviar nada ao usuário, que devolve a operadora atual do número, se ele foi portado (e de qual operadora veio) e a situação da linha reportada pelo provedor. Serve como camada antifraude antes do OTP: você decide se vale gastar um envio de SMS ou ligação e com que regra. Fica em POST /v1/lookup, exige o escopo lookup na API key e não consome a franquia de verificações. Está em ativação e o preço ainda não foi definido; será publicado na página de preços antes da liberação.
Qual a diferença entre o ProValidPhone e um gateway de SMS?
Um gateway só entrega mensagens. O ProValidPhone cuida do fluxo de verificação inteiro: gera o código, guarda apenas o hash, controla expiração e tentativas, aplica limites por número e por conta e oferece a ligação com voz como segundo canal, tudo atrás de uma API pequena.
Como funciona a verificação por ligação com voz?
Ao chamar POST /v1/verify/call, a plataforma disca para o número e dita o código de 6 dígitos em voz. O usuário digita o código no seu sistema e você confere em POST /v1/verify/check, exatamente como no fluxo por SMS. É indicado para telefone fixo e para quando o SMS não é entregue.
Quais limites antifraude estão ativos?
Até 3 envios por hora para o mesmo número em cada canal (SMS e voz), cota mensal de verificações por conta, bloqueio quando o trial expira sem plano ativo, código com validade de 5 minutos e no máximo 5 tentativas de conferência por código. Os limites são aplicados antes de qualquer envio, para não gerar custo.
Como a API é autenticada?
Por API key no header Authorization: Bearer pvp_live_… ou X-API-Key. A chave é mostrada uma única vez ao ser criada no painel e o banco guarda apenas o hash SHA-256. Chaves podem ser revogadas a qualquer momento.
Quanto custa usar o ProValidPhone?
Toda conta começa com 14 dias de teste, com 100 verificações no período de teste e sem cobrança. Depois, planos mensais pré-pagos com franquia: Starter a R$ 49 com 300 verificações, Pro a R$ 149 com 1.000 e Business a R$ 399 com 3.500. SMS ou ligação com voz custam o mesmo, e a validação estrutural e a conferência do código não consomem cota. Ao atingir a franquia, os envios pausam até você trocar de plano ou o ciclo mensal virar, sem cobrança extra. Acima de 3.500 verificações por mês, sob consulta.
Vocês têm webhooks e especificação OpenAPI?
Sim. Você cadastra uma URL e recebe os eventos verification.verified, verification.failed e verification.expired, cada um assinado com HMAC-SHA256 para conferir a origem, com reenvio automático e backoff em caso de falha. A especificação OpenAPI 3 é pública em https://api.provalidphone.com.br/v1/openapi.json e a referência navegável em Redoc fica em https://api.provalidphone.com.br/v1/docs/ para leitura direta no navegador.
Os dados dos meus usuários ficam protegidos?
O código OTP nunca é armazenado em texto claro, apenas um hash, e as sessões expiram. Os números são tratados como dado pessoal, mascarados nos logs, e a plataforma coleta apenas o necessário para validar e confirmar o telefone, em linha com a LGPD.
Posso usar como segundo fator de autenticação (2FA)?
Sim. O mesmo fluxo de enviar e conferir o código serve para login, troca de senha e confirmação de operações sensíveis, com a ligação com voz como alternativa ao SMS. A decisão de quando exigir o segundo fator fica no seu sistema.
Em quais países a validação funciona?
Hoje a validação estrutural cobre a numeração brasileira (DDDs, celulares com nono dígito e fixos) e os envios de SMS e voz são feitos para números do Brasil. Números de outros países são recusados na validação, antes de qualquer envio.
Coloque uma verificação de telefone confiável no seu cadastro
Crie a conta, gere a API key no painel e faça a primeira validação em minutos.
Criar conta grátis Ver preços Documentação