Перепродавайте личные виртуальные номера через API SMS Activate App: покупайте на свой аккаунт по нашей цене, добавляйте маржу, работайте через бот или сайт.
Это руководство для вас, если вы хотите продавать личные виртуальные номера своим клиентам через сервис под своим брендом (white-label), Telegram-бот или небольшой сайт. В нём описано, как устроена схема, как назначить цену за номер, какие вызовы API нужны, как работают расчёты и где заканчивается наша ответственность.
Как устроена перепродажа
У вас один аккаунт в SMS Activate App и API-ключ. Вы покупаете номера на этот аккаунт через API. Ваш бот или сайт показывает каждому клиенту его номер и коды подтверждения из SMS, которые на него приходят.
Каждый номер реальный: мобильный или местный из диапазона оператора связи, в зависимости от страны. Номер закреплён за вашим аккаунтом на срок 28 дней. Он принимает SMS и звонки.
Ваши клиенты остаются вашими клиентами. Вы принимаете их платежи, отвечаете на их вопросы и сами устанавливаете условия. Аккаунт у нас им не нужен. Подробнее об этой модели на странице для реселлеров.
Цена и маржа
Наша цена задаётся для каждого номера и каждой страны. Актуальное значение вы получаете из API:
- GET /v1/public/countries возвращает для каждой страны minPriceCents, maxPriceCents и availableNumbers.
- GET /v1/public/numbers/search?country=US&limit=20 возвращает номера, доступные для покупки. Поле priceCents у каждого из них содержит вашу цену.
Все суммы в API указаны в центах USD целыми числами.
Ваша цена складывается из нашей цены за номер и вашей маржи. Если номер обходится вам в C, а продаёте вы его за P, ваша маржа равна P минус C. Маржа в процентах считается как (P минус C), делённое на P. Наценка считается иначе: (P минус C), делённое на C. Наценка всегда больше маржи, поэтому решите, какой показатель вы имеете в виду, прежде чем ставить цель.
Пересчитывайте цену по актуальным данным при каждой продаже. Не опирайтесь на фиксированный прайс: цены по странам могут меняться. Скидок для реселлеров и оптовых уровней нет. Вы покупаете по обычной цене, той же, что на странице цен.
Заложите в бюджет и эти расходы:
- Окончательные покупки. После выдачи номер нельзя вернуть, а деньги за него не возвращаются, даже если платформа его отклонит.
- Решения платформ. Принимать номер или нет, решает платформа, а не мы. Дайте клиентам сначала проверить, что номер подходит для их сервиса, или заложите этот риск в цену.
- Автопродление. Номер продлевается и оплачивается каждые 28 дней, пока вы не отключите автопродление.
- Комиссии за платежи. Ваша платёжная система берёт с вас комиссию за каждый платёж клиента.
- Время на поддержку. Клиенты будут задавать вам вопросы, и ответы займут ваше время.
Работа с API по шагам
Базовый URL: https://api.sms-activate.app/v1/public. Каждый вызов, включая каталог, требует ключа в заголовке Authorization: Bearer vpn_xxx.
- Получите список стран. Вызовите GET /countries, чтобы узнать, в каких странах есть номера и в каком диапазоне цен.
- Найдите номера. Вызовите GET /numbers/search?country=US&limit=20, чтобы увидеть доступные номера в стране. У каждого номера указана ваша цена в priceCents.
- Купите номер. Вызовите POST /numbers с JSON в теле {"phone": "+15551234567", "country": "US"} и заголовком Idempotency-Key, в котором указан UUID. Если при повторе отправить тот же ключ, деньги не спишутся дважды. При успешной покупке приходит ответ 201 с номером, chargedCents и balanceAfterCents. Два поля необязательны: autoRenew (по умолчанию true) и note. В note удобно хранить идентификатор клиента.
- Получайте коды. Вызовите GET /numbers/{id}/sms для одного номера или GET /sms для всех ваших номеров. Оба вызова используют постраничную выдачу с курсором. Чтобы коды приходили к вам сами, вызовите PATCH /numbers/{id} с {"forwardWebhookUrl": "https://your-app.example.com/sms"}: тогда каждое SMS и каждый звонок на этот номер отправляются на ваш сервер с подписью HMAC-SHA256. Прежде чем показать код, сопоставьте его с нужным клиентом.
- Управляйте сроком. Если клиент не продлевает номер, вызовите PATCH /numbers/{id} с {"autoRenew": false}. Чтобы освободить ненужный номер, вызовите DELETE /numbers/{id}.
Ещё два вызова помогают вести учёт. GET /balance возвращает баланс в центах. GET /v1/me/transactions выводит выписку по счёту.
Ошибки приходят в одном формате: {"error": "<code>", "message": "...", "reqId": "..."}. Ориентируйтесь на код в error, а не на HTTP-статус. Некоторые отказы, например insufficientbalance, nonumbers и priceexceeded, являются ответом по существу. Показывайте их клиенту, а не повторяйте запрос вслепую. При ratelimited подождите столько, сколько указано в заголовке Retry-After.
Полная спецификация находится в файле OpenAPI, а каждый вызов описан в документации API.
Расчёты: ваш баланс у нас
Покупки оплачиваются с баланса вашего аккаунта. На сайте баланс пополняется криптовалютой (USDT). В Telegram-боте можно также оплатить рублёвой банковской картой и Telegram Stars. Если связать аккаунты, сайт и бот используют один баланс.
Пополняйте баланс заранее, до часов наибольшей нагрузки. При нехватке средств покупка отклоняется с ошибкой insufficient_balance, и клиент ждёт, пока вы пополняете счёт.
Вывод средств возможен только в USDT (TRON, BSC или TON). Вывод вы оформляете сами в аккаунте на сайте или в Telegram-боте: до 100 $ в день выплачивается автоматически за несколько минут, сумму сверх этого поддержка выплачивает вручную по запросу. Деньги, оплаченные картой, начисленные бонусом или полученные переводом, можно вывести через 180 дней после зачисления, пополнения криптовалютой сразу. Минимальная сумма: 10 $. Комиссия составляет 10% от суммы, но не меньше 5 USDT, и удерживается из суммы вывода.
Собственные покупки и партнёрская программа
Покупки на вашем аккаунте или на любом аккаунте, которым вы управляете, никогда не приносят партнёрскую комиссию.
Некоторые клиенты захотят завести собственный аккаунт. Отправьте им свою партнёрскую ссылку. Тогда вы получаете от 10% до 30% нашей маржи (не цены) с их покупок и продлений, пока существует их аккаунт; доля растёт с числом приведённых вами людей, которые купили: от 10% за первых 3 покупателей до 30% с 3001-го. Каждая комиссия зачисляется на ваш баланс через 30 дней после покупки. Подробности на страницах партнёрской программы и для реселлеров.
Поддержка
Ваши клиенты обращаются к вам. Вы обращаетесь к нам. Вам ответит сотрудник по почте support@sms-activate.app или в Telegram t.me/BestVoipTelegram, обычно в течение 24 часов.
Не обещайте клиентам больше, чем обещаем вам мы. Мы не обещаем, что придёт каждый код, и не обещаем, что платформа примет номер. Большинство кодов приходит в течение нескольких минут после отправки платформой. Попросите клиентов проверить номер на своём сервисе, прежде чем полагаться на него.
Полезные видео
Видео сторонних авторов о ценообразовании, Telegram-ботах и проектировании API. В них разбираются общие приёмы, наш сервис они не описывают.
- Markup vs Margin, they are not the same thing! (Brad Flynn): чем наценка отличается от маржи, с расчётами на примерах.
- The 6 Components of a SaaS Pricing Model (Willingness to Pay): метрика, период, скидки и уровень цены в модели ценообразования.
- Aiogram Basics: Build Your First Telegram Bot with Python (Almaz | Coding): основные понятия Telegram-ботов и первый работающий бот на Python.
- Build a Python Telegram Bot that Accepts Stars Payment (2025) (Nikandr Surkov): приём оплаты в Telegram Stars в боте на Python.
- What is API Idempotency and Why Is It Important? (Be A Better Dev): почему повторная покупка не должна списывать деньги дважды и как этого не допускает ключ идемпотентности.
- Polling vs Webhooks | System Design Tradeoffs (SoftwareDude): когда запрашивать новые данные по таймеру, а когда получать их по push-уведомлению.
С чего начать
- Создайте бесплатный аккаунт на странице регистрации.
- Создайте API-ключ в личном кабинете, на вкладке API-ключей.
- Прочитайте документацию API и файл OpenAPI.
- Проверьте актуальные цены на странице цен.
- Купите один номер и проверьте весь сценарий от начала до конца, прежде чем открывать продажи.