Testando cadastros com +226: checklist de número de verificação de Burkina Faso

O que deve estar pronto antes de pedir um número +226?

A maioria das primeiras tentativas que falham vem de uma etapa de configuração esquecida, não da rota em si. Confira esta lista antes do primeiro pedido:

• Uma chave de API. Crie uma no console de desenvolvedor; as chaves live têm o prefixo or_live_ e são enviadas como token Bearer. Você pode ter até 10 chaves, então reserve uma para o staging e outra para o CI.
• Uma carteira com saldo. Recarregue por cartão ou com USDT/USDC. Nada é descontado por um código que não chega.
• Os ids corretos. Burkina Faso é bf na API. Consulte o id do serviço com GET /api/v1/services em vez de adivinhar.
• Um plano de entrega. Ou um endpoint de webhook com o segredo guardado em local seguro, ou um loop de polling com intervalos razoáveis. Uma conta pode registrar até 5 endpoints de webhook, útil para separar staging de produção.
• Uma conta legítima para verificar. Um usuário de teste do seu próprio produto ou uma conta empresarial operada pela sua equipe. Valem os termos de cada serviço e a Política de Uso Aceitável da OTP Route.

A referência da API lista todos os campos, se você quiser lê-la antes de escrever código.

Quais apps podem entregar códigos em uma rota de Burkina Faso?

O catálogo ativo de bf lista hoje mais de 900 serviços. Entre os populares disponíveis no momento da redação estão WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, imo, Viber, Signal, LinkedIn, Uber, Amazon e ChatGPT (OpenAI).

A disponibilidade muda ao longo do dia conforme nossos parceiros de operadora acrescentam e esgotam capacidade, então trate essa lista como um retrato do momento. Seu código deve consultar GET /api/v1/prices logo antes de cada pedido; a resposta traz o preço atual e se o par pode mesmo ser pedido.

Como é a sequência de chamadas da API para o país `bf`?

1. Leia o preço do seu par com GET /api/v1/prices?country=bf&service=whatsapp (troque pelo id do seu serviço).
2. Crie a ativação com POST /api/v1/activations e o corpo {"service": "whatsapp", "country": "bf"}. Guarde o id da ativação retornado; tudo o que vem depois é indexado por ele.
3. Dispare o SMS no app que você está testando, usando o número +226 da resposta.
4. Aguarde o evento activation.sms_received no seu webhook. Verifique o cabeçalho X-OTPRoute-Signature, no formato t=<unix>,v1=<hex>: calcule o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare e descarte requisições com timestamp antigo. O passo a passo em como proteger webhooks de OTP com HMAC cobre os casos de borda.
5. Sem webhook? Consulte GET /api/v1/activations/{id} a cada poucos segundos.
6. Terminou antes ou está testando um caminho de falha? Chame POST /api/v1/activations/{id}/cancel. Você também verá activation.expired ou activation.cancelled quando uma execução terminar sem código.

A conta permite 300 requisições por minuto, o bastante para polling desde que cada execução espace um pouco as consultas.

Quem não programa também consegue pedir um código +226?

Sim. Equipe de suporte, marketing e gerentes de conta podem fazer o mesmo manualmente. Entre na conta, abra o OTP Gateway, escolha Burkina Faso, selecione o serviço e confirme o preço exibido na tela. O número aparece na hora; cole-o no app, peça o SMS e o código chega na mesma linha do painel. Pode deixar a aba aberta ou voltar depois, pois a ativação continua à escuta pelos 20 minutos completos.

Como armazenar números +226 e em que idioma virá o SMS?

Burkina Faso usa números nacionais de oito dígitos e não tem prefixo de tronco, então não há zero inicial para remover: a forma nacional e os dígitos depois de +226 são os mesmos. Armazene os números em E.164 como +226 seguido desses oito dígitos e normalize a entrada do usuário removendo espaços, hifens e o 00 internacional antes de salvar. Regras de validação copiadas de mercados que usam zero de tronco rejeitam entradas +226 válidas, um bug clássico de localização que merece um teste de regressão.

O francês é há muito tempo a língua da administração, da escola e dos negócios, e mooré, diula e fulfulde são amplamente falados. A maioria dos modelos de verificação chega em francês ou inglês, conforme o idioma da conta, então garanta que seu parser lide com caracteres acentuados em volta dos dígitos.

As equipes costumam testar aqui ao lançar na África Ocidental francófona, ao conferir o texto em francês numa tela de cadastro ou ao integrar clientes de pagamentos e dinheiro móvel; a página de onboarding fintech descreve esse padrão.

O que tentar quando nenhum código chega ao número?

• Deixe a janela terminar. Alguns serviços enviam com atraso; cancelar no terceiro minuto descarta uma execução que ainda poderia dar certo.
• Confirme que o serviço aceita números virtuais. Algumas plataformas os recusam por completo. É exatamente por isso que as ativações sem uso são reembolsadas.
• Tente outra rota ou repita mais tarde. Outro horário, ou uma rota vizinha da África Ocidental, muitas vezes se comporta de forma diferente.
• Não refaça o pedido em loop apertado. Repetições rápidas tendem a acionar os limites do próprio app de envio e pioram a tentativa seguinte.

O guia sobre como reduzir falhas na entrega de OTP aprofunda o desenho de novas tentativas.

Existe número fixo de longo prazo em Burkina Faso e como funciona a cobrança?

Não há linha +226 de longo prazo em autoatendimento. Os Dedicated Numbers são um produto dos Estados Unidos e do Canadá, a partir de $1.95/mês, com SMS de entrada e saída e chamadas pelo navegador. Se você precisa de uma linha permanente de Burkina Faso, escreva para [email protected]; se ela pode ser providenciada depende das regras locais e não é prometida.

O pagamento das ativações +226 sai de uma única carteira pré-paga em USD, sem assinatura e sem plano para escolher. As recargas por cartão ou USDT/USDC geram, cada uma, uma fatura em PDF por e-mail. Para trabalho de integração, peça a troca de uma conta de desenvolvimento para o sandbox, que devolve números e códigos simulados para que sua suíte de testes nunca toque em fundos reais. Os valores atuais estão na página de preços.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app em Burkina Faso sem um chip local?

Sim. Peça um número +226 no OTP Gateway, dispare o SMS pelo seu app e leia o código no painel ou pela API. Você só paga se o código chegar.

Qual é o id de Burkina Faso na API da OTP Route?

É bf. Combine-o com um id de serviço de GET /api/v1/services ao chamar os endpoints de preços ou de ativações.

Os números +226 começam com zero?

Não. Burkina Faso não tem prefixo de tronco, então um número é simplesmente +226 mais oito dígitos no formato E.164.

Por quanto tempo um número de verificação de Burkina Faso fica ativo?

Vinte minutos por ativação. Se a janela fechar sem SMS, ou se você cancelar, o valor integral volta automaticamente para a sua carteira.

O código vai chegar em francês?

Depende do serviço de envio e do idioma configurado na conta. Francês e inglês são os casos mais comuns, então teste os dois se o seu produto os oferece.

Posso usar um número +226 para abrir várias contas na mesma plataforma?

Não. A OTP Route serve para testar o seu próprio produto e operar contas empresariais legítimas. Cadastros em massa ou identidades inventadas violam a Política de Uso Aceitável e os termos da plataforma.

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.