Como verificar fluxos de cadastro chineses (+86) com uma API de roteamento de OTP

Por que o mercado chinês exige um plano de testes de verificação próprio?

A China tem um dos maiores ecossistemas móveis do mundo, e boa parte dele vive dentro de plataformas domésticas, e não nos apps globais que uma equipe ocidental costuma testar primeiro. Os chips lá são registrados com nome real, então os serviços locais tratam o número de telefone como um forte sinal de identidade e costumam ser mais rígidos sobre quais números aceitam.

Isso muda a forma como um engenheiro de QA deve pensar uma rota da China:

• Comércio transfronteiriço. Vendedores e compradores do Alibaba e do AliExpress confirmam o telefone ao se cadastrar ou alterar dados da conta, e por isso as equipes de marketplace querem ver essas mensagens de ponta a ponta.
• Texto em chinês. Os códigos de remetentes domésticos normalmente chegam em chinês simplificado, muitas vezes começando com o nome do remetente entre colchetes 【】. Um parser que procura a palavra "code" em inglês não vai encontrá-los.
• Codificação. O texto em chinês viaja como SMS Unicode; portanto, armazene o corpo das mensagens em UTF-8 e extraia os dígitos com um padrão que ignore o restante dos caracteres.

Usar um número +86 em testes contra uma rota real revela os três problemas antes dos seus clientes, e é aí que o roteamento de OTP por um caminho de operadora chinesa de verdade se paga.

Como armazenar um número móvel +86?

Os celulares do continente têm 11 dígitos e começam com 1. Diferentemente dos fixos, que são discados no país com um 0 de tronco mais o código de área, os móveis não levam nenhum prefixo de tronco; por isso, o formato E.164 é simplesmente +86 seguido dos 11 dígitos.

Alguns hábitos de normalização poupam depuração mais tarde:

• Remova espaços e hífens; os usuários costumam digitar o número em grupos de 3-4-4.
• Converta um 0086 ou 86 inicial em +86 antes de salvar e nunca coloque um 0 na frente de um celular.
• Valide o tamanho depois da normalização: 11 dígitos nacionais para um celular, nem mais.

Mantenha uma coluna canônica em E.164 e formate apenas na hora de exibir, na borda do sistema. O número devolvido por uma ativação já segue esse formato canônico, o que o torna uma boa massa de dados para testes unitários do seu próprio normalizador.

Quais apps podem enviar códigos para a rota da China hoje?

A rota da China cobre atualmente mais de 1.300 serviços. Entre os populares no retrato ao vivo estão WeChat, Alibaba, AliExpress, Microsoft & Outlook, LinkedIn, Telegram, WhatsApp, Google (Gmail & YouTube), TikTok, Amazon, Discord, ChatGPT (OpenAI) e Claude.

A disponibilidade muda ao longo do dia, conforme nossas operadoras parceiras adicionam e retiram capacidade; portanto, trate essa lista como ponto de partida. Chame GET /api/v1/services e GET /api/v1/countries para ver o quadro atual, em vez de fixar IDs de serviço em uma matriz de testes.

Como é o fluxo da API para o ID de país cn?

Crie uma chave Bearer (prefixo or_live_) no console do desenvolvedor e aponte seu cliente para https://otproute.com/api/v1. Uma execução típica da API de OTP da China segue estes passos, e os mesmos passos servem para receber mensagens OTP por SMS da China de qualquer serviço compatível:

1. Consulte GET /api/v1/prices?country=cn&service=wechat para ver o preço ao vivo do par que pretende testar.
2. Envie POST /api/v1/activations com o corpo {"service": "wechat", "country": "cn"} e guarde o ID de ativação devolvido.
3. Digite o número +86 no formulário de cadastro do produto que está sendo testado.
4. Deixe seu webhook receber activation.sms_received; sem webhook, consulte GET /api/v1/activations/{id} a cada poucos segundos.
5. Chame POST /api/v1/activations/{id}/cancel se o teste for interrompido, o que libera a reserva na hora.

