Виберіть мову

Гуртові ціни та рівні обсягу

API продає за тими самими цінами, що й застосунок, за вирахуванням гуртової знижки: рівня обсягу за витратами за 30 днів або фіксованої знижки реселера.

На цій сторінці
  1. Формула
  2. Рівні обсягу
  3. Знижка реселера
  4. Ваші ціни
  5. Захист ціни
  6. Повернення коштів

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 днів, рівень і скільки лишилося до наступного:
Bash
curl -s https://smsgrab.com/api/dev/v1/me \
  -H "Authorization: Bearer $SMSGRAB_KEY"
JSON
{ "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 підпорядковуються тим самим правилам, що й у застосунку. Номер без коду або скасований до першого коду повертається повністю.

Ця стаття була корисною?

Досі потрібна допомога?

Напишіть нам. Ми відповідаємо на кожне повідомлення, зазвичай протягом кількох годин.

Або напишіть на support@smsgrab.com