Подключите до пяти магазинов Яндекс Маркета по API, создавайте
товары по SKU, управляйте автоматической и ручной выдачей,
остатками, сообщениями и интеграциями в одном кабинете.
Сначала соберите 3 значения: Campaign ID, API-токен и SKU
Это разные данные. Campaign ID определяет магазин, API‑токен даёт сервису доступ к нему, а SKU — это код конкретного товара. Новый магазин создаётся только после проверки одновременно Campaign ID и API‑токена. Пароль от Маркета вводить не нужно.
KeyAutoFlow предназначен для продавцов
цифровых ключей, кодов активации и других
электронных товаров.
Автоматическая выдача
Сервис находит свободный ключ и передаёт его
покупателю через предусмотренный API Маркета.
Контроль остатков
Количество доступного товара считается по
свободным ключам, привязанным к конкретному SKU.
Личный кабинет
В кабинете отображаются товары, ключи, заказы,
статистика продаж и состояние подписки.
История операций
Каждая выдача сохраняется с номером заказа,
SKU, ключом, суммой и временем обработки.
KeyAutoFlow является действующим IT‑партнёром Яндекс Маркета и использует Partner API. Сервис остаётся независимым продуктом и не является подразделением или официальным продуктом Яндекса.
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
Несколько магазинов
В одном аккаунте можно подключить до пяти магазинов.
Данные и настройки каждого магазина изолированы.
Отдельные подключения
У каждого магазина собственные Campaign ID, API‑токен, каталог, товары, заказы, остатки и настройки выдачи.
Обязательная проверка
Пустой магазин создать нельзя. Сервер проверяет Campaign ID, работоспособность токена и доступ токена именно к этому магазину.
Переключение контекста
Перед работой выберите магазин в переключателе. Таблицы товаров, заказов и ручной выдачи показывают данные выбранного магазина.
Стоимость
Каждый дополнительный магазин увеличивает стоимость поддерживаемых тарифов. Новая сумма применяется при следующей оплате и заранее показывается в профиле.
Campaign ID фиксируется после успешного подключения. Изменение Campaign ID и удаление магазина выполняются только через поддержку после проверки владельца. При удалении магазин отключается, а история товаров и заказов сохраняется для восстановления и разбора операций.
09
Ручная выдача и пауза магазина
Заказы можно обрабатывать автоматически либо передавать оператору без предварительной загрузки ключа.
1
Выберите режим
Нажмите на метку «Авто» у товара, чтобы переключить его на ручную выдачу, либо включите общий ручной режим в Профиле для всех товаров и магазинов.
2
Получите заказ
Заказ появится в разделе «Ручная выдача». Автоматический резерв и отправка ключа для него не выполняются.
3
Передайте товар
Купите или подготовьте товар после заказа, укажите выдаваемое значение и завершите операцию из очереди. Не отмечайте заказ выполненным до фактической передачи.
Безлимитный остаток
Для товара в ручном режиме можно включить «∞ Безлимит». KeyAutoFlow будет поддерживать товар доступным на Маркете без локального пула ключей. После выключения остаток передаётся как нулевой.
Пауза магазина
Пауза останавливает обработку новых заказов, сообщений, каталога и остатков выбранного магазина. API‑токен и настройки сохраняются до возобновления.
Ручной режим не означает автоматическое выполнение обязательств перед покупателем. Продавец самостоятельно контролирует срок передачи товара и итоговый статус заказа.
10
Интеграции и сообщения
Дополнительные подключения включаются пользователем и могут быть отключены без передачи пароля от соответствующего сервиса.
Умный чат
Синхронизирует сообщения покупателей, помогает готовить ответы и соблюдает ограничения на автоматическую отправку. Возвраты, споры и неоднозначные запросы передаются оператору или сохраняются как черновики.
Telegram‑бот
Показывает товары и состояние остатков, помогает редактировать товар и отправляет уведомления о продажах и новых сообщениях. Подключение выполняется одноразовым кодом из Профиля.
Яндекс Диск
Используется для загрузки и выбора изображений товаров. Подключается отдельным OAuth‑токеном с правами Яндекс Диск REST API; пароль от Яндекс ID сервису не передаётся.
Автозакупка
При подключении поставщика KeyAutoFlow может проверить наличие, создать и оплатить закупку, получить товар и передать его в заказ с учётом настроенных пользователем лимитов.
Секретные токены вводятся только в защищённых полях KeyAutoFlow. Не отправляйте их поддержке, в Telegram, по email или на скриншотах.
11
Безопасность и данные
Защитите API-доступ и регулярно проверяйте
настройки магазина и остатки ключей.
API-токен
Не публикуйте токен и не передавайте его
посторонним лицам.
Пароль кабинета
Используйте отдельный надёжный пароль и
завершайте сеанс на чужих устройствах.
История заказов
Проверяйте соответствие номера заказа, SKU,
ключа и владельца товара.
Проверка настройки
Перед запуском проверьте Campaign ID, SKU,
тестовый заказ и наличие свободных ключей.
Пароли хранятся как необратимые криптографические хэши. API‑токены, OAuth‑токены и цифровые товары шифруются при хранении. Доступ к магазинам, товарам и заказам проверяется на сервере по владельцу аккаунта; данные одного пользователя не выдаются другому. Подробности приведены в Политике конфиденциальности.
12
Поддержка
Поддержка отвечает не позднее одного рабочего дня.
При обращении укажите ID пользователя, ID магазина,
номер заказа и точное время возникновения ошибки.
Тикет в кабинете
Создайте обращение из авторизованного кабинета: так поддержка сразу увидит ID вашего аккаунта.
Не отправляйте API‑токены, пароли, полные цифровые ключи или данные покупателей. Для диагностики достаточно ID пользователя, внутреннего ID магазина, номера заказа, SKU, времени и текста ошибки.
13
Частые вопросы
Короткие ответы на основные вопросы продавцов.
Проверьте совпадение SKU с offerId, наличие
свободных ключей, настройки API и локальную
историю заказа.
Да, до пяти магазинов на одном аккаунте. У каждого должны быть собственные Campaign ID и API‑токен с доступом к этому магазину. Товары, заказы и настройки разделены. Дополнительные магазины могут увеличивать стоимость тарифа при следующей оплате.
Для создания обязательны Campaign ID и новый API‑токен. KeyAutoFlow проверяет их совместно и создаёт магазин только тогда, когда токен действительно имеет доступ к указанной кампании.
После подключения Campaign ID блокируется. Изменение идентификатора и удаление магазина выполняются только через тикет в поддержку после проверки владельца. История операций при отключении сохраняется.
В таблице товаров отображается количество
свободных, выданных и всех загруженных ключей.
Нет. Статус DELIVERY / DELIVERY_SERVICE_RECEIVED
означает, что Маркет принял цифровой товар.
Повторная выдача может привести к потере второго ключа.
Проверьте, что Campaign ID состоит только из цифр, токен актуален и имеет права на товары, остатки и заказы, а URL уведомлений указан без изменений. Затем сравните SKU товара в KeyAutoFlow с offerId в Маркете и убедитесь, что в пуле есть свободный ключ.
Да. В Профиле включите «Синхронизацию каталога с Яндекс Маркетом». Сервис добавит отсутствующие SKU сразу и затем будет проверять каталог каждые 5 минут. Ключи к новым товарам загружаются отдельно.
Готовы подключить первый магазин?
Создайте аккаунт, сохраните настройки Яндекс Маркета,
добавьте товар по SKU и загрузите первые цифровые ключи.