Testando cadastros na República Dominicana: checklist prévio e passo a passo

O que deve constar no checklist antes de pedir um número dominicano?

A maioria das execuções de teste que falham em um mercado novo remonta à configuração, e não à rota. Confira estes itens antes da primeira ativação:

• Id do serviço do app em teste, obtido em GET /api/v1/services.
• Id do país do, confirmado em GET /api/v1/countries.
• Preço ao vivo desse par em GET /api/v1/prices?country=do&service=<id>, para que o orçamento do teste seja conhecido de antemão.
• Saldo da carteira verificado com GET /api/v1/balance, para que um job de CI não trave no meio.
• Endpoint de webhook registrado no console do desenvolvedor, com o segredo de assinatura guardado no seu gerenciador de segredos.
• Parser de telefone configurado para tratar o número como região DO, e não como uma linha genérica +1.
• Texto em espanhol revisado nos seus próprios templates de verificação, se você mesmo enviar códigos a usuários dominicanos.

O guia de testes de QA detalha como as equipes estruturam esse tipo de checklist prévio.

Como os números de telefone da República Dominicana são formatados e armazenados?

A República Dominicana faz parte do Plano de Numeração Norte-Americano, então seus números compartilham o código de país +1 com os Estados Unidos, o Canadá e boa parte do Caribe. Três códigos de área atendem o país: 809, 829 e 849. Um número completo tem dez dígitos depois do +1, e não há 0 de tronco a remover.

Esse prefixo compartilhado é o detalhe que pega os engenheiros de surpresa. Um validador que associa todo número +1 aos EUA vai rotular errado os usuários dominicanos, aplicar a localidade errada e, às vezes, encaminhá-los para a fila de suporte errada. Armazene os números em E.164 (+1809…, +1829…, +1849…), mantenha a região ISO DO junto de cada registro e derive o país do código de área, e não apenas do código do país. Quando um usuário digitar um formato local como 809-555-0100, normalize-o na entrada e mostre-o de volta no estilo nacional.

Por que as equipes de produto testam com um número +1 da República Dominicana?

O espanhol é o idioma oficial, então um teste dominicano costuma ser a primeira verificação real de um fluxo de onboarding em espanhol fora da Espanha ou do México. Aparecem vários motivos práticos:

• Lançamentos no Caribe: confirmar que a tela de cadastro, o texto de consentimento e as mensagens de erro ficam corretos para usuários dominicanos.
• Clientes da diáspora: muitos dominicanos vivem nos Estados Unidos, e apps que atendem os dois lados precisam aceitar os dois tipos de número +1.
• Operações de hotelaria e viagens: o turismo é uma parte importante da economia, então apps de reservas e de transporte são testados aqui com frequência.
• Idioma da mensagem: os serviços globais costumam localizar o SMS no idioma da conta ou do dispositivo, enquanto os remetentes locais tendem a escrever em espanhol. A sua lógica de extração deve ler os dígitos, e não depender das palavras ao redor.

Quais serviços podem enviar códigos para um número de verificação da República Dominicana?

O snapshot ao vivo de do lista apps populares como WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Airbnb, Amazon, Microsoft & Outlook, Discord, Signal, Netflix e eBay. No catálogo inteiro, a rota cobre mais de 1.000 serviços.

A disponibilidade de cada par muda ao longo do dia conforme os parceiros de operadora acrescentam e consomem capacidade. Trate a lista acima como um guia e deixe a API decidir: GET /api/v1/prices só retorna o que pode de fato ser pedido agora.

Passo a passo: recebendo um OTP por SMS da República Dominicana pela API

