Códigos de verificação salvadorenhos (+503) para equipes de QA e de lançamento

Código de uso único ou linha de longo prazo: o que um teste salvadorenho precisa?

Comece pelo formato do teste, porque ele decide o produto.

• Uma única etapa de verificação (cadastro, troca de telefone, uma checagem adicional) corresponde ao OTP Gateway. Você pede um número +503 para um serviço, o código chega uma vez e o número cumpriu seu papel.
• Uma conta que precisa continuar fazendo login por semanas exige uma linha que seja sua. Os Dedicated Numbers são um produto dos EUA e do Canadá, a partir de $1.95/month, comprados na hora pelo painel, com SMS de entrada, SMS de saída e chamadas pelo navegador.

Para El Salvador não há Dedicated Number com contratação self-service. Se a sua equipe realmente precisa de uma linha salvadorenha de longo prazo, escreva para [email protected]; se é possível providenciar uma depende das regras locais e não é garantido. Muitas equipes resolvem o caso do "login repetido" com uma linha dos EUA, quando o serviço em teste a aceita. Para um lançamento salvadorenho, pese os dois caminhos com as notas sobre números temporários vs dedicados.

Como os números +503 devem ser armazenados e validados?

El Salvador usa um plano de numeração fechado de 8 dígitos, sem prefixo de tronco. O número que um morador escreve num formulário é o mesmo de 8 dígitos que vem depois do +503 na forma internacional, então a normalização consiste sobretudo em remover pontuação: os moradores costumam escrever celulares em dois blocos de quatro separados por hífen.

• Armazene a forma E.164, +503 seguido de oito dígitos, numa única coluna.
• Os celulares geralmente começam com 6 ou 7; as linhas fixas costumam começar com 2. Um validador que aceita apenas esses dígitos iniciais pega a maioria dos erros de digitação.
• Rejeite um 0 inicial extra. Usuários acostumados com outros planos latino-americanos às vezes o acrescentam, e algumas plataformas de SMS descartam a mensagem sem avisar.

Os templates de SMS do seu app para esse mercado normalmente estão em espanhol. Caracteres como á, í ou ó estão fora do alfabeto GSM básico, então um template que os use pode passar para a codificação UCS-2 e encurtar cada segmento. Mantenha o código perto do início da mensagem para que ele sobreviva a uma divisão.

Por que as equipes testam fluxos de cadastro em El Salvador?

Alguns padrões aparecem repetidamente:

• Lançamentos na América Central. Um produto que chega à Guatemala, a Honduras e a El Salvador quer a etapa de telefone de cada país verificada antes de os anúncios entrarem no ar.
• Clientes da diáspora. Muitos salvadorenhos vivem nos Estados Unidos e mantêm um número +503 para a família, então produtos de remessas, pagamentos e mensagens recebem números salvadorenhos mesmo quando o endereço do usuário é americano. Veja o onboarding fintech para esse fluxo.
• QA de localização. O texto em espanhol, o seletor de país e as máscaras de número precisam de um código salvadorenho real para confirmar que as telas funcionam de ponta a ponta.
• Preços em dólares americanos. O dólar americano é a moeda oficial de El Salvador, o que torna o mercado um lugar conveniente para testar checkout e onboarding juntos.

Como é a sequência de chamadas da API OTP de El Salvador?

Todas as requisições vão para https://otproute.com/api/v1 com uma chave Bearer de prefixo or_live_, criada no console do desenvolvedor (até 10 chaves, 300 requisições por minuto). O id do país de El Salvador é sv.

1. Busque GET /api/v1/countries e GET /api/v1/services e guarde os ids em cache.
2. Leia o preço ao vivo com GET /api/v1/prices?country=sv&service=<id>; ele também informa se há uma rota disponível agora.
3. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "telegram", "country": "sv"}. Guarde o id da ativação e o número.
4. Faça a versão salvadorenha do seu app enviar o SMS de verificação para esse número.
5. Aguarde o evento activation.sms_received no seu endpoint; sem um, consulte GET /api/v1/activations/{id} a cada poucos segundos.
6. Se o fluxo for abandonado, chame POST /api/v1/activations/{id}/cancel para que os fundos voltem na hora.

