Гуртові ціни та рівні обсягу
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 підпорядковуються тим самим правилам, що й у застосунку. Номер без коду або скасований до першого коду повертається повністю.
Ця стаття була корисною?
Дякуємо! Раді, що це допомогло.