Um checklist pré-voo para receber códigos SMS de Curaçao (+599)

O que deve constar no checklist antes de pedir um número +599?

Mercados insulares recompensam um pouco de preparação, porque a disponibilidade das rotas muda ao longo do dia e um teste apressado desperdiça tempo. Marque estes itens antes da primeira requisição:

• Uma chave de API do console do desenvolvedor. As chaves começam com or_live_; uma conta pode ter até 10, então dê ao CI e ao staging as suas próprias.
• Uma carteira em USD com saldo, ou uma conta de desenvolvimento passada para sandbox sob solicitação, se você só quer exercitar a integração.
• Os IDs certos. Curaçao é cw na API; o ID do serviço vem de GET /api/v1/services.
• Um endpoint de webhook com o segredo guardado, ou um laço de polling com intervalo razoável. São permitidos até 5 endpoints por conta.
• Uma regra de armazenamento para números +599 (tratada abaixo), para que os dados de teste coincidam com os de produção.
• Um plano para o caso vazio: o que o seu teste faz quando a janela expira sem código.

Que serviços a rota de número de verificação de Curaçao cobre?

O retrato ao vivo de Curaçao lista mais de 400 serviços. Entre os populares estão Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber e Airbnb. Os nomes de viagem e mensagens são os que as equipes de Curaçao costumam buscar primeiro, já que a hotelaria e os produtos voltados a visitantes geram boa parte dos cadastros digitais da ilha.

Trate esta lista como ponto de partida, e não como uma promessa. O estoque muda ao longo do dia, e é exatamente por isso que a API devolve a disponibilidade a cada consulta de preço.

Passo a passo: chamando a API de OTP de Curaçao

Toda chamada vai para https://otproute.com/api/v1 com a sua chave Bearer, dentro de um teto de 300 requisições por minuto.

1. Leia GET /api/v1/prices?country=cw&service=<id> para confirmar que a rota está aberta e ver o preço atual daquele par.
2. Crie o pedido com POST /api/v1/activations, enviando {"service": "telegram", "country": "cw"} ou o ID de serviço que você precisar. A resposta traz um ID de ativação e o número +599.
3. Digite esse número na tela de cadastro ou login que você está testando.
4. Espere activation.sms_received no seu webhook, ou faça polling em GET /api/v1/activations/{id} em intervalo tranquilo.
5. Se o teste for abandonado, chame POST /api/v1/activations/{id}/cancel para que a carteira seja creditada na hora.

Antes de confiar em qualquer webhook, confira o cabeçalho X-OTPRoute-Signature: calcule o HMAC-SHA256 sobre "<t>.<raw body>" com o segredo do endpoint e rejeite timestamps antigos. O guia de assinatura de webhooks explica isso com mais profundidade.

Como armazenar e normalizar um número +599?

Curaçao compartilha o código de país +599 com Bonaire, Santo Eustáquio e Saba, e os números de assinante de Curaçao seguem esse código com um 9. Esse 9 inicial faz parte do número, não é um prefixo de tronco; portanto, um normalizador que o remova vai corromper o registro. Armazene a string E.164 completa (+5999 seguido dos demais dígitos) sem espaços e adicione formatação apenas na hora de exibir.

Vale também conferir se o seu widget de entrada de telefone lista Curaçao como uma entrada própria, em vez de agrupá-la numa opção genérica de Antilhas Holandesas, o que bibliotecas mais antigas ainda fazem.

Quanto ao idioma: o papiamento, o holandês e o inglês são todos oficiais, e a maioria dos serviços globais envia códigos em inglês ou segue o idioma definido na conta. Se o seu produto é localizado em holandês ou papiamento, faça ao menos uma passada por idioma para ver o modelo real, e não um fallback. As equipes costumam testar aqui ao lançar no Caribe holandês, ao atender visitantes que reservam do exterior ou ao conduzir operações regionais a partir da ilha.

Qual é o caminho pelo painel para quem não programa?

Atendentes de suporte e gerentes de produto fazem o mesmo sem nenhum script:

1. Crie uma conta com e-mail e um código de 6 dígitos, ou com o login do Google, e ative a autenticação em dois fatores TOTP.
2. Recarregue a carteira.
3. Abra o OTP Gateway, escolha o serviço e depois Curaçao; o preço aparece antes de você confirmar.
4. Copie o número +599 para o app e acompanhe o cartão da ativação até o código aparecer.

Valem a mesma janela de 20 minutos e a mesma regra de reembolso da API.

Solução de problemas: o código de Curaçao não apareceu

Uma ativação silenciosa é normal de vez em quando e não custa nada, porque o valor volta para a carteira quando a janela fecha ou você cancela.

• Deixe a janela correr. Alguns serviços reenviam devagar; cancelar no minuto dois joga fora um código que ainda poderia chegar.
• Verifique a posição do serviço de destino sobre números virtuais. Alguns os recusam, e é por isso que o reembolso existe.
• Tente mais tarde, ou outra rota de país, se o teste não depender especificamente de um número de Curaçao.
• Evite repetir o pedido em um laço apertado. Espace as tentativas para não empilhar ativações paralelas para um único teste.

A página de solução de testes de QA mostra como as equipes embutem essas novas tentativas em suítes automatizadas.

Linhas de longo prazo, carteira e cobrança em projetos de Curaçao

Não existe número de longo prazo self-service para Curaçao. Se você precisa de uma linha que mantenha por meses, escreva para [email protected] e a equipe verificará o que as regras locais permitem; nada é prometido. As linhas dedicadas são um produto dos EUA e do Canadá, a partir de $1.95/mês, descritas na página de números virtuais.

As ativações de Curaçao saem de uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Pagamentos com cartão e USDT/USDC servem para recarregar, e cada recarga gera uma fatura em PDF por e-mail para a contabilidade do seu projeto em Curaçao. Os valores atuais estão na página de preços. Use a OTP Route apenas para os seus próprios produtos e contas legítimas, siga os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route se aplica.

Perguntas frequentes

Posso testar um fluxo de cadastro de Curaçao sem comprar um chip local?

Sim. Peça um número +599 no OTP Gateway para o serviço em teste e leia o código no painel ou pela API, sem chip nem aparelho na ilha.

Que ID de país a OTP Route usa para Curaçao?

Curaçao é cw. Combine cw com o ID de serviço listado por GET /api/v1/services em toda consulta de preço e pedido.

O 9 depois de +599 é um prefixo de tronco que devo remover?

Não. Em Curaçao, o 9 faz parte do número de assinante; portanto, mantenha-o no valor E.164 armazenado.

Sou cobrado quando uma ativação de Curaçao expira sem código?

Não. Se nenhum SMS chegar em 20 minutos, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira.

Posso manter um número de Curaçao para logins repetidos no mês que vem?

Não por self-service. Os números dedicados de longo prazo só são vendidos para os EUA e o Canadá; para Curaçao, você pode escrever ao suporte para perguntar, sem nenhuma promessa de disponibilidade.

Como monto a integração antes de gastar fundos da carteira?

Peça ao suporte o modo sandbox para uma conta de desenvolvimento. Ele devolve números e códigos simulados, para que todo o caminho da API e do webhook seja exercitado 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.