Como lidar com códigos únicos das Maldivas (+960) em QA e operações

A situação: um produto de viagens ou hotelaria precisa funcionar para usuários +960

Imagine uma plataforma de reservas, uma ferramenta de operações de resort ou um app de entregas prestes a atender hóspedes e parceiros em Malé e nos atóis. Os engenheiros moram em outro lugar, a tela de verificação foi desenhada para números bem mais longos e ninguém na equipe tem um chip maldivo. Alguém precisa comprovar que a etapa do telefone funciona antes do lançamento.

É essa a lacuna que o OTP Gateway preenche. Ele entrega ao seu teste um número +960 real para uma única verificação, de modo que você pode receber SMS OTP das Maldivas no seu fluxo de cadastro em staging ou produção sem viajar, sem roaming e sem pegar o celular de um colega.

As equipes costumam chegar aqui por um destes três motivos: QA de localização para um mercado muito ligado ao turismo, um lançamento regional no Sul da Ásia e no Oceano Índico, ou uma equipe de operações que quer verificar uma conta da empresa sem vinculá-la ao número pessoal de ninguém. A página de testes de QA descreve o fluxo de trabalho mais amplo.

Por que os números maldivos de sete dígitos atrapalham o código de validação?

As Maldivas usam um plano de numeração fechado: +960 seguido de sete dígitos, sem prefixo de tronco para adicionar ou remover. Esse tamanho curto é justamente o que derruba muitos formulários. Uma regex que espera pelo menos nove dígitos nacionais, ou uma biblioteca configurada com outra região padrão, rejeitará um número perfeitamente válido.

Algumas verificações que valem a pena incluir na sua suíte de testes:

• aceite tanto +960 seguido de sete dígitos quanto a forma local de sete dígitos, e normalize para E.164 antes de salvar;
• confirme que nenhum caminho do código insere um zero, porque não há prefixo de tronco a restaurar;
• exiba o número corretamente nas telas de confirmação e nos recibos.

O divehi, língua nacional, é escrito da direita para a esquerda no alfabeto thaana, enquanto o inglês é muito usado nos negócios e no turismo. Espere que a maioria dos textos de verificação de apps internacionais chegue em inglês, mas extraia os dígitos em vez de comparar a redação, para que um modelo localizado não quebre o seu parser.

O que um número +960 consegue verificar hoje?

No momento, a rota das Maldivas cobre mais de 1.700 serviços. Os nomes do snapshot atual incluem WhatsApp, Telegram, Viber, Instagram, Facebook, Airbnb, Uber, Google (Gmail e YouTube), LinkedIn, Microsoft e Outlook, Snapchat, TikTok, Claude e Netflix.

Para um produto de viagens, a combinação mais útil costuma ser um serviço de reservas ou de mensagens mais o seu próprio app, para ver como o número de um hóspede se comporta nos dois. A disponibilidade muda ao longo do dia, e por isso a API retorna dados ao vivo em vez de uma lista fixa. O catálogo completo está em serviços.

Como integrar a API de OTP das Maldivas a um teste automatizado

Crie uma chave de API no console do desenvolvedor; ela começa com or_live_ e é enviada como token Bearer para https://otproute.com/api/v1. O id de país das Maldivas é mv.

1. Pergunte a GET /api/v1/prices?country=mv&service=airbnb quanto o pedido vai custar e se há disponibilidade.
2. Envie POST /api/v1/activations com {"service": "airbnb", "country": "mv"} para receber um id de ativação e o número +960.
3. Passe o número para o fluxo em teste.
4. Capture o código +960 quando activation.sms_received chegar ao seu endpoint, ou faça polling em GET /api/v1/activations/{id}.
5. Quando um teste nas Maldivas for interrompido antes da hora, envie POST /api/v1/activations/{id}/cancel e a carteira é creditada na hora.

As entregas assinadas incluem X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Calcule o HMAC-SHA256 do timestamp, um ponto e o corpo bruto usando o segredo do endpoint, compare e recuse timestamps antigos. Você pode registrar até 5 endpoints de webhook e usar até 300 requisições por minuto. Os detalhes de cada campo desta API de OTP das Maldivas estão na documentação para desenvolvedores.

Como abrir um número +960 pelo painel

Nem todo mundo no projeto escreve código, e o painel cobre o mesmo terreno. Escolha as Maldivas como país, selecione o serviço, confirme o preço ao vivo e o número aparece na tela. Cole-o no app e acompanhe o pedido: o código surge na mesma linha assim que o serviço o enviar.

O pedido dura 20 minutos. Você só paga se o código chegar; um pedido cancelado ou expirado é reembolsado automaticamente, então um agente de suporte que verifica um fluxo voltado a hóspedes não precisa de aprovação do financeiro a cada tentativa.

Quando o código demora: uma rotina curta de recuperação

O tempo de entrega depende do serviço e da rota, então um primeiro minuto silencioso é normal. Se nada tiver chegado:

1. Continue esperando até a janela estar perto de fechar.
2. Tente novamente mais tarde no mesmo dia ou teste com outra rota de serviço.
3. Verifique se o serviço de destino aceita números virtuais; alguns os recusam por política.
4. Evite fazer novos pedidos em um loop rápido, que só desperdiça o limite de requisições.

O artigo sobre roteamento de OTP por país explica como usar rotas alternativas quando um único país tem pouca oferta.

Linhas de longo prazo, carteira e modo sandbox

A OTP Route não tem número de longo prazo por autoatendimento nas Maldivas. Se você precisa de uma linha que sua equipe mantenha, escreva para [email protected]; se isso é possível depende das regras locais. Os Números Dedicados, que renovam mês a mês, existem apenas nos Estados Unidos e no Canadá, a partir de $1.95/month.

A cobrança funciona com uma única carteira pré-paga em USD: sem assinatura e sem níveis de plano. Recarregue por cartão ou com USDT/USDC, e uma fatura em PDF chega por e-mail a cada recarga. Desenvolvedores podem pedir o modo sandbox para uma conta de desenvolvimento e testar a integração com números e códigos simulados.

Mantenha o uso legítimo: teste os seus próprios produtos, siga os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route vale para todos os pedidos.

Perguntas frequentes

Quantos dígitos tem um número de telefone das Maldivas?

Sete dígitos depois do código de país +960, sem prefixo de tronco. Sua validação deve aceitar esse tamanho menor.

Qual id de país da API corresponde às Maldivas?

É mv. Use-o em GET /api/v1/prices e no corpo de POST /api/v1/activations.

Posso testar o cadastro +960 do meu app de reservas sem estar nas Maldivas?

Sim. Peça um número maldivo de uso único no OTP Gateway, digite-o no seu app e leia o código no painel ou pela API.

O que acontece com meu dinheiro se nenhum código maldivo chegar?

Nada é cobrado. Quando a janela de 20 minutos termina sem SMS, ou você cancela, o valor integral volta para a carteira.

O texto de verificação virá em divehi?

A maioria dos serviços internacionais envia em inglês, embora a redação dependa do app. Extraia os dígitos em vez da frase, assim qualquer um dos idiomas funciona.

Posso manter um número +960 para uma conta de equipe?

Não por autoatendimento. Linhas mantidas são um produto dos EUA e do Canadá; para as Maldivas, escreva para [email protected] e pergunte sobre as opções.

Preciso de um plano mensal para usar a OTP Route?

Não. Você paga conforme o uso, com uma carteira pré-paga em USD recarregada por cartão ou USDT/USDC, e recebe uma fatura em PDF a cada recarga.

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.