Checklist pré-voo para números de verificação das Ilhas Cayman

Checklist pré-voo: o que deve estar pronto antes de pedir um número +1 345?

Percorra esta lista uma vez e a primeira ativação em Cayman tende a correr sem sobressaltos:

• Conta e segurança. Cadastre-se com um e-mail e um código de 6 dígitos enviado por e-mail (ou login do Google) e ative a autenticação em dois fatores TOTP para quem puder gastar da carteira.
• Carteira com saldo. Recarregue a carteira pré-paga em USD por cartão ou com USDT/USDC. Não há plano para escolher nem mensalidade.
• Chave de API. Crie uma chave no console de desenvolvedor; ela começa com or_live_ e vai em um cabeçalho Bearer. Uma conta pode ter até 10 chaves.
• Endpoint de webhook. Registre uma URL e guarde o segredo onde o seu handler possa lê-lo. O teto é de cinco endpoints por conta.
• Interpretação de telefone configurada. Garanta que sua biblioteca de números resolva o código de área 345 como Ilhas Cayman, em vez de tratar todo número +1 como dos Estados Unidos.
• Sandbox, se quiser um ensaio. Peça ao suporte que mude uma conta de desenvolvimento para o modo sandbox, para que números e códigos simulados exercitem a sua integração sem tocar nos fundos da carteira.

A referência da API lista todos os campos que você verá nas respostas.

Por que um número de Cayman atrapalha código que assume que +1 significa Estados Unidos?

As Ilhas Cayman fazem parte do Plano de Numeração Norte-Americano, então compartilham o código de país 1 com os EUA, o Canadá e uma longa lista de territórios caribenhos. O que identifica uma linha de Cayman é o código de área 345. Um número completo tem dez dígitos depois do código do país, é escrito localmente como (345) NXX-XXXX e armazenado em E.164 como +1345 seguido de sete dígitos.

Três consequências práticas para engenheiros:

• A detecção de região precisa olhar o código de área. Um formulário de cadastro que deduz o país só pelo prefixo +1 vai classificar um cliente de Cayman como americano e pode escolher o fuso horário, a moeda ou o texto de consentimento errados.
• No NANP, o 1 inicial também é o dígito de tronco para longa distância, então os usuários às vezes digitam 1 345... ou apenas 345.... Normalize as três formas para a string E.164 antes de salvar.
• Armazene os números sem espaços, hifens ou parênteses e formate-os apenas na exibição.

O inglês é o idioma oficial, então os códigos desse mercado costumam chegar em inglês. A redação exata, porém, é definida pelo serviço que envia a mensagem, não pela rota.

Quais serviços podem enviar códigos a um número de verificação das Ilhas Cayman?

O retrato atual do país ky inclui WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix e eBay. Contando a cauda longa, a rota cobre mais de 600 serviços, e a lista muda ao longo do dia, razão pela qual a disponibilidade é sempre lida da API e nunca fixada no código.

As equipes costumam precisar de um número +1 345 para testes porque as ilhas são um grande centro financeiro offshore e um destino turístico movimentado. Administradoras de fundos, seguradoras, plataformas de viagem e empresas imobiliárias integram clientes locais, e suas equipes de produto querem ver o fluxo de cadastro se comportar como um residente de Cayman o experimentaria. As notas sobre onboarding fintech tratam desse padrão com mais profundidade.

Passo a passo: como é a sequência de chamadas da API de OTP das Ilhas Cayman?

Todas as chamadas vão para https://otproute.com/api/v1 com a sua chave Bearer, dentro de um limite de 300 requisições por minuto.

1. Chame GET /api/v1/services uma vez e guarde em cache os ids de serviço de que a sua suíte de testes precisa.
2. Chame GET /api/v1/prices?country=ky&service=<id> para ler o preço atual e confirmar que o par está disponível agora.
3. Envie POST /api/v1/activations com um corpo como {"service": "<id>", "country": "ky"}. A resposta traz o id da ativação e o número +1 345.
4. Digite esse número no app em teste e dispare a etapa de SMS.
5. Aguarde activation.sms_received no seu webhook. Verifique primeiro o cabeçalho X-OTPRoute-Signature: calcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare com v1 e rejeite timestamps antigos.
6. Sem webhook, consulte GET /api/v1/activations/{id} em intervalos modestos até o código aparecer ou a janela fechar.
7. Se o teste for interrompido, chame POST /api/v1/activations/{id}/cancel para que o valor reservado volte à carteira.

