Números de verificação de Aruba: levando códigos +297 para as suas execuções de teste

O que os engenheiros devem saber sobre a numeração +297 de Aruba?

Aruba é um país constituinte do Reino dos Países Baixos, com o seu próprio código de chamada, +297, separado da faixa holandesa +31. Os números de assinante têm sete dígitos e não há prefixo de tronco, então o que uma pessoa local escreve em um formulário já é o número nacional significativo completo.

Essa simplicidade esconde um bug clássico de validação. Muitos formulários de cadastro exigem no mínimo oito ou dez dígitos porque a equipe só testou mercados maiores, e um usuário arubano esbarra em um erro antes mesmo de qualquer código ser enviado. Algumas regras mantêm tudo limpo:

• Armazene todo número como E.164, por exemplo +2975XXXXXX, sem espaços nem pontuação.
• Na entrada, remova espaços, hífens e um 00 inicial e depois acrescente +297 se o usuário escolheu Aruba no menu de países.
• Nunca adicione um 0; Aruba não tem dígito de tronco para restaurar.
• Deixe uma biblioteca de números de telefone mantida julgar a validade, em vez de uma checagem de comprimento escrita à mão.

Um número +297 real para testes é a forma mais rápida de provar que o seu formulário, a coluna do banco de dados e o seu remetente de SMS concordam com esse formato de sete dígitos.

Por que uma equipe faria QA com um número arubano?

A ilha vive do turismo, então os produtos que mais se importam são mecanismos de reservas, apps de aluguel e de transporte, software de hotelaria, fintechs de viagem e programas de fidelidade. As equipes que se expandem pelo Caribe holandês costumam lançar Aruba, Curaçao e Sint Maarten juntas e querem uma única suíte de regressão que cubra os três códigos de discagem.

O idioma também importa. Holandês e papiamento são os idiomas oficiais, enquanto o inglês e o espanhol são ouvidos em toda parte, em lojas e hotéis. Os serviços globais costumam enviar os códigos em inglês ou no idioma da conta, então o seu parser deve extrair os dígitos com um padrão em vez de comparar com uma frase fixa. Se a sua interface oferece textos em holandês ou papiamento, um número de verificação de Aruba permite que o QA confirme toda a jornada localizada, do rótulo do campo de telefone à tela de digitação do código.

Quais serviços podem entregar um código em um número +297?

O snapshot ao vivo de Aruba lista rotas populares como WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, Uber, Airbnb, Signal e LinkedIn. No total, o OTP Gateway tem mais de 600 serviços para este país.

A disponibilidade muda ao longo do dia conforme as nossas operadoras parceiras rotacionam o estoque, e é por isso que a OTP Route a expõe ao vivo em vez de uma tabela estática. Consulte o catálogo antes de cada execução, em vez de fixar uma lista de serviços nas suas fixtures.

Como uma requisição da API de OTP de Aruba flui do início ao fim?

Autentique-se com uma chave Bearer que começa com or_live_; o console do desenvolvedor permite ter até 10 chaves e 5 endpoints de webhook, com um teto de 300 requisições por minuto. A URL base é https://otproute.com/api/v1.

1. Chame GET /api/v1/countries e GET /api/v1/services uma vez para guardar os ids em cache. Aruba é aw.
2. Leia o preço atual com GET /api/v1/prices?country=aw&service=airbnb para que o seu job registre o custo antes de se comprometer.
3. Crie o pedido com POST /api/v1/activations e um corpo JSON {"service": "airbnb", "country": "aw"}. A resposta traz o id da ativação e o número +297 a digitar no app em teste.
4. Deixe o seu listener de webhook capturar activation.sms_received para esse pedido; um job sem endpoint público pode, em vez disso, consultar GET /api/v1/activations/{id} a cada poucos segundos.
5. Se o teste for abortado, libere o pedido com POST /api/v1/activations/{id}/cancel.

Todo webhook traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte requisições com timestamps antigos. O guia de captura por webhook percorre um handler completo, e a documentação da API lista todos os campos desta API de verificação por SMS.

Alguém sem código pode pedir um número de Aruba?

Sim. A equipe de suporte e os gerentes de produto podem fazer o mesmo pelo navegador:

1. Entre na conta e abra a página do OTP Gateway no painel.
2. Escolha Aruba como país e selecione o serviço que está verificando.
3. Confirme o preço exibido e copie o número +297 que aparecer.
4. Digite-o no app e peça o código; o SMS aparece no cartão do pedido quando chegar.

Cada número recebe um código de verificação para um serviço, então abra um novo pedido para cada verificação separada.

E se o código nunca chegar ao número arubano?

Todo pedido fica aberto por 20 minutos. Quando nenhum SMS chega nesse tempo, ou se você cancelar antes, o valor total volta para a sua carteira por conta própria; você só paga quando o código realmente chega. A velocidade de entrega varia conforme o serviço e a rota, então deixe a janela correr em vez de desistir depois de um minuto.

Se uma rota continua voltando vazia:

• Tente de novo mais tarde, quando o estoque tiver rotacionado, ou use outra rota de serviço para o mesmo fluxo.
• Verifique se o serviço recusa números virtuais; alguns recusam, e é exatamente por isso que o reembolso existe.
• Espace as novas tentativas em vez de refazer pedidos em um loop apertado a partir do CI.

Mais ideias estão na nossa nota sobre como reduzir falhas na entrega de OTP.

Existe uma linha +297 de longo prazo, e como funciona a cobrança?

Não existe número de longo prazo em autoatendimento para Aruba. Os Números Dedicados são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês; se as suas operações realmente precisam de uma linha arubana, escreva para [email protected] e a equipe verificará o que as regras locais permitem, sem nenhuma promessa de que seja possível providenciar.

Todo o resto funciona com uma única carteira pré-paga em USD, sem mensalidade e sem plano a escolher. O saldo é adicionado por cartão ou com as stablecoins USDT/USDC, e uma fatura em PDF por e-mail acompanha cada recarga. Enquanto você desenvolve, uma conta de desenvolvimento pode ser mudada para sandbox sob solicitação, para que números e códigos simulados exercitem a sua lógica de roteamento de OTP sem tocar nos fundos da carteira. Os valores atuais estão na página de preços. Use o serviço apenas para os seus próprios produtos e contas, siga os termos de cada app e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

Perguntas frequentes

Posso testar o cadastro arubano do meu app de hotelaria sem um chip da ilha?

Sim. Peça um número de Aruba no OTP Gateway, informe-o no seu app e leia o código no painel ou no seu webhook.

Qual é o id de país de Aruba na API da OTP Route?

Use aw em toda requisição, por exemplo GET /api/v1/prices?country=aw&service=whatsapp.

Devo adicionar um zero inicial aos números arubanos?

Não. Aruba não tem prefixo de tronco, então a forma armazenada é simplesmente +297 seguido de sete dígitos.

Quanto custa receber um OTP por SMS de Aruba?

As rotas de Aruba têm preço a partir de $0.20 por código, com o valor de cada serviço definido ao vivo. Esse valor exato volta de GET /api/v1/prices e aparece no painel antes de você confirmar.

Um número +297 pode receber um segundo código de login na semana que vem?

Não. Um número do gateway cobre um único código de verificação. Contas que precisam entrar de novo mais tarde combinam melhor com um Número Dedicado dos EUA ou do Canadá.

A OTP Route pode nos ajudar a abrir muitas contas em uma plataforma?

Não. Ela existe para testar os seus próprios fluxos de verificação e operar as suas próprias contas legítimas, e os termos de cada plataforma, além da nossa Política de Uso Aceitável, se aplicam.

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.