Чек-лист перед получением SMS-кодов с Кюрасао (+599)

Что должно быть в чек-листе перед заказом номера +599?

Островные рынки вознаграждают небольшую подготовку: доступность маршрутов меняется в течение дня, а поспешный тест съедает время. Отметьте эти пункты до первого запроса:

• API-ключ из консоли разработчика. Ключи начинаются с or_live_; на аккаунте может быть до 10, поэтому выделите CI и staging отдельные.
• Пополненный кошелёк в USD либо тестовый аккаунт, переведённый в песочницу по запросу, если вы хотите только прогнать интеграцию.
• Правильные id. В API Кюрасао — это cw; id сервиса берётся из GET /api/v1/services.
• Вебхук-эндпоинт с сохранённым секретом либо цикл опроса с разумным интервалом. На аккаунт допускается до 5 эндпоинтов.
• Правило хранения номеров +599 (описано ниже), чтобы тестовые данные совпадали с боевыми.
• План на пустой случай: что делает ваш тест, когда окно истекло без кода.

Какие сервисы охватывает маршрут проверочных номеров Кюрасао?

В актуальном срезе по Кюрасао перечислено более 400 сервисов. Среди популярных — Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber и Airbnb. Названия из сфер путешествий и мессенджеров команды Кюрасао выбирают первыми, поскольку гостиничные и ориентированные на гостей продукты порождают значительную часть цифровых регистраций на острове.

Считайте этот список отправной точкой, а не обещанием. Инвентарь меняется в течение дня, и именно поэтому API возвращает доступность вместе с каждым запросом цены.

Шаг за шагом: вызовы Curacao OTP API

Каждый вызов идёт на https://otproute.com/api/v1 с вашим Bearer-ключом в пределах 300 запросов в минуту.

1. Запросите GET /api/v1/prices?country=cw&service=<id>, чтобы убедиться, что маршрут открыт, и увидеть текущую цену для этой пары.
2. Создайте заказ через POST /api/v1/activations, отправив {"service": "telegram", "country": "cw"} или id нужного сервиса. В ответе будут id активации и номер +599.
3. Введите этот номер на экране регистрации или входа, который тестируете.
4. Дождитесь activation.sms_received на вебхуке или опрашивайте GET /api/v1/activations/{id} со спокойным интервалом.
5. Если тест оставлен, вызовите POST /api/v1/activations/{id}/cancel, чтобы средства сразу вернулись на кошелёк.

Прежде чем доверять любому вебхуку, проверьте заголовок X-OTPRoute-Signature: вычислите HMAC-SHA256 от "<t>.<raw body>" секретом эндпоинта и отклоняйте устаревшие метки времени. В руководстве по подписи вебхуков это разобрано подробнее.

Как хранить и нормализовать номер +599?

Кюрасао делит код страны +599 с Бонэйром, Синт-Эстатиусом и Сабой, а абонентские номера Кюрасао идут за этим кодом с цифры 9. Эта ведущая 9 — часть номера, а не транковый префикс, поэтому нормализатор, который её убирает, испортит запись. Храните полную строку E.164 (+5999 и остальные цифры) без пробелов, а форматирование добавляйте только при отображении.

Стоит также проверить, что виджет ввода телефона в вашем продукте показывает Кюрасао отдельной позицией, а не сливает её в общий пункт «Нидерландские Антильские острова», как до сих пор делают старые библиотеки.

Что касается языка: официальными являются папьяменто, нидерландский и английский, и большинство глобальных сервисов присылают коды на английском или следуют языку аккаунта. Если ваш продукт локализуется на нидерландский или папьяменто, проведите хотя бы по одному прогону на каждый язык, чтобы увидеть настоящий шаблон, а не запасной вариант. Команды обычно тестируют здесь при запуске в нидерландской части Карибского бассейна, обслуживании гостей, бронирующих из-за рубежа, или региональных операциях с острова.

Каков путь через панель управления для тех, кто не пишет код?

Сотрудники поддержки и продакт-менеджеры могут сделать то же самое без скриптов:

1. Создайте аккаунт по email и 6-значному коду либо через Google и включите двухфакторную аутентификацию TOTP.
2. Пополните кошелёк.
3. Откройте OTP Gateway, выберите сервис, затем Кюрасао; цена появится до подтверждения.
4. Скопируйте номер +599 в приложение и следите за карточкой активации, пока не появится код.

Действуют то же 20-минутное окно и то же правило возврата, что и при работе через API.

Устранение неполадок: код с Кюрасао не пришёл

Молчащая активация время от времени — это нормально, и она ничего не стоит: сумма возвращается на кошелёк, когда окно закрывается или вы отменяете заказ.

• Дайте окну отработать. Некоторые сервисы присылают код с задержкой; отмена на второй минуте выбрасывает код, который ещё мог прийти.
• Узнайте позицию целевого сервиса по виртуальным номерам. Некоторые их отклоняют, потому и существует возврат.
• Повторите позже или попробуйте маршрут другой страны, если тест не зависит именно от номера Кюрасао.
• Не заказывайте повторно в плотном цикле. Делайте паузы между попытками, чтобы не копить параллельные активации для одного теста.

На странице решения для QA-тестирования показано, как команды встраивают такие повторы в автоматизированные наборы тестов.

Долгосрочные линии, кошелёк и оплата для проектов на Кюрасао

Самостоятельного долгосрочного номера для Кюрасао нет. Если вам нужна линия на месяцы, напишите на [email protected], и команда проверит, что разрешают местные правила; ничего не обещается. Выделенные линии — продукт для США и Канады от $1.95 в месяц, описанный на странице виртуальных номеров.

Активации Кюрасао списываются с одного предоплаченного кошелька в USD, без ежемесячной платы и без выбора тарифа. Для пополнения подходят и карты, и USDT/USDC, а каждое пополнение формирует PDF-счёт на почту для бухгалтерии вашего проекта на Кюрасао. Актуальные тарифы — на странице тарифов. Используйте OTP Route только для собственных продуктов и легитимных аккаунтов, соблюдайте условия каждого сервиса и учтите, что действует Политика допустимого использования OTP Route.

Частые вопросы

Можно ли протестировать регистрацию на Кюрасао без покупки местной SIM-карты?

Да. Закажите номер +599 в OTP Gateway для тестируемого сервиса и прочитайте код в панели управления или через API — без SIM-карты и телефона на острове.

Какой id страны использует OTP Route для Кюрасао?

Кюрасао — это cw. Сочетайте cw с id сервиса из GET /api/v1/services в каждой проверке цены и заказе.

Девятка после +599 — это транковый префикс, который нужно убирать?

Нет. Для Кюрасао 9 входит в абонентский номер, поэтому сохраняйте её в хранимом значении E.164.

Спишутся ли деньги, если активация Кюрасао истекла без кода?

Нет. Если SMS не пришло в течение 20 минут или вы отменили заказ раньше, вся сумма автоматически возвращается на ваш кошелёк.

Можно ли оставить номер Кюрасао для повторных входов в следующем месяце?

Самостоятельно — нет. Долгосрочные выделенные номера продаются только для США и Канады; по Кюрасао можно написать в поддержку и уточнить, не рассчитывая на гарантию наличия.

Как настроить интеграцию, пока я не трачу средства кошелька?

Запросите у поддержки режим песочницы для тестового аккаунта. Он возвращает имитированные номера и коды, так что весь путь API и вебхуков можно прогнать от начала до конца.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.