Оптовые цены и уровни объёма
API продаёт по тем же ценам, что и приложение, за вычетом оптовой скидки: уровня объёма по расходам за 30 дней или фиксированной скидки реселлера.
На этой странице
API для разработчиков продаёт каждый номер по той же цене, что и приложение. Оптовые скидки снижают эту цену по мере роста вашего объёма, и одна и та же скидка действует везде, где вы покупаете: в приложении, на сайте, в Telegram-боте и через API.
Формула
price = ceil( list_price × (100 − discount_percent) / 100 )
price = max( price, minimum_price )
price = min( price, list_price )
list_price — цена номера в приложении. Результат округляется вверх до цента. У некоторых очень дешёвых номеров есть минимальная цена, поэтому их скидка может быть меньше, а цена никогда не превышает цену по прайсу.
Уровни объёма
Скидка зависит от ваших чистых расходов (списания минус возвраты) за последние 30 дней, суммированных по всем каналам. Когда расходы переходят порог уровня, скидка примерно через 5 минут начинает действовать на каждый покупаемый номер, а когда расходы за 30 дней опускаются ниже порога, уровень снижается. Текущие уровни указаны на странице «Опт» на сайте и в GET /dev/v1/me.
Скидка реселлера
Одобренные реселлеры получают фиксированную скидку на каждый номер при любом месячном объёме. Всегда действует бо́льшая из скидки реселлера и уровня объёма. Реселлеры могут помечать каждую покупку параметром customer_ref и получать выписку по дням, клиентам и сервисам через GET /dev/v1/statement. Заявку можно подать на странице «Опт» на сайте, подробности — в документации для разработчиков.
Ваши цены
GET /dev/v1/pricesвозвращает вашу текущую цену каждого предложения с учётом скидки рядом с ценой по прайсу.GET /dev/v1/meпоказывает вашу скидку, её источник, расходы за 30 дней, уровень и сколько осталось до следующего:
curl -s https://smsgrab.com/api/dev/v1/me \
-H "Authorization: Bearer $SMSGRAB_KEY"
{ "pricing": {
"discount_percent": 5, "source": "tier", "program_enabled": true,
"trailing_30d_spend_minor": 31250,
"tier": { "level": 2, "min_spend_minor": 25000, "discount_percent": 5 },
"next_tier": { "level": 3, "min_spend_minor": 100000, "discount_percent": 8,
"remaining_minor": 68750 } } }
Защита цены
Цена фиксируется в момент покупки и сохраняется в активации. Передавайте max_price_minor при каждой покупке: если цена выросла выше этого значения, покупка отклоняется с 409 PRICE_CHANGED, и ничего не списывается.
Возвраты
Покупки через API подчиняются тем же правилам, что и в приложении. Номер без кода или отменённый до первого кода возвращается полностью.
Эта статья была полезной?
Спасибо! Рады, что помогло.