Предполётный чек-лист для номеров верификации Каймановых островов

Предполётный чек-лист: что должно быть готово перед заказом номера +1 345?

Пройдитесь по этому списку один раз, и первая активация для Каймановых островов, скорее всего, пройдёт без сюрпризов:

• Аккаунт и безопасность. Зарегистрируйтесь по адресу почты и 6-значному коду из письма (или через вход Google), затем включите двухфакторную защиту TOTP для всех, кто может тратить средства кошелька.
• Пополненный кошелёк. Пополните предоплаченный кошелёк в долларах США картой или стейблкоинами USDT/USDC. Тарифного плана выбирать не нужно, абонентской платы нет.
• API-ключ. Создайте ключ в консоли разработчика; он начинается с or_live_ и передаётся в заголовке Bearer. На аккаунте может быть до 10 ключей.
• Вебхук-эндпоинт. Зарегистрируйте URL и сохраните его секрет там, где его сможет прочитать ваш обработчик. Предел — пять эндпоинтов на аккаунт.
• Настроенный разбор телефонов. Убедитесь, что ваша библиотека для номеров относит код зоны 345 к Каймановым островам, а не считает каждый номер +1 американским.
• Песочница для пробного прогона. Попросите поддержку перевести тестовый аккаунт в режим песочницы, чтобы имитированные номера и коды проверяли вашу интеграцию без расхода средств кошелька.

Все поля, которые вы увидите в ответах, перечислены в справочнике API.

Почему номер с Каймановых островов ломает код, считающий, что +1 означает Америку?

Каймановы острова входят в Североамериканский план нумерации, поэтому делят код страны 1 с США, Канадой и длинным списком карибских территорий. Кайманову линию определяет код зоны 345. Полный номер состоит из десяти цифр после кода страны, на месте записывается как (345) NXX-XXXX, а в формате E.164 хранится как +1345 и ещё семь цифр.

Три практических следствия для инженеров:

• Определение региона должно опираться на код зоны. Форма регистрации, которая выводит страну только из префикса +1, пометит кайманского клиента как американского и может выбрать неверный часовой пояс, валюту или текст согласия.
• В NANP ведущая 1 одновременно служит цифрой междугородного набора, поэтому пользователи иногда вводят 1 345... или просто 345.... Приводите все три варианта к строке E.164 перед сохранением.
• Храните номера без пробелов, дефисов и скобок и форматируйте их только при отображении.

Официальный язык — английский, поэтому коды для этого рынка обычно приходят на английском. Точную формулировку, впрочем, определяет сервис, отправляющий сообщение, а не маршрут.

Какие сервисы могут направлять коды на номер верификации Каймановых островов?

В актуальном снимке для страны ky сейчас есть WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix и eBay. С учётом длинного хвоста маршрут охватывает более 600 сервисов, а список меняется в течение дня, поэтому доступность всегда нужно читать из API, а не зашивать в код.

Номер +1 345 для тестов командам обычно нужен потому, что острова — крупный офшорный финансовый центр и оживлённое туристическое направление. Администраторы фондов, страховщики, туристические платформы и компании недвижимости подключают местных клиентов, и их продуктовым командам нужно видеть, как процесс регистрации работает с точки зрения жителя Каймановых островов. Этот сценарий подробнее разобран в материале об онбординге в финтехе.

Шаг за шагом: как выглядит последовательность вызовов OTP API для Каймановых островов?

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

1. Один раз вызовите GET /api/v1/services и закешируйте идентификаторы сервисов, нужные вашему набору тестов.
2. Вызовите GET /api/v1/prices?country=ky&service=<id>, чтобы прочитать актуальную цену и убедиться, что пара сейчас доступна.
3. Отправьте POST /api/v1/activations с телом вида {"service": "<id>", "country": "ky"}. В ответе будут идентификатор активации и номер +1 345.
4. Введите этот номер в тестируемое приложение и запустите шаг отправки SMS.
5. Дождитесь activation.sms_received на вебхуке. Сначала проверьте заголовок X-OTPRoute-Signature: вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните с v1 и отклоняйте устаревшие метки времени.
6. Без вебхука опрашивайте GET /api/v1/activations/{id} с умеренным интервалом, пока не появится код или не закроется окно.
7. Если тест прерван, вызовите POST /api/v1/activations/{id}/cancel, чтобы удержанная сумма вернулась на кошелёк.

В руководстве по HMAC для вебхуков проверка подписи разобрана построчно.

Шаг за шагом для коллег, которые предпочитают панель

Сотрудникам поддержки и менеджерам по аккаунтам вообще не нужно трогать API:

1. Откройте страницу OTP Gateway в панели.
2. Выберите Каймановы острова как страну, затем сервис, который вы проверяете.
3. Проверьте показанную цену перед заказом и подтвердите.
4. Скопируйте номер в приложение, запросите код и оставьте страницу активации открытой: SMS появится там, когда придёт.

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

Устранение неполадок: что делать, если код не приходит на номер +1 345?

За молчащую активацию ничего не списывается. Если SMS не пришло до истечения 20 минут или вы отменили активацию, вся сумма автоматически возвращается на кошелёк. Прежде чем заказывать снова:

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

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

Можно ли оставить кайманскую линию надолго и как устроена оплата?

Самостоятельно оформить долгосрочный номер для Каймановых островов нельзя. Общий код страны +1 этого не меняет: Dedicated Numbers — продукт только для США и Канады, от $1.95/месяц, с входящими SMS, исходящими SMS и звонками из браузера. Если вашей команде нужна постоянная линия 345, напишите на [email protected]; доступность зависит от местных правил и не гарантируется.

Всё остальное работает с одного предоплаченного кошелька в долларах США. За каждое пополнение картой или USDT/USDC на почту приходит PDF-счёт, а модель оплаты по факту объясняется на странице тарифов.

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

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

Да. Закажите номер +1 345 в OTP Gateway, введите его в приложении и прочитайте код в панели или через API. Цена от $0.20 за код, и платить нужно только если код пришёл.

Какой идентификатор страны использует API для Каймановых островов?

Идентификатор — ky. Передавайте его как значение country при вызове GET /api/v1/prices или POST /api/v1/activations.

Как хранить кайманский номер телефона в базе данных?

Храните его в формате E.164: +1345 и семизначный абонентский номер без пробелов и знаков препинания. Территорию определяйте по коду зоны 345, а не по префиксу +1.

Считается ли номер +1 345 американским для Dedicated Numbers?

Нет. Dedicated Numbers продаются только для США и Канады, поэтому кайманская линия доступна лишь как активация OTP Gateway на один код.

Что будет с моими деньгами, если SMS не придёт?

Активация остаётся открытой 20 минут. Если за это время код не пришёл или вы отменили активацию раньше, вся сумма автоматически возвращается на кошелёк.

Можно ли запускать тесты OTP для Каймановых островов в CI, не тратя средства кошелька?

Попросите поддержку перевести тестовый аккаунт в песочницу. Она возвращает имитированные номера и коды, так что ваш пайплайн сможет пройти весь цикл активации и вебхука бесплатно.

Сколько сервисов OTP Route охватывает для Каймановых островов?

Более 600 на момент последнего снимка. Поскольку наличие меняется в течение дня, запрашивайте GET /api/v1/services и эндпоинт цен, чтобы получить актуальные данные.

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