As entregas de webhook trazem X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte timestamps antigos. Cada conta tem até 10 chaves, 5 endpoints de webhook e 300 requisições por minuto; a referência completa está na documentação da API.

Quem não programa pode pedir um número chinês?

Pode. Gerentes de produto e a equipe de suporte fazem tudo pelo painel:

1. Abra o OTP Gateway, escolha China e depois o serviço.
2. Confira o preço exibido antes de pedir.
3. Copie o número +86 para o app que você está verificando.
4. Acompanhe o cartão da ativação; o texto da mensagem aparece ali assim que for recebido.

Valem a mesma janela de 20 minutos e a mesma regra de reembolso; portanto, uma verificação manual de uma tela de onboarding localizada não custa nada se o app nunca enviar nada.

O que tentar quando um código chinês não chega?

O silêncio geralmente significa que o serviço se recusou a enviar para aquele número ou que a rota está ocupada, e não que a sua integração esteja quebrada. Siga com calma:

• Deixe a janela completa correr; alguns remetentes tentam de novo no próprio ritmo.
• Confirme se o serviço aceita números virtuais. Plataformas com regras de nome real muitas vezes não aceitam, e o reembolso automático existe justamente para esse caso.
• Volte depois de uma pausa ou teste o mesmo cenário por outra rota de serviço.
• Evite pedir de novo em um laço apertado. Isso consome os limites de requisições e raramente muda o resultado.

Nosso guia sobre como reduzir falhas na entrega de OTP aprofunda o desenho de novas tentativas.

Posso manter um número +86 por muito tempo e como é a cobrança?

Não existe linha de longo prazo self-service para a China. Os Números Dedicados são um produto dos Estados Unidos e do Canadá, a partir de $1.95/mês, com SMS de entrada, SMS de saída e chamadas pelo navegador. Se a sua equipe precisa de uma linha chinesa duradoura, escreva para [email protected]; a disponibilidade depende das regras locais e não é prometida.

O dinheiro fica em uma única carteira pré-paga em USD, sem cobrança mensal e sem plano para escolher. Os testes na China saem desse saldo, que você recarrega com cartão ou com USDT/USDC, recebendo por e-mail uma fatura em PDF a cada recarga. Os detalhes estão na página de preços, e a visão geral dos números virtuais explica as linhas dos EUA e do Canadá. Para trabalho de integração, peça o modo sandbox: ele devolve números e códigos simulados para que um pipeline seja exercitado sem tocar nos fundos da carteira.

Perguntas frequentes

Posso testar um fluxo de cadastro do WeChat ou do Alibaba sem um chip chinês?

Você pode pedir um número +86 para esse serviço pela OTP Route e ler o código no painel ou pela API. Algumas plataformas recusam números virtuais; nesse caso, a ativação é reembolsada automaticamente.

Qual é o ID do país China na API da OTP Route?

Use cn onde quer que um ID de país seja esperado, por exemplo em GET /api/v1/prices?country=cn&service=<id>.

As mensagens de verificação chinesas chegam em inglês?

Remetentes domésticos costumam escrever em chinês simplificado, enquanto apps globais muitas vezes enviam em inglês ou em um idioma ligado à conta. Monte a extração do código em torno dos dígitos, não de palavras-chave.

Por quanto tempo uma ativação +86 fica aberta?

Vinte minutos. Se nenhum SMS chegar antes do fim, ou se você cancelar antes, o valor integral volta para a sua carteira.

Um número de verificação da China serve para logins repetidos?

Não. Cada ativação recebe um código e depois termina; por isso serve para testes de cadastro e onboarding, não para contas que precisem se autenticar de novo no mês seguinte.

Que regras valem para o uso de números +86?

Respeite os termos de cada plataforma e a Política de Uso Aceitável da OTP Route. O produto serve para testar seus próprios fluxos de verificação e operar contas empresariais legítimas, nunca para cadastros em massa.

Um job de CI pode usar números da China sem pagar?

Sob solicitação, uma conta de desenvolvimento pode passar para o modo sandbox, que devolve números e códigos simulados para que seus testes da API de verificação por SMS rodem de ponta a ponta sem custo.

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.