Um checklist para receber códigos de verificação de Comores (+269)

Uma equipe pode receber SMS de Comores sem ter um chip local?

Pode. Enviar um chip para Moroni só para que um testador leia um código é lento e difícil de repetir, além de prender o calendário de releases a uma pessoa com um celular na mão. Com a OTP Route, você pede um número +269 para um serviço escolhido, dispara o código no app em teste e o recolhe por software. A mesma rota serve para um gerente de produto clicando no painel e para um job de CI que nunca abre um navegador.

O restante desta página está organizado como um checklist, depois os passos exatos e, por fim, as soluções para os casos em que a mensagem não aparece.

Checklist antes de pedir um número +269

Passe por estes itens uma vez por projeto e a maioria das tentativas fracassadas desaparece antes de acontecer:

• Uma chave de API começando com or_live_, criada no console do desenvolvedor. Você pode ter até 10 chaves; dê ao CI a sua própria e revogue-a de forma independente.
• Um endpoint de webhook (até 5 por conta) que verifique o cabeçalho X-OTPRoute-Signature, ou um laço de polling se você não puder expor uma URL pública.
• Fundos na carteira em USD, ou uma conta sandbox se você só quer exercitar a integração sem gastar nada.
• Um normalizador no seu código que armazene os números de Comores em formato E.164 (detalhes mais abaixo).
• Confirmação de que o serviço de destino aceita números virtuais. Algumas plataformas os recusam; é uma política do lado delas, e a regra de reembolso existe justamente para esse caso.
• Um orçamento de requisições. A API permite 300 requisições por minuto por conta; portanto, faça polling em um intervalo razoável, em vez de martelar o endpoint de status.

Quais apps podem enviar códigos para a rota de Comores agora?

O retrato ao vivo de Comores lista mais de 800 serviços. Entre os populares estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, ChatGPT (OpenAI), Claude, Amazon, Discord, LinkedIn, Signal e Viber.

O estoque muda ao longo do dia, e por isso a API devolve a disponibilidade ao vivo, em vez de publicar um catálogo fixo. Trate esta lista como ponto de partida e confirme com GET /api/v1/countries e GET /api/v1/services antes que uma execução de testes dependa de um par específico.

Passo a passo: a sequência da API de OTP de Comores

A URL base é https://otproute.com/api/v1, e toda requisição leva Authorization: Bearer <key>.

1. Leia o preço atual com GET /api/v1/prices?country=km&service=<id>, em que km é o ID de país de Comores e o ID do serviço vem da lista de serviços.
2. Crie a ativação com POST /api/v1/activations e o corpo {"service": "<id>", "country": "km"}. A resposta traz o número +269 e um ID de ativação.
3. Digite esse número no formulário de cadastro ou login que você está testando.
4. Espere activation.sms_received no seu webhook, ou chame GET /api/v1/activations/{id} a cada poucos segundos.
5. Se o teste for abortado, chame POST /api/v1/activations/{id}/cancel para liberar a reserva no seu saldo.

Para verificar a assinatura, calcule um HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare com o valor v1 e recuse requisições com timestamp antigo. A documentação da API traz a referência completa.

A mesma tarefa sem escrever código

A equipe de suporte e os gerentes de contas de agências fazem tudo pelo navegador. Entre na conta, abra o OTP Gateway, escolha Comores, selecione o serviço e confira o preço mostrado antes de confirmar. O número aparece na hora; cole-o no app e mantenha a página aberta. Quando o SMS chegar, o código é exibido ao lado da ativação e você pode copiá-lo direto para o campo de verificação.

Solução de problemas quando nenhum código +269 chega

O silêncio costuma ser um problema de roteamento ou de aceitação, e não um bug no seu cliente. Siga nesta ordem:

• Dê tempo à janela. Uma ativação fica ativa por 20 minutos; reenviar o código pelo app dentro dessa janela não tem problema.
• Não peça de novo em um laço apertado. Disparar novas ativações a cada poucos segundos gasta seu orçamento de requisições e raramente ajuda.
• Tente mais tarde ou por outra rota. Um par de serviço diferente, ou um país vizinho como Madagascar, pode se comportar de outro jeito no dia.
• Verifique a aceitação. Se o app recusa números virtuais, nenhuma nova tentativa vai mudar isso.

Você só paga quando um código é entregue. Quando a janela fecha vazia, ou você cancela, o valor integral é creditado de volta automaticamente. O guia sobre como reduzir falhas na entrega de OTP aprofunda o assunto.

Como armazenar números +269 e em que idioma chegam os códigos?

Os números de Comores são curtos: o código do país +269 seguido de um número nacional de sete dígitos, sem prefixo de tronco para remover. Armazene-os em formato E.164, +269 mais sete dígitos sem espaços, e rejeite entradas com um zero inicial copiado de hábitos de outros países.

Os idiomas oficiais são o comoriano, o francês e o árabe. Apps globais geralmente enviam os códigos em inglês ou francês, conforme a localidade da conta; portanto, o seu parser deve procurar a sequência de dígitos, e não uma frase fixa. As equipes testam aqui quando atendem a comunidade comoriana no exterior, fazem QA de localização em francês ou preparam um lançamento na África Oriental e no Oceano Índico.

Carteira, sandbox e linhas de longo prazo

A cobrança é feita em uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher; recarregue com cartão ou com USDT/USDC, e cada recarga chega com uma fatura em PDF por e-mail. Os valores atuais estão na página de preços. Peça o modo sandbox para uma conta de desenvolvimento a fim de receber números e códigos simulados enquanto monta a integração.

A OTP Route não tem número de longo prazo self-service para Comores. Os Números Dedicados são um produto dos EUA e do Canadá a partir de $1.95/mês; se você precisa de uma linha +269 duradoura, escreva para [email protected] e a equipe dirá se as regras locais permitem, sem nenhuma promessa de que permitam.

Perguntas frequentes

Posso testar o fluxo de cadastro de Comores do meu app sem um chip local?

Sim. Peça um número +269 no OTP Gateway, digite-o no seu formulário de cadastro e leia o código no painel ou no seu webhook.

Qual é o ID do país Comores na API da OTP Route?

É km. Passe-o como valor de country ao consultar preços ou criar uma ativação.

Quanto custa um código de verificação de Comores?

As ativações de Comores começam em $0.20 por código, e o valor depende do serviço escolhido. O valor exato é devolvido por GET /api/v1/prices e mostrado no painel antes de você confirmar.

O que acontece se o código nunca chegar?

Depois de 20 minutos a ativação expira e a cobrança integral volta para a sua carteira. Cancelar antes dispara o mesmo reembolso.

Preciso remover um zero inicial dos números de Comores?

Não há prefixo de tronco em Comores; portanto, o formato armazenado é simplesmente +269 seguido do número de sete dígitos.

Existe alguma política de uso que eu deva conhecer?

Use números de Comores apenas para testar ou operar suas próprias contas e produtos legítimos, siga os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route se aplica. Crie uma conta quando estiver pronto.

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.