Como receber códigos de verificação búlgaros em números +359

Uma equipe consegue receber códigos SMS OTP búlgaros sem um chip local?

A maioria das equipes que faz essa pergunta está em um de três cenários: um produto está prestes a ser lançado na Bulgária e o QA quer acompanhar o fluxo de cadastro real, um grupo de operações regional gerencia perfis empresariais registrados com um contato +359, ou uma agência está conferindo o onboarding de um cliente do exterior. Enviar chips búlgaros para cada caso é lento e deixa plástico esquecido em gavetas.

O OTP Gateway troca isso por uma única requisição: escolha um serviço e a Bulgária, receba um número de verificação +359 temporário e leia o código quando o serviço o enviar. Um número atende a uma verificação. Nossos parceiros de operadora fornecem as rotas, enquanto a OTP Route cuida do roteamento de OTP, do cronômetro e do reembolso automático.

Quais serviços posso rotear por um número +359?

O panorama atual da Bulgária lista mais de 1.600 serviços. Entre os populares disponíveis agora estão WhatsApp, Viber, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, eBay, Uber, Discord e Signal.

O Viber merece uma menção especial porque é muito usado para conversas pessoais e profissionais na Bulgária, de modo que um plano de QA local costuma testá-lo ao lado do WhatsApp. A disponibilidade das rotas muda ao longo do dia, e é por isso que as listas de preços e serviços vêm da API no momento da requisição, e não de uma tabela estática.

Como é a sequência da API OTP da Bulgária?

Crie uma chave Bearer (prefixo or_live_) no console do desenvolvedor e chame https://otproute.com/api/v1:

1. Busque GET /api/v1/services e GET /api/v1/countries uma vez e guarde os ids em cache; a Bulgária é bg.
2. Leia a tarifa atual com GET /api/v1/prices?country=bg&service=<id>.
3. Abra uma ativação via POST /api/v1/activations com um corpo como {"service": "viber", "country": "bg"}.
4. Aguarde o webhook activation.sms_received ou consulte GET /api/v1/activations/{id} quando o seu runner não puder expor um endpoint.
5. Se um teste for abortado antes da hora, envie POST /api/v1/activations/{id}/cancel para que o dinheiro volte na hora.

Verifique o cabeçalho X-OTPRoute-Signature em cada entrega (um HMAC-SHA256 sobre o timestamp e o corpo bruto) e descarte timestamps antigos. A documentação para desenvolvedores lista os limites da conta: 10 chaves, 5 endpoints de webhook, 300 requisições por minuto.

Como armazenar e normalizar números +359?

Os búlgaros escrevem os números no país com um 0 de tronco inicial, então um celular escrito como 088 123 4567 vira +359 88 123 4567 no formato internacional; o zero desaparece depois do código de país. Persista a forma E.164 e formate apenas para exibição. Se um formulário aceita entrada local, remova espaços, traços e esse dígito de tronco antes da validação. Um bug clássico é salvar +3590…, para o qual nenhuma rota entregará nada.

O alfabeto também importa. O búlgaro se escreve em cirílico, e os serviços que localizam seus textos envolvem o código em palavras cirílicas. Mensagens em cirílico trafegam em UCS-2, o que reduz um único segmento a 70 caracteres, então um modelo localizado longo pode chegar dividido. Se uma regex extrai os seus dígitos, teste-a com contextos em cirílico, e não só em inglês.

E se o código nunca aparecer?

Deixe a janela de 20 minutos correr antes de tirar conclusões; alguns apps enviam com atraso ou só depois de um segundo toque em "reenviar". Se nada chegar, a OTP Route devolve o valor total à carteira automaticamente, e o evento activation.expired avisa o seu sistema que o espaço foi encerrado. Depois disso:

• Tente de novo mais tarde, ou escolha outra rota para o mesmo serviço.
• Confirme se o serviço aceita números virtuais; alguns os recusam, e é exatamente por isso que o reembolso existe.
• Espere entre as tentativas em vez de refazer o pedido em loop.

Nosso texto sobre como reduzir entregas de OTP que falham vai além.

Existe uma linha búlgara de longo prazo, e como é a cobrança?

Hoje não existe número búlgaro de longo prazo em autoatendimento. Os Números Dedicados são um produto dos EUA e do Canadá a partir de $1.95/mês; se sua equipe precisa de uma linha +359 duradoura, escreva para [email protected] e a equipe vai avaliar, embora as regras locais decidam se isso é possível.

O pagamento dos códigos +359 funciona por uma única carteira pré-paga em USD: sem mensalidade, sem faixa para escolher. Recargas por cartão e por USDT/USDC são aceitas, e a fatura em PDF de cada uma chega à sua caixa de entrada. Para o trabalho de integração, peça que uma conta de desenvolvimento seja colocada em sandbox, que devolve números e códigos simulados para exercitar o fluxo sem gastar os fundos da carteira. As tarifas atuais estão na página de preços.

Perguntas frequentes

Posso testar o fluxo de cadastro búlgaro do meu app sem um chip local?

Sim. Peça um número +359 para testes pelo OTP Gateway, dispare o cadastro do seu app e leia o código no painel ou pela API.

Qual é o id de país da Bulgária na API de verificação por SMS?

Use bg no campo country de POST /api/v1/activations e nas consultas de preço. Os ids de serviço vêm de GET /api/v1/services.

Quanto custa um número de verificação búlgaro?

Os códigos búlgaros partem de $0.20 por código, com a tarifa definida por serviço. O valor exato é retornado por GET /api/v1/prices e exibido no painel antes de você confirmar.

Sou cobrado se o código nunca chegar?

Não. Quando nenhum SMS chega ao número em 20 minutos, ou se você cancela antes, o valor integral volta para a sua carteira automaticamente.

Os códigos búlgaros chegam em texto cirílico ou latino?

Depende do serviço e das configurações de idioma da conta que está sendo verificada. Construa seu parser para lidar com os dois alfabetos ao redor dos dígitos.

Posso manter o mesmo número +359 para logins futuros?

Não pelo OTP Gateway, porque cada número cobre uma única verificação. Os números de longo prazo em autoatendimento existem apenas nos EUA e no Canadá; para a Bulgária, escreva para [email protected] e pergunte.

A OTP Route serve para registrar muitas contas?

Não. Ela serve para testar e operar seus próprios produtos e contas empresariais legítimos; siga os termos de cada serviço, e a Política de Uso Aceitável da OTP Route se aplica.

Como começo com os números búlgaros?

Crie uma conta com seu e-mail e um código de 6 dígitos ou com o login do Google, recarregue a carteira e depois faça o pedido pelo painel ou gere uma chave de API.

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.