Como levar códigos de verificação liberianos (+231) para as suas execuções de teste

Por que as equipes querem um número liberiano?

A Libéria é um mercado anglófono da África Ocidental, o que a torna uma primeira parada prática para empresas que se expandem pela costa: o texto raramente precisa de tradução, então o esforço de teste vai para o próprio fluxo de verificação. As equipes também olham para +231 quando atendem a diáspora liberiana e querem confirmar que um parente no país consegue de fato concluir o cadastro. Produtos de fintech e de marketplace, em especial, precisam ver que um número local passa nas verificações antes do lançamento; veja onboarding em fintech para o padrão mais amplo.

Um terceiro grupo é o da equipe de operações que gerencia contas empresariais para um escritório ou parceiro liberiano. Usar um número do gateway para a verificação única mantém os telefones pessoais dos funcionários fora dos perfis da empresa, e o código chega a um lugar que toda a equipe pode ver.

O que posso verificar em uma rota +231?

O país lista atualmente mais de 1.700 serviços. Entre as escolhas comuns estão WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), Snapchat, imo, Viber, X (Twitter), LinkedIn e Microsoft & Outlook. O estoque se move ao longo do dia, e é por isso que a API devolve a disponibilidade em tempo real em vez de um catálogo fixo.

Em um plano de testes, liste os dois ou três serviços em que os seus usuários realmente confiam e depois verifique cada par com uma consulta de preço no início da execução. Um app de mensagens que funciona em +231 esta manhã pode ficar indisponível por um tempo à tarde, e um pipeline que verifica antes falha com um motivo claro em vez de um timeout.

Que endpoints uma integração com a Libéria chama?

Tudo fica em https://otproute.com/api/v1 com uma chave Bearer do console do desenvolvedor.

• Consulte os ids com GET /api/v1/services e GET /api/v1/countries; a Libéria é lr.
• Veja o preço do par com GET /api/v1/prices?country=lr&service=<id>.
• Crie o pedido com POST /api/v1/activations e um corpo {"service": "<id>", "country": "lr"}.
• Receba activation.sms_received, activation.expired ou activation.cancelled no seu webhook, indexados pelo id da ativação, ou faça polling em GET /api/v1/activations/{id}.

Confira X-OTPRoute-Signature em cada webhook: calcule HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint e rejeite timestamps antigos. O post sobre segurança de webhooks mostra os detalhes.

Posso receber um SMS OTP da Libéria sem escrever código?

Sim. No painel, escolha a Libéria, escolha o serviço, confirme o preço exibido e faça o pedido. Cole o número +231 no app; o código aparece ao lado do pedido assim que for entregue. Copie-o direto para o campo de código do app e, se você terminou com um pedido que não é mais necessário, cancele-o na mesma tela para que o saldo volte na hora.

Como formato e normalizo números +231?

Os números liberianos costumam ser escritos localmente com um prefixo de tronco 0 na frente. Descarte esse zero e coloque +231 antes para obter a forma E.164 que o seu banco de dados deve guardar. Os celulares de diferentes operadoras locais compartilham o mesmo código de país +231, então não é preciso ramificar por operadora ao rotear um OTP. Valide pela forma internacional em vez da local e mantenha uma string de exibição separada se a sua equipe de suporte preferir o formato local familiar. O inglês é a língua oficial, então a maioria dos modelos de serviço chega em inglês. Isso simplifica a extração do código, mas ainda assim compare pelo grupo de dígitos e não por uma frase fixa, porque os serviços reescrevem as mensagens sem aviso.

O que ajuda quando um código liberiano atrasa ou não chega?

A entrega depende do serviço e da rota. Se nada aparecer:

• Deixe a janela de 20 minutos terminar; um pedido cancelado ou expirado é reembolsado integralmente.
• Tente de novo mais tarde ou por outra rota de serviço.
• Confirme que o serviço aceita números virtuais; alguns os recusam.
• Evite refazer o pedido em loop rápido, o que só queima tentativas.

Mais sobre isso em reduzindo entregas de OTP com falha.

Existe uma linha liberiana de longa duração e como se paga por ela?

Não há número de longa duração em self-service para a Libéria. As linhas dedicadas são um produto dos Estados Unidos e do Canadá, a partir de $1.95/month. Se precisar de uma linha liberiana duradoura, escreva para [email protected]; se é possível ou não depende das regras locais e não é garantido. Para a maioria dos planos de teste liberianos, o gateway basta, porque cada etapa de cadastro ou confirmação precisa de apenas um código.

A cobrança vem de uma carteira pré-paga em USD, sem mensalidade. Recarregue por cartão ou USDT/USDC, receba faturas em PDF por e-mail e solicite o modo sandbox enquanto desenvolve. Comece em cadastro.

Perguntas frequentes

Posso testar o fluxo de cadastro liberiano do meu app de fora do país?

Sim. Peça um número +231 no OTP Gateway e conclua a verificação remotamente; nenhum chip local é necessário.

Que id de país a API usa para a Libéria?

Use lr no campo country de POST /api/v1/activations e nas consultas de preço.

Quanto custa um código liberiano?

Os pedidos da Libéria começam em $0.20 por código, com o valor dependendo do serviço. O valor exato volta de GET /api/v1/prices e é exibido antes de você fazer o pedido.

O que acontece com o meu saldo se um código liberiano nunca for entregue?

Nada é cobrado. Um pedido +231 que não recebe SMS em 20 minutos, ou que você cancela, é reembolsado integralmente na carteira, de forma automática.

Posso reutilizar o mesmo número +231 na semana que vem?

Não. Um número do gateway serve para um único código de verificação. Linhas de longa duração existem apenas nos EUA e no Canadá.

Devo usar polling ou webhooks?

Os webhooks pesam menos nos seus sistemas; o polling funciona bem para scripts. Muitas equipes usam webhooks e recorrem ao polling quando um handler está fora do ar.

Existe um modo de teste que não cobra a minha carteira?

Sim. Mediante solicitação, uma conta de desenvolvimento pode passar para o sandbox, que devolve números e códigos simulados.

Há limites sobre o que posso verificar?

Sim: os termos do app de destino se aplicam, assim como a Política de Uso Aceitável da OTP Route. Os números liberianos servem para testar o seu produto e operar contas que a sua organização realmente possui.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.