Reseller Portal

Telegram Buyer & Reseller API

Use a psk_live_... API key to connect your own Telegram bot or website store to PerkShelf. Automatically list products and fulfill software licenses from your prepaid wallet.

Your Active Buyer API Key

Active • Live Production

Purchases made with this API key debit your current PerkShelf wallet balance.

•Rate limit: 60 requests / minute

Core REST Endpoints

Standard JSON payloads over HTTPS with Bearer token authentication.

GET/api/v1/buyer/products

Returns all active products, your wholesale prices, and live stock counts.

curl -X GET https://perkshelf.dev/api/v1/buyer/products \
  -H "Authorization: Bearer Click 'Generate API Key' to initialize key"

POST/api/v1/buyer/purchase

Debits your prepaid wallet and returns the generated coupon code or activation link instantly.

curl -X POST https://perkshelf.dev/api/v1/buyer/purchase \
  -H "Authorization: Bearer Click 'Generate API Key' to initialize key" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "lovable-dev-pro-1-year-coupon-code",
    "quantity": 1,
    "external_order_id": "cust-order-101"
  }'