Números de verificação da Guiana Francesa (+594) para desenvolvedores e QA

Um código ou um número que você mantém: o que a Guiana Francesa oferece?

Antes de escrever qualquer código, decida qual produto a tarefa exige.

• O OTP Gateway serve para verificações pontuais: confirmar que o seu fluxo de cadastro aceita um número de verificação da Guiana Francesa, uma rodada de regressão antes de um lançamento ou a criação única de um perfil comercial regional. Cada número é usado para um único código.
• Os Dedicated Virtual Numbers servem para contas que precisam continuar recebendo códigos, como um login de staging que a sua equipe de QA abre toda semana. Eles são vendidos de forma instantânea apenas nos Estados Unidos e no Canadá, a partir de $1.95/month.

A Guiana Francesa entra no primeiro grupo. Não existe linha +594 de longo prazo em autoatendimento; se a sua equipe precisar de uma, escreva para [email protected], e a disponibilidade depende das regras locais. A comparação entre números temporários e dedicados ajuda quando você não sabe de que lado uma tarefa se encaixa.

Como funciona a sequência da API OTP da Guiana Francesa?

O id de país da Guiana Francesa é gf. Com uma chave Bearer (prefixo or_live_) em https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> retorna o preço atual e mostra se a rota está aberta.
2. POST /api/v1/activations com {"service": "facebook", "country": "gf"} reserva um número +594 e devolve um id de ativação.
3. O seu teste informa o número no app que está sendo testado.
4. O código chega por activation.sms_received em um webhook, ou por GET /api/v1/activations/{id} se você fizer polling.
5. POST /api/v1/activations/{id}/cancel libera um pedido de que o teste não precisa mais.

As requisições de webhook incluem X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Calcule o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare em tempo constante, recuse timestamps antigos e elimine duplicatas pelo id da ativação. Os limites por conta são 10 chaves de API, 5 endpoints de webhook e 300 requisições por minuto; a referência completa está na documentação.

Por que números +594 confundem a validação de telefone?

A Guiana Francesa é uma região ultramarina da França e segue o plano de numeração francês, mas tem o seu próprio código de país, +594, em vez do +33 da França. Nacionalmente, os números têm dez dígitos com um 0 inicial: os celulares costumam começar com 0694 e as linhas fixas com 0594. Internacionalmente o 0 é descartado, então um celular vira +594 694 XX XX XX.

Essa organização gera alguns bugs clássicos, e um número +594 para testes é a maneira mais fácil de pegá-los:

• Um seletor de países que agrupa os territórios franceses sob a França e acrescenta +33 a um número 0694.
• Bibliotecas de telefone que informam a região como GF enquanto a sua lógica de negócio só conhece FR.
• Código de exibição que formata em pares de dígitos à francesa, mas salva a string formatada em vez do E.164.

Armazene +594… sem espaços e mantenha região e país como conceitos separados no seu modelo de dados.

Quais apps podem enviar códigos de verificação para números da Guiana Francesa?

Mais de 700 serviços estão disponíveis atualmente na rota da Guiana Francesa. O retrato atual inclui WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber e LinkedIn.

O texto do SMS costuma estar em francês, o idioma que a maioria das contas locais usa, mas cada serviço escolhe seus próprios modelos; por isso, extraia os dígitos em vez de procurar uma frase. As equipes testam aqui ao localizar fluxos em francês para além da França metropolitana, ao atender clientes das regiões ultramarinas francesas ou ao conferir se uma conta regional ainda é verificada depois de uma mudança de configuração.

Como pedir um número +594 pelo painel?

Não é preciso código:

1. Cadastre-se com o seu e-mail e um código de 6 dígitos enviado por e-mail, ou com o login do Google, e aproveite para ativar a autenticação em dois fatores (TOTP).
2. Adicione saldo à carteira com cartão ou com USDT/USDC.
3. Escolha Guiana Francesa e o serviço; o preço é exibido antes de você confirmar.
4. Cole o número no app e acompanhe a página da ativação para ver o código.

Equipes de operações e gerentes de contas de agências costumam seguir esse caminho, enquanto os engenheiros configuram a API. Ambos usam a mesma carteira.

O que acontece quando o código nunca chega?

As ativações duram 20 minutos. O pagamento só é cobrado se o código chegar; um pedido cancelado, ou uma janela que se encerra sem SMS, devolve automaticamente o valor integral à carteira.

Se você está esperando um código +594:

• Deixe a janela terminar; um serviço pode demorar sem que haja algo errado.
• Verifique se o serviço aceita números virtuais. Alguns não aceitam, e o reembolso existe justamente para esse caso.
• Tente de novo mais tarde ou escolha outra rota de serviço.
• Evite programar novos pedidos imediatos a cada falha; um backoff exponencial mantém a rota +594 utilizável para todos.

Nossas notas sobre como reduzir falhas na entrega de OTP vão além. Limite os testes na Guiana Francesa a produtos e contas que a sua equipe possui, respeite os termos de cada serviço e considere a Política de Uso Aceitável da OTP Route parte do acordo.

Como funcionam pagamentos, faturas e testes em sandbox?

A OTP Route funciona com uma carteira pré-paga em USD: pague conforme o uso, sem mensalidade e sem plano. O saldo é adicionado por cartão ou com stablecoins USDT/USDC, e uma fatura em PDF chega por e-mail após cada recarga, para o seu financeiro. Os valores atuais estão na página de preços.

Engenheiros que estão montando o fluxo gf podem pedir ao suporte que ative o modo sandbox em uma conta de desenvolvimento. Ele devolve números e códigos simulados, de modo que o fluxo +594, a verificação de webhooks e a lógica de nova tentativa podem ser exercitados de ponta a ponta sem gastar saldo da carteira. Do ponto de vista da API, o roteamento de OTP para a Guiana Francesa não é diferente de qualquer outro mercado: só muda o id do país, e a API de verificação por SMS continua a mesma.

Perguntas frequentes

Posso testar o cadastro do meu app na Guiana Francesa sem um chip local?

Sim. Peça um número do OTP Gateway para gf, informe-o no seu formulário de cadastro e leia o código no painel ou no seu webhook.

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

Não. A Guiana Francesa usa o plano de numeração francês, mas tem o seu próprio código de país, +594, e as bibliotecas de telefone a tratam como uma região separada.

Quanto custa um código +594?

A partir de $0.20 por código, variando conforme o serviço; o painel e GET /api/v1/prices mostram o preço atual. Sem SMS em 20 minutos, há reembolso automático.

Posso manter um número da Guiana Francesa para logins futuros?

Não há opção em autoatendimento. Os Dedicated Numbers de longo prazo se limitam aos EUA e ao Canadá; escreva para [email protected] para perguntar sobre +594.

Em que idioma os códigos chegam?

Geralmente em francês, embora cada serviço escolha seu próprio modelo e possa seguir a configuração de idioma da conta.

Posso testar a integração antes de adicionar saldo à carteira?

Peça o modo sandbox para uma conta de desenvolvimento. Ele simula números e códigos para que você teste o fluxo completo sem gastar nada.

Por que o meu código da Guiana Francesa não chegou?

O serviço pode estar lento, pode rejeitar números virtuais ou a rota pode estar ocupada. Aguarde a janela terminar e tente de novo mais tarde ou em outra rota; pedidos que falham são reembolsados.

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.