API Reference

REST API для цифровых продуктов. Подарочные карты, пополнения, ключи, Steam, Roblox, Telegram — одна интеграция.

Базовый URLhttps://api.fazercards.com/api/v1

АутентификацияX-API-Key

Добавляйте заголовок в каждый запрос. API-ключ идентифицирует ваш аккаунт реселлера и авторизует доступ к продуктам и заказам.

Быстрый старт

Получите API-ключ в панели реселлера (Профиль → API-ключ). Затем выполните первый запрос:

bash

curl -X GET "https://api.fazercards.com/api/v1/me" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ:

json

{
  "id": "res_xxx",
  "email": "your@email.com",
  "subscription": {
    "plan": "bronze",
    "status": "active",
    "expires_at": "2026-04-10T00:00:00Z"
  }
}

Эндпоинты

Каталог

Игры и категории от провайдеров

Каталог объединяет игры от нескольких провайдеров. GET /games — список игр с ID, именем, иконкой и типами. Game ID (pubgm, mlbb, steam и т.д.) используются при выборе продуктов.

Типичный поток: 1) GET /games — список игр, 2) GET /topup/products?game_id=pubgm — продукты игры, 3) POST /orders — создание заказа.

GET/games

Список всех игр для пополнений. Каждая игра имеет id (например pubgm, mlbb), name, icon_url, types.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/games" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "games": [
    {
      "id": "pubgm",
      "name": "PUBG Mobile",
      "icon_url": "https://...",
      "types": ["topup"],
      "is_featured": true
    },
    {
      "id": "steam",
      "name": "Steam",
      "types": ["gift_card", "topup"]
    }
  ]
}

Пополнение

Пополнение по ID игрока (PUBG, Roblox, Free Fire и др.)

Пополнения доставляют игровую валюту (UC, алмазы и т.д.) на аккаунт игрока. Нужен ID игрока и продукт.

GET/checkplayerid

Проверка ID игрока перед заказом. Параметры: game (pubgm, mlbb), user_id, server_id (опц.).

Запрос

curl -X GET "https://api.fazercards.com/api/v1/checkplayerid?game=pubgm&user_id=51234567890" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "valid": "valid",
  "name": "PlayerName",
  "openid": "51234567890"
}

GET/topup/products

Список продуктов для пополнения. Параметр game_id из /games (pubgm, mlbb).

Запрос

curl -X GET "https://api.fazercards.com/api/v1/topup/products?game_id=pubgm" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "products": [
    {
      "id": "pubgm_uc_60",
      "game_id": "pubgm",
      "name": "60 UC",
      "display_name": "60 UC",
      "region": "global",
      "currency": "USD",
      "price": 0.99,
      "min_quantity": 1,
      "max_quantity": 10,
      "fields": [
        {"name": "user_id", "label": "Player ID", "required": true, "type": "text"}
      ]
    }
  ]
}

POST/topup/order

Создание заказа пополнения. Поля: product_id, quantity, game_fields (ID игрока, server_id).

Запрос

curl -X POST "https://api.fazercards.com/api/v1/topup/order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "pubgm_uc_60",
    "quantity": 1,
    "game_fields": {"user_id": "51234567890"}
  }'

Ответ

{
  "id": "ord_abc123",
  "type": "topup",
  "status": "processing",
  "product_id": "pubgm_uc_60",
  "amount_charged": 0.99,
  "currency": "USD",
  "created_at": "2026-03-10T12:00:00Z"
}

Подарочные карты

Покупка подарочных карт (iTunes, Google Play, Steam и др.)

Подарочные карты возвращают коды активации (Steam, Amazon и т.д.). GET /giftcards/products — список, POST /giftcards/order — заказ.

GET/giftcards/products

Список подарочных карт. Фильтр: ?category=steam.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/giftcards/products?category=steam" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "products": [
    {
      "id": "steam_10_usd",
      "name": "Steam $10",
      "display_name": "Steam Wallet $10",
      "face_value": 10,
      "face_currency": "USD",
      "price": 9.50,
      "stock": 100
    }
  ]
}