O guia de webhooks com HMAC explica a verificação de assinatura linha por linha.

Passo a passo para colegas que preferem o painel

A equipe de suporte e os gerentes de conta não precisam tocar na API:

1. Abra a página do OTP Gateway no painel.
2. Escolha as Ilhas Cayman como país e, depois, o serviço que você está verificando.
3. Confira o preço exibido antes de pedir e confirme.
4. Copie o número para o app, peça o código e deixe a página da ativação aberta; o SMS aparece ali quando chegar.

A janela de 20 minutos e o reembolso valem exatamente como na API.

Solução de problemas: e se nenhum código chegar ao número +1 345?

Uma ativação silenciosa não gera cobrança. Se nenhum SMS chegar antes de os 20 minutos acabarem, ou se você cancelar, o valor integral volta para a carteira sozinho. Antes de pedir de novo:

• Deixe a janela correr. O tempo de entrega depende do serviço e da rota, então um código lento não é necessariamente um código que falhou.
• Verifique a política do serviço. Alguns serviços recusam números virtuais por completo, que é exatamente a situação para a qual o reembolso existe.
• Tente mais tarde ou troque de rota. O estoque muda ao longo do dia; uma segunda tentativa uma hora depois, ou um país caribenho vizinho, pode se comportar de outro modo.
• Evite loops apertados. Um script que cancela e pede de novo a cada poucos segundos queima o seu limite de requisições e raramente ajuda.

O manual de falhas de entrega traz mais diagnósticos. Use cada número apenas para o seu próprio produto ou para as suas próprias contas empresariais, siga os termos de cada serviço e lembre-se de que vale a Política de Uso Aceitável da OTP Route.

Posso manter uma linha de Cayman a longo prazo e como funciona a cobrança?

Não existe número de longo prazo em autoatendimento para as Ilhas Cayman. Compartilhar o código de país +1 não muda isso: os Dedicated Numbers são um produto apenas dos Estados Unidos e do Canadá, a partir de $1.95/mês, com SMS de entrada, SMS de saída e chamadas pelo navegador. Se a sua equipe precisa de uma linha 345 permanente, escreva para [email protected]; a disponibilidade depende das regras locais e não é prometida.

Todo o resto funciona com uma única carteira pré-paga em USD. As recargas por cartão ou USDT/USDC geram, cada uma, uma fatura em PDF por e-mail, e a página de preços explica o modelo de pagamento conforme o uso.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app nas Ilhas Cayman sem um chip local?

Sim. Peça um número +1 345 pelo OTP Gateway, digite-o no seu app e leia o código no painel ou pela API. Você paga a partir de $0.20 por código e somente quando o código chega.

Qual id de país a API usa para as Ilhas Cayman?

O id é ky. Passe-o como valor de country ao chamar GET /api/v1/prices ou POST /api/v1/activations.

Como devo armazenar um número de telefone de Cayman no meu banco de dados?

Armazene-o em E.164: +1345 seguido do número de assinante de sete dígitos, sem espaços nem pontuação. Detecte o território pelo código de área 345, não pelo prefixo +1.

Um número +1 345 conta como número dos EUA para os Dedicated Numbers?

Não. Os Dedicated Numbers são vendidos apenas para os Estados Unidos e o Canadá, então uma linha de Cayman só está disponível como ativação de código único no OTP Gateway.

O que acontece com o meu dinheiro se o SMS nunca chegar?

A ativação fica aberta por 20 minutos. Se nenhum código chegar nesse prazo, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira.

Posso rodar testes de OTP de Cayman no CI sem gastar saldo da carteira?

Peça ao suporte que mova uma conta de desenvolvimento para o sandbox. Ele devolve números e códigos simulados, e o seu pipeline pode exercitar todo o fluxo de ativação e webhook sem custo.

Quantos serviços de Cayman a OTP Route cobre?

Mais de 600 no último retrato. Como o estoque muda ao longo do dia, consulte GET /api/v1/services e o endpoint de preços para saber a disponibilidade atual.

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.