Como capturar OTPs da Careem com um número de verificação controlado por API

Qual é a sequência de chamadas de uma API de código de verificação da Careem?

Todas as requisições vão para https://otproute.com/api/v1 com uma chave Bearer (prefixo or_live_) criada no console do desenvolvedor. Para a Careem, o fluxo é curto:

1. GET /api/v1/prices?country=ae&service=careem retorna o preço atual de um número dos Emirados Árabes Unidos; troque o id do país pelo mercado que você está testando.
2. POST /api/v1/activations com {"service": "careem", "country": "ae"} retorna um id de ativação e o número.
3. Seu dispositivo de teste ou emulador digita esse número na tela de telefone da Careem.
4. O código chega a você por webhook ou por uma chamada de consulta (polling), e o seu script o envia.
5. POST /api/v1/activations/{id}/cancel libera a ativação se a execução for interrompida antes de o código ser necessário.

Os limites da conta são 10 chaves de API, 5 endpoints de webhook e 300 requisições por minuto, o que sobra para uma matriz de testes em paralelo. A referência dos endpoints está na documentação.

Como um handler de webhook deve processar os códigos da Careem?

Inscreva um endpoint em activation.sms_received, activation.expired e activation.cancelled. Cada entrega inclui X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcule o HMAC-SHA256 de <t>.<raw body> com o segredo daquele endpoint, compare em tempo constante e rejeite timestamps fora de uma pequena tolerância. O guia de webhooks com HMAC mostra os detalhes.

Torne o handler idempotente, gravando os dados pela chave do id da ativação, porque uma entrega repetida não deve enviar um código duas vezes. Responda rapidamente com um 2xx e passe o trabalho lento para uma fila.

O polling é a alternativa mais simples para um único teste: chame GET /api/v1/activations/{id} a cada poucos segundos até o código aparecer ou a ativação informar que expirou.

Quando a Careem pede um número de telefone?

A Careem é um aplicativo de transporte e serviços do dia a dia com sede em Dubai, mais conhecido no Golfo, no Oriente Médio em geral e no Paquistão. Como a maioria dos apps de transporte, ela trata o número de celular como o identificador central da conta: normalmente um código é enviado no cadastro e de novo quando alguém entra em um dispositivo novo ou recupera o acesso. Motoristas e a equipe de suporte também usam esse número para falar com o passageiro durante uma corrida.

Para uma equipe de QA, isso faz da etapa do telefone a primeira barreira de todo fluxo que vale testar, desde a entrada de um novo passageiro até um administrador de viagens corporativas que faz login em um notebook recém-configurado.

De qual país deve ser o número de telefone da Careem?

A rota da Careem abrange atualmente 197 países, mas a escolha útil é o mercado a que pertence a sua conta ou o seu caso de teste. Um perfil de passageiro de Riade deve ter um número saudita, e um teste de cadastro de passageiro em Karachi ou Lahore pertence a um número paquistanês. Opções de uso comum:

• Emirados Árabes Unidos (ae) e Arábia Saudita (sa)
• Paquistão, Jordânia, Catar e Egito
• Kuwait, Bahrein, Omã e Marrocos para outros fluxos regionais
• Turquia, Reino Unido, Índia e Quênia para cenários de viajantes e diáspora

O artigo sobre roteamento por país explica como escolher uma alternativa quando o primeiro país está com pouco estoque.

Como obtenho um código da Careem pelo painel?

Abra o OTP Gateway, escolha a Careem como serviço e o país de que precisa e confira o preço exibido. Peça o número, informe-o no app da Careem e deixe o cartão da ativação aberto; o código aparece ali quando for recebido. O número vale para esse único código.

Por que um OTP da Careem pode não chegar?

A Careem pode recusar números virtuais, conforme as suas próprias verificações de risco, e pode mudar esse comportamento sem aviso. É justamente por isso que o reembolso existe: se nenhum SMS chegar na janela de 20 minutos, ou se você cancelar, o dinheiro volta para a carteira automaticamente.

• Espere a janela terminar antes de fazer um novo pedido.
• Tente de novo mais tarde ou em outro país que combine com o seu cenário.
• Confirme que o número foi enviado completo, no formato internacional.
• Não martele a rota com pedidos seguidos vindos do CI; adicione um intervalo crescente (backoff).

Um login duradouro da Careem deve ficar em um Número Dedicado?

Um número do OTP Gateway recebe um único código. Se uma conta empresarial da Careem ou um perfil de staging de longa duração precisar entrar de novo semanas depois, um Número Dedicado mantém a mesma linha enquanto ela é renovada. Eles estão disponíveis na hora apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS recebidos no painel e pelo webhook number.sms_received. Veja números virtuais.

O pagamento é feito em uma carteira pré-paga em USD, recarregada por cartão ou USDT/USDC, com fatura em PDF a cada recarga e sem mensalidade; contas de desenvolvimento podem pedir um sandbox para execuções simuladas. O serviço existe para que as equipes testem o que constroem e operem contas que de fato lhes pertencem. Siga os termos da Careem, mantenha uma conta por pessoa ou empresa real e lembre-se de que a Política de Uso Aceitável se aplica. Careem é uma marca registrada de seu titular, e a OTP Route não tem nenhuma afiliação com ela.

Perguntas frequentes

Qual id de serviço a OTP Route usa para a Careem?

O id de serviço é careem. Combine-o com um id de país, por exemplo {"service": "careem", "country": "sa"}.

Posso receber um OTP da Careem sem um chip do Golfo?

Sim. Peça no OTP Gateway um número do país de que você precisa e leia o código no painel ou pela API.

A Careem aceita números virtuais?

Nem sempre. Quem decide isso é a Careem, e é por isso que as ativações sem SMS são reembolsadas automaticamente.

Quanto custa um número virtual para a Careem?

A partir de $0.20 por código. O preço exato varia conforme o país e é retornado por GET /api/v1/prices antes de você pedir.

Devo usar polling ou webhooks para testar a verificação por SMS da Careem?

O polling serve bem para uma única execução manual. Para jobs de CI em paralelo, um webhook assinado com handler idempotente escala melhor.

Posso manter o mesmo número de telefone da Careem para logins futuros?

Somente com um Número Dedicado, que é um produto dos EUA e do Canadá. Os números do OTP Gateway cobrem um único código de verificação.

Posso usar a OTP Route para criar várias contas de passageiro da Careem?

Não. Use-a para os seus próprios testes e para contas empresariais legítimas, e mantenha uma conta por pessoa ou empresa real, conforme os termos da Careem.

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.