API Reference

REST API for digital products. Gift cards, top-ups, game keys, Steam, Roblox, Telegram — one integration.

Base URLhttps://api.fazercards.com/api/v1
AuthenticationX-API-Key

Include the header in every request. The API key identifies your reseller account and authorizes access to products and orders.

Quick Start

Get your API key from the reseller panel (Profile → API key). Then make your first request:

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

Response:

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

Endpoints

Catalog

Games and categories from providers

The catalog aggregates games from multiple providers. Use GET /games to list all available games (for top-ups). Each game has an id, name, icon_url, and types. Game IDs like pubgm, mlbb, steam are used when fetching top-up products.

Typical flow: 1) GET /games — list games, 2) GET /topup/products?game_id=pubgm — get products for a game, 3) POST /topup/order — create order with product_id and game_fields (player ID, etc.).

GET/games

Returns all games available for top-ups. Each game has id (e.g. pubgm, mlbb), name, icon_url, types.

Request

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

Response

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

Top-up

Mobile game top-ups (PUBG, Free Fire, etc.)

Top-ups deliver in-game currency (UC, diamonds, etc.) to player accounts. You need the player ID and optionally server/region. Use GET /checkplayerid to validate the player ID before ordering.

GET/checkplayerid

Validate player ID before ordering. Pass game (e.g. pubgm, mlbb), user_id, optional server_id.

Request

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

Response

{
  "valid": "valid",
  "name": "PlayerName",
  "openid": "51234567890"
}
GET/topup/products

Get top-up products for a game. Pass game_id from /games (e.g. pubgm, mlbb).

Request

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

Response

{
  "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

Create top-up order. Include product_id, quantity, and game_fields (player ID, server_id if required).

Request

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"}
  }'

Response

{
  "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"
}

Gift Cards

Gift cards and internal codes

Gift cards return redemption codes (Steam, Amazon, etc.). Use GET /giftcards/products with optional ?category=steam to filter. Order with product_id and quantity. Codes are delivered in the order payload or via webhook.

GET/giftcards/products

Get gift card products. Optional ?category=steam to filter by category.

Request

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

Response

{
  "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

Create gift card order. Codes are delivered in response when completed, or via webhook.

Request

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}'

Response

{
  "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"
}

Game Keys

Steam/Xbox/other game keys

Game keys are Steam/Xbox/other keys. Use GET /gamekeys for categories, POST /gamekeys/products with game_id for products. Check POST /gamekeys/region-restriction before ordering — some keys are region-locked.

GET/gamekeys

List game key categories (steamkeys, xboxkeys, otherkeys). Excludes gift cards.

Request

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

Response

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

Get products for a game. Use game_id from /gamekeys. Check region-restriction first for region-locked keys.

Request

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"}'

Response

{
  "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

Check if a game key is region-locked. Returns region_type (CIS, ROW, GLOBAL, etc.), available countries, and restrictions.

Request

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"}'

Response

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

Create game key order. Keys delivered in payload.codes when completed, or via webhook.

Request

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}'

Response

{
  "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 Top-up / Steam Gifts

Steam wallet refills. Steam giftable games.

POST/steamtopup/check-login

Validate Steam login before ordering. Pass username (Steam login).

Request

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"}'

Response

{"can_refill": true}
GET/steamtopup/rates

Get Steam wallet exchange rates. Optional ?currency=RUB for a single rate.

Request

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

Response

{
  "rates": [
    {"currency": "USD", "rate": 1.0},
    {"currency": "RUB", "rate": 0.01}
  ]
}
POST/steamtopup/order

Create Steam wallet top-up. Requires username and amount_usd.

Request

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}'

Response

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

List Steam giftable games. Optional ?limit=50.

Request

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

Response

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

Get editions/packages for a Steam game. Use appid from /steamgifts/games.

Request

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

Response

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

Create Steam gift order. Required: appid, package_id, region, invite_url (Steam invite link).

Request

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"}'

Response

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

Telegram

Telegram Premium and Stars

GET/telegram/premium

Get Telegram Premium subscription offers and pricing.

Request

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

Response

{"items": [...], "note": "..."}
GET/telegram/stars

Get Telegram Stars offers (in-app purchases for bots).

Request

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

Response

{"items": [...], "note": "..."}
POST/telegram/premium/gift

Create Telegram Premium gift. Pass username and months.

