Путь разработчика к швейцарским (+41) кодам подтверждения

Какие запросы возвращают швейцарский код через API?

OTP API для Швейцарии — тот же компактный набор методов, что и для любой другой страны; идентификатор страны — ch. Авторизуйтесь Bearer-ключом (префикс or_live_), созданным в консоли разработчика; на одном аккаунте можно держать до 10 ключей.

1. Получите идентификаторы через GET /api/v1/services и GET /api/v1/countries и кэшируйте их между запусками.
2. Проверьте цену через GET /api/v1/prices?country=ch&service=<id>. В ответе — текущая цена и признак того, открыт ли сейчас маршрут.
3. Отправьте POST /api/v1/activations с телом {"service": "whatsapp", "country": "ch"} или с тем сервисом, который покрывает ваш тест. Сохраните возвращённый идентификатор активации.
4. Подставьте номер +41 в поле телефона вашего собственного продукта.
5. Читайте результат через GET /api/v1/activations/{id} или из вебхука; чисто отменить заказ можно через POST /api/v1/activations/{id}/cancel.

GET /api/v1/balance стоит вызывать на шаге подготовки вашего набора тестов. Лимит — 300 запросов в минуту на аккаунт: этого с запасом хватает для нескольких параллельных задач, которые опрашивают API с умеренным интервалом. Справочник по методам: документация.

Опрос или вебхуки для активаций +41?

Опрос делает простой скрипт ещё проще. Но как только тесты идут параллельно, выигрывают вебхуки: ничего не нужно гонять по кругу, пока SMS движется к номеру в Цюрихе.

OTP Route позволяет зарегистрировать до пяти эндпоинтов; подпишите каждый на activation.sms_received, activation.expired и activation.cancelled. Проверяйте каждую доставку, прежде чем ей доверять: возьмите части t и v1 из X-OTPRoute-Signature, вычислите HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, сравните за постоянное время и отклоняйте метки времени за пределами небольшого допуска. Привяжите обработку к идентификатору активации, чтобы повторная доставка не приводила ни к чему.

Подробнее о проверке подписи — в материале защита вебхуков OTP с помощью HMAC.

Как швейцарский номер должен выглядеть в вашей базе данных?

Внутри страны швейцарские номера начинаются с транкового префикса 0, например мобильный записывается как 079 123 45 67. В международном формате этот ноль пропадает: формат E.164 — +41 79 123 45 67, то есть девять цифр после кода страны. Мобильные диапазоны находятся в блоке 07x. Храните каноническую строку +41… и форматируйте её только для отображения — иначе дедупликация и поиск ломаются, когда одна запись содержит 079, а другая +4179.

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

Команды тестируют здесь перед запуском финтех- или e-commerce-продукта на швейцарском рынке, при работе сотрудников поддержки, которые ведут бизнес-аккаунты из Женевы или Базеля, и при проверке трансграничных сценариев, затрагивающих также Лихтенштейн, у которого свой код +423.

С какими сервисами можно проходить проверку на швейцарский номер

В текущем снимке для ch значатся Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) и Claude, среди прочих. Всего для Швейцарии в OTP Gateway доступно более 1 700 сервисов.

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

Что делать, если швейцарская активация остаётся пустой

Если на номер +41 ничего не приходит, пройдите по этим пунктам, прежде чем трогать код:

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

В статье о маршрутизации OTP по странам объясняется, почему одно и то же приложение может вести себя по-разному на маршрутах разных стран.

Есть ли долгосрочный швейцарский номер?

Как самостоятельный продукт — нет. Для Швейцарии OTP Route предлагает только одноразовые номера через OTP Gateway.

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

Кошелёк, счета и песочница для OTP-маршрутизации в Швейцарии

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

Для работы над интеграцией запросите режим песочницы на тестовом аккаунте. Он возвращает имитированные номера и коды, поэтому весь путь SMS verification API можно проверить, не расходуя средства кошелька. Реальные активации используйте только для собственных продуктов и аккаунтов, соблюдая условия каждого сервиса и Политику допустимого использования OTP Route. Страница о решении для QA-тестирования показывает, как команды встраивают это в проверки перед релизом.

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

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

Для Швейцарии это ch. Швейцарские запросы передают это двухбуквенное значение везде, где ожидается страна, включая тело запроса активации.

Можно ли проверить швейцарский сценарий входа, не имея швейцарской SIM-карты?

Да. Номер +41 для тестирования из OTP Gateway получает код, который вы затем читаете в панели или через API.

Нужно ли сохранять 0 при записи швейцарского мобильного номера?

Нет. Ноль — это внутренний транковый префикс; храните формат E.164, начинающийся с +41 и далее девять цифр.

На каком языке придёт швейцарское проверочное SMS?

Это зависит от отправителя: распространены немецкий, французский, итальянский и английский. Извлекайте код по шаблону из цифр, а не по фиксированной формулировке.

Сколько стоит SMS OTP для Швейцарии?

От $0.20 за код; точная цена для каждого сервиса возвращается методом GET /api/v1/prices до того, как вы сделаете заказ.

Что происходит с деньгами, если код не пришёл?

Они автоматически возвращаются на ваш кошелёк, когда окно закрывается или когда вы отменяете активацию.

Покрывает ли швейцарский маршрут Лихтенштейн?

Нет, у Лихтенштейна свой код страны +423 и своя страница в списке стран, поэтому заказывайте его отдельно.

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