1. Autentique cada chamada com uma chave Bearer que comece com or_live_; uma conta pode ter até 10 chaves.
2. Envie POST /api/v1/activations com o corpo {"service": "<id>", "country": "do"}. A resposta traz o id da ativação e o número +1.
3. Digite esse número no formulário de cadastro do app que você está testando.
4. Aguarde activation.sms_received no seu webhook. Verifique o cabeçalho X-OTPRoute-Signature calculando o HMAC-SHA256 do timestamp, um ponto e o corpo bruto com o segredo do endpoint, e recuse timestamps antigos.
5. Se você não puder expor um endpoint público, consulte GET /api/v1/activations/{id}, ficando abaixo do limite de 300 requisições por minuto.
6. Chame POST /api/v1/activations/{id}/cancel quando um teste for abortado, para que os fundos voltem na hora.

A referência da API lista todos os campos, e o texto sobre como proteger webhooks de OTP com HMAC explica a verificação de assinatura com mais profundidade.

Passo a passo: o caminho pelo painel para quem não programa

Líderes de suporte e profissionais de marketing podem executar o mesmo teste sem código. Crie uma conta com o seu e-mail e o código de seis dígitos, recarregue a carteira, escolha o serviço, escolha República Dominicana e copie o número que aparecer. O texto de verificação surge no cartão da ativação assim que chega. Cada número recebe um código, e o pedido se encerra após 20 minutos; se nada chegou, o dinheiro volta para a carteira automaticamente.

Solução de problemas, linhas de longo prazo e cobrança

Quando um código não aparece, percorra esta lista antes de pedir de novo:

• Deixe a janela de 20 minutos correr até o fim; alguns remetentes enfileiram mensagens.
• Verifique se o app de destino recusa números virtuais. Alguns recusam, e é exatamente por isso que os pedidos não utilizados são reembolsados.
• Tente de novo mais tarde com o mesmo par, ou use outra rota de serviço se o seu fluxo permitir.
• Evite refazer o pedido em um laço rápido. Espere entre as tentativas.

Não há número dominicano de longo prazo com contratação self-service. Se você precisa de uma linha que fique com você, escreva para [email protected]; se uma pode ser oferecida depende das regras locais. As linhas dedicadas são um produto dos EUA e do Canadá, a partir de $1.95/month.

A carteira é pré-paga em USD, sem mensalidade. Recarregue por cartão ou USDT/USDC e receba uma fatura em PDF por e-mail a cada pagamento. Para o trabalho de integração, peça ao suporte que coloque uma conta de desenvolvimento em sandbox, que devolve números e códigos simulados. Veja os preços para o modelo atual.

Perguntas frequentes

Posso testar o cadastro do meu app na República Dominicana sem um chip local?

Sim. Peça um número +1 para o país do pelo OTP Gateway e leia o código no painel ou pela API, sem chip nem aparelho envolvidos.

Quais códigos de área os números dominicanos usam?

Os números dominicanos usam os códigos de área 809, 829 e 849 sob o código de país +1. Armazene-os em E.164 e mantenha a região DO junto de cada registro.

Quanto custa um número de verificação da República Dominicana?

As ativações dominicanas começam em $0.20 por código, e o valor varia de um app para outro. O valor exato volta de GET /api/v1/prices antes de você fazer o pedido.

Serei cobrado se o SMS nunca chegar?

Não. Se nenhuma mensagem chegar em 20 minutos, ou se você cancelar antes, o valor integral volta para a sua carteira.

Posso manter o mesmo número dominicano para logins futuros?

Não por self-service; cada número temporário recebe um único código. Escreva para [email protected] para perguntar sobre opções de longo prazo, que dependem das regras locais.

A OTP Route é adequada para suítes de teste automatizadas?

Sim. Os endpoints REST, os webhooks assinados e uma conta sandbox opcional permitem que jobs de CI exercitem um fluxo de cadastro dominicano de ponta a ponta. Siga os termos de cada app e a Política de Uso Aceitável da OTP Route.

As mensagens de verificação dominicanas chegam em espanhol?

Com frequência, embora muitos apps globais escrevam o SMS no idioma definido na conta ou no dispositivo. Interprete o código numérico em vez de procurar um texto fixo.

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.