Подключаем коды верификации Чада (+235) к вашему стеку

Какова последовательность вызовов для запроса OTP API в Чаде?

Запросы для Чада идут на тот же базовый URL, что и для любого другого рынка, https://otproute.com/api/v1, и подписываются Bearer-ключом or_live_. Ключи создаются в консоли разработчика; на аккаунте может быть до 10 ключей и 300 запросов в минуту.

Типичный прогон для Чада состоит из четырёх вызовов:

1. GET /api/v1/countries и GET /api/v1/services, чтобы убедиться, что td есть в списке, и найти идентификатор сервиса, на который нацелен тест.
2. GET /api/v1/prices?country=td&service=<id>, чтобы узнать актуальную цену для этой пары, прежде чем что-либо тратить.
3. POST /api/v1/activations с телом вида {"service": "telegram", "country": "td"}. В ответе будут идентификатор активации и номер +235, который нужно ввести в тестируемое приложение.
4. Дождитесь кода, затем дайте активации завершиться или вызовите POST /api/v1/activations/{id}/cancel, если тест прерван раньше.

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

Как приёмнику вебхука обрабатывать коды +235?

Опрос GET /api/v1/activations/{id} раз в несколько секунд подходит для одного скрипта. Когда один ключ делят несколько тестовых раннеров, вебхук чище. Зарегистрируйте эндпоинт (пять на аккаунт) и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

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

Считайте идентификатор активации ключом идемпотентности. Если то же событие доставлено дважды, вторая запись не должна ничего менять, а обработчик должен быстро возвращать 2xx и выполнять медленную работу потом.

Какие приложения могут присылать коды на номер верификации в Чаде?

Актуальный снимок для td содержит более 1500 сервисов. Среди популярных: WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) и AliExpress.

Наличие не статично. Маршруты открываются и закрываются в течение дня по мере того, как наши операторы-партнёры перераспределяют ёмкость, поэтому сервис, видимый утром, может пропасть к вечеру. Читайте каталог во время выполнения, а не зашивайте его в код, и держите в плане тестов второй сервис на случай, если первый временно недоступен для Чада.

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

В Чаде закрытый план нумерации: национальные номера состоят из восьми цифр, а префикса для внутренних звонков, который нужно убирать, нет, поэтому форма E.164 — это просто +235 и эти восемь цифр. Это делает Чад одним из самых простых рынков для валидации.

• Храните полную строку E.164 в одном столбце, а не разделяйте код страны и абонентский номер.
• Если ваша форма принимает пробелы или привычную группировку по две цифры, удаляйте их перед сохранением.
• Добавьте в тесты проверку, что значение со случайным ведущим 0 отклоняется или очищается: пользователи из других планов нумерации иногда добавляют его по привычке.

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

Зачем продуктовые команды запускают тесты в Чаде?

Мало какие инженерные команды сидят в Нджамене, и именно поэтому удалённый номер +235 так полезен. Вот частые причины:

• Запуски во франкоязычной Центральной Африке: продукт, уже работающий в соседних странах, добавляет Чад в выбор страны при регистрации и должен подтвердить, что процесс работает.
• QA локализации на арабский и французский, включая отображение экрана ввода кода справа налево.
• Клиенты из диаспоры, которые сохраняют чадский номер, живя за границей, что влияет на то, как ваши антифрод-правила воспринимают код страны.
• Операционные команды, которые ведут бизнес-аккаунты в мессенджерах для региональных партнёров.

Общая картина описана в материале о маршрутизации OTP по странам.

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

Молчащий номер — это обычно проблема маршрута или приёма, а не ошибка в вашем коде. Идите по порядку:

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

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

Есть ли долгосрочная линия в Чаде и как она оплачивается?

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

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

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

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

Используйте td в поле country в POST /api/v1/activations и в запросе цен.

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

Да. Закажите номер +235 в OTP Gateway, введите его в приложении и прочитайте код в панели, через API или вебхук.

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

Одна активация открыта 20 минут и покрывает один код. После этого закажите новую.

Плачу ли я, если SMS не пришло?

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

Нужно ли убирать префикс у номеров Чада?

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

Можно ли оставить номер Чада для последующих входов?

В режиме самообслуживания нет. Долгосрочные Dedicated Numbers есть только в США и Канаде; по Чаду напишите команде и уточните, что возможно.

Есть ли правила использования?

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

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