Руководство по биллингу AI-сервисов
Пошаговое руководство для B2B-клиентов платформы Vibekassa Billing
Введение
Это руководство демонстрирует, как компания-провайдер AI-сервисов может использовать платформу Vibekassa Billing для учёта и выставления счетов своим клиентам.
Сценарий: Компания SupportGenius LLC предоставляет AI-бота для службы поддержки. Один из её клиентов — интернет-магазин RetailMax Online — использует этого бота для обработки обращений покупателей.
Шаг 1. Структура компаний
В системе создаётся иерархия компаний:
Vibekassa (Оператор платформы)
└── SupportGenius LLC (B2B-провайдер AI-сервисов)
└── RetailMax Online (B2C-клиент, интернет-магазин)
| Компания | Тип | ИНН | Роль |
|---|---|---|---|
| SupportGenius LLC | B2B | 7701234567 | Провайдер AI-бота для поддержки |
| RetailMax Online | B2C | 7703456789 | Интернет-магазин, ~200 обращений/месяц |
Шаг 2. Создание тарифного плана
SupportGenius LLC создаёт тарифный план для своих клиентов.
Тариф: «Стандартный план поддержки»
| Параметр | Значение |
|---|---|
| Название | Стандартный план поддержки |
| Владелец | SupportGenius LLC |
| Период | Ежемесячный |
| Доступен для покупки | Да |
Позиции тарифа
| Позиция | Цена | Описание |
|---|---|---|
ticket_resolved |
25.00 ₽ | Успешно решённое обращение без участия человека |
ticket_escalated |
5.00 ₽ | Обращение, переданное живому оператору |
deepseek/deepseek-chat |
Вход: 0.50 ₽/1M токенов, Выход: 1.00 ₽/1M токенов | Потребление токенов AI-модели |
Шаг 3. Подключение клиента
3.1. Создание компании-клиента
RetailMax Online регистрируется как B2C-клиент компании SupportGenius LLC.
| Поле | Значение |
|---|---|
| Краткое название | RetailMax Online |
| Полное название | ООО «РетейлМакс Онлайн» |
| ИНН | 7703456789 |
| Тип | B2C |
| Родительская компания | SupportGenius LLC |
3.2. Назначение тарифа
Клиенту назначается тариф «Стандартный план поддержки».
3.3. Выпуск API-ключа
Для интеграции AI-бота создаётся API-ключ.
| Поле | Значение |
|---|---|
| Название | RetailMax Production Key |
| Компания | RetailMax Online |
| Статус | Активен |
Шаг 4. Учёт событий биллинга
4.1. Событие: Обращение решено AI-ботом
Когда AI-бот успешно решает проблему клиента без участия человека, система фиксирует событие:
API-запрос от AI-бота:
curl -X POST https://billing.vibekassa.ru/v1/outcomes \
-H "Authorization: Bearer sk-vbk-retailmax-2025" \
-H "Content-Type: application/json" \
-d '{
"events": [
{
"eventName": "ticket_resolved",
"eventNumber": 1,
"additionalData": "{\"ticketId\": \"RM-2025-00142\", \"category\": \"доставка\"}"
}
]
}'
Результат: Событие записано, стоимость 25.00 ₽
4.2. Событие: Обращения переданы оператору
Если AI-бот не смог решить проблему и передал её живому оператору:
API-запрос:
curl -X POST https://billing.vibekassa.ru/v1/outcomes \
-H "Authorization: Bearer sk-vbk-retailmax-2025" \
-H "Content-Type: application/json" \
-d '{
"events": [
{
"eventName": "ticket_escalated",
"eventNumber": 3,
"additionalData": "{\"ticketIds\": [\"RM-2025-00891\", \"RM-2025-00892\", \"RM-2025-00893\"], \"reason\": \"возврат товара\"}"
}
]
}'
Результат: 3 события по 5.00 ₽ = 15.00 ₽
4.3. Пакетная отправка за день
В конце рабочего дня система может отправить сводку всех событий:
API-запрос:
curl -X POST https://billing.vibekassa.ru/v1/outcomes \
-H "Authorization: Bearer sk-vbk-retailmax-2025" \
-H "Content-Type: application/json" \
-d '{
"events": [
{
"eventName": "ticket_resolved",
"eventNumber": 15,
"additionalData": "{\"date\": \"2025-12-17\"}"
},
{
"eventName": "ticket_escalated",
"eventNumber": 3,
"additionalData": "{\"date\": \"2025-12-17\"}"
}
]
}'
Итого за день:
- Решённых обращений: 15 × 25.00 ₽ = 375.00 ₽
- Эскалаций: 3 × 5.00 ₽ = 15.00 ₽
- Всего: 390.00 ₽
Шаг 5. Формирование счёта
В конце месяца SupportGenius LLC формирует счёт для RetailMax Online.
Пример счёта за декабрь 2025
| Тип события | Кол-во | Цена за единицу | Сумма |
|---|---|---|---|
| Решённые обращения | 189 | 25.00 ₽ | 4 725.00 ₽ |
| Эскалации | 21 | 5.00 ₽ | 105.00 ₽ |
| Токены AI | 5.2M | ~0.75 ₽/1M | 3.90 ₽ |
| Итого | 4 833.90 ₽ | ||
| НДС (20%) | 966.78 ₽ | ||
| К оплате | 5 800.68 ₽ |
Типы ценообразования
Система поддерживает три типа ценообразования для событий:
| Тип | Описание | Пример |
|---|---|---|
| TARIFF | Цена берётся из позиции тарифа | ticket_resolved → 25.00 ₽ |
| EXPLICIT | Цена указывается явно в запросе | Разовая услуга 500.00 ₽ |
| ZERO | Событие без тарифной позиции | Бесплатное тестовое событие |
Резюме
- Создайте тарифный план с нужными позициями
- Подключите клиента и назначьте ему тариф
- Выпустите API-ключ для интеграции
- Отправляйте события через API по мере их возникновения
- Формируйте счета в конце периода
- Отслеживайте статистику использования
Руководство создано для версии Vibekassa Billing 1.0