POST/giftcards/order

Создание заказа подарочной карты. Коды в ответе при completed или через вебхук.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/giftcards/order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "steam_10_usd", "quantity": 2}'

Ответ

{
  "id": "ord_xyz789",
  "type": "gift_card",
  "status": "completed",
  "product_id": "steam_10_usd",
  "amount_charged": 19.00,
  "currency": "USD",
  "payload": {"codes": ["XXXX-YYYY-ZZZZ", "AAAA-BBBB-CCCC"]},
  "created_at": "2026-03-10T12:00:00Z"
}

Ключи игр

Ключи для PC и консолей

Ключи игр — Steam/Xbox/другие ключи. GET /gamekeys — категории, POST /gamekeys/order — заказ.

GET/gamekeys

Список категорий ключей (steamkeys, xboxkeys, otherkeys). Без подарочных карт.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/gamekeys" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "games": [
    {
      "game_id": "doom_eternal_cis_steam_key",
      "name": "DOOM Eternal (CIS) Steam Key",
      "type": "steamkeys"
    }
  ]
}

POST/gamekeys/products

Продукты по game_id из /gamekeys. Для регион-лок ключей сначала проверьте region-restriction.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/gamekeys/products" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id": "doom_eternal_cis_steam_key"}'

Ответ

{
  "products": [
    {
      "product_id": "doom_eternal_cis_steam_key_523",
      "game_id": "doom_eternal_cis_steam_key",
      "name": "DOOM Eternal",
      "display_name": "DOOM Eternal (CIS)",
      "price": 5.43,
      "currency": "USD",
      "in_stock": 10
    }
  ]
}

POST/gamekeys/region-restriction

Проверка регион-лока ключа. Возвращает region_type (CIS, ROW, GLOBAL), доступные страны, ограничения.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/gamekeys/region-restriction" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id": "doom_eternal_cis_steam_key"}'

Ответ

{
  "region_type": "CIS",
  "has_availability": true,
  "available": [
    {"code": "RU", "name": "Russia"},
    {"code": "KZ", "name": "Kazakhstan"}
  ],
  "regional_only": true
}

POST/gamekeys/order

Создание заказа ключа. Ключи в payload.codes при completed или через вебхук.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/gamekeys/order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "doom_eternal_cis_steam_key_523", "quantity": 1}'

Ответ

{
  "id": "ord_key123",
  "type": "game_key",
  "status": "completed",
  "product_id": "doom_eternal_cis_steam_key_523",
  "amount_charged": 5.43,
  "currency": "USD",
  "payload": {"codes": ["XXXXX-YYYYY-ZZZZZ-AAAAA-BBBBB"]},
  "created_at": "2026-03-10T12:00:00Z"
}

Пополнение Steam / Подарки Steam

Пополнение кошелька Steam. Подарочные игры Steam.

POST/steamtopup/check-login

Проверка Steam-логина перед заказом. Параметр: username (логин Steam).

Запрос

curl -X POST "https://api.fazercards.com/api/v1/steamtopup/check-login" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "steam_user"}'

Ответ

{"can_refill": true}

GET/steamtopup/rates

Курсы обмена Steam-кошелька. Фильтр: ?currency=RUB.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/steamtopup/rates" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "rates": [
    {"currency": "USD", "rate": 1.0},
    {"currency": "RUB", "rate": 0.01}
  ]
}

POST/steamtopup/order

Создание пополнения Steam. Параметры: username и amount_usd.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/steamtopup/order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "steam_user", "amount_usd": 10}'

Ответ

{
  "id": "ord_steam123",
  "type": "steam_topup",
  "status": "processing",
  "amount_charged": 10,
  "currency": "USD",
  "created_at": "2026-03-10T12:00:00Z"
}

GET/steamgifts/games

