Как выдавать покупателям свои лицензионные ключи

Если ваша программа проверяет собственные лицензионные ключи, ключ, созданный маркетплейсом, вам бесполезен: программа его никогда не видела и отклонит. Нужно, чтобы каждая продажа отдавала покупателю один из ваших ключей, тех, что уже знает ваш сервер активации. Именно это делает пул ключей. По замеру 26 сентября 2026 года им пользуются лишь 0,10% активных товаров, а ключами, которые генерирует Getly, ещё 0,11%. То есть почти все продавцы программ здесь до сих пор рассылают ключи руками или не рассылают вовсе.

Ниже разбираем панель в том виде, в каком она есть в кабинете сегодня, что происходит, когда пул пустеет, и что делать с возвратами.

Сначала: какой ключ вам нужен

Товар выдаёт ключи одного вида, никогда оба сразу.

• Свои ключи. Вы создаёте их в своей системе (сервер лицензий, выгрузка из инструмента активации) и вставляете в Getly. Проверяет их ваша программа, как и раньше.
• Ключи Getly. Ключи вида GETLY-XXXXX-XXXXX-XXXXX-XXXXX, которые создаются в момент продажи. Они включаются через API, а не в форме товара, и имеют смысл, только если ваша программа спрашивает у Getly, действителен ли ключ.

Включив свои ключи, вы выключаете для этого товара ключи Getly. Если у программы уже есть система лицензий, вам нужен первый вариант, и дальше речь о нём.

Шаг 1: сначала сохраните товар

Пул принадлежит товару, поэтому товар должен существовать. При создании нового товара шаг Цена показывает вместо панели подсказку: сохраните товар и откройте его снова через раздел товаров в кабинете. При редактировании на шаге Цена появится панель в рамке с заголовком Выдавать мои лицензионные ключи.

Шаг 2: вставьте ключи

1. В поле Добавить ключи - по одному на строку вставьте список. Ключи разделяются переносами строк, пустые строки игнорируются.
2. Под полем сразу видно, сколько ключей будет добавлено, например «120 ключей к добавлению». Если число не совпадает с ожидаемым, скорее всего, ключи в списке разделены запятыми или пробелами, а не переносами.
3. Нажмите Добавить ключи.

Ключи сохраняются сразу, не дожидаясь сохранения товара. Сообщение покажет, сколько добавлено и сколько пропущено. Пропускаются дубликаты (и повторы внутри вставленного списка, и ключи, которые уже есть в пуле), а также ключи длиннее 500 символов. За один раз можно добавить до 5000 ключей, более длинный список придётся разбить на части.

Порядок важен: ключи выдаются в той последовательности, в какой вы их добавили, от старых к новым. Если часть ключей из старой партии и её нужно продать первой, вставьте её первой.

Шаг 3: включите пул и настройте предупреждение

1. Включите переключатель рядом с Выдавать мои лицензионные ключи. Подпись под ним напоминает: изменение вступит в силу после сохранения товара. До этого добавленные ключи лежат в пуле и не выдаются.
2. В поле Написать мне, когда останется столько ключей укажите число от 1 до 1000. Выберите запас, которого хватит, чтобы сделать новую партию: если вы продаёте около десяти в неделю, а новые ключи готовите два дня, 10 будет разумным порогом.
3. Перейдите на последний шаг и нажмите Обновить товар (или Сохранить изменения у черновика).

Три счётчика вверху панели теперь показывают Доступно, Выдано и Ждут покупатели. Список Ваши ключи показывает каждый ключ в скрытом виде, лишь несколько символов с концов, со статусом, а у проданных ключей ещё и с датой выдачи.

Что видит покупатель

После оплаты ключ появляется в библиотеке покупателя рядом со скачиванием и в письме о покупке. На странице товара с ключами покупатель заранее видит, что ключ придёт на почту после покупки, поэтому отдельная доставка ключа никого не удивляет.

Учтите: ключ расходует каждый завершённый заказ, в том числе бесплатные (бесплатный товар, «плати сколько хочешь» за $0, «Бесплатно на этой неделе») и продления доступа на срок. Если вы запускаете бесплатную неделю на товаре с пулом, заложите это в размер пула.

Когда ключи кончились

Пустой пул не останавливает продажи. Это сделано намеренно: покупатель, который хочет товар, должен иметь возможность заплатить в два часа ночи, пока вы спите. Вместо остановки происходит вот что:

• Покупатель платит и получает файлы. В его библиотеке написано, что ключ придёт на почту, как только продавец его добавит.
• Вам приходит письмо о том, что ключи закончились, с числом ожидающих покупателей, и уведомление в кабинете. На панели появляется строка вроде «3 покупателя ждут».
• Когда вы добавите ключи, ожидающие получат их сразу, начиная с самого раннего заказа, каждый письмом. Сообщение после добавления покажет, сколько ожидавших покупателей получили ключ.

Ещё до нуля вы получите письмо о том, что ключей мало, на заданном пороге. Каждое предупреждение приходит один раз на пересечение: после пополнения выше порога следующее снижение снова вас предупредит.

Это важно и из-за правила, которое действует с 26 сентября 2026 года для новых публикаций и правок: платный товар, чья единственная доставка сводится к обещанию прислать что-то позже, отправляется на проверку. Доставка по почте принимается, когда Getly видит, что она автоматизирована, и пул ключей входит в число таких способов.

Удаление ключей и возвраты

Непроданный ключ можно удалить значком корзины рядом с ним, перед удалением появится подтверждение. Ключ, который уже ушёл покупателю, удалить нельзя.

Если по заказу оформлен возврат, ключ остаётся в списке с пометкой Возврат и никому больше не выдаётся. Отключить ключ, который понимает только ваша программа, Getly не может, поэтому это сигнал для вас: найдите ключ в своей системе лицензий и отзовите его там. Окно возврата у каждого магазина не меньше 30 дней, а решение по возврату принимает Getly, так что время от времени проверяйте список на пометку «Возврат».

Из вашей системы: API

Если ключи создаются автоматически, кабинет вам не нужен. GET /api/v1/products/{id}/keys отдаёт пул и счётчики, POST по тому же адресу добавляет ключи, а DELETE /api/v1/products/{id}/keys/{keyId} удаляет непроданный ключ. Скрипт, который пополняет пул, когда тот опускается ниже порога, избавит вас даже от письма о нехватке.

Сделайте сегодня

Откройте один товар-программу, сгенерируйте партию ключей в своей системе, вставьте их в поле Добавить ключи - по одному на строку, включите пул, задайте порог предупреждения и сохраните. Затем сделайте тестовую покупку своего товара: она проходит тот же чекаут, письмо и библиотеку, выдаёт помеченный образец тестового ключа и не расходует ключ из вашего пула.