Автоматизация SMS-проверки +260 для тестов регистрации в Замбии

Какие методы вызывает интеграция с OTP API для Замбии?

Интеграция — это короткая цепочка HTTPS-вызовов к https://otproute.com/api/v1, каждый из которых несёт Authorization: Bearer с ключом, имеющим префикс or_live_. Идентификатор страны Замбии — zm.

• GET /api/v1/countries и GET /api/v1/services: справочные данные, которые можно кэшировать на день.
• GET /api/v1/prices?country=zm&service=<id>: актуальная цена и признак того, может ли маршрут сейчас принять заказ.
• POST /api/v1/activations с {"service": "whatsapp", "country": "zm"}: возвращает идентификатор активации и номер +260.
• GET /api/v1/activations/{id}: статус и, когда код получен, сам код.
• POST /api/v1/activations/{id}/cancel: вернуть номер досрочно.
• GET /api/v1/balance: вызовите его первым, чтобы набор тестов быстро остановился при пустом кошельке.

Создавайте ключи в консоли разработчика — до 10 на аккаунт, удобный приём — по одному на среду. Лимит аккаунта — 300 запросов в минуту. Полные схемы — в документации API.

Как написать вебхук, принимающий коды +260?

Опрос работает, но когда одновременно идёт несколько активаций, вебхук чище. Добавьте до 5 эндпоинтов в консоли разработчика и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

Каждый запрос несёт X-OTPRoute-Signature: t=<unix>,v1=<hex>. Соберите строку <t>.<raw body>, вычислите HMAC-SHA256 с секретом эндпоинта и сравните с v1 за постоянное время. Используйте сырые байты в том виде, в каком они получены, отклоняйте метки времени старше нескольких минут и сохраняйте результаты по идентификатору активации, чтобы повторная доставка ничего не меняла. Быстро отвечайте 2xx, а медленную работу выполняйте после. Наш разбор защиты вебхуков OTP с помощью HMAC подробнее, а тестирование SMS OTP в CI-пайплайнах показывает, где это вписывается в сборку.

От каких сервисов проверочный номер Замбии может получать коды?

По живому снимку у Замбии более 1 100 сервисов. Среди них: WhatsApp, Facebook, Google (Gmail & YouTube), Telegram, Instagram, TikTok, X (Twitter), LinkedIn, Uber, imo, Microsoft & Outlook, Amazon и Netflix. Поскольку маршруты меняются каждый час, пусть метод цен подскажет вашему коду, что открыто, прежде чем заказывать.

Формат замбийских номеров и языки, на которых приходят коды

Замбийские номера набираются внутри страны с транковым 0 и девятью цифрами. В международной форме ноль пропадает, получается +260 и девять цифр. Перед сохранением приводите всё к этой форме E.164 и убедитесь, что ваше поле ввода принимает и локальный стиль, который пользователи действительно набирают, и международный.

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

Команды тестируют Замбию при выходе в Южную Африку, при создании онбординга для продуктов мобильных денег или кредитования и при поддержке клиентов из регионального операционного центра. Эта ситуация описана на странице онбординг в финтехе.

Можно ли сделать то же самое из панели?

Да, и это удобно для разовых проверок. Войдите, откройте OTP Gateway, выберите сервис и Замбию, посмотрите показанную цену и оформите заказ. Введите номер +260 в приложении; код появится в панели, когда придёт. Отмените активацию, которая вам больше не нужна, и её сумма вернётся на кошелёк.

Что делать, если код не пришёл, и когда лучше выделенная линия?

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

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

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

Как тарифицируется интеграция с Замбией и как безопасно её тестировать?

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

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

Какой идентификатор страны OTP Route использует для Замбии?

zm, как в POST /api/v1/activations с {"service": "telegram", "country": "zm"}.

Можно ли получать SMS OTP-коды из Замбии без замбийской SIM-карты?

Да. OTP Gateway предоставляет номер +260 для тестирования, а код приходит к вам в панель, вебхуком или при опросе.

Как правильно хранить номера +260?

Отбросьте внутренний транковый 0 и сохраняйте +260 и девять цифр в формате E.164. Форматируйте для отображения отдельно.

Вернутся ли деньги, если WhatsApp или другой сервис отклонит номер?

Да. Когда код не пришёл в течение 20 минут или вы отменили заказ, сумма автоматически зачисляется обратно на кошелёк.

Можно ли оставить замбийский номер для будущих входов?

Не в режиме самообслуживания. Долгосрочные номера — продукт для США и Канады; о Замбии напишите на [email protected], без каких-либо обещаний.

Можно ли опробовать интеграцию, не платя за реальные коды?

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

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