Testando a verificação de telefone +596 para usuários da Martinica

Por que a Martinica quebra validações de telefone que só esperam a França?

A Martinica faz parte da França e da União Europeia, mas tem o próprio código de chamada, +596, e não +33. Essa combinação gera um bug clássico: um produto francês limita o campo de telefone a +33, ou um seletor de países esconde a Martinica sob a França, e os clientes da ilha não conseguem concluir o cadastro.

Os números locais seguem o padrão francês de dez dígitos com um 0 de tronco. Os celulares costumam ser escritos como 0696 ou 0697 seguidos de seis dígitos, e os telefones fixos como 0596. Em E.164, o zero sai e o código é acrescentado, resultando em +596 696 xx xx xx para um celular. Repare na peculiaridade do fixo: +596 596… repete os dígitos, o que alguns validadores caseiros marcam por engano como erro de digitação.

• Armazene +596 mais nove dígitos; coloque espaços apenas na tela.
• Remova o zero de tronco quando o usuário digitar 0696… com a ilha selecionada.
• Teste se +596, Guadalupe (+590) e Guiana Francesa (+594) são aceitos, cada um, como códigos distintos.

Quem precisa de um número +596 para testes?

O francês é o idioma oficial e o crioulo martinicano é muito falado, mas os textos de verificação de apps globais quase sempre chegam em francês ou inglês, conforme o idioma da conta. Isso faz da Martinica uma boa verificação para equipes que já localizam para a França:

• Lançamentos na França e na UE que precisam tratar residentes de territórios ultramarinos como clientes domésticos.
• Operações no Caribe de produtos de viagem, entrega e hotelaria usados na ilha.
• Suítes de regressão que cobrem parsing de telefone, modelos de SMS e fluxos de recuperação para códigos de chamada menos comuns.

O guia de testes de QA descreve como encaixar essas verificações em um pipeline existente.

Quais serviços podem enviar um código para um número martinicano?

Mais de 600 serviços estão disponíveis na rota da Martinica. O snapshot atual dos mais populares inclui WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, Microsoft e Outlook, Amazon, Discord, Snapchat, Airbnb, Uber e Netflix.

A disponibilidade muda ao longo do dia, então leia-a da API no momento em que precisar, em vez de fixá-la em um plano de testes.

Como recebo códigos SMS OTP da Martinica pela API?

Crie uma chave Bearer (prefixo or_live_) no console do desenvolvedor e aponte seu cliente para https://otproute.com/api/v1. O id de país da Martinica é mq.

1. Consulte GET /api/v1/prices?country=mq&service=<id> para ver o preço ao vivo e a disponibilidade do par.
2. Faça o pedido por POST /api/v1/activations com {"service": "airbnb", "country": "mq"} ou com o serviço que estiver testando.
3. Digite o número +596 retornado no seu próprio app e dispare o código.
4. Receba-o em um webhook inscrito em activation.sms_received, ou faça polling em GET /api/v1/activations/{id} a cada poucos segundos.
5. Se o teste terminar antes da hora, libere a ativação com POST /api/v1/activations/{id}/cancel.

Verifique cada webhook antes de confiar nele: o cabeçalho X-OTPRoute-Signature contém t=<unix>,v1=<hex>, em que v1 é o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint como chave. Rejeite timestamps antigos e torne o handler idempotente pelo id da ativação. Referência completa: documentação para desenvolvedores.

Existe um caminho pelo painel para quem não é desenvolvedor?

Agentes de suporte e equipes de crescimento podem executar o mesmo roteamento de OTP pelo navegador. Cadastre-se com e-mail ou Google, recarregue a carteira, selecione a Martinica e o serviço, confira o preço exibido e confirme. O número +596 aparece na tela, e o código é adicionado ao mesmo cartão quando o SMS chega. A janela é de 20 minutos; sem SMS, ou depois de um cancelamento, o dinheiro volta direto para o seu saldo.

E se um código de verificação +596 atrasar ou não chegar?

Rotas menores podem ser mais silenciosas, então se prepare para isso:

• Espere a janela inteira antes de decidir que a tentativa falhou.
• Lembre que um serviço pode recusar números virtuais; nesse caso, você não é cobrado.
• Tente de novo depois de uma pausa, ou use uma rota próxima, como Guadalupe, se o seu cenário permitir.
• Evite martelar o endpoint de pedidos; espace as novas tentativas.

A checklist de falhas de entrega traz mais ideias. Siga os termos de cada serviço; a Política de Uso Aceitável da OTP Route se aplica.

Posso ter um número permanente da Martinica e como pago?

Números de longo prazo por autoatendimento não são oferecidos para a Martinica. As linhas dedicadas existem apenas para os Estados Unidos e o Canadá, a partir de $1.95/month; para uma linha martinicana, escreva para [email protected], sabendo que as regras locais determinam o que é possível.

O pagamento é feito com uma única carteira pré-paga em USD, sem assinatura. Recarregue por cartão ou com USDT/USDC, receba uma fatura em PDF a cada recarga e peça o modo sandbox para uma conta de desenvolvimento se quiser números e códigos simulados enquanto monta a integração.

Perguntas frequentes

Um número da Martinica é o mesmo que um número francês +33?

Não. A Martinica usa o próprio código de chamada, +596, embora faça parte da França, então seus formulários precisam aceitá-lo separadamente.

Como fica um celular martinicano em E.164?

Retire o zero inicial e acrescente o código: um número escrito 0696 xx xx xx vira +596 696 xx xx xx.

Qual id de país devo enviar para a Martinica?

Envie mq como valor de country nas consultas de preço e nos pedidos de ativação.

Posso testar o cadastro do meu app de reservas na Martinica sem um chip local?

Sim. Peça um número +596 para esse serviço no OTP Gateway e leia o código no painel ou pela API.

Pago por uma ativação +596 que nunca recebe SMS?

Não. Ativações expiradas e canceladas são reembolsadas integralmente na carteira; você só paga quando o código chega.

A OTP Route vende linhas de longo prazo da Martinica?

Não por autoatendimento. Os números dedicados de longo prazo são um produto dos EUA e do Canadá; escreva para [email protected] para perguntar sobre a Martinica.

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.