Como receber códigos SMS OTP do Kosovo por API ou pelo painel

Por que uma equipe de produto precisaria de um número +383?

O Kosovo é um mercado pequeno com uma presença desproporcional no exterior: uma grande diáspora vive na Alemanha, na Suíça e em outras partes da Europa Ocidental, e muitas dessas pessoas mantêm um número kosovar para a família e para o banco. Apps que atendem a esse público, de viagens a transferências de dinheiro, precisam ver o que um usuário +383 vivencia no cadastro.

A localização é o outro motivo. Albanês e sérvio são idiomas oficiais, então um fluxo traduzido para qualquer um deles merece um teste real de ponta a ponta, e não uma revisão por capturas de tela. Um número de verificação do Kosovo no OTP Gateway permite que o QA faça essa checagem de qualquer escritório.

As equipes de operações regionais sediadas em Pristina ou que cobrem os Bálcãs Ocidentais têm um terceiro motivo: perfis empresariais registrados com um contato local às vezes pedem um código novo, e canalizar isso por uma ferramenta compartilhada e auditável é melhor do que passar de mão em mão o aparelho de um funcionário.

Quais apps estão na rota do Kosovo agora?

O retrato de hoje mostra mais de 400 serviços para o Kosovo. Entre os populares atualmente oferecidos estão WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber e Flipkart.

A lista é menor do que em mercados europeus maiores e muda com mais frequência, então trate qualquer lista escrita como uma pista. A resposta definitiva é o que GET /api/v1/countries e o painel retornarem no momento em que você fizer o pedido.

Trabalhando com a API OTP do Kosovo na prática

O id do país é xk. Uma integração típica resolve os ids de serviço em GET /api/v1/services, confere o custo com GET /api/v1/prices?country=xk&service=<id> e depois abre uma ativação com POST /api/v1/activations e um corpo como {"service": "telegram", "country": "xk"}. A resposta traz o número e um id de ativação que você guarda para depois.

A partir daí, o código chega a você como um webhook activation.sms_received, assinado no cabeçalho X-OTPRoute-Signature com HMAC-SHA256 sobre "<t>.<raw body>". Rejeite timestamps antigos e indexe seu handler pelo id da ativação, para que uma entrega repetida seja processada apenas uma vez. O polling em GET /api/v1/activations/{id} também funciona quando um job de CI não tem URL pública. Veja o guia de integração para exemplos completos.

O que mudou quando o Kosovo recebeu o +383 e como armazenar os números?

O Kosovo recebeu seu próprio código de país, +383, apenas no fim da década de 2010. Antes disso, suas redes móveis usavam códigos emprestados, inclusive os de Mônaco e da Eslovênia, e alguns cadastros de clientes antigos ainda guardam números nesses formatos. Se você importa dados legados, sinalize essas entradas em vez de reescrevê-las automaticamente.

Os números nacionais começam com o prefixo de tronco 0; um celular mostrado localmente como 044 123 456 é +383 44 123 456 em E.164. Salve a forma internacional, remova o zero na entrada e formate apenas ao exibir. O texto em albanês usa letras como ë, que ficam fora do alfabeto GSM básico, então uma mensagem localizada pode ser enviada em UCS-2, com segmentos mais curtos.

O que deve acontecer quando um código do Kosovo atrasa ou não chega?

Dê à ativação os 20 minutos completos. Quando a janela fecha sem SMS, ou você cancela, a cobrança é estornada para a carteira automaticamente e activation.expired ou activation.cancelled é disparado. Próximos passos sensatos:

• tente de novo após uma pausa ou escolha uma rota vizinha, como a Albânia, se o seu teste permitir;
• verifique se o serviço de destino aceita números virtuais;
• adicione backoff às tentativas automáticas em vez de pedir em loop.

Linhas de longo prazo, carteira e sandbox para projetos no Kosovo

A OTP Route não tem número de longo prazo em autoatendimento para o Kosovo. Sua linha de Números Dedicados, a partir de $1.95/mês, cobre apenas dois países: os Estados Unidos e o Canadá. Para uma linha +383 duradoura, escreva para [email protected]; se algo pode ser providenciado depende das regras locais.

Os gastos saem de uma única carteira pré-paga em USD, conforme o uso, recarregada por cartão ou USDT/USDC, com uma fatura em PDF enviada por e-mail a cada recarga. Desenvolvedores podem pedir o modo sandbox em uma conta de desenvolvimento para receber números e códigos simulados enquanto integram os webhooks. Detalhes em preços.

Perguntas frequentes

Posso conferir o cadastro em albanês do meu app com um número real do Kosovo?

Sim. Peça um número +383 para testes no OTP Gateway, inicie o cadastro em albanês, e o código aparece no painel e no seu webhook.

Qual id o Kosovo usa na API de verificação por SMS?

O Kosovo é xk em todo endpoint que recebe um país, inclusive GET /api/v1/prices e POST /api/v1/activations.

Quanto custa um número de verificação do Kosovo?

A partir de $0.20 por código; a tarifa exata depende do serviço e é exibida antes do pedido, ou devolvida pelo endpoint de preços.

Por que vejo menos serviços para o Kosovo do que para a Alemanha?

A cobertura segue o que nossos parceiros de operadora conseguem rotear para cada país, e mercados menores têm listas mais curtas. Consulte a lista em tempo real antes de planejar uma execução de testes.

O que acontece com meu dinheiro se os OTPs do Kosovo nunca chegarem?

Ele volta integralmente para a carteira quando a janela de 20 minutos termina sem SMS, ou imediatamente se você cancelar.

Números antigos +377 ou +386 ainda pertencem a usuários do Kosovo?

Alguns cadastros legados podem contê-los, mas os números novos usam +383. Trate os formatos mais antigos como dados a revisar, e não como algo a converter às cegas.

Posso manter um número +383 para logins repetidos?

Não em autoatendimento. Cada número do gateway cobre um código, e as linhas de longo prazo são um produto dos EUA e do Canadá; escreva para [email protected] para perguntar sobre o Kosovo.

Há regras sobre como uso os números da OTP Route?

Sim. Use a OTP Route apenas para os seus próprios produtos e contas empresariais legítimos, siga os termos de cada serviço e respeite a Política de Uso Aceitável. Cadastre-se para começar.

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.