Guia para desenvolvedores sobre códigos de verificação da Moldávia (+373)

Como é uma ativação +373, do pedido ao código?

Uma ativação é um objeto de curta duração com um id, um número de telefone e um status. Seu cliente se autentica em https://otproute.com/api/v1 com uma chave Bearer que começa com or_live_, gerada no console do desenvolvedor (até 10 chaves por conta, 300 requisições por minuto).

O ciclo de vida para a Moldávia é este. Seu job lê GET /api/v1/prices?country=md&service=<id> para confirmar que a rota está aberta e ver o preço do dia. Em seguida envia POST /api/v1/activations com {"service": "<id>", "country": "md"} e recebe o id da ativação e um número +373. O teste digita esse número no app de destino e dispara o SMS. A partir daí, a ativação fica ativa por 20 minutos; ela termina quando um código é recebido, quando você chama POST /api/v1/activations/{id}/cancel ou quando o tempo se esgota.

Os ids de serviço e o catálogo completo de países vêm de GET /api/v1/services e GET /api/v1/countries. Busque-os na inicialização em vez de deixá-los fixos no código, porque a lista ao vivo é a fonte de verdade. O guia de integração da API de OTP mostra um cliente completo.

Meu cliente da API de OTP da Moldávia deve fazer polling ou ouvir webhooks?

Os dois funcionam com a mesma API de verificação por SMS, e muitas equipes usam ambos: webhooks pela velocidade, polling como rede de segurança.

Webhooks. Adicione um endpoint no console do desenvolvedor (uma conta pode registrar cinco) e trate activation.sms_received, activation.expired e activation.cancelled. Valide o cabeçalho X-OTPRoute-Signature, no formato t=<unix>,v1=<hex>, calculando o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint e rejeitando timestamps vencidos. Baseie o processamento no id da ativação, para que uma entrega duplicada seja inofensiva.

Polling. Chame GET /api/v1/activations/{id} a cada poucos segundos com backoff e pare quando o status for final. Isso serve a runners de CI atrás de um firewall que não aceitam requisições de entrada. Nosso artigo sobre testes de SMS OTP em pipelines de CI trata de timeouts e novas tentativas nos dois padrões.

O que torna os números de telefone da Moldávia diferentes de tratar?

Os números nacionais da Moldávia têm oito dígitos depois do código de país +373, e a discagem doméstica acrescenta um prefixo de tronco 0 na frente. Os usuários digitam, portanto, o mesmo celular em vários formatos: com o 0 inicial, com +373 ou com 00373. Normalize removendo espaços e hifens, retirando o 0 doméstico ao adicionar o código de país e salvando a forma E.164. Um validador que insiste em um zero inicial rejeitará entradas internacionais corretamente formatadas, uma das primeiras coisas que um número +373 para testes costuma revelar.

O romeno é o idioma oficial e o russo é muito falado, então os textos de verificação de serviços locais podem chegar em qualquer um dos dois, ou em inglês nos apps globais. Mensagens em cirílico são enviadas em uma codificação mais ampla e são divididas de forma diferente do texto latino, algo que vale cobrir em qualquer parser que extraia o código.

As equipes testam na Moldávia quando localizam um app para romeno ou russo, atendem clientes da região ou têm equipes de suporte e engenharia em Chișinău cujas etapas de verificação precisam ser conferidas.

Quais apps encaminham códigos para a Moldávia atualmente?

A OTP Route lista mais de 1.700 serviços para a Moldávia. O snapshot atual dos populares inclui Telegram, Viber, WhatsApp, Signal, Facebook, Instagram, TikTok, Google (Gmail e YouTube), LinkedIn, Snapchat, Amazon, eBay, Netflix e Claude.

Trate isto como um retrato em movimento. O estoque muda ao longo do dia, então peça a lista ao vivo antes de cada execução e mantenha uma rota alternativa pronta para serviços instáveis. O artigo sobre roteamento por país explica como o roteamento de OTP para um país alternativo funciona sem mudar a lógica do seu teste.

Por que um código da Moldávia pode não aparecer?

Um serviço pode recusar números virtuais de vez, limitar tentativas repetidas ou entregar devagar em determinada rota. Nada disso custa nada a você, porque um código que não chega dentro da janela de 20 minutos significa um reembolso integral e automático na carteira.

Passos práticos quando isso acontece:

• Espere a janela terminar em vez de cancelar no primeiro silêncio.
• Confirme se o serviço aceita números virtuais.
• Tente de novo mais tarde, ou mude para outro país que o serviço suporte.
• Espace os pedidos repetidos; disparar novas ativações em um loop rápido é contraproducente.
• Registre os ids das ativações junto com os logs do app, para poder comparar execuções com falha e com sucesso.

Como alguém sem conhecimento de código pede um número da Moldávia?

Crie uma conta em cadastro usando e-mail e um código de 6 dígitos enviado por e-mail, ou o login do Google. No OTP Gateway, selecione o serviço, escolha a Moldávia, veja o preço ao vivo e confirme. Cole o número +373 no app que você está verificando; o código aparece no painel assim que for recebido. Você pode cancelar a partir da mesma tela e o valor volta direto para a carteira.

E as linhas duradouras, o acesso ao sandbox e o pagamento?

A OTP Route não vende um número moldavo de longo prazo por autoatendimento. Os Números Dedicados são oferecidos apenas nos Estados Unidos e no Canadá, a partir de $1.95/month. Para uma linha +373 duradoura, escreva para [email protected]; se é possível providenciar uma depende das regras locais.

O pagamento é conforme o uso, a partir de uma única carteira em USD, sem assinatura e sem níveis. Adicione saldo por cartão ou com USDT/USDC e receba uma fatura em PDF por e-mail a cada recarga. Desenvolvedores que queiram ensaiar uma integração antes podem pedir que a conta seja movida para o sandbox, onde números e códigos são simulados e a carteira não é tocada.

Perguntas frequentes

Posso receber um SMS OTP da Moldávia sem morar lá?

Sim. O OTP Gateway emite um número +373 que você pode usar de qualquer lugar, e o código é exibido no painel ou enviado ao seu cliente de API.

Qual id de país meu código deve enviar para a Moldávia?

Envie md como valor de country. Os ids de serviço vêm de GET /api/v1/services.

Devo armazenar os números da Moldávia com o 0 inicial?

Não. Armazene-os em E.164 como +373 mais os oito dígitos nacionais, descartando o prefixo de tronco doméstico.

O que acontece se eu cancelar uma ativação da Moldávia?

Chamar POST /api/v1/activations/{id}/cancel antes de um código chegar encerra a ativação e devolve o valor integral à sua carteira.

Existe um número de verificação da Moldávia que eu possa manter por meses?

Não por autoatendimento. Os Números Dedicados de longo prazo são um produto dos EUA e do Canadá; escreva para o suporte e pergunte sobre a Moldávia.

Posso usar a OTP Route para criar muitas contas em um mesmo app?

Não. Ela se destina a testar e operar os seus próprios produtos e contas legítimos, dentro dos termos de cada serviço e da Política de Uso Aceitável da OTP Route.

Minha suíte de testes pode rodar contra a Moldávia sem gastar dinheiro?

Sim, se você solicitar o modo sandbox para uma conta de desenvolvimento. Ele retorna números e códigos simulados para testes de ponta a ponta.

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.