Как получать SMS-коды OTP из Косова через API или панель

Зачем продуктовой команде вообще нужен номер +383?

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

Второй фактор — локализация. Албанский и сербский — официальные языки, поэтому сценарий, переведённый на любой из них, заслуживает настоящего сквозного теста, а не просмотра скриншотов. Верификационный номер Косова из OTP Gateway позволяет QA провести такую проверку из любого офиса.

У региональных операционных команд, работающих в Приштине или охватывающих весь регион Западных Балкан, есть третья причина: бизнес-профили, зарегистрированные на местный контакт, иногда запрашивают свежий код, и пропускать его через общий, подотчётный инструмент лучше, чем передавать из рук в руки телефон сотрудника.

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

Сегодняшний срез показывает более 400 сервисов для Косова. Среди популярных сейчас доступны WhatsApp, Viber, Telegram, Facebook, Instagram, TikTok, Google (Gmail и YouTube), Microsoft и Outlook, Amazon, Snapchat, Netflix, Airbnb, Uber и Flipkart.

Список короче, чем на более крупных европейских рынках, и меняется чаще, поэтому воспринимайте любой записанный список как подсказку. Авторитетный ответ — то, что GET /api/v1/countries и панель возвращают в момент заказа.

API OTP для Косова на практике

Идентификатор страны — xk. Типичная интеграция получает идентификаторы сервисов из GET /api/v1/services, проверяет стоимость через GET /api/v1/prices?country=xk&service=<id>, а затем открывает активацию через POST /api/v1/activations с телом вроде {"service": "telegram", "country": "xk"}. Ответ содержит номер и идентификатор активации, который вы сохраняете на будущее.

Далее код приходит к вам вебхуком activation.sms_received, подписанным в заголовке X-OTPRoute-Signature как HMAC-SHA256 от "<t>.<raw body>". Отклоняйте старые метки времени и привязывайте обработчик к идентификатору активации, чтобы повторно доставленное событие обрабатывалось только один раз. Опрос GET /api/v1/activations/{id} тоже подходит, когда у CI-задачи нет публичного URL. Полные примеры есть в руководстве по интеграции.

Что изменилось, когда у Косова появился код +383, и как хранить номера?

Собственный код страны +383 Косово получило только в конце 2010-х. До этого его мобильные сети использовали заимствованные коды, в том числе Монако и Словении, и в некоторых старых клиентских записях до сих пор лежат номера в этих форматах. Если вы импортируете устаревшие данные, помечайте такие записи, а не переписывайте их автоматически.

Внутренние номера начинаются с префикса 0; мобильный номер, который локально выглядит как 044 123 456, в E.164 — это +383 44 123 456. Сохраняйте международную форму, убирайте ноль при вводе и форматируйте только при отображении. В албанском тексте есть буквы вроде ë, выходящие за базовый алфавит GSM, поэтому локализованное сообщение может отправляться в UCS-2 с более короткими сегментами.

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

Дайте активации полные 20 минут. Когда окно закрывается без SMS или вы отменяете заказ, списание автоматически отменяется в кошельке и срабатывает activation.expired или activation.cancelled. Разумные следующие шаги:

• повторите после паузы или выберите соседний маршрут, например Албании, если это допускает ваш тест;
• проверьте, принимает ли целевой сервис виртуальные номера вообще;
• добавьте задержку с нарастанием в автоматические повторы вместо заказов в цикле.

Долгосрочные линии, кошелёк и песочница для проектов в Косове

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

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

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

Можно ли проверить регистрацию в моём приложении на албанском языке с настоящим номером Косова?

Да. Закажите номер +383 для тестов в OTP Gateway, начните регистрацию на албанском, и код появится в панели и на вашем вебхуке.

Какой идентификатор использует Косово в API SMS-верификации?

Косово — это xk во всех конечных точках, принимающих страну, включая GET /api/v1/prices и POST /api/v1/activations.

Сколько стоит верификационный номер Косова?

От $0.20 за код; точный тариф зависит от сервиса и показывается до заказа или возвращается конечной точкой цен.

Почему для Косова я вижу меньше сервисов, чем для Германии?

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

Что будет с моими деньгами, если косовские OTP не придут?

Они полностью вернутся в кошелёк, когда 20-минутное окно закончится без SMS, или сразу при отмене.

Принадлежат ли старые номера +377 или +386 по-прежнему пользователям из Косова?

В устаревших записях они могут встречаться, но новые номера используют +383. Относитесь к старым форматам как к данным для проверки, а не для слепого преобразования.

Можно ли сохранить номер +383 для повторных входов?

Самостоятельно — нет. Каждый номер шлюза рассчитан на один код, а долгосрочные линии — продукт для США и Канады; по Косову напишите на [email protected].

Есть ли правила использования номеров OTP Route?

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

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