Список подарочных игр Steam. Фильтр: ?limit=50.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/steamgifts/games" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "games": [{"appid": 782330, "name": "DOOM Eternal"}],
  "meta": {"total": 5000, "truncated": false}
}

GET/steamgifts/games/{appid}

Издания/пакеты для Steam-игры. Параметр: appid из /steamgifts/games.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/steamgifts/games/782330" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "game": [
    {"edition": "Standard", "package_id": 12345, "regions_info": [{"region": "RU", "price": 1999}]}
  ]
}

POST/steamgifts/order

Создание заказа подарка Steam. Поля: appid, package_id, region, invite_url (ссылка-приглашение).

Запрос

curl -X POST "https://api.fazercards.com/api/v1/steamgifts/order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appid": 782330, "package_id": 12345, "region": "RU", "invite_url": "https://s.team/p/xxx"}'

Ответ

{
  "id": "ord_gift123",
  "type": "steam_gift",
  "status": "processing",
  "amount_charged": 29.99,
  "currency": "USD",
  "created_at": "2026-03-10T12:00:00Z"
}

Telegram Stars и Premium

GET/telegram/premium

Предложения и цены подписки Telegram Premium.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/telegram/premium" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"items": [...], "note": "..."}

GET/telegram/stars

Предложения Telegram Stars (покупки в ботах).

Запрос

curl -X GET "https://api.fazercards.com/api/v1/telegram/stars" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"items": [...], "note": "..."}

POST/telegram/premium/gift

Подарить Telegram Premium. Параметры: username и months.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/telegram/premium/gift" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "telegram_user", "months": 1}'

Ответ

{"order_id": "ord_tg123", "status": "processing"}

POST/telegram/stars/buy

Покупка Telegram Stars. Параметры: username и amount.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/telegram/stars/buy" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "telegram_user", "amount": 100}'

Ответ

{"order_id": "ord_stars123", "status": "processing"}

Roblox

GamePass-трансфер Robux

GET/roblox/packages/products

Продукты паков Roblox (Robux). Обычная и backup-доставка.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/roblox/packages/products" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "products": [
    {"id": "roblox_pack_80", "name": "80 Robux", "price": 0.99, "is_backup": false}
  ]
}

POST/roblox/packages/buy

Создание заказа пака Roblox. Поля: product_id, login, password. Backup: is_backup=true, backup_codes.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/roblox/packages/buy" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "roblox_pack_80", "login": "roblox_user", "password": "***"}'

Ответ

{
  "id": "ord_roblox123",
  "type": "roblox_packs",
  "status": "processing",
  "product_id": "roblox_pack_80",
  "amount_charged": 0.99,
  "currency": "USD",
  "payload": {"chat_id": "chat_xxx"},
  "created_at": "2026-03-10T12:00:00Z"
}

GET/roblox/packages/chat/{chatId}

Сообщения чата по заказу Roblox. chatId — в payload заказа. Используется для связи с оператором.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/roblox/packages/chat/chat_xxx" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "messages": [
    {"id": "msg_1", "content": "Please provide 2FA code", "sender": "operator", "created_at": "..."}
  ]
}

POST/roblox/packages/chat/{chatId}/send

Отправка сообщения в чат заказа. Ответ оператору (например, 2FA-код).

Запрос

curl -X POST "https://api.fazercards.com/api/v1/roblox/packages/chat/chat_xxx/send" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "123456"}'

Ответ

{"id": "msg_2", "content": "123456", "sender": "user", "created_at": "..."}

Заказы

Управление заказами

docs.api.orderStatusExplain

GET/orders/{orderId}

Детали заказа. При статусе completed коды в payload.codes (или через вебхук).

Запрос

curl -X GET "https://api.fazercards.com/api/v1/orders/ord_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "id": "ord_abc123",
  "type": "gift_card",
  "status": "completed",
  "product_id": "steam_10_usd",
  "amount_charged": 9.50,
  "currency": "USD",
  "payload": {"codes": ["XXXX-YYYY-ZZZZ"]},
  "created_at": "2026-03-10T12:00:00Z",
  "updated_at": "2026-03-10T12:00:15Z"
}

