Коды подтверждения Польши (+48): чек-лист, шаги API и решения

Подготовка: что нужно перед тестированием польских регистраций?

Пройдитесь по этому списку один раз, и первый польский заказ, скорее всего, пройдёт без сюрпризов:

1. Доступ. Создайте Bearer-ключ в консоли разработчика (он начинается с or_live_). Отдельные ключи для staging, CI и продакшена делают ротацию безболезненной.
2. Идентификаторы. Польша — pl. Берите id сервисов из GET /api/v1/services, а не зашивайте отображаемые названия.
3. Средства. Пополните кошелёк; каждая цена видна до заказа.
4. Куда доставлять. Зарегистрируйте HTTPS-вебхук и держите его секрет вне системы контроля версий. Опрос тоже работает, если входящий трафик заблокирован.
5. Лимит запросов. API допускает 300 запросов в минуту на аккаунт, так что ограничивайте параллельные наборы тестов соответственно.
6. Область применения. Верифицируйте только аккаунты, принадлежащие вашему продукту, вашей компании или вашему клиенту, и соблюдайте условия каждого сервиса наряду с нашей Политикой допустимого использования.

Для пайплайнов отдельно см. тестирование SMS OTP в CI-пайплайнах.

Какие сервисы сейчас отправляют коды на номера +48?

С точки зрения маршрутизации OTP Польша — одна из самых широких позиций каталога: более 2 300 сервисов. В текущем срезе популярных — Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber и Netflix.

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

Каковы точные шаги Poland OTP API?

Используя API SMS-верификации на https://otproute.com/api/v1, автоматический тест делает следующее:

1. GET /api/v1/prices?country=pl&service=<id> подтверждает актуальную цену этого сервиса в Польше.
2. POST /api/v1/activations с телом {"service": "<id>", "country": "pl"} возвращает номер +48 и id активации.
3. Ваш тест вводит номер в форму регистрации и запрашивает SMS.
4. Обработчик получает activation.sms_received; если он видит activation.expired или activation.cancelled, то помечает прогон как недоставленный.
5. Без вебхука читайте GET /api/v1/activations/{id} каждые несколько секунд, пока не появится код или не закончится окно.
6. Вызывайте POST /api/v1/activations/{id}/cancel, когда тест досрочно сворачивается.

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

Может ли операционная команда заказать польский номер без API?

Да. В кабинете OTP Route откройте OTP Gateway, выберите Польшу, найдите сервис и подтвердите показанную цену. После заказа скопируйте номер верификации Польши на экран проверки в приложении и следите за карточкой активации: текст SMS появится там, как только будет получен. Ничего устанавливать не нужно, а один и тот же кошелёк оплачивает и браузер, и API.

Чем польские номера и сообщения отличаются в обработке?

В Польше закрытый план нумерации без префикса междугородной связи: каждый номер, мобильный или стационарный, состоит из девяти цифр после +48. Это делает валидацию приятно строгой. Отклоняйте вводы, которые не сводятся к девяти национальным цифрам, убирайте пробелы и дефисы, которые пользователи ставят группами по три, и храните +48 и девять цифр одной строкой E.164. Случайный ведущий ноль — опечатка, а не префикс, который нужно сохранять.

Сообщения с кодами часто приходят на польском, если язык аккаунта польский. Символы вроде ą, ę, ł и ż не входят в 7-битный алфавит GSM, поэтому, если вы отправляете собственные польские OTP-сообщения, ожидайте более коротких сегментов и тестируйте шаблон в том виде, в каком он реально отображается на телефоне. При разборе входящих кодов ориентируйтесь на цифры и игнорируйте слова вокруг них.

Частые причины тестировать здесь: продукт выходит на польский рынок, локализационный QA польскоязычных сценариев, региональные команды, которые ведут бизнес-аккаунты по всей Центральной Европе, и приложения, среди клиентов которых есть поляки, живущие в других странах ЕС.

Устранение проблем: почему нет кода +48?

• Окно ещё открыто. Дайте ему все 20 минут, прежде чем делать выводы; плата берётся, только если код пришёл.
• Сервис может отклонять виртуальные номера. Некоторые платформы так делают, и тогда автоматический возврат возвращает на кошелёк всю сумму.
• Маршрут загружен. Повторите позже или протестируйте другой маршрут сервиса.
• Тест крутится в цикле. Повторный заказ каждые несколько секунд сжигает бюджет запросов; добавьте задержку.

Другие приёмы собраны в материале о снижении числа неудачных доставок OTP.

Есть ли в Польше выделенные номера и как устроена оплата?

Не как самостоятельно оформляемый продукт. Dedicated Virtual Numbers (выделенные виртуальные номера), от $1.95/month, предлагаются только в США и Канаде. Чтобы спросить о долгосрочной польской линии, напишите на [email protected]; возможность определяют местные правила, поэтому её наличие не обещается.

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

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

Как протестировать польскую регистрацию, если ни у кого в команде нет SIM-карты +48?

Закажите номер +48 для тестирования в OTP Gateway и используйте его в сценарии. Код появится в кабинете и может быть отправлен на ваш вебхук.

Каков код страны Польши в вызовах API OTP Route?

pl; он используется и в POST /api/v1/activations, и в запросе цен.

Сколько цифр в польском телефонном номере?

Девять национальных цифр после +48, без префиксного нуля. Фиксированная длина упрощает валидацию на сервере.

Сколько стоит получить SMS-код OTP из Польши?

Цены начинаются от $0.20 за код и зависят от сервиса. Кабинет и эндпоинт цен показывают точную сумму до заказа.

Потеряю ли я деньги, если польская активация истечёт пустой?

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

Можно ли смоделировать весь польский сценарий до запуска в продакшен?

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

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