API FoxyStars

Получить ключGet a key

1. Откройте @FoxyStarsShopBot и пополните баланс - с него оплачиваются заказы через API. Ключ выдаётся, когда сумма ваших пополнений за всё время достигнет 1000 ₽: деньги остаются на балансе и идут на заказы.Open @FoxyStarsShopBot and top up your balance - API orders are paid from it. The key is issued once your top-ups reach 1000 RUB in total: the money stays on your balance and is spent on orders.
2. В главном меню бота нажмите кнопку API, затем «Получить ключ».In the bot's main menu tap API, then “Get key”.
3. Ключ вида fs_live_… всегда можно скопировать кнопкой «Скопировать ключ» в разделе API в боте. Никому его не передавайте. Если ключ попал к чужим - нажмите «Перевыпустить ключ»: старый перестанет работать сразу.You can always copy the fs_live_… key with the “Copy key” button in the bot's API section. Don't share it. If someone else got it, tap “Reissue key”: the old one stops working immediately.

АвторизацияAuthentication

Передавайте ключ в заголовке каждого запроса:

Send the key in a header of every request:

Authorization: Bearer fs_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Можно и заголовком X-API-Key: fs_live_…. Без ключа или с неверным ключом - ответ 401 unauthorized.The X-API-Key: fs_live_… header works too. No key or a wrong key returns 401 unauthorized.

Быстрый стартQuick start

Четыре запроса - и первый заказ готов:

Four requests to your first order:

# 1. балансbalance
curl https://api.foxystarsshop.com/balance -H "Authorization: Bearer $KEY"

# 2. цена 100 звёздprice for 100 stars
curl "https://api.foxystarsshop.com/price?product=stars&quantity=100" -H "Authorization: Bearer $KEY"

# 3. заказorder
curl -X POST https://api.foxystarsshop.com/orders -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"custom_id":"order-1001","product":"stars","quantity":100,"recipient":"@durov"}'

# 4. статус заказа (опрашивайте раз в 3-5 секунд)order status (poll every 3-5 seconds)
curl https://api.foxystarsshop.com/orders/123 -H "Authorization: Bearer $KEY"

Формат ответаResponse format

Успех - "ok": true и данные в data. Ошибка - "ok": false и объект error с машинным кодом и понятным описанием.

Success is "ok": true with the payload in data. An error is "ok": false with an error object holding a machine code and a readable message.

{ "ok": true,  "data": { "balance": "1250.00", "currency": "RUB" } }

{ "ok": false, "error": { "code": "insufficient_balance", "message": "not enough balance, top it up in the bot", "price": "146.00" } }

Заказы и статусыOrders & statuses

Заказ выполняется в фоне: POST /orders сразу отвечает 202 со статусом pending, дальше вы опрашиваете GET /orders/{id}. Обычно заказ выполняется за 10-60 секунд. Уведомлений о готовности (webhook) нет: статус узнавайте запросом, а за многими заказами удобно следить одним запросом GET /orders?ids=1,2,3.

Orders run in the background: POST /orders replies 202 with status pending right away, then you poll GET /orders/{id}. An order usually completes in 10-60 seconds. There are no ready notifications (webhooks): check the status with a request, and track many orders at once with GET /orders?ids=1,2,3.

Сколько реально списано - в полях заказа charged и refunded_amount (у SMM они учитывают и частичный возврат за невыполненную часть, у SMS - возврат за номер, на который не пришла SMS).

How much was actually charged is in the order's charged and refunded_amount fields (for SMM they include a partial refund for the undelivered part, for SMS - the refund for a number that got no SMS).

result.status: "checking" (SMM, розыгрыши, реклама, продление прокси) - заказ мог уже уйти в работу, но подтверждение не дошло: заказ проверяет наша поддержка вручную, деньги списаны. Если заказ не выполнен, поддержка вернёт их на баланс.

result.status: "checking" (SMM, giveaways, ads, proxy renewal) - the order may already be in progress but the confirmation was lost: our support checks it manually, the money is charged. If it was not fulfilled, support returns it to your balance.

custom_id и повторыcustom_id & retries

custom_id - ваш уникальный номер заказа (1-64 символа, например номер заказа на вашем сайте). Он защищает от двойной оплаты:

custom_id is your unique order id (1-64 characters, e.g. the order number on your website). It protects from double charges:

Необязательный max_price - потолок цены: если цена успела вырасти выше него, заказ не создаётся (409 price_changed, в ответе текущая цена).

