OTP-маршрутизация для Суринама: коды +597 для разработчиков и QA

Кому нужен номер верификации Суринама?

Суринам — небольшой рынок, но особенный: официальный язык — нидерландский, широко распространён также сранан-тонго, страна входит в Карибское сообщество и граничит с Гайаной, Французской Гвианой и Бразилией. Команды, которые выпускают интерфейсы на нидерландском для Южной Америки, поддерживают клиентов, связанных с Нидерландами, или проверяют региональные сценарии онбординга, упираются в одно и то же препятствие: экран регистрации, который требует номер +597. OTP Route предоставляет такой номер на один код, без местной SIM-карты.

Что можно верифицировать на маршруте +597?

Актуальный список для Суринама охватывает более 900 сервисов. Частые варианты — WhatsApp, Telegram, Instagram, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, LinkedIn, Signal, Viber и Uber. Поскольку наличие меняется в течение дня, перед каждым прогоном получайте текущие пары из API.

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

Что должно быть готово перед первым заказом +597?

Короткий список избавит от лишних активаций:

• API-ключ из консоли разработчика, хранящийся в вашем хранилище секретов, а не в тестовом коде.
• Публичный URL вебхука с проверкой подписи либо цикл опроса с умеренным интервалом.
• Идемпотентный обработчик, чтобы повторная доставка activation.sms_received не отправила код дважды.
• Проверка того, принимает ли тестируемый сервис виртуальные номера вообще.
• Либо средства на кошельке, либо аккаунт sandbox для пробных прогонов.

Как работает схема OTP API для Суринама?

Отправляйте запросы на https://otproute.com/api/v1 с вашим Bearer-ключом or_live_. Идентификатор страны Суринама — sr.

1. GET /api/v1/prices?country=sr&service=<id> возвращает текущую цену.
2. POST /api/v1/activations с телом {"service": "<id>", "country": "sr"} резервирует номер +597.
3. Запустите отправку SMS из тестируемого приложения.
4. Слушайте activation.sms_received или опрашивайте GET /api/v1/activations/{id}.

Проверяйте X-OTPRoute-Signature каждого вебхука, прежде чем ему доверять. Каждый вызов разбирают руководство по интеграции и документация.

Можно ли сделать это вместо этого через панель?

Да. Выберите Суринам и сервис в OTP Gateway, прочитайте цену, подтвердите и вставьте номер в приложение. Код появится на карточке активации, когда придёт SMS. Отмените в любой момент внутри окна, если он больше не нужен. Этот путь подходит сотрудникам поддержки и аккаунт-менеджерам, верифицирующим один бизнес-профиль и не желающим трогать API-ключ.

Как хранить и разбирать номера Суринама?

У номеров Суринама после кода страны +597 семь национальных цифр. Сохраняйте их как +597 и эти семь цифр, без пробелов. Коды от международных приложений обычно приходят на английском или нидерландском в зависимости от настроек аккаунта, поэтому извлекайте числовой код по шаблону, а не полагайтесь на окружающий текст.

Полезный регрессионный тест — подать в форму номер +597 и убедиться, что валидация не отклоняет его за то, что он короче десятизначных номеров, которых многие библиотеки ждут от Северной Америки. Короткие национальные номера — частый источник тихих сбоев регистрации на небольших рынках.

Почему суринамский код может не прийти?

Большинство промахов связано со стороной получателя, а не с вашим кодом. Сервис может придерживать сообщения на виртуальные номера, маршрут может быть загружен в этот час, или приложение может ограничивать повторные запросы с одного устройства. Дождитесь конца 20-минутного окна, повторите позже или с другой парой сервиса и не открывайте новую активацию каждые несколько секунд. Как планировать запасные варианты, объясняет наша статья о маршрутизации OTP по странам.

Что насчёт оплаты и долгосрочных линий?

OTP Route работает на едином предоплаченном USD-кошельке без абонентской платы: пополняйте картой или в USDT/USDC и каждый раз получайте PDF-счёт на почту. Для аккаунтов разработки по запросу доступен переключатель sandbox. Самообслуживаемого долгосрочного номера в Суринаме нет; Dedicated Numbers продаются только для США и Канады, от $1.95/month, а о линии +597 можно спросить, написав на [email protected] — без обещания, что её удастся оформить. Полные тарифы — на странице цен.

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

Можно ли получать SMS OTP из Суринама, не находясь в Суринаме?

Да. OTP Route назначает номер +597 удалённо, а код приходит в панель или на ваш вебхук. Никому в команде не нужны суринамская SIM-карта или местные контакты.

Какой идентификатор страны в API у Суринама?

Используйте sr в запросах цен и в теле активации. Идентификаторы сервисов берутся из GET /api/v1/services.

Как долго номер +597 остаётся активным для получения кода?

Двадцать минут на одну активацию. В течение этого окна можно попросить приложение отправить код повторно.

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

Дайте окну отработать, затем повторите позже или попробуйте другой маршрут, например Гайану. Не заказывайте снова в быстром цикле и проверьте, принимает ли сервис виртуальные номера.

Плачу ли я за неудачные попытки?

Нет. Вы платите только когда код пришёл; истёкшие или отменённые активации автоматически возвращаются на кошелёк.

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

От $0.20 за код. Актуальная цена по каждому сервису возвращается API и отображается в панели до заказа.

Может ли мой CI-конвейер использовать номера Суринама?

Да, через REST API с отдельным ключом. Держите запросы в пределах 300 в минуту и см. руководство по тестированию SMS OTP в CI-конвейерах.

Какие ограничения действуют на использование номера +597?

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

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