Как доставить коды подтверждения +63 в тесты и рабочие процессы

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

На Филиппинах развитая индустрия аутсорсинга и клиентской поддержки, огромная мобильная потребительская аудитория и миллионы граждан, работающих за рубежом, но по-прежнему держащих аккаунты на домашние номера. Эти три факта объясняют большую часть спроса:

• Команды поддержки и BPO, которые ведут бизнес-аккаунты клиентов и которым нужен номер, которым никто не пользуется лично (линии поддержки клиентов).
• Продуктовые команды, запускающие приложение или кошелёк в Маниле или Себу и желающие проверить регистрацию на настоящей маршрутизации +63 (тестирование в CI/CD).
• Приложения для филиппинских работников за рубежом, которым нужно проверять сценарий верификации на филиппинских номерах из-за границы.

Какова последовательность запросов в Philippines OTP API?

Используйте идентификатор страны ph, базовый URL https://otproute.com/api/v1 и Bearer-ключ or_live_.

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

Про повторные попытки и ротацию ключей рассказывает руководство по интеграции OTP API.

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

Для Филиппин сейчас доступно более 1 400 сервисов. Среди популярных в живом списке — Facebook, Viber, Shopee, Lazada, WhatsApp, Telegram, TikTok, Instagram, Google (Gmail & YouTube), X (Twitter), Discord, Microsoft & Outlook, ChatGPT (OpenAI) и Netflix. Поскольку наличие меняется от часа к часу, запрашивайте эндпоинт цен во время выполнения, а не зашивайте список в код.

Могут ли нетехнические сотрудники заказать номер +63 в кабинете?

Да, и для службы поддержки, которая верифицирует несколько клиентских аккаунтов в неделю, это обычно более простой путь. После регистрации по коду из письма или через Google откройте OTP Gateway, выберите Филиппины, выберите сервис и проверьте цену, показанную перед подтверждением. Вставьте номер +63 в проверяемое приложение и держите вкладку открытой: код появится на том же экране. Руководителям групп стоит включить двухфакторную аутентификацию (TOTP) для входа в OTP Route, поскольку в течение смены им могут пользоваться несколько операторов.

Как превратить мобильный номер 09XX в формат E.164?

Филиппинские мобильные номера локально записываются с префиксом 0, например 09xx xxx xxxx. Для E.164 уберите 0 и добавьте +63, получится +63 9xx xxx xxxx: десять цифр после кода страны, причём мобильные начинаются с 9.

Пользователи часто вставляют номера с дефисами, с 0, оставшимся после +63, или с 63 без плюса. Нормализуйте при вводе, храните значение E.164, а форму с 09 оставьте только для отображения. Сообщения с кодами для филиппинских пользователей обычно на английском, хотя некоторые приложения отправляют их на филиппинском, если так задан язык аккаунта, поэтому парсерам стоит искать цифры, а не окружающие слова.

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

Каждая активация живёт 20 минут, и плата берётся, только если код пришёл. Отмена или истёкшее окно возвращают на кошелёк всю сумму без каких-либо заявок.

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

Оплата, песочница и вопрос о долгосрочной линии

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

Самостоятельно оформляемых долгосрочных филиппинских номеров нет. Выделенные линии существуют только для США и Канады, от $1.95/month; командам, которым нужна постоянная линия +63, можно написать на [email protected], а ответ зависит от местных правил.

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

Можно ли протестировать регистрацию в филиппинском приложении из-за пределов страны?

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

Сохранять ли 0 при вводе номера +63 в приложении?

Нет. После выбора +63 вводите десять цифр, начинающихся с 9, и отбрасывайте ведущий 0.

Сколько стоит SMS-код OTP для Филиппин в OTP Route?

От $0.20 за код. Точная сумма для сервиса приходит из GET /api/v1/prices и показывается в кабинете до покупки.

Доступен ли Viber на филиппинском маршруте?

Он есть в текущем списке популярных, но наличие меняется в течение дня, поэтому перед заказом подтвердите его живым запросом цены.

Что, если сервис отклоняет номер?

Если код не пришёл в течение 20 минут или вы отменили заказ, ничего не списывается. Некоторые сервисы по политике отклоняют виртуальные номера.

Может ли наша BPO-команда месяцами пользоваться одним номером +63?

С OTP Gateway нет: один номер обслуживает одну верификацию. Долгосрочные линии, оформляемые самостоятельно, есть только в США и Канаде; о Филиппинах спросите поддержку.

Есть ли песочница для автотестов?

Да, по запросу. Тестовый аккаунт в песочнице возвращает имитированные номера и коды, так что CI-задачи никогда не трогают средства кошелька.

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

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

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