Optional max_price is a price ceiling: if the price has risen above it, no order is created (409 price_changed, the current price is in the reply).

ТоварыProducts

У звёзд, Premium и TON поля quantity и recipient передаются прямо в теле заказа. У остальных товаров параметры лежат в объекте params, например:

For Stars, Premium and TON the quantity and recipient fields go right in the order body. Other products take their parameters in a params object, for example:

{ "custom_id": "order-2001", "product": "steam", "params": { "login": "gabelogannewell", "amount_usd": "5.00" } }

Цена Steam: GET /price?product=steam&amount_usd=5.00. Логин проверяется до списания: несуществующий аккаунт - 422 invalid_recipient.Steam price: GET /price?product=steam&amount_usd=5.00. The login is checked before charging: an unknown account returns 422 invalid_recipient.

Telegram-получателя можно указать как @durov, durov или t.me/durov. Цены совпадают с ценами бота и меняются вместе с курсом - берите актуальную через GET /price. Другие товары бота появятся в API следующими обновлениями.A Telegram recipient can be @durov, durov or t.me/durov. Prices match the bot and follow the exchange rate - get the current one via GET /price. More of the bot's products will come to the API in later updates.

ЛимитыLimits

ОшибкиErrors

Если заказ уже создан, но не выполнился, причина будет в поле error самого заказа: price_changed, out_of_stock, insufficient_balance, supplier_error, supplier_cancelled, cancelled, upstream_unavailable, interrupted, product_unavailable, forbidden, lot_unavailable, link_busy, proxy_expired, subscription_not_found, internal_error.

If an order was created but not completed, the reason is in the order's own error field: price_changed, out_of_stock, insufficient_balance, supplier_error, supplier_cancelled, cancelled, upstream_unavailable, interrupted, product_unavailable, forbidden, lot_unavailable, link_busy, proxy_expired, subscription_not_found, internal_error.

МетодыEndpoints

GET/balance

Баланс вашего аккаунта в боте.

Your account balance in the bot.

{ "ok": true, "data": { "balance": "1250.00", "currency": "RUB" } }

GET/products

Список товаров и допустимое количество.

Products and allowed quantities.

{ "ok": true, "data": [
  { "product": "stars", "title": "Telegram Stars", "recipient": "Telegram username",
    "quantity": { "min": 50, "max": 25000, "unit": "stars" } },
  { "product": "premium", "title": "Telegram Premium", "recipient": "Telegram username",
    "quantity": { "choices": [3, 6, 12], "unit": "months" } },
  { "product": "ton", "title": "TON top-up", "recipient": "Telegram username",
    "quantity": { "min": 1, "max": 10000, "unit": "TON" } },
  ... steam, giftcard, proxy, proxy_renew, esim, esim_topup, smm, sms, nft_rent, username_rent, number_rent, vpn, cinema, giveaway, ads
] }

GET/price?product=stars&quantity=100

Текущая цена. Параметры: product и параметры товара - те же, что в заказе, только строкой запроса. У звёзд, Premium и TON это quantity (получатель не нужен), у остальных - поля из params, например ?product=steam&amount_usd=5.00, ?product=esim&plan_id=..., ?product=smm&service_id=...&quantity=1000, ?product=proxy_renew&order_id=...&period=30.

Current price. Parameters: product plus the product's parameters - the same as in the order, just as a query string. For Stars, Premium and TON it is quantity (no recipient needed); for other products - the params fields, e.g. ?product=steam&amount_usd=5.00, ?product=esim&plan_id=..., ?product=smm&service_id=...&quantity=1000, ?product=proxy_renew&order_id=...&period=30.

{ "ok": true, "data": { "product": "stars", "quantity": 100, "unit_price": "1.46", "price": "146.00", "currency": "RUB" } }

Пополнения игр и сервисовGame and service top-ups

Все пополнения, кроме Steam, - это товар giftcard: в params передаётся brand из таблицы и service_id номинала из GET /catalog. Покупатель получает код в result.codes и активирует его сам. Steam - отдельный товар steam: деньги зачисляются прямо на аккаунт по логину.

All top-ups except Steam are the giftcard product: pass the brand from the table and the item's service_id from GET /catalog in params. The buyer gets a code in result.codes and redeems it. Steam is a separate steam product: money is credited straight to the account by login.

