SMS-коды подтверждения из Ямайки: чек-лист, шаги и решения проблем

Что нужно проверить перед первой ямайской активацией?

Ямайка входит в Североамериканский план нумерации, поэтому часть проверок отличается от большинства стран:

• Ваш валидатор принимает номера +1, не относящиеся к США или Канаде. Многие формы регистрации молча считают любой номер +1 американским.
• В вашем селекторе стран Ямайка указана отдельно, а не слита с +1 как единый регион.
• Ключ API or_live_ создан в консоли разработчика, а конечная точка вебхука с секретом развёрнута — или ваш тестовый стенд настроен на опрос.
• Кошелёк пополнен, либо для пробного прогона включён режим песочницы.
• Вы знаете идентификатор сервиса из GET /api/v1/services; идентификатор страны Ямайки — jm.

Ошибки в первых двух пунктах дают сбои, которые выглядят как проблемы маршрутизации, хотя целиком находятся в вашем собственном коде.

Почему ямайский номер +1 требует особой обработки?

Ямайские номера используют коды зон 876 и более новый 658, за которыми следует семизначный абонентский номер, так что полная форма E.164 — это +1 плюс десять цифр. Внутри страны для межгорода набирают ведущую 1, которую нужно убирать перед сохранением.

Инженерам важно понимать: один лишь +1 ничего не говорит о стране. Определение региона должно опираться на код зоны, и любая логика, выбирающая валюту, часовой пояс или шаблон SMS по коду набора, требует такой же аккуратности. Храните каноническую строку E.164, определённый регион держите в отдельном поле и тестируйте ввод и с 876, и с 658.

Официальный язык — английский, и проверочные сообщения почти всегда приходят на нём, тогда как в повседневной речи часто звучит ямайский патуа. Команды тестируют здесь запуски в Карибском регионе, денежные переводы и финтех-сценарии для диаспоры в США, Великобритании и Канаде, а также туристические и гостиничные продукты. О выборе маршрутов под каждый рынок рассказывает статья о маршрутизации OTP по странам.

Каковы шаги в API SMS-верификации для Ямайки?

1. Проверьте актуальную цену через GET /api/v1/prices?country=jm&service=<id> относительно базового URL https://otproute.com/api/v1.
2. Закажите: POST /api/v1/activations с телом {"service": "<id>", "country": "jm"}. Запишите идентификатор активации и номер.
3. Введите номер в тестируемом приложении.
4. Получите код через событие activation.sms_received на вебхуке или опросом GET /api/v1/activations/{id}.
5. Чтобы досрочно отказаться от ямайской попытки, отправьте POST /api/v1/activations/{id}/cancel — это снимет резервирование.

Прежде чем реагировать на любое событие, заново вычислите HMAC-SHA256 от "<t>.<raw body>" с секретом вашей конечной точки, сравните с значением v1 в X-OTPRoute-Signature и отклоняйте слишком старые метки времени. Обрабатывайте также activation.expired и activation.cancelled с привязкой к идентификатору активации, чтобы повторы никогда не обрабатывались дважды. Для планирования мощности: один аккаунт может держать 10 ключей и 5 конечных точек вебхуков, с потолком в 300 запросов в минуту на все.

Какие приложения могут получать коды на ямайском маршруте?

Для Ямайки сейчас доступно более 900 сервисов. Часто используются WhatsApp, Telegram, Google (Gmail и YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb и ChatGPT (OpenAI).

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

Как не разработчикам пройти тот же чек-лист в панели?

Создайте аккаунт на странице /signup с кодом из письма или через Google, включите TOTP и пополните кошелёк. Затем откройте OTP Gateway, выберите сервис, выберите Ямайку и подтвердите актуальную цену. Вставьте номер в приложение, и код появится в панели, как только придёт сообщение. Сотрудники поддержки часто идут этим путём, чтобы воспроизвести проблему клиента с регистрацией на ямайском номере.

Устранение неполадок: ямайский код опаздывает, не приходит или отклонён

• Отклонён уже при вводе? Сначала проверьте собственную форму: частый виновник — валидатор только для США. Если сам сторонний сервис отказывается принять номер, возможно, он не принимает виртуальные номера.
• Пока ничего? Оставьте активацию открытой на все 20 минут, а не отменяйте и не заказывайте заново.
• Всё ещё ничего? Попробуйте позже или с другим маршрутом сервиса. Не долбите один и тот же заказ в цикле.

Если SMS не дошло до номера до конца окна, вся сумма автоматически возвращается в кошелёк. Более длинный чек-лист есть в руководстве по снижению числа недоставленных OTP.

Относятся ли к Ямайке выделенные линии, кошелёк и песочница?

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

Всё остальное работает так же, как везде: предоплаченный кошелёк в долларах США, без абонентской платы, пополнение картой или USDT/USDC и PDF-счёт на почту за каждое пополнение. Режим песочницы, доступный по запросу, возвращает имитированные номера и коды для интеграционных тестов. О том, как начисляются платежи, читайте на странице /pricing.

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

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

Да. Закажите через OTP Route номер +1 876 или +1 658 для вашего сервиса и читайте код в панели или через API, где бы ни находилась ваша команда.

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

Отправляйте jm. Код набора — +1, но страну API определяет по этому идентификатору.

Считается ли ямайский номер американским?

Нет. У него общий код +1, но это отдельная страна со своими кодами зон, и многие приложения относят его к Ямайке.

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

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

Можно ли купить в OTP Route долгосрочный ямайский номер?

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

Можно ли протестировать вебхуки, не платя?

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

Какое использование номера +1 Ямайки для тестов допускается?

Тестирование собственного продукта, QA-автоматизация и работа с законными бизнес-аккаунтами. Карибский маршрут подчиняется условиям каждого приложения и Политике допустимого использования OTP Route.

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