Códigos de verificação de Mônaco (+377) para equipes de produto e QA

Por que as equipes testam com números monegascos?

Mônaco é minúsculo, mas pesa mais do que o seu tamanho para empresas de private banking, hotelaria, serviços de iatismo e eventos internacionais. Os clientes de lá esperam que um produto aceite um número +377 sem reclamar, e um número surpreendente de formulários ainda presume que qualquer pessoa perto da Riviera tem uma linha francesa +33.

Essa suposição gera chamados de suporte reais. Muita gente que trabalha em Mônaco mora do outro lado da fronteira, na França, e tem números franceses, enquanto os residentes têm números monegascos, de modo que uma mesma base de clientes mistura os dois códigos. Um número de verificação de Mônaco, pedido como um número +377 para testes, permite que engenheiros de QA provem que o seletor de país, as regras de validação e os modelos de SMS tratam o principado como país próprio, e não como um subúrbio francês.

Como um formulário deve armazenar e validar números +377?

Mônaco tem seu próprio código de chamada do país, separado da França, e seus números nacionais são curtos em comparação com a maior parte da Europa. Na forma internacional não há prefixo de tronco: o número é +377 seguido diretamente dos dígitos do assinante.

Algumas regras práticas para engenheiros:

• Persista os números em E.164 (+377…) e aplique um agrupamento amigável apenas na hora de exibir.
• Usuários acostumados à discagem francesa às vezes digitam um 0 inicial por hábito. Remova-o durante a normalização em vez de falhar na validação.
• Não deduza o país a partir de um prefixo +33 e um endereço postal de Mônaco; mantenha o país do telefone e o país de cobrança como campos independentes.
• Use uma biblioteca de números de telefone mantida, em vez de uma checagem de comprimento escrita à mão, já que comprimentos franceses fixados no código rejeitam números monegascos válidos.

O francês é o idioma oficial, então os textos de verificação costumam chegar em francês, embora o italiano e o inglês sejam muito usados localmente e muitos apps enviem inglês quando o idioma da conta está definido assim. Teste ambos se o seu onboarding for localizado.

Quais serviços uma rota de Mônaco consegue verificar?

Mais de 1,300 serviços estão disponíveis na rota de Mônaco neste momento. Entre os populares no panorama de hoje estão Instagram, Airbnb, Telegram, Claude, WhatsApp, Facebook, Google (Gmail e YouTube), Uber, Netflix, eBay, LinkedIn e X (Twitter).

A cobertura não é fixa. Os nossos parceiros de operadora alternam capacidade ao longo do dia, então um serviço visível de manhã pode estar pausado à tarde. Um bom roteamento de OTP lê a disponibilidade na hora do pedido em vez de depender de uma lista em cache, e a API de verificação por SMS expõe exatamente isso pelo endpoint de preços.

Como é a sequência da API OTP de Mônaco?

As requisições vão para https://otproute.com/api/v1 e se autenticam com uma chave Bearer que começa com or_live_, criada no console do desenvolvedor. O id do país de Mônaco é mc.

1. Busque GET /api/v1/services e GET /api/v1/countries de vez em quando para mapear nomes em ids.
2. Antes de cada pedido, chame GET /api/v1/prices?country=mc&service=<id>. Ele responde com o preço em tempo real e se o par pode ser atendido.
3. Crie o pedido com POST /api/v1/activations, por exemplo {"service": "airbnb", "country": "mc"}. Guarde o id de ativação retornado.
4. Digite o número +377 no seu app e espere activation.sms_received no seu webhook, ou faça polling em GET /api/v1/activations/{id}.
5. No encerramento, chame POST /api/v1/activations/{id}/cancel para tudo o que ainda estiver pendente.

Verifique o cabeçalho X-OTPRoute-Signature de cada webhook recalculando o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, e rejeite timestamps antigos. Cada conta pode registrar 5 endpoints de webhook e enviar até 300 requisições por minuto, o que deixa espaço para execuções paralelas em Mônaco. O guia de integração percorre os mesmos passos com tratamento de erros.

Existe um jeito sem código para a equipe de operações?

O painel cobre o mesmo caminho para quem prefere não mexer em uma API. Escolha Mônaco no OTP Gateway, selecione o serviço, confira o preço que aparece e confirme. O número +377 aparece em um cartão de ativação; cole-o na tela de login ou cadastro e o código surge nesse cartão quando o SMS chegar.

A janela dura 20 minutos. Se o código não chegar a tempo, ou se você cancelar o pedido, o valor integral é reembolsado à carteira sem precisar abrir chamado de suporte.

E se um código de Mônaco não chegar?

Mercados pequenos têm menos rotas, então paciência e um plano alternativo pesam mais aqui do que em países grandes.

• Dê ao pedido a janela completa antes de cancelar.
• Verifique se o serviço aceita números virtuais para aquela ação; alguns os recusam de cara.
• Tente de novo depois de uma pausa em vez de refazer o pedido em loop, o que pode acionar limites de requisições do lado do serviço.
• Se o teste só precisar de um número da região da Riviera, a rota da França ou a rota da Itália pode ter mais capacidade naquele momento.

Mantenha todo teste dentro dos termos do serviço. A OTP Route serve para verificar os seus próprios produtos e contas empresariais legítimas, e a sua Política de Uso Aceitável se aplica.

Dá para manter um número de Mônaco a longo prazo e como funciona a cobrança?

Não existe linha +377 de longo prazo em autoatendimento. Os Dedicated Virtual Numbers, que você mantém enquanto renovam e que oferecem SMS de entrada, SMS de saída e chamadas pelo navegador, são um produto dos Estados Unidos e do Canadá a partir de $1.95/month. Para uma linha monegasca, escreva para [email protected]; o time pode dizer se as regras locais permitem alguma coisa, sem promessa alguma.

Os pedidos de Mônaco saem da mesma carteira pré-paga em USD que todo o resto, sem mensalidade e sem plano para escolher. Recarregue com cartão ou USDT/USDC e espere uma fatura em PDF por e-mail a cada recarga. Durante o trabalho de integração, uma conta de desenvolvimento pode ser colocada em sandbox sob solicitação, retornando números e códigos simulados para que você teste de ponta a ponta sem gastar nada. Os detalhes estão na página de preços.

Perguntas frequentes

Um número de telefone de Mônaco é igual a um francês?

Não. Mônaco usa seu próprio código +377, então a lógica de validação deve tratá-lo separadamente do +33 da França.

Qual é o id de Mônaco na API da OTP Route?

Use mc na consulta de preços e no corpo da requisição de ativação.

Posso obter um número +377 para testar um lançamento europeu?

Sim, o OTP Gateway emite números +377 de uso único para verificações individuais, pedidos pelo painel ou pela API.

Quanto tempo tenho para receber o código de Mônaco?

Cada ativação fica aberta por 20 minutos; se nada chegar, a cobrança é reembolsada automaticamente.

Os números monegascos incluem prefixo de tronco?

Não no formato internacional. Remova qualquer 0 inicial que o usuário digitar e armazene o número como +377 mais os dígitos do assinante.

Em que idioma será o SMS de verificação de um serviço em Mônaco?

Geralmente em francês, mas depende do app e da configuração de idioma da conta, então textos em inglês ou italiano são possíveis.

Posso executar meus testes de Mônaco sem gastar fundos reais?

Peça o modo sandbox em uma conta de desenvolvimento. Ele retorna números e códigos simulados para testes de integração.

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.