KronclAPI
Мои приложения
Введение
Публичные методы
Аккаунт
Компания
Базовые действия
Хранилище
Тарификация
GET Текущий план
GET Транзакции
POST Отменить транзакцию
POST Сменить тариф
Участники
Логи
Документы
Поддержка
Персонал (HRM)
Финансы (FM)
Клиенты (CRM)
Склад (WM)
Сделки (DM)
Создать приложение
Документация API платформы. Последняя сборка v1.5.30

Тарификация компании

Методы для управления тарифным планом организации.

# Получение текущего плана

GET
/companies/{id}/pricing

Возвращает текущий тарифный план организации и оставшееся время.

Структура ответа

RESPONSE_DATA:
application/json
is_trialrequired
boolean
Пробный
Активен ли тестовый период
expires_atrequired
string
Истекает
Дата окончания текущего периода (RFC 3339)
days_leftrequired
int
Осталось дней
Количество дней до окончания
days_totalrequired
int
Всего дней
Общая длительность периода
current_planrequired
array
Текущий тариф
Текущий тарифный план (PricingPlan)
next_planoptional
array
Следующий тариф
Следующий тарифный план, если задан (PricingPlan)

Тариф

PRICING_PLAN:
application/json
coderequired
string
Код
Уникальный код тарифа (например: finansist, titan, stoik)
lvlrequired
int
Уровень
Порядковый номер уровня тарифа
price_per_monthrequired
int
Цена в месяц
Стоимость за месяц в рублях
price_per_yearrequired
int
Цена в год
Стоимость за год в рублях
price_currencyrequired
enum
RUB
Валюта
Валюта цены
namerequired
string
Название
Отображаемое название тарифа
descriptionrequired
string
Описание
Краткое описание тарифа
limit_db_mbrequired
int
Лимит БД (МБ)
Максимальный объём базы данных в мегабайтах
limit_objects_mbrequired
int
Лимит файлов (МБ)
Максимальный объём файлового хранилища в мегабайтах
limit_objects_countrequired
int
Лимит файлов (шт.)
Максимальное количество файлов в хранилище
created_atrequired
string
Создан
Дата добавления тарифа (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления тарифа (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Company pricing plan retrieved successfully",
    "data": {
        "is_trial": true,
        "expires_at": "2026-07-14T00:00:00Z",
        "days_left": 30,
        "days_total": 90,
        "current_plan": {
            "code": "stoic",
            "name": "Стоик",
            "lvl": 1,
            "price_per_month": 4800,
            "price_per_year": 51840,
            "price_currency": "RUB",
            "description": "Полный функционал.",
            "limit_db_mb": 300,
            "limit_objects_mb": 700,
            "limit_objects_count": 5000,
            "created_at": "2026-04-24T00:17:05Z",
            "updated_at": "2026-05-24T15:28:33Z"
        }
    },
    "meta": {
        "timestamp": "2026-06-14T00:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../pricing",
        "method": "GET"
    }
}

# Смена тарифа

POST
/companies/{id}/pricing/migrate

Меняет тарифный план организации. Средства за неиспользованный период не возвращаются.

Структура запроса

MIGRATE_REQUEST:
application/json
plan_coderequired
string
Код тарифа
Код нового тарифного плана (financier, titan, stoic)
periodrequired
enum
monthyear
Период
Период оплаты
success_urloptional
string
URL успеха
URL для редиректа после успешной оплаты

Структура ответа

MIGRATE_RESPONSE:
application/json
transactionrequired
array
Транзакция
Созданная транзакция (PricingTransaction)
payment_page_urlrequired
string
Ссылка на оплату
Ссылка на страницу оплаты Т-Банка
payment_idrequired
string
ID платежа
Идентификатор платежа в Т-Банке
PRICING_TRANSACTION:
application/json
idrequired
string
ID
Уникальный идентификатор транзакции
company_idrequired
string
ID компании
Идентификатор организации
account_idrequired
string
ID аккаунта
Идентификатор инициатора
amountoptional
int
Сумма
Сумма в рублях (null для trial)
currencyrequired
enum
RUB
Валюта
Валюта платежа
statusrequired
enum
successpendingunsuccessrevoked
Статус
Статус транзакции
plan_codeoptional
string
Тариф
Код оплаченного тарифа
is_trialrequired
boolean
Пробный
Относится ли к тестовому периоду
next_plan_codeoptional
string
Следующий тариф
Код следующего тарифа (для запланированного перехода)
expires_atrequired
string
Истекает
Дата окончания периода (RFC 3339)
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата обновления (RFC 3339)

Примеры ответов

200
400
{
    "status": true,
    "message": "Payment initiated successfully",
    "data": {
        "transaction": {
            "id": "880e8400-e29b-41d4-a716-446655440070",
            "company_id": "660e8400-e29b-41d4-a716-446655440020",
            "account_id": "550e8400-e29b-41d4-a716-446655440001",
            "amount": 4800,
            "currency": "RUB",
            "status": "pending",
            "plan_code": "stoic",
            "is_trial": false,
            "next_plan_code": null,
            "expires_at": "2026-07-14T00:00:00Z",
            "created_at": "2026-06-14T12:00:00Z",
            "updated_at": "2026-06-14T12:00:00Z"
        },
        "payment_page_url": "https://securepay.tinkoff.ru/pay/xxx",
        "payment_id": "1234567890"
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../pricing/migrate",
        "method": "POST"
    }
}

# Получение транзакций

GET
/companies/{id}/pricing/transactions

Возвращает историю биллинговых транзакций организации.

Структура ответа

RESPONSE_DATA:
application/json
transactionsrequired
array
Транзакции
Список транзакций (PricingTransaction[])
paginationrequired
array
pagination

Транзакция

PRICING_TRANSACTION:
application/json
idrequired
string
ID
Уникальный идентификатор транзакции
company_idrequired
string
ID компании
Идентификатор организации
account_idrequired
string
ID аккаунта
Идентификатор инициатора
amountoptional
int
Сумма
Сумма в рублях (null для trial)
currencyrequired
enum
RUB
Валюта
Валюта платежа
statusrequired
enum
successpendingunsuccessrevoked
Статус
Статус транзакции
plan_codeoptional
string
Тариф
Код оплаченного тарифа
is_trialrequired
boolean
Пробный
Относится ли к тестовому периоду
next_plan_codeoptional
string
Следующий тариф
Код следующего тарифа (для запланированного перехода)
expires_atrequired
string
Истекает
Дата окончания периода (RFC 3339)
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Pricing transactions retrieved successfully",
    "data": {
        "transactions": [
            {
                "id": "880e8400-e29b-41d4-a716-446655440070",
                "company_id": "660e8400-e29b-41d4-a716-446655440020",
                "account_id": "550e8400-e29b-41d4-a716-446655440001",
                "amount": 4800,
                "currency": "RUB",
                "status": "success",
                "plan_code": "stoic",
                "is_trial": false,
                "next_plan_code": null,
                "expires_at": "2026-07-14T00:00:00Z",
                "created_at": "2026-06-14T12:00:00Z",
                "updated_at": "2026-06-14T12:00:00Z"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../pricing/transactions",
        "method": "GET"
    }
}

# Отзыв транзакции

POST
/companies/{id}/pricing/transactions/{transactionId}/revoke

Отменяет биллинговую транзакцию.

Примеры ответов

200
404
{
    "status": true,
    "message": "Transaction revoked successfully",
    "data": {},
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../pricing/transactions/.../revoke",
        "method": "POST"
    }
}