SMS-верификация в Нигерии (+234) по API для QA, финтеха и команд запуска

Какие эндпоинты вызывать, чтобы получить нигерийский OTP?

Всё находится под адресом https://otproute.com/api/v1, а авторизация выполняется Bearer-ключом с префиксом or_live_. Идентификатор страны для Нигерии — ng. Типичная интеграция делает четыре вызова:

1. GET /api/v1/prices?country=ng&service=<id> — убедиться в актуальной цене до заказа.
2. POST /api/v1/activations с телом {"service": "<id>", "country": "ng"} — зарезервировать номер +234. Сохраните полученный id активации: по нему привязаны все последующие вызовы и события вебхука.
3. GET /api/v1/activations/{id} — узнать статус и, когда код доставлен, сам код.
4. POST /api/v1/activations/{id}/cancel — отменить, если тест упал раньше и номер больше не нужен.

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

Что выбрать для тестов в Лагосе: опрос или вебхуки?

Опроса достаточно для нескольких ручных прогонов. Когда пайплайн заказывает сразу несколько номеров +234 параллельно, удобнее вебхуки. Зарегистрируйте один из пяти доступных эндпоинтов в консоли разработчика и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

Каждый запрос содержит заголовок X-OTPRoute-Signature: t=<unix>,v1=<hex>. Пересчитайте HMAC-SHA256 от метки времени, точки и необработанного тела запроса с секретом эндпоинта, сравните значения за постоянное время и отбрасывайте запрос, если метка времени устарела. Храните id уже обработанных активаций, чтобы повторная доставка события не запускала тест дважды. Более полный чек-лист есть в статье о защите вебхуков OTP с помощью HMAC. Общий трафик не должен превышать 300 запросов в минуту на аккаунт — этого с запасом хватает, если опираться на события, а не на частый опрос.

Какие сервисы доступны на маршрутах +234?

В маршруте ng сейчас доступно более 2 700 сервисов. Чаще всего запрашивают WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon и ChatGPT (OpenAI). В течение дня наличие меняется, так как наши операторы-партнёры обновляют ресурсы, поэтому запрашивайте актуальную доступность, а не рассчитывайте на сервис, который был вчера.

Зачем командам вообще нужен номер для верификации в Нигерии?

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

Официальный язык страны — английский, поэтому SMS с кодами обычно приходят на английском, и проверки в автотестах остаются простыми. Финтех-командам стоит заглянуть на страницу про онбординг в финтехе: там описано, как это сочетается с проверками личности, которые OTP Route не заменяет.

Как форматируются мобильные номера в Нигерии?

Код страны — +234, префикс междугородной связи — 0. Нигерийцы обычно записывают мобильный номер как одиннадцать цифр, начинающихся с нуля, например 0803 123 4567; в международном формате ноль пропадает, и получается +234 803 123 4567. Храните значение в формате E.164 (+234803...), принимайте при вводе локальный одиннадцатизначный вариант и убирайте ведущий 0 перед сохранением. Валидатор, проверяющий только общую длину, спокойно пропустит +2340803... — частую причину неудачных отправок в продакшене.

Можно ли заказать нигерийский номер из личного кабинета?

Да. Зарегистрируйтесь по коду из письма или через Google, пополните кошелёк, откройте OTP Gateway, выберите Нигерию и сервис и подтвердите показанную цену. Номер готов сразу, а код появится рядом с заказом, как только придёт.

Если код не пришёл, дайте отработать 20-минутному окну: вы платите, только если код пришёл, а истёкшие или отменённые заказы возвращаются автоматически. Затем попробуйте новый заказ чуть позже, другой маршрут — например, Гану, если тест это допускает, — и проверьте, не отказывается ли сервис от виртуальных номеров. Не отправляйте новые заказы в плотном цикле.

А как насчёт долгосрочных нигерийских номеров, оплаты и песочницы?

Самостоятельно оформить долгосрочный нигерийский номер в OTP Route нельзя. Dedicated Numbers (выделенные номера) продаются только для США и Канады, от $1.95/month. Если нужна постоянная линия +234, напишите на [email protected]; возможность зависит от местного регулирования.

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

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

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

Да. Закажите номер +234 в OTP Gateway и читайте код в личном кабинете или через API.

Какой идентификатор страны для Нигерии в API OTP Route?

Используйте ng как значение country в запросах цен и активаций.

Сколько стоит получить нигерийский SMS-код OTP?

От $0.20 за код; точная сумма зависит от сервиса и возвращается эндпоинтом цен.

Списываются ли деньги, если SMS не пришло?

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

Как хранить номер вида 0803 123 4567?

Отбросьте ведущий ноль и сохраните как +2348031234567 — это формат E.164 без пробелов.

Можно ли использовать эти номера для любых аккаунтов?

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

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