Buyer Automation API

Quick Links

Base URL: https://rexoprime.com

Swagger UI: https://rexoprime.com/api/swagger/

OpenAPI JSON: https://rexoprime.com/api/telegram-buyer/openapi.json

If you are new: read this page first, then use Swagger to run real test calls.

API Source Setup

Use this exact base URL in reseller panels:

https://rexoprime.com

A tgb_... key issued by Rexo Prime AI Tool Shop only validates on https://rexoprime.com. Do not send it to any other site.

Browser integrations are supported. CORS is enabled for buyer API routes only.

Endpoints

1) List products

GET /api/telegram-buyer/products

Optional query params: category_id, q

Returns only main-bot products the key owner can buy.

2) Wallet balance

GET /api/telegram-buyer/balance

Returns wallet + totals + effective API profile settings.

3) Purchase

POST /api/telegram-buyer/purchase

JSON body fields:

Per-user policy can also block purchase by daily spend limit, product allowlist, discount/commission profile, or purchase-disabled flag.

Order status

GET /api/telegram-buyer/order/{order_id}

Check an order after purchase. Read delivery_status and stop polling once final is true.

For a failed order, refunded is true when the money went back to your balance, with refund_amount and refunded_at. message carries a short explanation you can show to your staff. A failed order never becomes delivered later, so do not retry it: place a new order if you still need the product.

4) Product overrides (your own naming & pricing)

Customise what your API returns for each main-catalog product — your own name, description, flat price, and bulk (quantity) pricing. Overrides apply everywhere (this API, the bot, the website, and the Mini App).

PUT / POST / PATCH JSON body — all optional; omit a key to leave it unchanged, send "" to clear:

Pricing precedence: your bulk tiers > your flat price > the shop's own pricing (the shop's own bulk tiers apply automatically when you set no override). A price/tier below base is rejected (below_base_price / bulk_below_base); a malformed tier list is rejected (invalid_bulk_tiers). Stock is always live from the catalog.

curl -X PUT "https://rexoprime.com/api/telegram-buyer/products/123/overrides" \
  -H "X-API-Key: tgb_xxxxxxxxx" -H "Content-Type: application/json" \
  -d '{"custom_name":"My Product","custom_bulk_tiers":"1-9 -> 4.50\n10-49 -> 4.00\n50+ -> 3.50"}'

Products Response Fields

Every product includes Rexo Prime AI Tool Shop-native fields and compatibility fields so common reseller panels can read it.

Sample product with tier (bulk) pricing

The promotions array and bulk_tiers_text already reflect your per-product override when you set one (see Per-product overrides above); otherwise they carry the shop's own bulk pricing.

{
  "product_id": 42,
  "name": "Gemini Pro 18 month 5TB",
  "price": 0.60,
  "base_price": 0.60,
  "pricing_mode": "bulk",
  "bulk_tiers_text": "1-9 -> 0.60\n10-49 -> 0.55\n50+ -> 0.50",
  "promotions": [
    { "type": "bulk_price", "minQty": 1,  "maxQty": 9,  "price": 0.60, "label": "1-9 -> 0.60" },
    { "type": "bulk_price", "minQty": 10, "maxQty": 49, "price": 0.55, "label": "10-49 -> 0.55" },
    { "type": "bulk_price", "minQty": 50,               "price": 0.50, "label": "50+ -> 0.50" }
  ],
  "stock": 733,
  "min_purchase_quantity": 0,
  "max_purchase_quantity": 100,
  "delivery_mode": "automatic"
}

Buying 25 units here charges 0.55/unit (the 10-49 tier). You don't have to compute it — send your quantity to /purchase and the response returns the exact unit_price and totals.

JavaScript / Browser Example

CORS is enabled for buyer API routes, so reseller panels can call the API from a browser app.

const BASE = "https://rexoprime.com";
const KEY = "tgb_xxxxxxxxx";

const products = await fetch(`${BASE}/api/telegram-buyer/products?key=${encodeURIComponent(KEY)}`)
  .then(r => r.json());

const purchase = await fetch(`${BASE}/api/telegram-buyer/purchase`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: KEY,
    product_id: products.products[0].product_id,
    quantity: 1,
    client_order_id: "web-order-1001"
  })
}).then(r => r.json());

Response Model

Success:

{
  "success": true,
  "version": "1.2.0",
  "order_id": 1721,
  "product_id": 42,
  "quantity": 1,
  "base_unit_price": 10.0,
  "price_after_commission": 9.5,
  "unit_price": 9.5,
  "commission_percent": 5.0,
  "commission_total": 0.5,
  "discount_percent": 0.0,
  "discount_total": 0.0,
  "new_balance": 120.25
}

Error:

{
  "success": false,
  "message": "Insufficient wallet balance.",
  "status": "insufficient_balance"
}

FAQ

Can reseller/API users increase selling price?

Yes. They can resell externally at any price. Optionally they may send resell_unit_price metadata if admin enabled it for that user. Markup cap is admin-controlled.

Do they need to add balance first?

Yes. Purchases only use wallet balance already in the main bot account.

Can this API access seller-bot products?

No. This API is main bot only.

Why does an external panel say “invalid API key”?

Most common cause: the base URL is wrong. Use https://rexoprime.com, not another provider domain. If the URL is correct, check that the API key is copied exactly and that the user is not paused, banned, IP-blocked, or rate-limited.