Подключите магазин Яндекс Маркета по API, создайте товары
по SKU, загрузите цифровые ключи и контролируйте каждый
обработанный заказ в одном кабинете и отвечайте покупателям через умный чат.
Сначала соберите 3 значения: Campaign ID, API-токен и SKU
Это разные данные. Campaign ID определяет магазин, API-токен даёт сервису доступ к нему, а SKU — это код конкретного товара. Ни ключи, ни пароль от Маркета сюда не нужны.
KeyAutoFlow предназначен для продавцов
цифровых ключей, кодов активации и других
электронных товаров.
Автоматическая выдача
Сервис находит свободный ключ и передаёт его
покупателю через предусмотренный API Маркета.
Контроль остатков
Количество доступного товара считается по
свободным ключам, привязанным к конкретному SKU.
Личный кабинет
В кабинете отображаются товары, ключи, заказы,
статистика продаж и состояние подписки.
История операций
Каждая выдача сохраняется с номером заказа,
SKU, ключом, суммой и временем обработки.
02
Как работает выдача
Обработка проходит от уведомления Маркета до
фиксации заказа в локальной истории.
1
Маркет создаёт заказ
Сервис получает событие об оплаченном заказе
в статусе PROCESSING.
2
Определяется товар
По offerId система находит товар с
совпадающим SKU у владельца магазина.
3
Резервируется свободный ключ
Из нужного пула атомарно выбирается один
неиспользованный код.
4
Код передаётся Маркету
Маркет принимает цифровой товар и доставляет
его покупателю по своему сценарию.
5
Создаётся локальная запись
Заказ появляется в истории, а ключ отмечается
как выданный и закрепляется за заказом.
03
Подключение магазина
Для интеграции понадобятся аккаунт KeyAutoFlow,
Campaign ID и API-токен Яндекс Маркета.
1
Создайте аккаунт
Зарегистрируйтесь и войдите в личный кабинет.
2
Откройте настройки
Укажите название магазина, Campaign ID и
API-токен с нужными правами.
3
Сохраните данные
После сохранения сервис сможет получать
заказы и работать с остатками.
Что вставить в поле Campaign ID
Номер кампании магазина
В кабинете продавца Маркета нажмите значок аккаунта.
Откройте Настройки → API и модули.
Скопируйте значение из блока Campaign ID или из журнала запросов API.
Это только цифры. Business ID вручную в KeyAutoFlow указывать не нужно.
Что вставить в поле API-токен
Новый ключ доступа Маркета
В том же разделе API и модули создайте API-ключ.
Выберите права для работы с товарами, остатками и заказами.
Скопируйте ключ сразу после создания и вставьте его в Профиле KeyAutoFlow.
После сохранения токен не показывается целиком. Не присылайте его в чат, почту или скриншоты.
URL уведомлений
Вставьте в настройках API Маркета
https://keyautoflow.ru/market/notification
Скопируйте адрес из блока «URL API-уведомлений» в Профиле. Он позволяет получать новые заказы без ручного обновления страницы.
1. Начните с главной страницы. Создайте аккаунт, затем откройте «Профиль» в кабинете.
API-токен после сохранения не отображается полностью.
В кабинете показывается только признак наличия токена.
04
Товары и SKU
SKU товара в KeyAutoFlow должен полностью
совпадать с offerId на Яндекс Маркете.
Даже одно отличие в символе, регистре или дефисе
помешает системе сопоставить заказ с товаром.
Где взять SKUВ кабинете Маркета откройте каталог или карточку товара и скопируйте код предложения продавца — offerId.
Что не подходитНе используйте ID карточки Маркета, ID кампании, штрихкод или название товара вместо SKU.
Как добавить товарСоздайте товар вручную с этим SKU либо включите в Профиле синхронизацию каталога: новые SKU импортируются автоматически.
Автосинхронизация добавляет только отсутствующие товары. Она не меняет уже созданные карточки, их ключи, цены и ручные настройки. После импорта обязательно загрузите ключи в нужный пул.
Загружайте ключи списком: один цифровой товар
должен находиться на одной строке.
Game Name | XXXXX-XXXXX-XXXXX
Game Name | YYYYY-YYYYY-YYYYY
Game Name | ZZZZZ-ZZZZZ-ZZZZZ
После импорта сравните количество добавленных строк
с исходным файлом и проверьте число свободных ключей
у нужного товара.
06
Обработка заказов
Новые оплаченные заказы обрабатываются через
уведомления Маркета и отображаются в истории.
Автоматический режим
Webhook получает событие, находит товар и
запускает выдачу без участия продавца.
Контроль результата
В истории видно номер заказа, SKU, переданный
ключ, сумму и время создания записи.
Заказ со статусом DELIVERY / DELIVERY_SERVICE_RECEIVED
уже принят Маркетом и не должен получать второй ключ.
07
Остатки
Доступный остаток товара определяется по числу
свободных ключей в пуле.
После выдачи код переходит в использованные, поэтому
количество доступных единиц уменьшается автоматически.
Остаток = количество ключей, где used = false
08
Безопасность и данные
Защитите API-доступ и регулярно проверяйте
настройки магазина и остатки ключей.
API-токен
Не публикуйте токен и не передавайте его
посторонним лицам.
Пароль кабинета
Используйте отдельный надёжный пароль и
завершайте сеанс на чужих устройствах.
История заказов
Проверяйте соответствие номера заказа, SKU,
ключа и владельца товара.
Проверка настройки
Перед запуском проверьте Campaign ID, SKU,
тестовый заказ и наличие свободных ключей.
09
Поддержка
При обращении укажите ID пользователя, Campaign ID,
номер заказа и точное время возникновения ошибки.
Telegram
@keyautoflow
Сайт
keyautoflow.ru
10
Частые вопросы
Короткие ответы на основные вопросы продавцов.
Проверьте совпадение SKU с offerId, наличие
свободных ключей, настройки API и локальную
историю заказа.
Каждый магазин должен иметь собственные
корректные настройки, товары и Campaign ID.
В таблице товаров отображается количество
свободных, выданных и всех загруженных ключей.
Нет. Статус DELIVERY / DELIVERY_SERVICE_RECEIVED
означает, что Маркет принял цифровой товар.
Повторная выдача может привести к потере второго ключа.
Проверьте, что Campaign ID состоит только из цифр, токен актуален и имеет права на товары, остатки и заказы, а URL уведомлений указан без изменений. Затем сравните SKU товара в KeyAutoFlow с offerId в Маркете и убедитесь, что в пуле есть свободный ключ.
Да. В Профиле включите «Синхронизацию каталога с Яндекс Маркетом». Сервис добавит отсутствующие SKU сразу и затем будет проверять каталог каждые 5 минут. Ключи к новым товарам загружаются отдельно.
Готовы подключить первый магазин?
Создайте аккаунт, сохраните настройки Яндекс Маркета,
добавьте товар по SKU и загрузите первые цифровые ключи.