Números de verificação do Haiti (+509) para equipes de produto e QA

Por que uma equipe de produto testaria um número de telefone haitiano?

O Haiti é um mercado em que o número de telefone muitas vezes faz mais papel do que um endereço de e-mail. Aplicativos de mensagens carregam conversas de família, de negócios e da comunidade, e muitos produtos que atendem clientes haitianos também são feitos para a grande diáspora nos Estados Unidos, no Canadá e na França. Equipes de remessas, dinheiro móvel, marketplace e mensagens acabam precisando provar que um número +509 consegue se cadastrar, entrar e recuperar uma conta.

O idioma é o outro motivo. O crioulo haitiano e o francês são ambos oficiais, então o QA de localização significa verificar se as suas telas, mensagens de erro e modelos de SMS soam corretos em cada um, e se um usuário que troca de idioma no meio do fluxo ainda recebe um código que consegue entender. Testar com um número de verificação real do Haiti é a forma mais direta de ver esse caminho como um cliente veria. Para um roteiro mais amplo, veja a nossa página de verificação em apps móveis.

Como os números +509 são formatados e armazenados?

Os números haitianos têm oito dígitos depois do código de país +509. A discagem nacional não usa prefixo de tronco, o que significa que a forma local são esses oito dígitos e a forma internacional acrescenta +509 na frente.

Armazene o valor canônico em E.164 (+509 seguido dos oito dígitos) e remova espaços, hifens e um 00509 inicial na entrada. Atenção também ao comportamento da diáspora: um cliente haitiano que mora no exterior pode se cadastrar com um número dos EUA ou do Canadá e depois acrescentar uma linha +509, então o seu seletor de países e as verificações de duplicidade devem tratar o código do país como parte da identidade, e não como enfeite.

O SMS em si é redigido pelo serviço remetente. Dependendo do app e do idioma da conta, um código enviado a um número haitiano pode vir em francês, inglês ou outro idioma que o serviço suporte, então garanta que o seu parser extraia os dígitos independentemente das palavras ao redor.

Quais serviços podem enviar um código para um número de verificação do Haiti?

A rota +509 oferece atualmente mais de 1.000 serviços. O panorama ao vivo inclui WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, TikTok, X (Twitter), Snapchat, Signal, Viber, Amazon, Netflix e eBay.

Encare esses nomes como exemplos do que os números +509 costumam atender, e não como um cardápio fixo. O estoque muda ao longo do dia, então a API e o painel mostram o que está aberto no momento em que você pergunta. Alguns serviços também recusam números virtuais, e o reembolso automático existe justamente para esse caso. Os nomes dos serviços pertencem aos seus donos; não há afiliação entre eles e este produto.

Chamando a API OTP do Haiti com o id de país `ht`

Desenvolvedores chegam ao mesmo estoque por REST. Autentique-se com uma chave Bearer do console do desenvolvedor (prefixo or_live_) em https://otproute.com/api/v1 e depois:

1. Liste os serviços com GET /api/v1/services e, para confirmar a cobertura, os países com GET /api/v1/countries.
2. Leia o preço ao vivo em GET /api/v1/prices?country=ht&service=<id>.
3. Faça o pedido com POST /api/v1/activations, enviando {"service": "<id>", "country": "ht"}.
4. Colete o código de um webhook activation.sms_received ou por polling de GET /api/v1/activations/{id}.
5. Libere o número antes com POST /api/v1/activations/{id}/cancel se o seu teste terminar de outro jeito.

Todo webhook traz X-OTPRoute-Signature: t=<unix>,v1=<hex>. Verifique o HMAC-SHA256 sobre o timestamp e o corpo bruto com o segredo do seu endpoint, descarte eventos com timestamps antigos e torne o handler idempotente no id da ativação. O guia de integração da API mostra esse fluxo de roteamento OTP com mais profundidade. Dimensione os seus scripts em torno de 300 requisições por minuto por conta.

Obtendo um código +509 pelo painel

A equipe de suporte e de operações pode dispensar a API por completo. Abra o OTP Gateway no seu painel, escolha Haiti e o serviço, e olhe o preço exibido antes de pedir. Depois de confirmar, você recebe um número +509 para testes; cole-o no app, solicite o SMS e acompanhe o cartão do pedido para ver o código. O número pertence àquela única verificação e se encerra quando a janela de 20 minutos termina.

Sem código ainda? Solução de problemas da rota do Haiti

O silêncio em um pedido +509 costuma ter algumas causas comuns:

• O serviço ainda está enviando. Dê a ele a janela inteira antes de presumir falha.
• O serviço rejeita números virtuais. Se uma segunda tentativa mais tarde também ficar em silêncio, escolha outra forma de testar aquele fluxo específico.
• A rota está ocupada. Tente de novo após uma pausa, ou escolha outra rota para o mesmo serviço, em vez de disparar novos pedidos em sequência.
• O seu webhook perdeu o evento. Consulte a ativação para ver se o código já está lá.

Se a janela se encerrar vazia ou você cancelar, o valor integral volta automaticamente para a carteira, então uma tentativa fracassada não custa nada. Mais táticas estão reunidas em reduzindo falhas na entrega de OTP.

Linhas de longo prazo, carteira e sandbox para o trabalho com o Haiti

A OTP Route não vende números haitianos de longo prazo em autoatendimento. Os Números Virtuais Dedicados, que você mantém enquanto renovam, são um produto dos EUA e do Canadá a partir de $1.95/month, e podem ser um complemento sensato para linhas de suporte voltadas à diáspora no lado norte-americano. Se você precisa especificamente de uma linha +509 de longo prazo, escreva para [email protected]; a equipe vai analisar, mas as regras locais decidem e nada é prometido.

Os pagamentos passam por uma única carteira pré-paga em USD: pague conforme o uso, sem assinatura, recarregue por cartão ou USDT/USDC e receba uma fatura em PDF a cada recarga. Peça o modo sandbox para uma conta de desenvolvimento para ensaiar todo o fluxo da API de verificação por SMS com códigos simulados. Use números haitianos somente para os seus próprios produtos e contas comerciais legítimas, siga os termos de cada serviço e respeite a Política de Uso Aceitável. Cadastre-se quando estiver pronto para fazer o primeiro pedido.

Perguntas frequentes

Posso verificar o fluxo de cadastro do meu app no Haiti sem um chip haitiano?

Sim. Peça um número +509 no OTP Gateway da OTP Route, dispare o SMS do seu app e leia o código no painel ou por webhook.

Que id de país a API usa para o Haiti?

O id é ht. Combine-o com um id de serviço, por exemplo POST /api/v1/activations com {"service": "telegram", "country": "ht"}.

Quantos serviços funcionam com um número de verificação do Haiti?

Mais de 1.000 no momento do último panorama. A lista exata muda ao longo do dia, então confira GET /api/v1/prices ou o painel antes de pedir.

Pago se o código +509 nunca chegar?

Não. Se a janela de 20 minutos passar sem SMS, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira.

Os códigos chegarão em crioulo haitiano?

Isso depende inteiramente do serviço remetente e do idioma da conta. Construa seus testes para extrair os dígitos, seja a mensagem em francês, inglês ou outro idioma.

Posso obter um número haitiano de longo prazo para uma central de suporte?

Não como produto de autoatendimento. A OTP Route oferece linhas dedicadas nos Estados Unidos e no Canadá; para o Haiti, escreva para [email protected] e pergunte sobre as opções.

Que formas de pagamento posso usar para recarregar?

Cartão e as stablecoins USDT ou USDC, creditados em uma carteira pré-paga em USD. Não há mensalidade nem plano a escolher.

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.