Страны и номиналы у каждого сервиса свои и зависят от наличия - смотрите GET /catalog?product=giftcard&brand=.... Если номинал раскупили, он пропадает из каталога и появляется снова после завоза.Countries and denominations differ per service and depend on stock - see GET /catalog?product=giftcard&brand=.... Sold-out items disappear from the catalog and come back after restock.

GET/catalog?product=giftcard

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

What exactly can be bought for products with options: first the list of brands, then a brand's items with prices. Only items in stock are listed.

{ "ok": true, "data": { "product": "giftcard", "brands": [
  { "brand": "xbox", "title": "Xbox" }, { "brand": "roblox", "title": "Roblox" }, ...
] } }

{ "ok": true, "data": { "product": "giftcard", "brand": "roblox", "currency": "RUB", "items": [
  { "service_id": 2618, "country": "GLOBAL", "nominal": "50 R$", "price": "89.81" }, ...
] } }

Заказ карты и её цена:

Ordering a card and checking its price:

POST /orders
{ "custom_id": "order-3001", "product": "giftcard", "params": { "brand": "roblox", "service_id": 2618 }, "max_price": "95.00" }

GET /price?product=giftcard&brand=roblox&service_id=2618

Готовый заказ:

A completed order:

"result": { "brand": "roblox", "service_id": 2618, "nominal": "50 R$", "country": "GLOBAL",
            "codes": ["XXXX-XXXX-XXXX"] }

Цены в каталоге обновляются раз в полчаса, при заказе цена считается заново (используйте max_price). Изредка код приходит с задержкой: тогда заказ уже completed, в result будет "codes": [] и "pending": true - запросите заказ ещё раз через минуту, код появится.Catalog prices refresh every 30 minutes; the price is recalculated when you order (use max_price). Rarely the code arrives with a delay: the order is already completed and result has "codes": [] and "pending": true - fetch the order again in a minute and the code will be there.

GET/catalog?product=proxy

Без version - версии и допустимые сроки, с version - страны, где они есть.

Without version: versions and allowed periods; with version: available countries.

{ "ok": true, "data": { "product": "proxy", "versions": [
  { "version": "ipv4", "title": "Dedicated IPv4", "periods": [7, 14, 30, 60, 90] },
  { "version": "ipv4_shared", "title": "Shared IPv4", "periods": [7, 14, 30, 60, 90] },
  { "version": "ipv6", "title": "IPv6", "periods": [3, 7, 14, 30, 60, 90] }
], "count": { "min": 1, "max": 10 } } }

{ "ok": true, "data": { "product": "proxy", "version": "ipv6", "countries": ["de", "nl", "ru", "us", ...] } }

Заказ, цена и готовый результат:

Order, price and the completed result:

POST /orders
{ "custom_id": "order-4001", "product": "proxy",
  "params": { "version": "ipv4", "country": "de", "period": 30, "count": 2 } }

GET /price?product=proxy&version=ipv4&period=30&count=2

"result": { "version": "ipv4", "country": "de", "period": 30, "count": 2,
  "protocols": ["http", "https", "socks5"],
  "proxies": [ { "id": "10000001", "host": "203.0.113.10", "ip": "203.0.113.10", "port": 8000,
                 "user": "aB3dE", "pass": "fG7hJ", "expires_at": "2026-10-29T10:00:00Z" }, ... ] }

Если выдано меньше прокси, чем заказано, списывается только за выданные - price заказа уменьшится, разница вернётся на баланс. Купленные прокси видны в боте в разделе «Мои прокси» - там же их можно продлить.If fewer proxies are delivered than ordered, you pay only for those delivered: the order's price goes down and the difference returns to your balance. Purchased proxies also appear in the bot under "My proxies", where they can be renewed.

GET/catalog?product=esim

Без country - коды стран, где есть тарифы. С country=TR - тарифы страны, с country=REGIONAL - тарифы на несколько стран (в поле region).

Without country: country codes with plans. With country=TR: that country's plans; with country=REGIONAL: multi-country plans (see region).

{ "ok": true, "data": { "product": "esim", "country": "TR", "currency": "RUB", "plans": [
  { "plan_id": "529faa9f-4ea7-49f1-abde-ca4d46352092", "country": "TR", "region": "",
    "data_gb": 0.5, "is_unlimited": false, "validity_days": 7, "price": "63.00" }, ...
] } }

POST /orders
{ "custom_id": "order-5001", "product": "esim", "params": { "plan_id": "529faa9f-4ea7-49f1-abde-ca4d46352092" } }