GET/orders

Список заказов. Параметры: status, limit, offset.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/orders?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "orders": [
    {"id": "ord_abc", "type": "gift_card", "status": "completed", "amount_charged": 9.50, ...}
  ]
}

Аккаунт

Информация об аккаунте и балансе

Заказы списываются с баланса. Пополнение через GET /balance/topup/methods и POST /balance/topup.

GET/me

Информация о текущем пользователе API и подписке.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/me" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "id": "res_xxx",
  "email": "your@email.com",
  "subscription": {"plan": "bronze", "status": "active", "expires_at": "..."}
}

GET/balance

Текущий баланс. Заказы списываются с баланса.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/balance" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"currency": "USD", "available": 150.50}

GET/balance/topup/methods

Доступные способы пополнения баланса: Binance Pay, USDT (TRC20, BEP20, TON, Aptos), карты.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/balance/topup/methods" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{
  "methods": [
    {"id": "binance_pay", "name": "Binance Pay"},
    {"id": "usdt_trc20", "name": "USDT (TRC20)"},
    {"id": "usdt_bep20", "name": "USDT (BEP20)"},
    {"id": "usdt_ton", "name": "USDT (TON)"},
    {"id": "usdt_aptos", "name": "USDT (Aptos)"}
  ]
}

POST/balance/topup

Создание запроса на пополнение. Возвращает URL оплаты или инструкции.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/balance/topup" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method_id": "usdt_trc20", "amount": 50}'

Ответ

{
  "payment_url": "https://...",
  "amount": 50,
  "currency": "USDT",
  "address": "Txxx...",
  "expires_at": "..."
}

GET/transactions

Список транзакций баланса (add_balance, charge_balance, refund)

GET/transaction/{transactionId}

Детали транзакции

POST/balance/topup/verify-binance-pay

Проверка платежа Binance Pay после завершения

Вебхуки

Настройка вебхуков для уведомлений

GET/me/webhook

Текущая конфигурация вебхука (URL). Секрет не возвращается после первоначальной настройки.

Запрос

curl -X GET "https://api.fazercards.com/api/v1/me/webhook" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"webhook_url": "https://your-server.com/webhook"}

POST/me/webhook

Установка URL вебхука. Секрет возвращается один раз — сохраните для проверки подписи.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/me/webhook" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url": "https://your-server.com/webhook"}'

Ответ

{
  "webhook_url": "https://your-server.com/webhook",
  "secret": "whsec_xxx..."
}

PUT/me/webhook/settings

Обновление URL вебхука без смены секрета.

Запрос

curl -X PUT "https://api.fazercards.com/api/v1/me/webhook/settings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url": "https://new-url.com/webhook"}'

Ответ

{"webhook_url": "https://new-url.com/webhook"}

POST/me/webhook/regenerate

Перегенерация секрета вебхука. Новый секрет возвращается один раз.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/me/webhook/regenerate" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"secret": "whsec_new_xxx..."}

POST/me/webhook/test

Отправка тестового вебхук-события на ваш URL для проверки.

Запрос

curl -X POST "https://api.fazercards.com/api/v1/me/webhook/test" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"sent": true}

DELETE/me/webhook

Удаление вебхука. Уведомления больше не будут отправляться.

Запрос

curl -X DELETE "https://api.fazercards.com/api/v1/me/webhook" \
  -H "X-API-Key: YOUR_API_KEY"

Ответ

{"webhook_url": null}

Руководство по вебхукам →

Начать

Начните интеграцию с бесплатным триалом.

API Reference

Быстрый старт

Эндпоинты

Каталог

Пополнение

Подарочные карты

Ключи игр

Пополнение Steam / Подарки Steam

Telegram

Roblox

Заказы

Аккаунт

Подписка

Вебхуки

Начать