API для реселлеров

Станьте реселлером SMS-активаций

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

195сервисов сейчас в каталоге

209стран сейчас в каталоге

TRY · USD · RUBвалюты отображения

Зарегистрируйтесь бесплатно и получите API-ключ Обзор SMS API

Страницы API

Кому подойдёт

С одним API-ключом вы можете вести активации множества клиентов и продавать SMS-верификации через собственный интерфейс. Интерфейс, цены и общение с клиентами остаются за вами; на стороне Turonay движется только баланс, привязанный к вашему API-ключу. Начать можно с небольшого бота и пользоваться той же интеграцией по мере роста клиентской базы.

Владельцам Telegram-ботов

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

Владельцам панелей и сайтов

Продавайте SMS-активации на своём сайте. Панели с поддержкой handler_api обычно подключаются сменой одного лишь базового адреса.

Агентствам и студиям разработки

Напишите одну интеграцию для клиентов, а ценообразование и выставление счетов оставьте на своей стороне.

QA и тестовым командам

Проверяйте регистрацию и верификацию сквозным тестом с реальными SMS; за попытки без пришедшего кода платить не нужно.

Как формируется наценка

cost в ответе getPrices — это сумма, которую платите вы; скидка вашего уровня в ней уже учтена. Цену для клиента вы назначаете сами, а разница и есть ваша наценка.

bash

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getPrices&service=wa&country=62"
{"62":{"wa":{"cost":12.50,"count":744716}}}

Статья	Сумма в примере
Ваша стоимость (`getPrices` → `cost`)	12.50 TRY
Ваша цена продажи	18.00 TRY
Наценка с одной активации	5.50 TRY

Цифры приведены только для примера. Реальные цены зависят от сервиса и страны и всегда должны читаться через getPrices.

Если цена продажи у вас фиксирована, передавайте в maxPrice максимальную стоимость, которую вы готовы нести за одну активацию. Если цена окажется выше, покупка не выполняется, и наценка не уходит в минус. Проверять цену через getPrices до показа клиенту — самый надёжный способ держать цену продажи в соответствии с текущей стоимостью.

bash

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getNumber&service=wa&country=62&maxPrice=12"
WRONG_MAX_PRICE:12.50

Скидки по уровням

Каждый аккаунт относится к уровню в зависимости от общей суммы пополнений баланса. По мере пополнений уровень растёт, и у каждого уровня своя скидка. Пороги и размеры скидок устанавливает Turonay; после входа на странице «Уровень» видны актуальный список уровней и то, сколько осталось до следующего.

Скидка применяется к ценам API автоматически: getPrices показывает вашу стоимость со скидкой, а getNumber резервирует ту же цену.
Если вы подходите под несколько уровней, действует наибольшая скидка.
Скидка никогда не опускает цену ниже минимального порога.
Точные ставки могут меняться, поэтому на этой странице не указан фиксированный процент; актуальную ставку вы увидите на странице своего уровня.

Варианты интеграции

Совместимость с handler_api

Благодаря протоколу, совместимому с handler_api, готовые боты и панели обычно подключаются сменой базового адреса и ключа. Примеры по языкам: Python, PHP, Node.js.

Уведомления через вебхуки

Используйте подписанные вебхуки, чтобы передавать код клиенту без опроса; уведомление ставится в очередь, как только код записан, и обычно доставляется в течение 1–2 минут. Тело запроса подписано HMAC-SHA256.

getActiveActivations для панели

getActiveActivations возвращает ваши открытые активации вместе с кодами. После перезапуска сервер продолжит с того же места, а данные можно использовать для собственной админ-панели.

Все методы описаны в разделах «Центр SMS API» и «Справочник API».

Защита от рисков и правила оплаты

Главные риски перепродажи — платить за недоставленные активации и терять деньги на колебаниях цены. Система ограничивает оба риска так:

Оплата за код: при выдаче номера сумма только резервируется, а списывается при получении кода.
Возврат резерва: если вы отменили активацию до прихода кода, провайдер её отменил или срок истёк, зарезервированная сумма возвращается на баланс.
Потолок цены: при превышении maxPrice покупка не выполняется и возвращается WRONG_MAX_PRICE:цена.
Котировка цены: цена, показанная в getPrices, сохраняется ненадолго (около двух минут); даже если за это время цена вырастет, спишется та цена, которую вы видели.
После кода отмена невозможна: в этом случае setStatus 8 возвращает EARLY_CANCEL_DENIED. Выстраивайте политику возвратов для клиентов с учётом этого правила.
Недостаточно средств: если баланса не хватает на цену, возвращается NO_BALANCE и покупка не выполняется.
Лимит запросов: действует лимит запросов в минуту (по умолчанию 60 запросов в минуту на ключ и IP). Вместо частого опроса используйте вебхуки.

Как начать

1. Зарегистрируйтесь

Чтобы создать аккаунт, перейдите на страницу регистрации.

2. Пополните баланс

На странице «Оплата» добавьте средства картой, криптовалютой или банковским переводом. Сумма пополнений определяет ваш уровень.

3. Получите API-ключ

Создайте ключ в разделе API своего профиля.

4. Протестируйте

Проверьте соединение через getBalance и getPrices и получите первый номер. Подробности: «Справочник API».

5. Подключите вебхук и запускайтесь

Укажите адрес вебхука, отправьте тестовое событие из профиля и начинайте продавать.

Вопросы реселлеров

Нужно ли платить отдельно или заключать договор, чтобы стать реселлером?

Отдельной подписки или платы за доступ к API нет. API-ключ вы получаете в профиле и платите только за доставленные коды.

Могу ли я сам назначать цену для клиентов?

Да. getPrices показывает вашу стоимость, а цена продажи целиком на вашей стороне. Наценка — это разница между ценой продажи и стоимостью.

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

Уровень зависит от общей суммы пополнений вашего баланса, и у каждого уровня своя скидка. Если вы подходите под несколько уровней, действует наибольшая. Скидка автоматически отражается в ценах getPrices и getNumber; актуальные ставки видны после входа на странице вашего уровня.

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

Если вы отмените активацию через setStatus 8 до прихода кода, зарезервированная сумма вернётся на баланс и ничего не спишется. Так же происходит, если провайдер отменил активацию или срок истёк.

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

После прихода кода активацию отменить нельзя: setStatus 8 вернёт EARLY_CANCEL_DENIED, а оплата не возвращается, так как услуга оказана. Определите собственную политику возвратов с учётом этого.

Сколько активаций можно вести одновременно?

Число одновременных активаций зависит от вашего баланса и лимита запросов в минуту (по умолчанию 60 запросов в минуту на ключ и IP). Если планируете много одновременных активаций, используйте вебхуки вместо частого опроса.

Как отслеживать цены и остатки в реальном времени?

getPrices возвращает в JSON текущую цену и количество номеров по сервисам и странам; getNumbersStatus показывает остатки сервисов в стране, а getCountries — страны, в которых можно получить номер.

Начните как реселлер

Получите API-ключ, посмотрите свою стоимость через getPrices, проверьте сценарий на небольшой тестовой активации и сделайте первую продажу. Если что-то не получится, напишите нам через систему обращений в поддержку.

Зарегистрируйтесь бесплатно и получите API-ключ Обзор SMS API