Путь разработчика к иорданским (+962) кодам подтверждения

Как выглядит последовательность запросов для номера +962?

API SMS-верификации — это обычный REST на https://otproute.com/api/v1 с Bearer-ключами с префиксом or_live_, которые вы создаёте в консоли разработчика. Вот порядок, которому следует большинство интеграций для Иордании:

1. Обнаружение: GET /api/v1/services и GET /api/v1/countries возвращают идентификаторы. Иордания — это jo; сервис вроде Telegram — telegram.
2. Проверка цены: GET /api/v1/prices?country=jo&service=telegram возвращает текущую стоимость этой пары и можно ли её заказать.
3. Заказ: POST /api/v1/activations с {"service": "telegram", "country": "jo"} резервирует номер и возвращает идентификатор активации.
4. Получение: опрашивайте GET /api/v1/activations/{id} каждые несколько секунд или позвольте вебхуку прислать результат.
5. Очистка: POST /api/v1/activations/{id}/cancel освобождает ненужную активацию и возвращает за неё средства.

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

Как убедиться, что вебхук действительно пришёл от OTP Route?

Каждое событие (например, activation.sms_received или activation.expired) приходит с заголовком X-OTPRoute-Signature вида t=<unix>,v1=<hex>. Ваш сервер вычисляет HMAC-SHA256 от "<t>.<raw body>" с секретом этой конечной точки и сравнивает результат с v1. Отклоняйте запрос, если значения различаются или если t слишком далеко в прошлом: это останавливает повторные воспроизведения.

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

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

Для Иордании указано более 1 700 сервисов. Среди популярных: WhatsApp, Telegram, Facebook, Instagram, Snapchat, TikTok, X (Twitter), Discord, Claude, Microsoft и Outlook, Amazon, Viber, imo, Signal и LinkedIn.

Список — это снимок, а не обещание. Ёмкость операторов меняется в течение дня, поэтому API сообщает актуальную доступность, и ваш код должен читать её перед заказом.

Форматирование иорданских номеров: нулевой префикс, E.164 и арабский текст

Код страны Иордании — +962, внутренний префикс — 0. Локально мобильный номер записывается с 07; в международной форме ноль исчезает, остаётся +962 и девять цифр, начинающихся с 7. Храните форму E.164, а когда пользователи вставляют местный номер, убирайте ведущий 0 перед добавлением кода страны. Сравнение 07… с +9627… как строк — классическая причина ошибок с дублями аккаунтов.

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

С Иорданией работают, когда локализуют продукт для арабоязычных пользователей, ведут поддержку из Аммана для всего региона или проверяют сценарии наряду с соседними рынками, такими как Саудовская Аравия и Объединённые Арабские Эмираты.

Заказ иорданского кода из панели

Операционные сотрудники могут сделать то же самое без написания кода. Создайте аккаунт по email и шестизначному коду или через вход Google, пополните баланс, выберите Иорданию и сервис в OTP Gateway, подтвердите показанную цену и оформите заказ. Номер +962 появляется сразу, а код показывается рядом, как только придёт SMS.

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

Порядок отладки, когда коды не приходят

Начните с самого простого объяснения и двигайтесь дальше:

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

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

Долгосрочные линии, кошелёк и песочница

У OTP Route нет самостоятельного долгосрочного номера в Иордании. Выделенные номера, от $1.95/month, мгновенно предлагаются только в США и Канаде. Если вашей команде нужна постоянная линия +962, напишите на [email protected]; возможность организовать её зависит от местных правил.

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

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

Какой код страны для Иордании в API?

Используйте jo как значение country в API OTP Route, например в GET /api/v1/prices?country=jo&service=whatsapp.

Нужно ли отбрасывать 0 в иорданском мобильном номере?

Да, для международного формата. Местный номер с 07 превращается в +962 и девять цифр, начинающихся с 7.

Придёт ли иорданский код подтверждения на арабском?

Может. Язык обычно определяется приложением и настройками аккаунта, поэтому разбирайте цифры по шаблону и тестируйте сообщения и на арабском, и на английском.

Как долго номер +962 удерживается под мой код?

Каждая активация длится 20 минут. Если за это время SMS не пришло, оплата возвращается в ваш кошелёк.

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

Самостоятельно — нет. Выделенные номера — продукт для США и Канады; по Иордании можно написать на [email protected].

Можно ли получать иорданские SMS OTP в автоматических тестах?

Да. Оформите заказ через POST /api/v1/activations, затем опрашивайте активацию или обрабатывайте подписанный вебхук; аккаунт в режиме песочницы позволяет отрепетировать это с имитированными кодами.

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