Тестируем проверку номеров +268 без SIM-карты в Мбабане

Почему регистрацию с +268 так сложно тестировать из-за границы?

Eswatini — небольшой рынок, и именно это создаёт проблему для распределённых команд. Ваш продукт, возможно, уже обслуживает клиентов в Манзини или Мбабане в рамках запуска в Южной Африке, но ни у кого в QA нет местной SIM-карты, роуминг ненадёжен для автоматизации, а просьба коллеге из региона пересылать коды в чате не масштабируется дальше нескольких прогонов.

В итоге путь с +268 в поле телефона никогда не проходят от начала до конца. Правила валидации, списки стран и SMS-шаблоны для королевства выходят в релиз без проверки, а первый настоящий пользователь становится тестовым случаем. OTP Route закрывает этот пробел: выдаёт тесту настоящий свазилендский номер подтверждения для одного кода, а затем возвращает код вашему коду.

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

OTP Gateway сейчас показывает для Eswatini более 900 сервисов. Среди популярных в сегодняшнем срезе WhatsApp, Facebook, Google (Gmail & YouTube), Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Uber, Amazon, imo, Netflix и ChatGPT (OpenAI).

Доступность на любом маршруте меняется в течение дня, поскольку наши операторы-партнёры добавляют и выводят мощности, поэтому считайте этот список отправной точкой. Актуальный ответ всегда даёт GET /api/v1/services и GET /api/v1/countries, а дашборд показывает ту же картину, прежде чем вы потратите средства.

Как поток Eswatini OTP API выглядит в коде?

Создайте Bearer-ключ (префикс or_live_) в консоли разработчика и обращайтесь к базовому URL https://otproute.com/api/v1. Типичный шаг теста выглядит так:

1. Вызовите GET /api/v1/prices?country=sz&service=whatsapp, чтобы получить актуальную цену для этой пары.
2. Отправьте POST /api/v1/activations с JSON-телом, где указаны сервис и sz в качестве страны. В ответе будут id активации и номер +268.
3. Введите номер в форму регистрации, которую проходит ваш тест.
4. Дождитесь вебхука activation.sms_received или опрашивайте GET /api/v1/activations/{id}, пока не появится код.
5. Если сценарий прерван, вызовите POST /api/v1/activations/{id}/cancel, и сумма сразу вернётся в кошелёк.

Запросы вебхука содержат заголовок X-OTPRoute-Signature. Пересчитайте HMAC-SHA256 от метки времени и сырого тела с секретом эндпоинта, отклоняйте устаревшие метки и привязывайте каждое событие к id активации, чтобы повторы не приносили вреда. Полный обработчик разобран в руководстве по приёму через вебхуки, а все эндпоинты перечислены в справочнике API.

Что инженерам нужно знать о телефонных номерах Eswatini?

В Eswatini код страны +268, восьмизначные национальные номера и нет префикса для внутренних звонков, то есть ведущий ноль убирать не нужно. Нормализация проще, чем на многих рынках: храните значение в E.164 как +268 и восемь цифр, а входные данные с другим числом цифр отклоняйте до того, как они дойдут до SMS-провайдера.

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

Что делать, если код +268 не приходит?

Небольшие маршруты бывают тише крупных, так что допускайте редкие пустые активации:

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

Дополнительная диагностика есть в чек-листе по неудачным доставкам.

Можно ли сохранить долгосрочный номер Eswatini?

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

Как оплачивается маршрутизация OTP для Eswatini?

Расходы на тесты +268 списываются с единого предоплаченного баланса в USD; ничего не списывается ежемесячно, а тарифов для сравнения нет. Пополнять можно картой и стейблкоинами USDT/USDC, и после каждого пополнения на почту приходит PDF-счёт для вашей бухгалтерии. Плата взимается только при доставке кода. Для работы над интеграцией попросите поддержку переключить аккаунт разработки в песочницу: она возвращает имитированные номера и коды, и ваш CI-набор работает без расхода средств кошелька. Подробности — на странице цен. Соблюдайте правила каждого сервиса; к каждой активации применяется Политика допустимого использования OTP Route.

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

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

Да. Закажите активацию для страны sz, введите номер +268 в форму и читайте код в дашборде, опросом или через вебхук.

Нужно ли убирать ведущий ноль у номеров Eswatini?

Нет. В Eswatini нет префикса для внутренних звонков, поэтому форма E.164 — это просто +268 и восьмизначный национальный номер.

Сколько стоит номер подтверждения для Eswatini?

Коды начинаются от $0.20 за код; точная цена для каждого сервиса возвращается GET /api/v1/prices и показывается в дашборде до заказа.

На каком языке будет текст с OTP?

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

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

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

Какой маршрут попробовать, если Eswatini молчит?

Многие команды переходят на South Africa или Mozambique для регионального покрытия, пока маршрут +268 восстанавливается.

Можно ли гонять эти тесты в CI, не тратя средства?

Да. Аккаунт разработки по запросу переводится в песочницу, которая возвращает имитированные номера и коды для сквозных тестов конвейера.

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