Документация для продавцов

Автоматическая выдача цифровых товаров

Подключите до пяти магазинов Яндекс Маркета по API, создавайте товары по SKU, управляйте автоматической и ручной выдачей, остатками, сообщениями и интеграциями в одном кабинете.

Товары и SKU Точная привязка к offerId Маркета
Пул ключей Свободные и выданные коды отдельно
Безопасная выдача Один заказ получает один ключ
Полный запуск без догадок

Сначала соберите 3 значения: Campaign ID, API-токен и SKU

Это разные данные. Campaign ID определяет магазин, API‑токен даёт сервису доступ к нему, а SKU — это код конкретного товара. Новый магазин создаётся только после проверки одновременно Campaign ID и API‑токена. Пароль от Маркета вводить не нужно.

Открыть инструкцию по шагам
01Создать аккаунт и открыть Профиль
02Скопировать Campaign ID из Маркета
03Создать и сохранить API-токен
04Добавить товар с точным SKU / offerId
05Загрузить ключи и сделать тестовую проверку
01

Назначение сервиса

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

Номер кампании магазина

  1. В кабинете продавца Маркета нажмите значок аккаунта.
  2. Откройте Настройки → API и модули.
  3. Скопируйте значение из блока Campaign ID или из журнала запросов API.

Это только цифры. Business ID вручную в KeyAutoFlow указывать не нужно.

Что вставить в поле API-токен

Новый ключ доступа Маркета

  1. В том же разделе API и модули создайте API-ключ.
  2. Выберите права для работы с товарами, остатками и заказами.
  3. Скопируйте ключ сразу после создания и вставьте его в Профиле KeyAutoFlow.

После сохранения токен не показывается целиком. Не присылайте его в чат, почту или скриншоты.

URL уведомлений

Вставьте в настройках API Маркета

https://keyautoflow.ru/market/notification

Скопируйте адрес из блока «URL API-уведомлений» в Профиле. Он позволяет получать новые заказы без ручного обновления страницы.

Главная страница KeyAutoFlow в браузере с кнопкой Регистрация
1. Начните с главной страницы. Создайте аккаунт, затем откройте «Профиль» в кабинете.
API-токен после сохранения не отображается полностью. В кабинете показывается только признак наличия токена.
04

Товары и SKU

SKU товара в KeyAutoFlow должен полностью совпадать с offerId на Яндекс Маркете.

Даже одно отличие в символе, регистре или дефисе помешает системе сопоставить заказ с товаром.

Где взять SKU В кабинете Маркета откройте каталог или карточку товара и скопируйте код предложения продавца — offerId.
Что не подходит Не используйте ID карточки Маркета, ID кампании, штрихкод или название товара вместо SKU.
Как добавить товар Создайте товар вручную с этим SKU либо включите в Профиле синхронизацию каталога: новые SKU импортируются автоматически.
Автосинхронизация добавляет только отсутствующие товары. Она не меняет уже созданные карточки, их ключи, цены и ручные настройки. После импорта обязательно загрузите ключи в нужный пул.
Примеры SKU: MRKT-KG7754HHG MRKT-TZ4QZ6BP MRKT-RSI5ON4C
Точное совпадение SKU Один товар — один пул ключей Остаток равен свободным ключам
05

Загрузка ключей

Загружайте ключи списком: один цифровой товар должен находиться на одной строке.

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 вашего аккаунта.

Telegram

@keyautoflow

Не отправляйте 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 и загрузите первые цифровые ключи.

Регистрация