API OTP para Samoa: testando cadastros +685 no Pacífico

Samoa em resumo para equipes de produto e QA

Samoa é uma nação independente do Pacífico, com o samoano e o inglês como idiomas oficiais. Uma grande comunidade samoana vive na Nova Zelândia, na Austrália e nos Estados Unidos, por isso apps de remessas, mensagens e viagens muitas vezes precisam funcionar para usuários que circulam entre esses países e a terra natal.

Dois detalhes merecem atenção. Primeiro, Samoa (+685) é um país diferente da Samoa Americana, que fica dentro do plano de numeração norte-americano sob o +1 684; confundir os dois em um seletor de países faz os códigos irem para o lugar errado. Segundo, Samoa passou para o lado oeste da Linha Internacional de Data em 2011 e mantém um relógio bem adiantado em relação ao UTC, o que a torna um caso útil para testar limites de data na lógica de expiração.

Para uma equipe de produto, Samoa raramente é um mercado de lançamento isolado. Ela costuma aparecer em uma expansão pelo Pacífico, como exigência de um app voltado à diáspora ou porque uma organização parceira em Apia precisa ter uma conta empresarial confirmada. Em todos os casos o trabalho é o mesmo: provar que um usuário +685 consegue concluir o seu fluxo de cadastro.

Como tratar um número +685 no código?

Os números nacionais de Samoa são curtos em comparação com a maioria dos mercados, então validadores ajustados para números de nove ou dez dígitos podem rejeitar um número real. Salve os números como +685 mais os dígitos nacionais, sem separadores, e remova qualquer zero que o usuário acrescente por hábito. Como os timestamps de webhook são em segundos Unix, compare-os em UTC e não no horário local; isso evita surpresas quando o seu servidor e um testador em Samoa estão em dias diferentes do calendário.

Se o seu produto permite alternar entre um número da Nova Zelândia e outro de Samoa no mesmo perfil, adicione um teste que troque o código do país e confirme que o estado de verificação anterior é limpo, para que um código enviado a um número nunca seja aceito para o outro.

Quais serviços estão disponíveis nas rotas de Samoa?

O catálogo de Samoa lista atualmente mais de 600 serviços. Entre os mais pedidos estão WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon e Discord. A cobertura é menor aqui do que em mercados grandes e muda ao longo do dia, então consulte GET /api/v1/services e GET /api/v1/countries antes de cada execução. Se um serviço não estiver disponível, uma rota vizinha como Fiji ou Tonga pode servir ao seu teste.

O catálogo mais enxuto é um bom motivo para tornar a sua suíte de testes tolerante: se o serviço preferido estiver ausente na hora da execução, marque o caso como ignorado em vez de reprovado e registre isso para que alguém tente de novo mais tarde.

Pedindo um código de Samoa pela API

Com uma chave Bearer (or_live_…) em https://otproute.com/api/v1, consulte o preço com GET /api/v1/prices?country=ws&service=<id> e depois envie {"service": "<id>", "country": "ws"} para POST /api/v1/activations. Acompanhe o id da ativação consultando GET /api/v1/activations/{id} ou escutando activation.sms_received. Verifique o HMAC de X-OTPRoute-Signature em cada webhook, recuse timestamps antigos e faça o handler ser seguro para rodar duas vezes na mesma ativação. O guia de integração mostra o formato completo.

Os limites de taxa são generosos para um mercado deste tamanho: cada conta tem até 10 chaves, 5 endpoints de webhook e 300 requisições por minuto. Se você usar polling, alguns segundos entre as consultas são mais do que suficientes.

Fazendo manualmente no painel

1. Entre na sua conta e abra o OTP Gateway.
2. Escolha o serviço e depois Samoa.
3. Confira o preço atual e confirme.
4. Cole o número +685 no app em teste e peça o código.
5. Leia o código na tela ou cancele se não precisar mais dele.

Quando um código +685 demora ou não chega

Mantenha a ativação aberta pelos 20 minutos completos antes de desistir. Alguns apps recusam números virtuais por completo, e é exatamente por isso que pedidos sem resposta são reembolsados. Se uma rota continuar em silêncio, tente mais tarde ou escolha outra rota de serviço; disparar novos pedidos em um laço rápido raramente ajuda e consome o seu limite de requisições.

Registre o id da ativação a cada tentativa para ver se o silêncio veio de um app específico ou da rota como um todo.

Números de longo prazo e pagamento por uso

A OTP Route não vende um número samoano de longo prazo em autoatendimento. Os Números Dedicados começam em $1.95/mês e se limitam aos Estados Unidos e ao Canadá; para uma linha de Samoa, escreva para [email protected], sem promessa de que seja possível. A carteira pré-paga em USD aceita cartões e USDT/USDC, envia uma fatura em PDF por recarga e não tem mensalidade. Peça o modo sandbox em uma conta de desenvolvimento para ensaiar o fluxo ws sem gastar saldo.

Perguntas frequentes

Samoa é a mesma coisa que a Samoa Americana em números de telefone?

Não. Samoa usa +685, enquanto a Samoa Americana usa +1 684. Escolha o correto no seu seletor de países e na API.

Qual é o id de país de Samoa na API?

Use ws na consulta de preços e na solicitação de ativação.

Quanto custa um código de verificação de Samoa?

A partir de $0.20 por código; o preço exato depende do serviço e é exibido antes de você pedir.

Posso testar o cadastro de um usuário samoano a partir da Nova Zelândia ou da Austrália?

Sim. O número +685 recebe o SMS e a OTP Route o mostra a você, não importa onde a sua equipe trabalhe.

Pago se nenhuma mensagem chegar?

Não. Ativações expiradas ou canceladas são reembolsadas automaticamente na carteira.

Em que idiomas chegam os códigos de Samoa?

Normalmente em inglês, que é oficial junto com o samoano. Interprete os dígitos, não o texto ao redor.

Posso usar esses números para abrir muitas contas?

Não. Siga os termos de cada serviço; a Política de Uso Aceitável limita a OTP Route a testes e à operação das suas próprias contas e produtos legítimos.

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.