"result": { "plan_id": "529faa9f-...", "country": "TR", "data_gb": 0.5, "validity_days": 7,
            "iccid": "8997250000000000000", "lpa": "LPA:1$rsp-eu.example.com$ACTIVATION-CODE" }

Строку lpa закодируйте в QR-код - телефон установит eSIM, отсканировав его. Её же можно ввести вручную. Срок действия начинается при первом подключении к сети в стране тарифа.Encode the lpa string as a QR code: the phone installs the eSIM by scanning it. It can also be entered manually. Validity starts on first connection in the plan's country.

GET/catalog?product=smm

Три уровня: площадки → &platform=telegram типы услуг → &platform=telegram&type=views услуги. Цена услуги указана за price_per штук (обычно 1000).

Three levels: platforms → &platform=telegram service types → &platform=telegram&type=views services. A service's price is per price_per units (usually 1000).

{ "ok": true, "data": { "product": "smm", "currency": "RUB", "services": [
  { "service_id": 458, "name": "Быстрые подписчики", "price": "8.00", "price_per": 1000,
    "min": 10, "max": 40000, "guarantee_days": 0, "cancel": true, "input": null, "link": "url" }, ...
] } }

link: "url" - нужна полная ссылка с https://, "text" - @username или ключевое слово. Если input не null, передайте это поле в params: comments - список комментариев (тогда quantity не нужен: это число комментариев), keywords, username или poll_answer - номер варианта ответа. cancel: true - заказ этой услуги можно отменить, пока он не выполнен (см. «Отмена SMM» ниже). Для GET /price эти поля не нужны: у услуг с комментариями передайте quantity = число комментариев.

link: "url" means a full https:// link, "text" means @username or a keyword. If input is not null, pass that field in params: comments as a list of comments (then quantity is not needed: it equals the number of comments), keywords, username or poll_answer as the answer number. cancel: true means an order of this service can be canceled while it is not done yet (see "SMM cancel" below). GET /price does not need these fields: for comment services pass quantity = the number of comments.

POST /orders
{ "custom_id": "order-6001", "product": "smm",
  "params": { "service_id": 458, "link": "https://t.me/your_channel", "quantity": 1000 } }

"result": { "service_id": 458, "link": "https://t.me/your_channel", "quantity": 1000,
            "status": "in_progress", "remains": 400, "refunded": "0.00",
            "cancel_requested": false }

SMM-заказ выполняется от нескольких минут до суток. Статус заказа API станет completed, как только услугу приняли в работу, а ход выполнения смотрите в result.status: pending → in_progress → completed, либо partial (выполнено частично) / canceled. За невыполненную часть деньги сами возвращаются на баланс - сумма в result.refunded. checking - заказ проверяется вручную, при отмене деньги вернутся. Пока заказ на ссылку не завершён, второй на ту же ссылку и услугу не принимается (409 link_busy). Заказ, который ещё не выполнен, можно отменить - см. «Отмена SMM».

An SMM order takes from a few minutes to a day. The API order becomes completed as soon as the service accepts it; follow progress in result.status: pending → in_progress → completed, or partial (partially done) / canceled. Money for the undelivered part returns to your balance automatically, see result.refunded. checking means the order is being verified manually; if it's canceled, the money comes back. While an order for a link is running, a second one for the same link and service is rejected (409 link_busy). An order that is not done yet can be canceled - see "SMM cancel".

GET/catalog?product=sms

Номер для приёма SMS. Без service - список сервисов (популярные сверху, поиск &q=), с &service=tg - страны, где есть номера: цена и остаток.

A number to receive an SMS. Without service - the list of services (popular first, search with &q=); with &service=tg - countries with numbers, price and stock.

{ "ok": true, "data": { "product": "sms", "service": "tg", "name": "Telegram", "currency": "RUB",
  "code_wait_minutes": 20, "countries": [ { "country": 6, "name": "Indonesia", "iso": "id", "price": "36.00", "count": 29920 }, ... ] } }

{ "custom_id": "sms-1", "product": "sms", "params": { "service": "tg", "country": 6 } }

Заказ станет completed, как только номер выдан. Дальше следите за result.status: waiting - ждём SMS, received - код в result.code (все коды - result.codes), finished - завершён, cancelled - отменён, деньги вернулись (result.refunded).

