Birgen Store / FunPay Cardinal

From archive to your first delivery.

Connect your FunPay lots to Birgen Store products and manage automatic delivery from Cardinal.

Follow the Cardinal controls step by step. Keep test mode on until the balance, product, lot and price checks pass.

01 / 08

Prepare Cardinal

Make sure Cardinal, its Telegram bot, and the FunPay connection work. For lots linked to Birgen, turn off any other automatic delivery so the buyer does not receive conflicting messages.

02 / 08

Create store API access

In the Birgen Store bot, open Profile → My API and create a key. Save the key and secret when they appear, then top up the store balance used for purchases. Open the bot ↗

03 / 08

Install three files

Download the plugin archive. Put birgen_supplier.py, birgen_order_guard.py, and supplier_margin_lock.py in Cardinal’s plugins/ directory. Back up any files with the same names and storage/cache/birgen_supplier.sqlite3 before replacing them. Restart Cardinal only after in-progress purchases and deliveries finish.

04 / 08

Connect the store

In your Cardinal Telegram bot open /birgen → ⚙️ Настройки → 🔐 Настроить API-ключи. Send the key and then the secret as separate messages. The plugin deletes those messages after receiving them. Open /birgen again and check that the API and balance are available.

05 / 08

Choose a product

First tap /birgen → 🆕 Обновить товары у поставщика and wait for the catalog refresh. Then open 📦 Мои товары → ➕ Добавить из каталога поставщика. Search by name or use «Добавить по ID API». Check the Birgen ID, price, stock, and variant. New products start disabled.

06 / 08

Link your FunPay lot

From the product card open 🔗 Привязанные лоты / отвязать → ➕ Привязать ID. Enter the numeric ID from your own lot URL, such as funpay.com/lots/offer?id=123456. Check the lot ID and sale price. One lot can be bound to one Birgen product.

07 / 08

Set pricing and test

For a directly linked RUB lot, «Маржа» can set a target profit in rubles or a percentage. Verify the resulting price; the plugin accounts for a 6% FunPay fee. Set a stock interval if needed, enable the product, and run ⚙️ Настройки → 🧪 Полный тест без покупки. Resolve any reported issue first.

08 / 08

Start delivery

After checking the balance, lot, stock, and price, turn off test mode and enable automatic delivery in /birgen. Watch «Очередь», «Проблемы и ручная обработка», and «Журнал операций» after your first order.

After launch

If an order needs attention, check the queue and issue list before trying again. An uncertain delivery outcome goes to manual review; do not start a second purchase blindly.

The Cardinal plugin currently uses Russian button labels. The paths above show the exact labels to click. A supplier refund returns funds to your Birgen balance; handle any FunPay buyer refund separately.

Common setup questions

Why is the product unavailable?

Refresh the supplier catalog and product snapshot. Check the Birgen stock, account balance, direct lot binding, and whether the product is enabled. If stock is unknown, the plugin can disable a linked lot.

Why does a test order not buy anything?

Test mode deliberately stops before the Birgen purchase. Run the full check, then switch to working mode only when the lot, price, balance, and stock are correct.

What if delivery has an uncertain outcome?

Open the queue, issues, and operation journal. Do not start a second purchase until you have checked the original supplier order.