fazercards-python-sdk

Typed Python client for the FazerCards reseller API. Game top-ups, gift cards, Telegram Stars and Premium, Steam wallet, orders and signed webhooks. Sync and async, with retry rules built so an order is never placed twice.

pip install fazercards-python-sdk

Top up a game

from fazercards_sdk import FazerCards

with FazerCards("API_KEY") as fc:
    check = fc.topups.validate("free_fire", "123456789")
    if check.valid:
        order = fc.topups.order("free_fire_cis", "110_diamonds", "123456789", idempotency_key="ORDER-1042")

order.status moves from created to processing to completed, or to failed / refund with order.fail_reason. Follow it by webhook, or with fc.orders.wait(order.id).

Sell a gift card

order = fc.giftcards.order("playstation_tr", "250_try", quantity=1, idempotency_key="ORDER-1043")
order.codes

FazerCards can answer a gift card order with completed and an empty cards list, then fill the list a moment later. The client reads the order again before it returns (code_checks, default 3). If the codes still have not arrived, order.awaiting_codes is True: keep the order open and read it later, never show the customer an empty result.

Telegram and Steam

fc.telegram.stars_quote().price(500)
fc.telegram.buy_stars("@username", 500)
fc.telegram.buy_premium("username", months=12)

if fc.steam.check_login("steam_login").valid:
    fc.steam.order("steam_login", "19.50", "USD", idempotency_key="ORDER-1044")

Catalog

games = fc.topups.all_categories()
cards = fc.giftcards.all_categories()
offers = fc.topups.offers("free_fire_cis")
offers.get("110_diamonds").price
offers.fields
fc.giftcards.cards("playstation_tr").offers[0].stock

Categories come in cursor pages of up to 500 (fc.topups.categories(limit, cursor)); all_categories() follows the cursor. Orders come in numbered pages of up to 100 (fc.orders.list(page, limit), fc.orders.recent(count)).

Webhooks

event = fc.verify_webhook(request.body, headers=request.headers)
if event.needs_lookup:
    order = fc.orders.get(event.order_id)

The body is checked against X-Webhook-Signature (HMAC SHA256 of the raw body, sha256= prefix optional) in constant time. Set the address with fc.account.set_webhook("https://shop.example/webhook/fazercards"). See examples/fastapi_webhook.py.

Safety

Every top-up, gift card and Steam order carries an Idempotency-Key. Pass your own order number, so a double click or a crash can not buy twice. With several shops on one account set idempotency_prefix. Prices are Decimal end to end. fc.rate_limit keeps the last X-RateLimit-* headers.

Endpoints

AsyncFazerCards has the same methods, awaited.

Errors

FazerCardsError is the base. API answers raise APIError subclasses by status: BadRequestError (400), AuthenticationError (401, 403), NotFoundError (404), ConflictError (409), RateLimitError (429), ServerError (5xx). Each carries status_code, message and the raw body.

Config

Pass values in code, or set FAZERCARDS_API_KEY, FAZERCARDS_WEBHOOK_SECRET, FAZERCARDS_BASE_URL, FAZERCARDS_IDEMPOTENCY_PREFIX, FAZERCARDS_TIMEOUT, FAZERCARDS_MAX_RETRIES, or put them in fazercards.toml (example). Every path is a setting (FAZERCARDS_ENDPOINTS__BALANCE=...). Messages live in messages.yaml and can be replaced with messages.use(...).

Develop

pip install -e ".[dev]" && pytest && ruff check . && mypy src

Links

• Source code: github.com/qiyascc/fazercards-python-sdk
• PyPI: pypi.org/project/fazercards-python-sdk
• Project page: theqiyas.cc/projects/fazercards-sdk
• Author: Qiyas Sadıqov, more projects at theqiyas.cc

License

MIT