Заказы, оплата, отмена и апгрейд через AI

AI-ассистент, подключённый к вашему аккаунту по MCP (https://api.app.blackbox.md/mcp), умеет оформлять заказы, оплачивать их с баланса, отменять их и делать апгрейд серверов. Доступ ему даёт токен, который создаётся на blackbox.md в разделе «Личный кабинет» → «API-токены» (blackbox.md/ru/account/api-tokens). Результат виден в разделах «Личный кабинет» → «Заказы» и «Баланс».

Доступно: владельцу аккаунта blackbox.md — через API-токен с разрешением «Оформлять и изменять заказы от моего имени» (orders:write).

Чтобы видеть серверы, заказы и баланс, ассистенту нужны также разрешения «Читать список и статус моих серверов» и «Читать баланс, счета и заказы». При создании токена они отмечены по умолчанию.

Как защищены ваши деньги

Важно Если в AI-клиенте разрешён автоматический запуск инструментов, клиент ни о чём не спрашивает. Ассистенту предписано запрашивать подтверждение, прежде чем тратить деньги или отменять заказ, но BLACKBOX не может заставить клиент задать этот вопрос. Оставьте ручное подтверждение для create_order, pay_order, cancel_order и resize_server.

О разрешениях: Разрешения токенов (scopes). Как создать токен: API-токены: создание, копирование и отзыв.

Как оформить заказ

1. Попросите ассистента рассчитать заказ и прямо скажите, чтобы он дождался вашего подтверждения.
2. Ассистент смотрит каталог инструментом list_vm_plans и вызывает create_order без подтверждения. Он показывает сумму в MDL. Заказ пока не создаётся.
3. Проверьте тариф, операционную систему, SSH-ключи и сумму.
4. Подтвердите. Ассистент повторяет вызов с теми же данными и confirm=true.
5. Заказ появляется в «Заказах» со статусом «Новый» и номером BBX-…. Приходит обычное письмо «Am primit solicitarea dumneavoastră — BBX-…» (тема всегда на румынском); в строке «Сообщение:» указано Created via MCP (AI agent) on behalf of the customer.

Деньги при этом не списываются. Оплатите заказ через ассистента (следующий раздел) или на сайте кнопкой «Оплатить заказ».

Совет Хорошо работает такой шаблон: «Подготовь предложение на … и дождись моего подтверждения, прежде чем платить». Например:

Подготовь предложение на сервер vm-iops1-m с Ubuntu 24.04 и дождись моего подтверждения, прежде чем оформлять и оплачивать заказ.

Что можно указать в заказе:

Лимит: не больше 20 вызовов create_order в час, включая расчёты без подтверждения.

Как оплатить заказ с баланса

pay_order оплачивает с баланса заказ в статусе «Новый» — созданный ассистентом или оформленный вами на сайте.

1. Убедитесь, что баланса хватает на всю сумму: откройте страницу «Баланс» или спросите ассистента (инструмент get_balance). Если не хватает, пополните баланс на сайте: Пополнение баланса.
2. Попросите ассистента оплатить заказ BBX-…. Он передаёт текущую сумму заказа; если цена изменилась, оплата останавливается с ошибкой price_changed, и ассистент должен показать вам новую сумму.
3. После оплаты:
   • заказ переходит в статус «В работе»;
   • на странице «Баланс» в разделе «История операций» появляется строка «Comandă BBX-…» со знаком минус;
   • в разделе «Счета» появляется счёт BBX-… в статусе «Оплачен», а на почту приходит письмо «Plată confirmată — BBX-…»;
   • тарифы VPS: сервер создаётся автоматически, обычно в течение нескольких минут после подтверждения оплаты, затем приходит письмо «Serverul dvs. este gata — BBX-…»;
   • выделенные серверы: сервер готовит команда вручную; мы свяжемся с вами.

Лимит: 10 вызовов pay_order в минуту. Подробнее: Оплата заказа с баланса.

Если вызов завершился по тайм-ауту

Сразу после оплаты начинается создание сервера, поэтому вызов pay_order может затянуться. Если AI-клиент сообщает о тайм-ауте или ошибке соединения, не просите оплатить ещё раз. Попросите ассистента проверить заказ через list_orders или откройте «Заказы»: статус «В работе» означает, что оплата прошла. Повторная оплата того же заказа в любом случае будет отклонена (not_payable).

Как отменить заказ

Ассистент отменяет заказы в статусах «Новый» и «В работе» по тем же правилам, что и кнопка «Отменить заказ» на сайте: Отмена заказа и возврат средств.

1. Попросите ассистента проверить, что произойдёт при отмене заказа BBX-…. Он вызывает cancel_order без подтверждения и показывает предварительный расчёт:
   • сумму, которая вернётся на баланс, в MDL;
   • применённое правило: полный возврат (full), пропорциональный (prorated) или без возврата (none);
   • будет ли удалён сервер и его IP-адрес.
2. Изучите расчёт. Если хотите продолжить, прямо подтвердите отмену.
3. Ассистент повторяет вызов с confirm=true. Заказ переходит в статус «Отменён», а на почту приходит письмо «Comandă anulată — BBX-…». Если положен возврат, сумма поступает на баланс (строка «Rambursare comandă BBX-…» в «Истории операций»).

Необратимо Если у заказа есть сервер, при подтверждении он сразу удаляется вместе со всеми данными. В отличие от кнопки «Удалить» в панели, отсрочки 24 часа нет, и удаление нельзя остановить.

• Деньги возвращаются только на баланс. Чтобы вернуть их на карту, напишите на support@blackbox.md.
• Пока сервер создаётся, заказ отменить нельзя (provisioning_in_progress). Повторите через несколько минут.
• Лимит: 5 вызовов cancel_order за 5 минут, включая предварительные расчёты.

Как сделать апгрейд сервера

Ассистент переводит сервер на больший тариф того же семейства и оплачивает разницу с баланса — так же, как кнопка «Апгрейд» в панели: Апгрейд сервера: переход на больший тариф.

1. Запросите варианты апгрейда для сервера. Ассистент вызывает get_server_resize_options и показывает более крупные тарифы того же семейства, новую месячную цену и сумму, которая будет списана сейчас (пропорционально дням, оставшимся до конца текущего 30-дневного цикла).
2. Выберите тариф. Ассистент вызывает resize_server без подтверждения и показывает предварительный расчёт: новый тариф, сумму к списанию и ваш баланс. Если баланса не хватает, ошибка insufficient_balance появится уже на этом шаге.
3. Подтвердите. Ассистент повторяет вызов с confirm=true: сумма списывается с баланса (строка «Upgrade server» в истории), а сервер перезагружается на новом тарифе. Простой длится несколько минут; IP-адрес и данные сохраняются.
4. Ассистент узнаёт только о том, что апгрейд запущен. Результат вы увидите в письме «Serverul dvs. a fost actualizat — BBX-…» и в панели: поле «Конфигурация» на карточке сервера покажет новые ресурсы.

• Апгрейд работает только в сторону увеличения: уменьшить сервер или перевести его в другое семейство нельзя.
• Апгрейд доступен для серверов, заказанных с вашего аккаунта на тарифах VPS из каталога (vm-…). Для тарифов «VPS hosting» и старых тарифов, которые больше не продаются, возвращается not_upgradeable_plan, а выделенные серверы через ассистента не увеличиваются: в обоих случаях напишите нам.
• Если апгрейд не удался, сумма автоматически возвращается на баланс (строка «Anulare upgrade server»).
• Лимит: 3 вызова resize_server за 10 минут, включая предварительные расчёты.

Частые ошибки

Если ассистент сообщает, что инфраструктурный сервис временно недоступен, повторите попытку позже. Все коды и лимиты: Лимиты и коды ошибок MCP.

Частые вопросы

Может ли ассистент потратить деньги без моего ведома? Только если у токена есть разрешение «Оформлять и изменять заказы от моего имени», а AI-клиент не спрашивает вашего согласия. Даже тогда он платит только с баланса и только суммы, рассчитанные BLACKBOX: текущую сумму заказа или разницу за апгрейд. Для ассистента, который только читает данные, создайте токен без этого разрешения.

Можно ли оплатить картой заказ, созданный ассистентом? Да. Заказ появляется в «Заказах» со статусом «Новый». Нажмите «Оплатить заказ» и оплатите как обычно.

Может ли ассистент пополнить баланс или оплатить счета, выставленные командой? Нет. Баланс пополняется только на сайте, а инструменты MCP счета не оплачивают. Полный список инструментов: Список инструментов MCP.

Я хочу удалить сервер, но оставить себе время передумать. Как быть? Воспользуйтесь кнопкой «Удалить» в панели: у неё есть отсрочка 24 часа, но деньги при этом не возвращаются. См. Безвозвратное удаление сервера. Через ассистента отмена заказа удаляет сервер сразу.