Integrando a verificação por SMS +82 ao seu pipeline de release coreano

Por quais endpoints passa uma ativação +82?

Comece pela API de verificação por SMS, porque é onde a maioria dos planos de teste para a Coreia acaba de qualquer forma. Toda chamada vai para https://otproute.com/api/v1 com uma chave Bearer iniciada por or_live_, obtida no console do desenvolvedor.

• GET /api/v1/countries devolve kr para a Coreia do Sul; GET /api/v1/services fornece os ids de serviço.
• GET /api/v1/prices?country=kr&service=<id> informa o preço atual e se a rota está aberta.
• POST /api/v1/activations com {"service": "kakaotalk", "country": "kr"} reserva um número +82 e devolve um id de ativação.
• GET /api/v1/activations/{id} mostra o status e, depois de recebido, o código.
• POST /api/v1/activations/{id}/cancel libera um número de que você não precisa mais.
• GET /api/v1/balance permite que uma suíte falhe cedo quando a carteira está baixa.

O limite da conta é de 300 requisições por minuto, então fazer polling a cada poucos segundos em jobs paralelos é confortável. O guia de integração mostra um ciclo de requisição completo.

Como os webhooks assinados se encaixam em uma execução de teste coreana?

O polling basta para um desenvolvedor sozinho; jobs de CI em paralelo ficam mais limpos com entrega por push. Registre até cinco endpoints e assine activation.sms_received, activation.expired e activation.cancelled.

Toda requisição inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>. Pegue o corpo bruto exatamente como foi recebido, monte a string <t>.<raw body>, calcule o HMAC-SHA256 com o segredo do endpoint e compare com v1 usando uma checagem em tempo constante. Rejeite qualquer coisa com timestamp antigo para bloquear replays e indexe o seu handler pelo id da ativação, para que uma entrega repetida não resolva o mesmo teste duas vezes. O artigo sobre HMAC trata de casos-limite como a reserialização do corpo.

Que problema as equipes de lançamento na Coreia costumam estar resolvendo?

A Coreia do Sul é um mercado exigente para aplicativos móveis e jogos, e os usuários coreanos esperam uma localização bem-acabada. As equipes testam aqui antes de um release, ao adicionar telas em coreano ou quando a fila de suporte relata que os textos de verificação não estão chegando aos usuários coreanos. Sem um chip local, é lento receber mensagens SMS OTP da Coreia do Sul e reproduzir esses relatos. Um número único +82 de um serviço de roteamento de OTP permite que um engenheiro reproduza o fluxo exato de qualquer escritório, e o código chega às mesmas ferramentas de todos os outros mercados.

Como os números de telefone coreanos são formatados e armazenados?

Os celulares coreanos são escritos no formato doméstico como 010 seguido de oito dígitos. O 0 inicial é um prefixo de tronco, então a forma internacional o elimina: +82 10 e depois os oito dígitos restantes. Formulários que aceitam os dois estilos devem normalizar para E.164 na entrada; armazenar 010… e +8210… lado a lado cria usuários duplicados e consultas quebradas.

As mensagens de remetentes coreanos normalmente são escritas em hangul, enviado como SMS Unicode, enquanto os aplicativos globais seguem a configuração de idioma da conta. Analise os códigos buscando o grupo de dígitos, e não esperando um modelo em inglês. Esteja ciente também de que muitos serviços domésticos coreanos vinculam o cadastro a uma verificação de identidade com nome real, feita por meio da operadora móvel do assinante. Essa verificação foi pensada para assinaturas pessoais, um número único não a satisfaz, e você não deve tentar contorná-la.

Quais aplicativos estão abertos nas rotas sul-coreanas agora?

O retrato de kr mostra mais de 500 serviços. Escolhas comuns para um número de verificação da Coreia do Sul incluem KakaoTalk, LINE, WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, TikTok, Discord, Netflix, Microsoft & Outlook, Amazon, Uber, ChatGPT (OpenAI) e Claude.

A cobertura muda ao longo do dia, então confirme sempre com o endpoint de preços antes de um pedido. Quem não é desenvolvedor pode fazer o mesmo pelo painel: crie uma conta, abra o OTP Gateway, escolha o serviço e a Coreia do Sul, confira o preço exibido, confirme e copie o número +82 no aplicativo. O código aparece na tela assim que chega.

E se uma ativação +82 continuar vazia?

A janela de ativação é de 20 minutos, e você só é cobrado se um código chegar. Quando nada vier:

• Dê à janela o tempo completo antes de tratar o pedido como falho.
• Cancele e tente mais tarde, ou escolha outra rota para aquele serviço quando houver uma listada.
• Verifique se o aplicativo rejeita linhas virtuais ou exige verificações de identidade pela operadora; se sim, repetir o pedido não mudará o resultado.
• Não tente de novo em um loop apertado, o que tende a acionar limitação por parte do remetente.

Pedidos sem resposta ou cancelados são reembolsados automaticamente. Respeite os termos de cada aplicativo e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica a toda ativação.

Existe um número coreano de longo prazo, e como funciona a cobrança?

Não existe linha +82 de longo prazo em autoatendimento. Os Números Dedicados são oferecidos apenas nos Estados Unidos e no Canadá, desde $1.95/month, para contas que precisam continuar recebendo mensagens. Para outras necessidades na Coreia, escreva para [email protected]; a disponibilidade depende da regulamentação local e não é garantida.

O OTP Gateway é pago a partir de uma carteira pré-paga em USD, sem plano nem mensalidade. Abasteça com cartão ou USDT/USDC e receba uma fatura em PDF por recarga. Sob solicitação, uma conta de desenvolvimento pode passar para sandbox, para que o seu pipeline rode contra números e códigos simulados. Veja os preços para as tarifas atuais.

Perguntas frequentes

Posso testar a verificação por telefone coreana do meu aplicativo sem um chip coreano?

Sim. Peça um número +82 pelo OTP Gateway, digite-o no seu aplicativo e colete o código pela API, por um webhook ou pelo painel.

Incluo o 0 inicial ao digitar um número coreano no formato internacional?

Não. Elimine o prefixo de tronco, de modo que um celular 010 vire +82 10 mais oito dígitos.

Quanto custa um número +82 para testes?

Desde $0.20 por código, com o preço exato dependendo do serviço. O valor em tempo real vem do endpoint de preços e do painel.

Um número único passa pela verificação de nome real coreana?

Não. As verificações de identidade baseadas na operadora estão atreladas a assinaturas pessoais, então use a OTP Route apenas em fluxos que aceitam códigos SMS comuns.

Sou cobrado se o KakaoTalk ou outro aplicativo nunca enviar o código?

Não. Se nada chegar em 20 minutos, ou se você cancelar, o pagamento volta para a sua carteira.

Posso manter um número sul-coreano para logins repetidos?

Não em autoatendimento. Cada número único recebe um só código, e as linhas de longo prazo se limitam aos EUA e ao Canadá.

Que id de país a API espera para a Coreia do Sul?

O id de país é kr, usado na consulta de preços e no corpo da ativação.

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.