Request

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}'

Response

{"order_id": "ord_tg123", "status": "processing"}
POST/telegram/stars/buy

Buy Telegram Stars. Pass username and amount.

Request

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}'

Response

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

Roblox Packs

Roblox packs (Robux delivery)

GET/roblox/packages/products

Get Roblox pack products (Robux). Includes regular and backup delivery options.

Request

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

Response

{
  "products": [
    {"id": "roblox_pack_80", "name": "80 Robux", "price": 0.99, "is_backup": false}
  ]
}
POST/roblox/packages/buy

Create Roblox pack order. Required: product_id, login, password. For backup: is_backup=true and backup_codes (3 codes).

Request

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": "***"}'

Response

{
  "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}

Get chat messages for a Roblox order. chatId is in order payload. Used when operator needs info from you.

Request

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

Response

{
  "messages": [
    {"id": "msg_1", "content": "Please provide 2FA code", "sender": "operator", "created_at": "..."}
  ]
}
POST/roblox/packages/chat/{chatId}/send

Send a message in order chat. Use to reply to operator (e.g. 2FA code).

Request

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"}'

Response

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

Orders

Order status and details

docs.api.orderStatusExplain

GET/orders/{orderId}

Get order details. When status is completed, codes are in payload.codes (or delivered via webhook).

Request

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

Response

{
  "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

List orders. Optional query params: status, limit, offset.

Request

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

Response

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

Account

Balance, transactions, webhook config

Orders are charged from your balance. Top up via GET /balance/topup/methods and POST /balance/topup. We accept Binance Pay, USDT (TRC20, BEP20, TON, Aptos), and cards.

GET/me

Get current API user and subscription info.

Request

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

Response

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

Get current balance. Orders are charged from balance.

Request

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

Response

{"currency": "USD", "available": 150.50}
GET/balance/topup/methods

Get available payment methods for balance top-up: Binance Pay, USDT (TRC20, BEP20, TON, Aptos), cards.

Request

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

Response

{
  "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

Create balance top-up request. Returns payment URL or instructions (Binance Pay, USDT, etc.).

Request

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}'

Response

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

List balance transactions (add_balance, charge_balance, refund)

GET/transaction/{transactionId}

Get transaction details

POST/balance/topup/verify-binance-pay

Verify Binance Pay payment after user completes it

Subscription

Subscription management

GET/subscription

Get current subscription: plan (bronze/silver/gold), status, expires_at, auto_renew.

Request

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

Response

{
  "subscription": {
    "plan": "bronze",
    "plan_months": 1,
    "expires_at": "2026-04-10T00:00:00Z",
    "auto_renew": false,
    "status": "active",
    "charged": 9.99
  }
}
POST/subscription/renew

Renew subscription. Charges from balance. Optional: plan, months, auto_renew.

Request

curl -X POST "https://api.fazercards.com/api/v1/subscription/renew" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan": "bronze", "months": 1}'

Response

{"subscription": {"plan": "bronze", "status": "active", "expires_at": "..."}}
POST/subscription/upgrade

Upgrade plan or extend term. Required: plan. Optional: months, auto_renew.

Request

curl -X POST "https://api.fazercards.com/api/v1/subscription/upgrade" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan": "gold", "months": 3}'

Response

{"subscription": {"plan": "gold", "status": "active", ...}}
POST/subscription/auto-renew

Enable or disable auto-renew. Required: enabled (boolean).

Request

curl -X POST "https://api.fazercards.com/api/v1/subscription/auto-renew" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

Response

{"subscription": {"auto_renew": true, ...}}

Webhooks

Webhook configuration

GET/me/webhook

Get current webhook config (URL). Secret is never returned after initial setup.

Request

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

Response

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

Set webhook URL. Returns secret once — store it for signature verification.

Request

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"}'

Response

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

Update webhook URL without changing the secret.

Request

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"}'

Response

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

Regenerate webhook secret. Returns new secret once. Use after leak or rotation.

Request

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

Response

{"secret": "whsec_new_xxx..."}
POST/me/webhook/test

Send a test webhook event to your URL. Use to verify your endpoint.

Request

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

Response

{"sent": true}
DELETE/me/webhook

Remove webhook. No more notifications will be sent.

Request

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

Response

{"webhook_url": null}
Webhooks guide

Get Started

Start integrating with a free trial.