Birgen Store / FunPay Cardinal

От архива до первой выдачи.

Свяжите свои лоты FunPay с товарами Birgen Store и управляйте автовыдачей из Cardinal.

Настройте Cardinal по шагам. Не выключайте тестовый режим, пока не проверили баланс, товар, лот и цену.

01 / 08

Подготовьте Cardinal

Проверьте, что Cardinal работает, его Telegram-бот отвечает, а связь с FunPay стабильна. У лотов, которые привяжете к Birgen, отключите другую автовыдачу, чтобы покупатель не получил два разных сообщения.

02 / 08

Создайте доступ к API магазина

В боте Birgen Store откройте Профиль → Мой API и создайте ключ. Сохраните ключ и секрет при выдаче, затем пополните баланс магазина, с которого будут идти закупки. Открыть бота ↗

03 / 08

Установите три файла

Скачайте архив плагина. Поместите birgen_supplier.py, birgen_order_guard.py и supplier_margin_lock.py в plugins/ Cardinal. Перед заменой одноимённых файлов и базы storage/cache/birgen_supplier.sqlite3 сохраните копии. Перезапускайте Cardinal после завершения текущих покупок и выдач.

04 / 08

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

В Telegram-боте Cardinal откройте /birgen → ⚙️ Настройки → 🔐 Настроить API-ключи. Отправьте ключ, затем секрет отдельными сообщениями. Плагин удаляет их после получения. Снова откройте /birgen: API должен быть настроен, баланс — доступен.

05 / 08

Выберите товар

Сначала нажмите /birgen → 🆕 Обновить товары у поставщика и дождитесь обновления каталога. Затем откройте 📦 Мои товары → ➕ Добавить из каталога поставщика. Найдите товар по названию или через «Добавить по ID API». Проверьте Birgen ID, цену, остаток и вариант. Новый товар сначала выключен.

06 / 08

Привяжите лот FunPay

В карточке товара откройте 🔗 Привязанные лоты / отвязать → ➕ Привязать ID. Введите цифровой ID своего лота из ссылки вида funpay.com/lots/offer?id=123456. Проверьте ID лота и цену продажи. Один лот привязывается к одному товару Birgen.

07 / 08

Настройте цену и проверьте

Для напрямую привязанного лота в ₽ кнопка «Маржа» позволяет задать прибыль в рублях или процент. Проверьте итоговую цену: плагин учитывает комиссию FunPay 6%. При необходимости выберите интервал остатков, включите товар и запустите ⚙️ Настройки → 🧪 Полный тест без покупки. Сначала устраните все найденные проблемы.

08 / 08

Включите выдачу

После проверки баланса, лота, наличия и цены выключите тестовый режим и включите автовыдачу в /birgen. После первого заказа смотрите «Очередь», «Проблемы и ручная обработка» и «Журнал операций».

После запуска

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

Возврат у поставщика возвращает средства на ваш баланс Birgen. Возврат покупателю FunPay в таком случае нужно разбирать отдельно.

Частые вопросы при настройке

Почему товар недоступен?

Обновите каталог и цену/остаток в карточке товара. Проверьте наличие Birgen, баланс, прямую привязку лота и включение товара. Если остаток неизвестен, плагин может выключить привязанный лот.

Почему тестовый заказ ничего не покупает?

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

Что делать при неизвестном результате выдачи?

Откройте очередь, список проблем и журнал операций. Не запускайте вторую закупку, пока не проверили исходный заказ у поставщика.