Levando códigos de verificação de Cabo Verde (+238) para a sua pilha de testes

Quais endpoints uma ativação +238 usa?

Uma integração com a API de OTP de Cabo Verde precisa de poucas chamadas sob https://otproute.com/api/v1. Toda requisição leva uma chave Bearer que começa com or_live_, gerada no console de desenvolvedor. O id de Cabo Verde é cv; o id do serviço é o valor api_service do app que você está testando.

1. GET /api/v1/services e GET /api/v1/countries trazem os catálogos; guarde-os em cache por um dia.
2. GET /api/v1/prices?country=cv&service=<id> lê o preço atual e informa se a rota está aberta agora. O estoque muda ao longo do dia, então consulte antes de cada pedido em vez de fixar valores no código.
3. POST /api/v1/activations com {"service": "whatsapp", "country": "cv"} retorna um id de ativação e o número +238 para digitar no seu formulário de cadastro.
4. GET /api/v1/activations/{id} permite consultar o código por polling se você não usa webhooks.
5. POST /api/v1/activations/{id}/cancel libera o número quando um teste é interrompido, e o valor reservado volta para a carteira.

Uma chamada prévia a GET /api/v1/balance deixa a suíte parar cedo em vez de falhar no meio. O limite é de 300 requisições por minuto por conta, e a referência da API lista todos os campos.

Como aceito o webhook assinado de um código de Cabo Verde?

O polling serve para um script isolado; quando vários jobs rodam em paralelo, um webhook fica mais organizado. Registre um endpoint no console de desenvolvedor (uma conta pode ter cinco) e assine activation.sms_received, activation.expired e activation.cancelled.

Cada POST chega com um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Reconstrua a string <t>.<raw body>, assine-a com HMAC-SHA256 usando o segredo daquele endpoint e compare o resultado com v1 por uma checagem em tempo constante. Descarte tudo cujo timestamp tenha mais de alguns minutos, para que uma requisição capturada não possa ser reenviada. Depois, indexe o processamento pelo id da ativação: se o mesmo evento chegar duas vezes, a segunda cópia não deve mudar nada. Nosso artigo sobre como proteger webhooks de OTP com HMAC cobre os casos de borda.

Quais apps podem enviar códigos a um número cabo-verdiano hoje?

O catálogo ativo de cv cobre mais de 800 serviços. Entre os populares abertos no momento estão WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram e Netflix. Leia essa lista como um retrato do momento: as rotas abrem e fecham conforme a capacidade dos parceiros, e esse é justamente o sentido de rotear OTP por uma API que informa a disponibilidade em tempo real, em vez de uma página que a promete.

Se ninguém na equipe escreve código, o painel faz o mesmo trabalho. Escolha o serviço, escolha Cabo Verde, confirme o preço na tela e copie o número. O código aparece no cartão da ativação quando chegar.

Como fica um número +238 na hora de armazená-lo?

Cabo Verde usa um plano de numeração fechado: números nacionais de sete dígitos e nenhum prefixo de tronco, então não há zero inicial para remover. Em E.164, um número é simplesmente +238 seguido desses sete dígitos. A normalização é, portanto, trivial, mas o comprimento curto atrapalha validadores que presumem números de assinante mais longos, motivo comum de um formulário rejeitar uma entrada cabo-verdiana perfeitamente válida. Armazene a string E.164, formate-a como a sua interface preferir e inclua um caso +238 nos testes unitários do campo de telefone.

O português é o idioma oficial, enquanto o crioulo cabo-verdiano é o que a maioria fala no dia a dia, então confira como um modelo de OTP em português aparece num aparelho de lá. As equipes costumam pegar um número +238 para testes por causa da diáspora: comunidades cabo-verdianas nos Estados Unidos, em Portugal e em outras partes da Europa mantêm contas ligadas a números de origem, e produtos de remessas, viagens e mensagens querem que esses cadastros funcionem.

O que acontece com a carteira se nenhum SMS chegar em 20 minutos?

Cada ativação fica aberta por 20 minutos. Se um código chegar nessa janela, a cobrança permanece; se a janela fechar vazia, ou se você cancelar antes, o valor integral volta para a carteira sem abrir chamado de suporte. Quando nada chega:

• Deixe a janela correr até o fim em vez de disparar um novo pedido a cada poucos segundos; um loop de novas tentativas só trava saldo.
• Tente de novo mais tarde, ou exercite o mesmo fluxo por outra rota de serviço.
• Confirme que o app aceita números virtuais; alguns os recusam por política, e o reembolso existe exatamente para esse caso.
• Verifique se o seu formulário enviou o número +238 completo, e não um truncado.

O guia sobre como reduzir falhas na entrega de OTP aprofunda o diagnóstico.

Posso manter um número de Cabo Verde para logins repetidos?

Não em autoatendimento. Os Dedicated Numbers da OTP Route, linhas de longo prazo com SMS de entrada e saída, chamadas pelo navegador e encaminhamento por webhook, são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês. Não existe linha +238 de longo prazo em autoatendimento. Se a sua equipe tem uma necessidade real, escreva para [email protected]; se é possível providenciar depende das regras locais e não é garantido. Para uma conta de staging que precisa entrar várias vezes, um número virtual dos EUA ou do Canadá costuma ser a resposta prática.

Como o uso é cobrado e testado antes de entrar no ar?

A cobrança sai de uma única carteira pré-paga em USD, sem mensalidade e sem níveis de plano. Recarregue por cartão ou com stablecoins USDT/USDC; cada recarga vem com uma fatura em PDF por e-mail, o que facilita a conciliação do financeiro. Antes de as chaves de produção tocarem a carteira, peça que sua conta de desenvolvimento seja trocada para o sandbox: ele devolve números e códigos simulados, e o caminho de pedido, webhook e cancelamento do seu cliente de API de verificação por SMS pode rodar no CI sem gastar nada. Veja preços e a visão geral de testes de QA. Siga os termos de cada serviço e a Política de Uso Aceitável da OTP Route em todo o processo.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app em Cabo Verde sem um chip local?

Sim. Peça um número +238 no OTP Gateway, digite-o no seu formulário de cadastro e leia o código no painel, na API ou por webhook. Ninguém da equipe precisa estar nas ilhas.

Qual é o id de Cabo Verde na API da OTP Route?

É cv. Passe-o como country em POST /api/v1/activations e na consulta de preços.

Preciso colocar um 0 antes de um número cabo-verdiano?

Não. Cabo Verde não tem prefixo de tronco, então a forma internacional é apenas +238 mais o número nacional de sete dígitos.

Quanto custa um número de verificação de Cabo Verde?

Os preços do OTP Gateway começam em $0.20 por código e variam por serviço; a API e o painel mostram o valor exato antes do pedido. Você só é cobrado se um código chegar.

Todo app envia códigos a um número virtual cabo-verdiano?

Não. Alguns serviços recusam números virtuais, e as rotas mudam ao longo do dia. Se nenhum código chegar em 20 minutos, o valor volta para a carteira.

Existe um sandbox para testar a integração +238?

Sim, sob solicitação. Uma conta de desenvolvimento pode ser trocada para o modo sandbox, que devolve números e códigos simulados para que a integração rode de ponta a ponta sem gasto da carteira.

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.