Recebendo SMS OTP de Hong Kong (+852) para testes e operações

O que torna simples normalizar os números +852?

Hong Kong usa um plano de numeração fechado: todo número de assinante tem oito dígitos, não há códigos de área e não existe prefixo de tronco para remover. O número que um usuário local digita é, portanto, os mesmos oito dígitos que seguem +852 em E.164. As faixas de celular costumam começar por 5, 6 ou 9.

As pessoas normalmente escrevem os oito dígitos em dois grupos de quatro, então o seu formulário de cadastro deve remover espaços e hifens antes da validação. Armazene a string canônica +852XXXXXXXX, compare por esse valor e formate apenas na exibição. Como o tamanho é fixo, uma simples verificação de comprimento pega a maioria dos erros de digitação, mas mantenha uma biblioteca de telefones adequada no processo para a validação de faixas.

Que idiomas os textos de verificação de Hong Kong usam?

O chinês e o inglês são ambos oficiais, o cantonês é o idioma falado do dia a dia, e o chinês escrito aqui usa caracteres tradicionais. Um serviço pode enviar o código em inglês ou em chinês tradicional, dependendo do idioma da conta, e mensagens em escrita chinesa trafegam como SMS Unicode.

Duas consequências práticas para o QA. Primeiro, extraia o código casando o padrão de dígitos, e não as palavras próximas, para que o parser funcione nos dois modelos. Segundo, se o seu próprio produto envia uma mensagem localizada, confira se a versão em chinês tradicional é exibida corretamente no lado do recebimento, e não apenas no editor de modelos.

Por que as equipes fazem testes de cadastro em uma rota de Hong Kong?

Hong Kong é uma base regional para muitas empresas da Ásia-Pacífico, e os seus usuários costumam manter contas tanto em apps internacionais quanto em apps voltados à China continental. Essa mistura faz dela um mercado útil para verificar localização, onboarding transfronteiriço e fluxos de suporte.

O panorama atual mostra mais de 3.600 serviços para Hong Kong. Entre os mais usados estão WhatsApp, WeChat, LINE, Signal, Alibaba, Telegram, Google (Gmail & YouTube), Facebook, Instagram, LinkedIn, Uber, Airbnb, Netflix, AliExpress e Amazon. Produtos de pagamento e carteira também testam aqui, já que uma etapa de telefone quebrada na tela de onboarding de Hong Kong impede o cliente antes de qualquer transação. A disponibilidade ao vivo muda ao longo do dia, então leia-a em tempo de execução.

Como funciona o fluxo da API OTP de Hong Kong com o país `hk`?

Autentique-se em https://otproute.com/api/v1 com uma chave Bearer que começa por or_live_. Uma conta pode ter até 10 chaves e 5 endpoints de webhook.

1. Leia GET /api/v1/services e GET /api/v1/countries uma vez por execução para mapear nomes em ids.
2. Consulte GET /api/v1/prices?country=hk&service=<id> para obter o preço ao vivo.
3. Envie POST /api/v1/activations com {"service": "wechat", "country": "hk"}.
4. Informe o número +852 no fluxo que você está testando.
5. Pegue o código no evento activation.sms_received, ou recorra ao polling de GET /api/v1/activations/{id} a cada poucos segundos.
6. Em activation.expired ou activation.cancelled, marque o teste como sem código e siga em frente.

Verifique o cabeçalho X-OTPRoute-Signature (HMAC-SHA256 sobre <t>.<raw body>) e rejeite timestamps antigos. O guia de integração percorre cada chamada.

Como alguém que não é desenvolvedor obtém um número de verificação de Hong Kong?

Abra o OTP Gateway no painel, escolha Hong Kong e o serviço, confira o preço exibido e faça o pedido. Copie o número para o app e acompanhe o cartão da ativação; o código aparece ali assim que for recebido. Isso é útil para a equipe de suporte que reproduz o relato de um cliente na mesma rota que o seu CI usa.

E se o código +852 não aparecer?

Dê à ativação os 20 minutos inteiros. Se nenhum SMS chegar, ou se você cancelar antes, a cobrança volta automaticamente para a sua carteira, porque você só paga quando um código chega. Depois:

• verifique se o serviço recusa números virtuais, o que alguns fazem;
• tente de novo mais tarde ou por outra rota de serviço;
• confirme que o app recebeu os oito dígitos depois de +852, já que um formulário que insere um zero inicial perdido quebra o número;
• evite refazer o pedido em laço apertado, o que tende a repetir o mesmo resultado.

Existe uma linha de longo prazo em Hong Kong, e como funciona a cobrança?

Não existe número +852 de longo prazo de autoatendimento na OTP Route. Os Números Dedicados são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, e estão descritos na página de números virtuais. Para uma linha de Hong Kong, escreva para [email protected]; a possibilidade de fornecer uma depende das regras locais.

Todo o resto é pago conforme o uso, a partir de uma carteira pré-paga em USD, recarregada por cartão ou USDT/USDC, com uma fatura em PDF a cada recarga. Um modo sandbox com números simulados está disponível sob solicitação para contas de desenvolvimento. Siga os termos de cada serviço e a Política de Uso Aceitável.

Perguntas frequentes

Posso receber um SMS OTP de Hong Kong sem um chip local?

Sim. A OTP Route emite um número +852 de uso único para o serviço escolhido, e o código é entregue ao painel e ao seu webhook.

Preciso remover um prefixo de tronco dos números de Hong Kong?

Não. Hong Kong não tem prefixo de tronco, então os oito dígitos locais vão direto depois de +852.

Qual é o id de país da API para Hong Kong?

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

O código chegará em chinês ou em inglês?

Qualquer um dos dois pode acontecer, dependendo do serviço e das configurações de idioma da conta. Extraia os dígitos por padrão para que ambos os modelos funcionem.

Quanto custa um número +852 para testes?

A partir de $0.20 por código; o preço ao vivo por serviço vem de GET /api/v1/prices e é exibido no painel antes do pedido.

Posso recuperar meu dinheiro se o WeChat ou outro serviço não enviar nada?

Sim. Qualquer ativação que não receba SMS em 20 minutos, ou que você cancele, é reembolsada integralmente na carteira.

O roteamento OTP para Hong Kong é adequado para pipelines de CI?

É, desde que você use webhooks ou um polling moderado e trate a expiração como um resultado normal. Veja o artigo sobre pipelines de CI.

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.