The order becomes completed once the number is issued. Then follow result.status: waiting - waiting for an SMS, received - the code is in result.code (all codes in result.codes), finished - done, cancelled - cancelled and refunded (result.refunded).

{ "number": "6281200000123", "service": "tg", "country": 6, "status": "received",
  "code": "Telegram code 12345", "codes": ["Telegram code 12345"], "expires_at": "2026-09-29T12:20:00Z", "refunded": "0.00" }

GET/catalog?product=nft_rent

Лоты в аренду. У nft_rent сначала список коллекций, потом &collection=Voodoo%20Dolls - лоты коллекции. У username_rent и number_rent лоты сразу, есть поиск &q=. Везде есть &limit= (до 500) и &offset=.

Lots for rent. For nft_rent, first the list of collections, then &collection=Voodoo%20Dolls for its lots. username_rent and number_rent list lots directly, with &q= search. All support &limit= (up to 500) and &offset=.

{ "ok": true, "data": { "product": "username_rent", "currency": "RUB", "fee": "8.29", "total": 100,
  "items": [ { "address": "EQClfmNWMmseqPzyYIgkvZgqPSj3gr0XWctbqxodOEY2F7Sl", "name": "@aibisai",
               "price_per_day": "1.51", "min_days": 1, "max_days": 180 } ] } }

Стоимость аренды = days × price_per_day + fee (разовый сбор сети), с округлением вверх. Точную сумму даёт GET /price?product=username_rent&address=...&days=1. Цену лота назначает его владелец и может поменять - используйте max_price.

Rental cost = days × price_per_day + fee (a one-time network fee), rounded up. The exact total comes from GET /price?product=username_rent&address=...&days=1. The lot owner sets and may change the price - use max_price.

POST /orders
{ "custom_id": "order-7001", "product": "username_rent",
  "params": { "address": "EQClfmNWMmseqPzyYIgkvZgqPSj3gr0XWctbqxodOEY2F7Sl", "days": 7 } }

"result": { "address": "EQClfm...", "name": "@aibisai", "days": 7, "extend": false,
            "rented_until": "2026-10-06T05:48:45Z" }

POST/orders/{order_id}/bind

