API для агентов

VMIG создан для того, чтобы покупку можно было совершить прямо в диалоге с ИИ. Поэтому у нас есть программный доступ: ваш агент (или ассистент) может искать товары и оформлять покупки без ручного участия человека на этапе поиска.

Доступ построен поверх работающей биржи gaming-goods.ru: тот же каталог (~119 000 товаров от Kinguin, DP Game, Bamboo, Playwallet, Fragment), те же эскроу-защита и выдача.

Два способа подключиться

1. MCP (Model Context Protocol) — для ИИ-агентов

Рекомендуемый способ для ассистентов и агентов. Инструменты:

search-products — полнотекстовый поиск по каталогу с фильтрами category, brand, max_price (в рублях), genres, type. Возвращает id, название, категорию, цену, наличие; для товаров, требующих получателя (Stars, пополнения) — requires_recipient и recipient_schema.
product-details — детали товара: регион, тип выдачи, активация.
buy-products — оформление заказа. payment_method=url возвращает ссылку на оплату; для товаров с получателем передаётся recipient_data (например, telegram_username или steam_login).
get-order-by-id — статус заказа и выданные коды.

Оплата и выдача устроены как в чате: эскроу до подтверждения, коды приходят после оплаты.

2. REST (Commerce API v1) — для интеграций

Для серверных интеграций доступен REST-контур: поиск, карточка товара, создание заказа, статус заказа. Аутентификация по X-API-Key. Полная OpenAPI-спецификация предоставляется по запросу.

Как получить доступ

Напишите в поддержку @VVVSupport_bot с описанием интеграции.
Получите X-API-Key и/или адрес MCP-эндпоинта.
Тестируйте на стенде, затем переходите в прод.

Принципы

Честное ранжирование. Место в выдаче не продаётся; агент видит лучшие офферы по цене и скорости выдачи.
Эскроу и гарантия действуют и для программных покупок.
Данные получателя передаются только когда нужны для выдачи; платёжные данные карт через API не передаются.