Números de verificação marfinenses +225 para QA, lançamentos e operações regionais

O que mudou nos números de telefone marfinenses e como armazená-los?

A Costa do Marfim passou de números de assinante de oito para dez dígitos no início de 2021; por isso, fixtures de teste e regras de validação escritas antes disso são uma fonte comum de falhas silenciosas. Um número nacional atual tem dez dígitos, e os móveis começam com 01, 05 ou 07.

O detalhe que pega os engenheiros de surpresa: esse zero inicial não é um prefixo de tronco. Ele faz parte do número do assinante e permanece na forma internacional; assim, um celular marfinense fica +225 07 xx xx xx xx em E.164.

• Persista a string completa, +225 mais todos os dez dígitos, e adicione espaçamento apenas ao exibir.
• Desative qualquer regra genérica que remova o zero inicial em entradas +225; ela produz um valor de nove dígitos que nenhuma rede roteia.
• Trate uma entrada de oito dígitos como legado e peça ao usuário que a digite de novo, em vez de adivinhar o prefixo que falta.
• Mantenha atualizada a sua biblioteca de números de telefone, porque os metadados do plano de numeração da África Ocidental mudam de tempos em tempos.

Por que as equipes de produto e QA testam com números +225?

Abidjan é o centro comercial da África Ocidental francófona, o que faz da Costa do Marfim uma primeira parada frequente quando uma empresa se expande para a parte francófona da região. Motivos típicos para manter um número +225 de testes no plano:

• Lançamento de mercado: confirmar que cadastro, login e recuperação funcionam de ponta a ponta com um número local antes de o marketing entrar no ar.
• QA de localização: o francês é o idioma oficial; portanto, os SMS de verificação de apps globais costumam chegar em francês, ou em inglês quando a localidade da conta assim indica. Extraia os dígitos em vez de procurar uma frase fixa.
• Onboarding de carteira e pagamentos: o dinheiro móvel é muito usado, e muitos produtos financeiros tratam o número de telefone como a identidade principal do cliente. O guia de onboarding fintech trata desse padrão.
• Operações regionais: equipes que atendem mercados vizinhos como o Senegal costumam rodar as checagens marfinenses na mesma suíte.

Que serviços podem entregar um código a um número marfinense?

O catálogo ao vivo da Costa do Marfim lista mais de 800 serviços. As rotas populares no retrato atual incluem WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Uber, Signal e Viber.

O estoque muda ao longo do dia; portanto, trate qualquer lista como ponto de partida e pergunte à API o que pode ser pedido agora. O preço de um determinado par também pode variar de um serviço para outro, e é por isso que ele é informado ao vivo, em vez de impresso em uma tabela.

Como é, na prática, o fluxo da API de OTP da Costa do Marfim?

Aponte o seu cliente HTTP para https://otproute.com/api/v1 e autentique-se com uma chave Bearer or_live_ do console do desenvolvedor; para pedidos marfinenses, o ID de país é ci.

Uma execução de testes costuma começar com GET /api/v1/balance, para que uma carteira esgotada derrube o job logo de início. Em seguida, GET /api/v1/prices?country=ci&service=<id> confirma o preço atual e se há estoque para aquele par. O pedido em si é POST /api/v1/activations com um corpo como {"service": "whatsapp", "country": "ci"}; a resposta traz um ID de ativação e o número +225 para digitar no seu próprio app.

A partir daí, você pode fazer polling em GET /api/v1/activations/{id} ou, melhor para suítes paralelas, assinar um webhook para activation.sms_received, activation.expired e activation.cancelled. Cada entrega é assinada no cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>): recalcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte timestamps antigos. O passo a passo do HMAC e a documentação da API aprofundam o tema. O limite é de 300 requisições por minuto por conta, de sobra para um harness de testes de API de verificação por SMS.

Quem não programa pode pedir um número +225?

Pode. A equipe de operações e as agências costumam preferir o painel, que segue as mesmas regras de roteamento de OTP da API.

1. Crie uma conta em cadastro com o seu e-mail e um código de 6 dígitos, ou com o Google.
2. Adicione fundos à carteira em USD.
3. Escolha a Costa do Marfim e depois o serviço que você está verificando; o preço aparece antes de você confirmar.
4. Copie o número para o campo de telefone do app e peça o código.
5. O SMS aparece no cartão da ativação assim que for recebido.

A ativação fica aberta por 20 minutos. Se nada chegar, ou se você cancelar antes, o valor integral é devolvido automaticamente à carteira.

O que tentar quando um código marfinense não chega?

Códigos ausentes costumam ter uma causa comum; por isso, passe por estes pontos antes de escalar:

• Alguns serviços recusam números virtuais em certos países ou tipos de conta; o reembolso existe exatamente para esse caso.
• Deixe a janela de 20 minutos terminar, em vez de cancelar após um minuto, já que alguns remetentes enfileiram mensagens.
• Tente de novo mais tarde, ou com o mesmo serviço em outra rota de país, se o seu teste permitir.
• Não repita pedidos a cada poucos segundos; espaçar as novas tentativas mantém saudáveis tanto a sua carteira quanto a rota.

Siga sempre os termos de cada serviço; a Política de Uso Aceitável da OTP Route vale para todo pedido.

Há uma linha marfinense de longo prazo e como funciona a cobrança?

Não existe número de longo prazo self-service para a Costa do Marfim. As linhas dedicadas são um produto dos EUA e do Canadá a partir de $1.95/mês; se a sua equipe precisa de uma linha marfinense duradoura, escreva para [email protected] para perguntar, ciente de que a disponibilidade depende das regras locais e pode não ser possível.

A cobrança é pay as you go a partir de uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Os orçamentos de teste marfinenses podem ser carregados com cartão ou em USDT/USDC, e a fatura em PDF que acompanha cada depósito chega à caixa de entrada do dono da conta. Para trabalho de integração, uma conta de desenvolvimento pode ser passada para sandbox sob solicitação, de modo que o fluxo completo devolva números e códigos simulados sem tocar nos fundos da carteira. Os valores atuais estão na página de preços.

Perguntas frequentes

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

Sim. Peça um número +225 no OTP Gateway para o serviço que você está testando, digite-o no seu formulário de cadastro e leia o código no painel ou pela API.

Devo remover o zero depois de +225 ao salvar um número?

Não. Desde a mudança de 2021, o zero inicial faz parte do número marfinense de dez dígitos e deve ser mantido no armazenamento E.164.

Qual é o ID da Costa do Marfim na API da OTP Route?

É ci. Use-o no campo country ao chamar POST /api/v1/activations ou ao consultar preços.

Sou cobrado se o código marfinense nunca chegar?

Não. Você só paga quando o código chega; uma ativação expirada ou cancelada é reembolsada integralmente na sua carteira.

Em que idioma estará o SMS de verificação?

Quem decide é o serviço remetente, mas o francês e o inglês são os mais comuns em contas marfinenses; portanto, extraia o código numérico em vez de comparar texto.

Posso manter o mesmo número +225 para logins futuros?

Não como produto self-service, porque cada número do OTP Gateway cobre um código. Os números dedicados de longo prazo só são oferecidos de forma instantânea nos EUA e no Canadá; para a Costa do Marfim, você pode escrever ao suporte para perguntar.

Como evito gastar fundos da carteira enquanto monto a integração?

Peça o modo sandbox para uma conta de desenvolvimento. Ele devolve números e códigos simulados, para que você teste webhooks e polling 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.