Todo webhook traz X-OTPRoute-Signature: t=<unix>,v1=<hex>, um HMAC-SHA256 do timestamp, um ponto e o corpo bruto usando o segredo do seu endpoint. Verifique-o e descarte timestamps antigos; como proteger webhooks de OTP percorre o processo. Quem não programa pode fazer o mesmo pelo painel: escolha El Salvador, escolha um serviço, confirme o preço ao vivo e veja o código aparecer no cartão da ativação.

Quais serviços podem ser verificados em um número salvadorenho?

O snapshot ao vivo mostra mais de 900 serviços com rotas de El Salvador. Entre os populares estão WhatsApp, Facebook, Instagram, TikTok, Uber, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Telegram, Signal, LinkedIn e ChatGPT (OpenAI). A disponibilidade muda ao longo do dia, e é por isso que o endpoint de preços, e não uma lista fixa, deve guiar o seu executor de testes.

Alguns serviços recusam números que classificam como virtuais. Isso foge ao nosso controle, e é a razão de a regra de reembolso existir.

E se o código salvadorenho não chegar?

Um código +503 lento ainda não é um código que falhou, então deixe o pedido aberto pelos 20 minutos inteiros. Se nada chegar, o pedido expira, activation.expired é disparado e o valor integral volta para a sua carteira automaticamente. Depois:

• confirme se o serviço aceita números virtuais para esse tipo de etapa;
• tente de novo mais tarde, ou escolha outra rota de serviço, em vez de refazer o pedido em um laço rápido;
• verifique se o seu próprio app realmente enviou o SMS para o número exato retornado, no formato E.164.

Mais dicas de solução de problemas adequadas à América Central estão em como reduzir falhas na entrega de OTP.

Como funciona a cobrança dos pedidos de El Salvador?

A OTP Route usa uma única carteira pré-paga em USD, pague conforme o uso, sem mensalidade e sem plano para escolher. A recarga funciona por cartão ou stablecoins USDT/USDC, e uma fatura em PDF chega à sua caixa de entrada após cada recarga ou compra de número. Para o trabalho de integração, uma conta de desenvolvimento pode ser colocada em sandbox a pedido, devolvendo números e códigos simulados para que todo o ciclo rode sem gastar fundos da carteira. As tarifas atuais estão na página de preços.

Perguntas frequentes

Posso testar o cadastro do meu app em El Salvador sem um chip local?

Sim. Peça um número +503 no OTP Gateway para o serviço que você está testando, dispare o SMS e leia o código no painel ou pela API.

Os números salvadorenhos têm um prefixo de tronco como 0?

Não. Os números de El Salvador têm oito dígitos e nenhum prefixo de tronco, então a forma internacional é simplesmente +503 mais esses oito dígitos.

Qual é o id de El Salvador na API da OTP Route?

Use sv nas consultas de preço e no corpo da ativação, por exemplo GET /api/v1/prices?country=sv&service=<id>.

Sou cobrado se o número +503 nunca receber um código?

Não. Se nenhum SMS chegar dentro da janela de 20 minutos, ou se você cancelar antes, o valor integral é devolvido à sua carteira automaticamente.

Posso manter um número salvadorenho para logins repetidos?

Não como produto self-service. Os Dedicated Numbers de longo prazo são oferecidos nos Estados Unidos e no Canadá; para El Salvador, você pode escrever para [email protected] para perguntar, sem promessa de disponibilidade.

A OTP Route serve para criar muitas contas?

Não. Ela serve para 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.

Posso executar o fluxo salvadorenho no CI sem gastar dinheiro?

Sim. Uma conta de desenvolvimento pode ser colocada em sandbox a pedido, e ela devolve números e códigos simulados para que o seu pipeline exercite todo o caminho da 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.