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

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

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

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

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

PlayHouse VIP предназначен для продавцов цифровых ключей, кодов активации и других электронных товаров.

Автоматическая выдача

Сервис находит свободный ключ и передаёт его покупателю через предусмотренный API Маркета.

Контроль остатков

Количество доступного товара считается по свободным ключам, привязанным к конкретному SKU.

Личный кабинет

В кабинете отображаются товары, ключи, заказы, статистика продаж и состояние подписки.

История операций

Каждая выдача сохраняется с номером заказа, SKU, ключом, суммой и временем обработки.

02

Как работает выдача

Обработка проходит от уведомления Маркета до фиксации заказа в локальной истории.

1
Маркет создаёт заказ

Сервис получает событие об оплаченном заказе в статусе PROCESSING.

2
Определяется товар

По offerId система находит товар с совпадающим SKU у владельца магазина.

3
Резервируется свободный ключ

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

4
Код передаётся Маркету

Маркет принимает цифровой товар и доставляет его покупателю по своему сценарию.

5
Создаётся локальная запись

Заказ появляется в истории, а ключ отмечается как выданный и закрепляется за заказом.

03

Подключение магазина

Для интеграции понадобятся аккаунт PlayHouse VIP, Campaign ID и API-токен Яндекс Маркета.

1
Создайте аккаунт

Зарегистрируйтесь и войдите в личный кабинет.

2
Откройте настройки

Укажите название магазина, Campaign ID и API-токен с нужными правами.

3
Сохраните данные

После сохранения сервис сможет получать заказы и работать с остатками.

API-токен после сохранения не отображается полностью. В кабинете показывается только признак наличия токена.
04

Товары и SKU

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

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

Примеры 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

@playhousevip

Сайт

api.playhousevip.ru

10

Частые вопросы

Короткие ответы на основные вопросы продавцов.

Проверьте совпадение SKU с offerId, наличие свободных ключей, настройки API и локальную историю заказа.
Каждый магазин должен иметь собственные корректные настройки, товары и Campaign ID.
В таблице товаров отображается количество свободных, выданных и всех загруженных ключей.
Нет. Статус DELIVERY / DELIVERY_SERVICE_RECEIVED означает, что Маркет принял цифровой товар. Повторная выдача может привести к потере второго ключа.

Готовы подключить первый магазин?

Создайте аккаунт, сохраните настройки Яндекс Маркета, добавьте товар по SKU и загрузите первые цифровые ключи.

Начать бесплатно