← Назад на главную

Руководство по биллингу 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 обращений/месяц
Структура компаний в Vibekassa

Шаг 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
Статус Активен
Выпуск API-ключа

Шаг 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\"}"
      }
    ]
  }'

Итого за день:

Статистика событий Детализация событий

Шаг 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 Событие без тарифной позиции Бесплатное тестовое событие

Резюме

  1. Создайте тарифный план с нужными позициями
  2. Подключите клиента и назначьте ему тариф
  3. Выпустите API-ключ для интеграции
  4. Отправляйте события через API по мере их возникновения
  5. Формируйте счета в конце периода
  6. Отслеживайте статистику использования

Попробовать Vibekassa

Руководство создано для версии Vibekassa Billing 1.0