Для nft_rent и username_rent: привязать арендованный лот к аккаунту Fragment покупателя. Передайте ссылку TON Connect из Fragment (начинается с tc://). Работает, пока аренда действует.

For nft_rent and username_rent: bind the rented lot to the buyer's Fragment account. Pass the TON Connect link from Fragment (starts with tc://). Works while the rental is active.

POST /orders/8/bind
{ "link": "tc://?v=2&id=..." }

{ "ok": true, "data": { "order_id": 8, "address": "EQClfm...", "bound": true } }

POST/orders/{order_id}/login-code

Для number_rent: код входа в Telegram по арендованному номеру. Сначала начните вход в Telegram с этим номером, потом запросите код. Пока вход не начат - 409 login_not_started.

For number_rent: the Telegram login code for the rented number. Start logging in to Telegram with the number first, then request the code. Until then you get 409 login_not_started.

{ "ok": true, "data": { "order_id": 9, "address": "EQBNcg...", "code": "12345" } }

Продление: новый заказ с тем же address и extend: true - дни добавятся к текущему сроку. Продлить можно только свою действующую аренду и только если владелец лота это разрешает.Extending: a new order with the same address and extend: true - days are added to the current term. Only your own active rental can be extended, and only if the lot owner allows it.

GET/catalog?product=vpn

Тарифы VPN. Каждый заказ - отдельная подписка со своей ссылкой: отдайте её клиенту, по ней он подключит устройства (число устройств - в devices).

VPN plans. Each order is a separate subscription with its own link: give it to your customer to connect their devices (device limit in devices).

{ "ok": true, "data": { "product": "vpn", "currency": "RUB", "plans": [
  { "plan": "1m", "title": "1 month", "days": 30, "devices": 5, "price": "150.00" }, ...
] } }

POST /orders
{ "custom_id": "order-8001", "product": "vpn", "params": { "plan": "1m" } }

"result": { "plan": "1m", "days": 30, "devices": 5, "subscription_order_id": 9,
            "subscription_url": "https://vpnbest.net/v17h...", "expires_at": "2026-10-29T05:53:21Z" }

Продление: новый заказ с "subscription_order_id": 9 (номер заказа, которым подписка была куплена) - дни добавятся к той же подписке, ссылка не меняется. В expires_at заказа всегда актуальный срок.

Extending: a new order with "subscription_order_id": 9 (the order that bought the subscription) - days are added to the same subscription and the link stays the same. The order's expires_at always shows the current term.

GET/catalog?product=cinema

Сервисы и сроки с ценами. Заказ выполняется сразу, данные для входа - в result.credentials (логин:пароль).

Services and terms with prices. The order completes immediately; login data is in result.credentials (login:password).

POST /orders
{ "custom_id": "order-9001", "product": "cinema", "params": { "service": "netflix", "months": 1 } }

"result": { "service": "netflix", "months": 1, "credentials": "login:password",
            "expires_at": "2026-10-29T06:00:00Z", "expired": false }

Аккаунт общий: менять его данные нельзя. Если данные аккаунта сменятся, в заказе сразу будут новые - запрашивайте заказ, когда клиенту нужно войти. После окончания срока credentials становится null.

The account is shared: its login data must not be changed. If the account data changes, the order shows the new data right away - fetch the order when your customer needs to log in. After the term ends, credentials becomes null.

GET/catalog?product=giveaway

Розыгрыш оформляется в канале с публичным @username. У звёзд stars - это общий банк на всех победителей (у каждого не меньше 100 звёзд), допустимые банки зависят от числа победителей: GET /catalog?product=giveaway&winners=5. У Premium months - срок подписки каждому победителю. Цена зависит от канала, приза и числа победителей - смотрите GET /price.

The giveaway is set up in a channel with a public @username. For Stars, stars is one prize pool shared by all winners (at least 100 stars each); allowed pools depend on the number of winners: GET /catalog?product=giveaway&winners=5. For Premium, months is the subscription each winner gets. The price depends on the channel, prize and winners - use GET /price.

GET /price?product=giveaway&kind=stars&channel=your_channel&winners=5&stars=1000

POST /orders
{ "custom_id": "order-10001", "product": "giveaway",
  "params": { "kind": "stars", "channel": "@your_channel", "winners": 5, "stars": 1000 } }

"result": { "kind": "stars", "channel": "your_channel", "winners": 5, "stars": 1000, "status": "completed" }

После оплаты розыгрыш появится в канале: Настройки канала → Статистика → Голоса → «Предоплаченные розыгрыши», там задаются условия и срок. result.status: "checking" - оплата проверяется вручную, при неудаче деньги вернутся.

After payment the giveaway appears in the channel: Channel settings → Statistics → Boosts → "Prepaid giveaways", where you set its terms and end date. result.status: "checking" means the payment is being verified manually; if it failed, the money comes back.

POST/orders ads

Пополнение Telegram Ads: в кабинете ads.telegram.org нажмите «Add funds» - откроется Fragment, скопируйте оттуда ссылку на оплату. Деньги появляются в кабинете в течение нескольких минут.

Telegram Ads top-up: in ads.telegram.org tap "Add funds" - Fragment opens; copy the payment link from there. Funds appear in the ads account within a few minutes.

{ "custom_id": "order-11001", "product": "ads",
  "params": { "link": "https://fragment.com/ads/pay?account=XN-9In...", "ton": 20 } }

После покупки: продления и пополненияAfter purchase: renewals and top-ups

POST /orders
{ "custom_id": "renew-1", "product": "proxy_renew", "params": { "order_id": 6, "period": 30 } }

GET /catalog?product=esim_topup&order_id=7
POST /orders
{ "custom_id": "topup-1", "product": "esim_topup", "params": { "order_id": 7, "package_id": "tp_..." } }

POST/orders

Создать заказ. Получатель и цена проверяются сразу - до списания денег.

Create an order. The recipient and price are checked right away - before any money is charged.

{ "custom_id": "order-1001", "product": "stars", "quantity": 100, "recipient": "@durov", "max_price": "150.00" }

{ "ok": true, "data": {
  "order_id": 123, "custom_id": "order-1001", "product": "stars", "quantity": 100,
  "recipient": "durov", "params": { "quantity": 100, "recipient": "durov" },
  "price": "146.00", "currency": "RUB", "status": "pending",
  "refunded": false, "charged": "0.00", "refunded_amount": "0.00",
  "error": null, "result": null, "receipt": null,
  "created_at": "2026-09-29T10:00:00Z", "updated_at": "2026-09-29T10:00:00Z" } }

Повтор с тем же custom_id отвечает 200 и "idempotent_replay": true.A retry with the same custom_id replies 200 and "idempotent_replay": true.

GET/orders/{order_id}

Заказ по номеру. Ответ - тот же объект заказа, что выше. В result у выполненного заказа - то, что получил покупатель (для Steam - login, amount_usd и credited: done или in_progress, если зачисление ещё идёт). Готовый заказ выглядит так:

An order by its id. Returns the same order object. For a completed order, result holds what the buyer received (for Steam: login, amount_usd and credited: done, or in_progress while crediting is still running). A finished order looks like this:

{ "ok": true, "data": { "order_id": 123, "status": "completed", "refunded": false, "error": null, "receipt": "37004512", ... } }

Поля заказа:

Order fields:

GET/orders

Ваши заказы, новые первыми. Параметры: limit (1-100, по умолчанию 20), offset, фильтры status (pending, processing, completed, failed) и product. С параметром custom_id вернёт один заказ по вашему номеру.

Your orders, newest first. Parameters: limit (1-100, default 20), offset, filters status (pending, processing, completed, failed) and product. With custom_id it returns a single order by your id.

Статус многих заказов одним запросом: ids - до 100 номеров через запятую. Ответ - список в том же порядке; неизвестный номер придёт с error.code: "not_found". Так удобно следить за пачкой SMM-заказов, не тратя лимит запросов.

Status of many orders in one request: ids - up to 100 ids, comma-separated. The reply is a list in the same order; an unknown id comes back with error.code: "not_found". Handy for tracking a batch of SMM orders without spending the request limit.

curl "https://api.foxystarsshop.com/orders?ids=123,124,125" -H "Authorization: Bearer $KEY"

curl "https://api.foxystarsshop.com/orders?custom_id=order-1001" -H "Authorization: Bearer $KEY"

Примеры кодаCode examples

Заказ с ожиданием результата:

Create an order and wait for the result:

import time, uuid, requests

API = "https://api.foxystarsshop.com"
H = {"Authorization": "Bearer fs_live_..."}

order = requests.post(f"{API}/orders", headers=H, timeout=60, json={
    "custom_id": str(uuid.uuid4()),   # your order number
    "product": "stars", "quantity": 100, "recipient": "@durov",
}).json()
if not order["ok"]:
    raise SystemExit(order["error"])

oid = order["data"]["order_id"]
while True:
    o = requests.get(f"{API}/orders/{oid}", headers=H, timeout=30).json()["data"]
    if o["status"] in ("completed", "failed"):
        break
    time.sleep(4)
print(o["status"], o["error"])

const API = "https://api.foxystarsshop.com";
const H = { Authorization: "Bearer fs_live_...", "Content-Type": "application/json" };

const r = await fetch(`${API}/orders`, { method: "POST", headers: H, body: JSON.stringify({
  custom_id: crypto.randomUUID(), product: "premium", quantity: 3, recipient: "@durov",
}) }).then(r => r.json());
if (!r.ok) throw new Error(r.error.code);

let o;
do {
  await new Promise(s => setTimeout(s, 4000));
  o = (await fetch(`${API}/orders/${r.data.order_id}`, { headers: H }).then(r => r.json())).data;
} while (o.status === "pending" || o.status === "processing");
console.log(o.status, o.error);

<?php
$api = "https://api.foxystarsshop.com";
$h = ["Authorization: Bearer fs_live_...", "Content-Type: application/json"];

function call($m, $url, $h, $body = null) {
    $c = curl_init($url);
    curl_setopt_array($c, [CURLOPT_CUSTOMREQUEST => $m, CURLOPT_HTTPHEADER => $h,
        CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60]);
    if ($body) curl_setopt($c, CURLOPT_POSTFIELDS, json_encode($body));
    return json_decode(curl_exec($c), true);
}

$r = call("POST", "$api/orders", $h, ["custom_id" => "shop-" . time(),
    "product" => "ton", "quantity" => 5, "recipient" => "@durov"]);
if (!$r["ok"]) die($r["error"]["code"]);
do { sleep(4); $o = call("GET", "$api/orders/" . $r["data"]["order_id"], $h)["data"]; }
while (in_array($o["status"], ["pending", "processing"]));
echo $o["status"];

БезопасностьSecurity

Все запросы - только по HTTPS. Вы покупаете у нас по ценам бота и сами назначаете цену своим клиентам.

All requests go over HTTPS only. You buy from us at the bot's prices and set your own prices for your customers.