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

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

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

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

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

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

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

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

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

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

  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

Безопасность и данные

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

Регистрация