Um checklist prático para testes e operações de OTP em Gana (+233)

Antes de começar: uma lista de prontidão para Gana

Marque estes itens e um teste com +233 raramente trará surpresas:

1. Credenciais. Uma chave Bearer do console do desenvolvedor (prefixo or_live_). Chaves separadas para local, staging e CI facilitam a revogação.
2. Ids de país e de serviço. Gana é gh; os ids de serviço vêm de GET /api/v1/services.
3. Um parser de números que entenda o zero de tronco. Os ganenses escrevem os celulares com um 0 inicial no dia a dia, e os seus formulários receberão os dois estilos.
4. Infraestrutura de entrega. Um loop de polling ou um endpoint de webhook com o segredo guardado com segurança.
5. Uma lista curta de serviços a cobrir. Decida quais fluxos de cadastro e login precisam de um número ganense antes de pedir qualquer coisa.
6. Visibilidade do orçamento. Leia GET /api/v1/balance antes de um lote para não parar no meio da suíte.

Como os celulares ganenses são escritos, e como armazená-los?

O código de país de Gana é +233 e o prefixo de tronco é 0. Um celular escrito no formato nacional tem dez dígitos começando com 0; na forma internacional o 0 desaparece e nove dígitos seguem o +233. O clássico bug de qualidade de dados é o usuário que seleciona +233 e depois digita o número local com o zero, gerando um dígito extra. Remova um único 0 inicial quando houver código de país e salve o resultado em E.164, para que deduplicação, busca e envio de SMS concordem em uma só representação.

O inglês é a língua oficial, e a maioria dos textos de verificação chega a números ganenses em inglês, embora akan (twi), ewe, ga e dagbani sejam muito falados e alguns apps localizem o texto. Mantenha o seu extrator de código focado na sequência de dígitos, não nas palavras ao redor.

Por que testar aqui? Equipes que lançam na África Ocidental, produtos construídos em torno de mobile money e pagamentos e empresas que atendem a diáspora ganense no Reino Unido e na América do Norte precisam todos de prova de que os cadastros com +233 funcionam. As equipes de fintech podem ler nossas notas sobre onboarding fintech para o lado de KYC dessa história.

Pedindo um número +233 pela API de verificação por SMS

A URL base é https://otproute.com/api/v1.

1. Obtenha o preço atual da sua combinação com GET /api/v1/prices?country=gh&service=<id>; ele também informa se a rota está disponível agora.
2. Envie POST /api/v1/activations com {"service": "<id>", "country": "gh"} e guarde o id da ativação devolvido junto ao caso de teste.
3. Informe o número +233 ao produto em teste.
4. Receba o código por um webhook activation.sms_received, ou faça polling em GET /api/v1/activations/{id} em um intervalo razoável.
5. Em caso de falha ou ao encerrar, chame POST /api/v1/activations/{id}/cancel.

As requisições de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 do timestamp, de um ponto e do corpo bruto com o segredo do endpoint, compare em tempo constante e rejeite timestamps antigos. Torne o handler idempotente usando o id da ativação como chave, para que uma entrega reenviada não preencha o mesmo teste duas vezes. O hub do desenvolvedor reúne exemplos de SDK e a referência.

Quais serviços são roteados por Gana hoje?

Mais de 1,600 serviços estão disponíveis na rota de Gana. O retrato atual dos populares inclui WhatsApp, Telegram, Facebook, Instagram, TikTok, Snapchat, Google (Gmail & YouTube), LinkedIn, Uber, Amazon, ChatGPT (OpenAI), Claude, Discord e Signal. Apps sociais e de mensagens dominam aquilo em que os usuários ganenses se cadastram, então são uma primeira rodada natural para o QA de localização.

A disponibilidade é ao vivo, não fixa. Consulte o endpoint de preços para a combinação exata em vez de confiar em uma lista que estava correta hoje de manhã.

Executando tudo pelo painel

Nem todo mundo na equipe precisa de código. Entre na conta, abra o OTP Gateway, escolha Gana e o serviço, confira o preço que aparece antes do pedido e confirme. Copie o número +233 para o app em teste; quando o SMS chegar, o código é exibido ao lado do pedido, junto com o tempo restante. A equipe de operações costuma usar esse caminho para conferir um único fluxo depois de um release, sem tocar no harness de testes.

Solucionando um número +233 silencioso

Quando nada aparecer, percorra esta lista em ordem:

• A janela ainda está aberta? As ativações duram 20 minutos. Dê tempo ao serviço antes de concluir que falhou.
• O serviço aceitou o número? Algumas plataformas recusam números virtuais. Um erro no próprio formulário significa cancelar e tentar outra rota.
• Tente de novo mais tarde, ou por outra rota. A cobertura de um serviço muda ao longo do dia.
• Não martele. Um loop que refaz o pedido a cada poucos segundos desperdiça requisições do limite de 300 por minuto e raramente ajuda.
• Olhe os seus próprios logs. Uma assinatura rejeitada ou um handler que travou vai parecer um código ausente.

Você só é cobrado se o código chegar. Ativações expiradas e canceladas são reembolsadas integral e automaticamente na carteira. Nosso artigo sobre como reduzir falhas na entrega de OTP aprofunda o desenho de novas tentativas.

Linhas de longo prazo, pagamentos e o sandbox

Não existe número ganense de longo prazo em autoatendimento. As linhas dedicadas são um produto dos EUA e do Canadá, a partir de $1.95/month, descritas na página de números virtuais; para uma linha de Gana, escreva para [email protected], e a equipe dirá o que as regras locais permitem.

A OTP Route usa uma carteira pré-paga em USD, pague conforme o uso, sem assinatura. Adicione saldo por cartão ou com USDT/USDC e você recebe uma fatura em PDF por e-mail a cada vez. Para o trabalho de integração, uma conta de desenvolvimento pode ser colocada em sandbox mediante pedido, para devolver números e códigos simulados. Você pode criar uma conta com um código por e-mail ou com o login do Google. Use cada número de acordo com os termos do serviço de destino e com a nossa Política de Uso Aceitável.

Perguntas frequentes

Posso receber códigos SMS OTP de Gana por uma API?

Sim. Crie uma ativação com o país gh e colete o código por webhook ou por polling do endpoint de ativação.

Devo armazenar números ganenses com o zero inicial?

Não. Descarte o 0 de tronco e armazene em E.164 com +233 e nove dígitos, o que mantém busca e deduplicação consistentes.

Em que idioma são os textos de verificação em números ganenses?

Geralmente em inglês, a língua oficial. Alguns apps localizam o texto, então extraia os dígitos em vez de procurar um texto fixo.

Quanto custa um número +233 para testes?

Os códigos do OTP Gateway começam em $0.20 por código; o valor exato de cada serviço é exibido antes do pedido.

Serei cobrado se o app nunca enviar o código?

Não. Se nenhum SMS chegar na janela de 20 minutos, ou se você cancelar, o valor integral volta para a carteira.

A minha equipe de suporte pode ter um número permanente de Gana?

Não em autoatendimento. As linhas de longo prazo existem apenas nos EUA e no Canadá; pergunte à equipe por e-mail sobre outros países.

Posso pagar com stablecoins?

Sim. A carteira aceita recargas por cartão, além de USDT e USDC, e cada recarga vem com uma fatura em PDF.

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.