Como testar cadastros +243 na RDC sem um chip em Kinshasa

Sua equipe vai lançar na RDC, mas ninguém tem um chip +243. E agora?

É uma situação comum para equipes de produto e QA: o roadmap diz República Democrática do Congo, o release candidate está pronto, e as pessoas que precisam aprovar a etapa de verificação por telefone estão em outro país. Enviar chips físicos para um laboratório de testes, mantê-los com crédito e passar aparelhos de mão em mão pelo escritório é lento e prende cada teste a quem estiver com o celular naquele dia.

O OTP Gateway elimina esse gargalo. Você pede um número +243 para um serviço específico, usa-o uma única vez na sua tela de cadastro ou login e o código chega onde as suas ferramentas conseguem lê-lo. Assim, um número de verificação do Congo (RDC) passa a ser algo que um script de testes pede sob demanda, como qualquer outro fixture.

Motivos típicos para fazer essa checagem:

• confirmar que uma tela de onboarding em francês aceita e formata corretamente números congoleses;
• fazer testes de regressão de um app móvel antes de um lançamento regional na África Central;
• permitir que uma equipe de operações verifique uma conta empresarial da empresa sem expor o telefone pessoal de um funcionário.

Que serviços um número +243 pode verificar agora?

A cobertura da RDC abrange atualmente mais de 1.000 serviços. Entre os populares no retrato ao vivo estão WhatsApp, Telegram, Facebook, Instagram, TikTok, imo, Viber, Signal, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Amazon e ChatGPT (OpenAI).

Vale destacar apps de mensagens como imo, Viber e WhatsApp, porque muitos produtos da região transferem suporte ou notificações para eles e o QA frequentemente precisa de uma conta na mesma faixa de numeração dos usuários reais.

O estoque muda ao longo do dia; portanto, trate qualquer lista como ponto de partida. A visão de referência é a ao vivo: GET /api/v1/countries e GET /api/v1/prices devolvem o que pode ser pedido neste momento, e o painel mostra os mesmos dados antes de você pagar. O catálogo completo está em todos os países.

Como a API de OTP do Congo (RDC) se encaixa em uma execução de testes?

Tudo acontece em https://otproute.com/api/v1 com uma chave Bearer de prefixo or_live_, criada no console do desenvolvedor. Uma conta pode ter até 10 chaves e 5 endpoints de webhook, e o limite é de 300 requisições por minuto.

1. Consulte os preços com GET /api/v1/prices?country=cd&service=whatsapp (troque pelo serviço que você testa). O ID de país da RDC é cd.
2. Faça o pedido com POST /api/v1/activations e um corpo JSON como {"service": "whatsapp", "country": "cd"}. Você recebe um ID de ativação e o número +243.
3. Digite esse número na etapa de verificação do seu app.
4. Espere activation.sms_received no seu webhook, ou faça polling em GET /api/v1/activations/{id} a cada poucos segundos.
5. Libere pedidos não usados com POST /api/v1/activations/{id}/cancel.

As chamadas de webhook trazem 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 guia de captura por webhook e a referência da API cobrem os detalhes dessa API de verificação por SMS.

Como armazenar números +243 e em que idioma virá o SMS?

Os números congoleses são escritos localmente com o prefixo de tronco 0 seguido de nove dígitos. Na forma internacional, o zero some: +243 e depois esses nove dígitos. Armazene a versão E.164, remova espaços e o zero inicial na entrada e teste se o seu formulário aceita tanto a grafia local quanto a internacional, já que os usuários digitam a que viram por último.

O francês é o idioma oficial, e o lingala, o suaíli, o quicongo e o tshiluba são idiomas nacionais. Os SMS de serviços globais geralmente chegam em francês ou inglês, dependendo do app e das configurações da conta. Não faça o parse pelo texto ao redor; extraia o grupo de dígitos do corpo para que o mesmo parser funcione em qualquer idioma do modelo.

Em uma revisão de localização, ajuda capturar o texto completo do SMS junto com o código extraído. Isso dá a tradutores e ao QA um registro do que um usuário congolês realmente lê.

E se o código de verificação não aparecer?

Cada pedido fica aberto por 20 minutos. Você só paga se o código chegar; se a janela fechar sem SMS, ou se você cancelar, o valor integral volta automaticamente para a carteira. Portanto, um número silencioso custa tempo, não dinheiro.

Quando isso acontecer:

• deixe a janela correr antes de concluir que falhou, porque alguns serviços enviam com atraso;
• tente de novo mais tarde ou por outra rota de serviço, já que a disponibilidade muda de hora em hora;
• verifique se o serviço aceita números virtuais, pois alguns os recusam;
• não repita o pedido em um laço apertado, o que consome o limite de requisições sem melhorar o resultado.

O post sobre como reduzir falhas na entrega de OTP aprofunda o desenho de novas tentativas no roteamento de OTP.

Existe uma linha +243 de longo prazo para contas que vamos manter?

Não. A OTP Route não oferece um número de longo prazo self-service na RDC. Os números do gateway são feitos para um código cada, o que serve para testes de cadastro, mas não para uma conta que precise entrar de novo daqui a seis meses.

Os Números Dedicados, que você mantém enquanto são renovados, são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês. Se a sua equipe precisa de uma linha congolesa duradoura, escreva para [email protected] e descreva o uso; a disponibilidade depende das regras locais e não pode ser prometida.

Como funciona a cobrança do tráfego de teste da RDC?

Há 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, o que facilita conciliar os gastos de QA. Veja os preços para saber como o valor ao vivo é mostrado antes de cada pedido.

Para trabalho de integração, uma conta de desenvolvimento pode ser passada para sandbox sob solicitação; ela devolve números e códigos simulados para que um pipeline seja exercitado de ponta a ponta sem gastar fundos da carteira.

Use esses números apenas nos seus próprios produtos e contas, siga os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route vale para todo pedido.

Perguntas frequentes

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

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

Que ID de país a API usa para a República Democrática do Congo?

Use cd tanto na consulta de preços quanto no corpo da ativação, por exemplo {"service": "telegram", "country": "cd"}.

Sou cobrado se um código +243 nunca chegar?

Não. Um pedido +243 que fique em silêncio por 20 minutos, ou que você cancele antes, é reembolsado integralmente na carteira, sem abrir chamado.

Devo salvar os números congoleses com o zero inicial?

Armazene-os em formato E.164, ou seja, +243 seguido de nove dígitos, com o zero de tronco removido. Mantenha o formato local apenas para exibição, se os seus usuários o esperarem.

Minha equipe pode usar o mesmo número +243 para entrar de novo no mês que vem?

Não de forma confiável, porque os números do gateway servem para um único código. As linhas dedicadas de longo prazo são self-service apenas nos EUA e no Canadá; para a RDC, você pode escrever para [email protected] e perguntar.

Dá para rodar o CI contra a API sem gastar dinheiro?

Dá. Peça que sua conta de desenvolvimento seja passada para sandbox, e ela devolverá números e códigos simulados.

Por que um serviço rejeitou o número +243 que pedi?

Alguns serviços recusam números virtuais ou limitam certas faixas. Cancele ou deixe a janela expirar para ser reembolsado, depois tente mais tarde ou teste outra rota de serviço.

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.