Коды подтверждения Парагвая (+595): сначала API

Как запросить номер +595 в коде?

Начните в консоли разработчика и создайте Bearer-ключ; ключи начинаются с or_live_, их можно держать до 10, поэтому отдельные ключи для staging и CI создавать легко. Все вызовы идут на https://otproute.com/api/v1.

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

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

Что должен делать вебхук-обработчик с парагвайским кодом?

Ваш эндпоинт получает activation.sms_received, когда сообщение пришло, activation.expired, когда окно закрылось пустым, и activation.cancelled после отмены. Каждое событие привязано к id активации.

• Сначала проверьте подпись. Разделите X-OTPRoute-Signature на t и v1, посчитайте HMAC-SHA256 от метки времени, точки и необработанного тела запроса с секретом эндпоинта и сравните за постоянное время.
• Отклоняйте устаревшие запросы. Метка времени, сильно отличающаяся от ваших часов, означает повтор запроса или сильно рассинхронизированный сервер.
• Будьте идемпотентны. Сохраняйте id активации и игнорируйте повторы, чтобы повторная доставка не обработала код дважды.

На аккаунт разрешено до 5 вебхук-эндпоинтов. Если вы предпочитаете опрос, держите интервал умеренным; лимит — 300 запросов в минуту на аккаунт. Более полный чек-лист есть в руководстве по HMAC-вебхукам.

Какие сервисы открыты на парагвайских маршрутах?

Сейчас для Парагвая доступно более 1 600 сервисов. Среди самых востребованных — WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix и ChatGPT (OpenAI). WhatsApp — повседневный мессенджер для многих людей в регионе, поэтому с него команды часто начинают проверку при тестировании поддержки через чаты.

Как записываются и нормализуются мобильные номера +595?

В Парагвае для внутренних звонков используется префикс 0, поэтому мобильный номер в местной записи начинается с 09. В E.164 этот 0 уходит: канонический вид — +595 и девять цифр, причём мобильные начинаются с 9. Нормализуйте при вводе, храните только E.164, а форматируйте для показа на границе системы. Правила валидации, ожидающие фиксированную длину из другой страны, — частая причина того, что парагвайские пользователи не проходят регистрацию, поэтому включите номер +595 в тест-кейсы валидации.

Испанский и гуарани — официальные языки. Сообщения с кодами от международных сервисов, как правило, приходят на испанском или английском в зависимости от шаблона и настроек аккаунта. Разбирайте код шаблоном только по цифрам и храните тела сообщений в UTF-8, чтобы акценты и ñ пережили логирование.

Зачем командам верифицировать аккаунты в Парагвае?

Парагвай входит в Меркосур и расположен между Аргентиной, Бразилией и Боливией, поэтому компании, уже работающие в регионе, часто добавляют его в запуск по Южной Америке. Типичные причины тестировать здесь: локализационный QA на испанском для парагвайской аудитории, проверка того, что региональный онбординг принимает номера +595, верификация бизнес-профилей операционными командами для местных клиентов и поддержка парагвайцев за рубежом, которые регистрируются на домашние номера. Как эти проверки вписываются в релизное тестирование, описывает страница верификация мобильных приложений.

Есть ли способ получить номер верификации Парагвая без кода?

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

Что помогает, когда код +595 не появляется?

Дайте активации все 20 минут, прежде чем делать выводы. Если окно закроется пустым, оплата вернётся автоматически. Затем разберите обычные причины: сервис может не принимать виртуальные номера, маршрут может быть перегружен в этот час, либо другой маршрут сервиса сработает позже. Не отправляйте повторные заказы в плотном цикле; добавьте задержку между попытками и логируйте id активаций, чтобы замечать закономерности по сервисам.

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

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

Оплата идёт через один предоплаченный кошелёк в USD: пополнение картой или USDT/USDC, PDF-счёт по почте, и вы платите только за пришедшие коды. Тестовые аккаунты по запросу переводятся в песочницу с имитированными номерами и кодами. OTP Route предназначен для тестирования и работы с вашими собственными легитимными продуктами; соблюдайте условия каждого сервиса и Политику допустимого использования.

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

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

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

Хранить ли парагвайские номера с префиксом 09?

Нет. Отбросьте внутренний 0 и храните +595 и девятизначный национальный номер.

Сколько стоит номер +595 для тестирования?

Парагвайская активация стоит от $0.20 за код в зависимости от сервиса, а с кошелька списывается только код, который действительно пришёл.

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

Да. Закажите номер верификации Парагвая в OTP Gateway и читайте код в кабинете или через API.

Придут ли коды на гуарани?

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

Что будет с деньгами, если активация истечёт?

Если SMS не пришло в 20-минутное окно, вся сумма автоматически вернётся на ваш кошелёк.

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