Winners API — Developer Platform & Reseller Documentation

Winners B2B Reseller Gateway

Enterprise REST API for automated game top-up, digital gift vouchers, and live balance settlements.

For enterprise balance protection and multi-factor security, API secret keys are generated and managed exclusively via our official Telegram bot.

Instant Token Issuance & 1-Tap Copy

Open Telegram Bot > Click 🔌 B2B API & Docs to reveal your secret token with spoiler encryption.

Open @WS_StoreBot in Telegram

Overview & Base URL

The Winners API is organized around REST. All requests require SSL and accept/return standard JSON payloads.

⚡ Production Base URL: https://wsstore.pro/api/v1

Authentication

Pass your secret API key in the HTTP request header with either X-API-KEY or Bearer authorization:

// Recommended HTTP Header:
X-API-KEY: wn_live_9f8a3c2b1e4d5f6a7b8c9d0e1f2a3b4c

// Alternative Authorization Header:
Authorization: Bearer wn_live_9f8a3c2b1e4d5f6a7b8c9d0e1f2a3b4c

Account & Balance Details

GET /api/v1/getMe

Returns real-time account status, Telegram identity, active balance in AZN, and API key metrics.

Header	Type	Status	Description
X-API-KEY	string	Required	Your secret API token (Format: `wn_live_...`)

curl -X GET "https://wsstore.pro/api/v1/getMe" \
  -H "X-API-KEY: wn_live_YOUR_KEY"

const axios = require('axios');

const response = await axios.get('https://wsstore.pro/api/v1/getMe', {
  headers: { 'X-API-KEY': 'wn_live_YOUR_KEY' }
});
console.log(response.data);

import requests

headers = {'X-API-KEY': 'wn_live_YOUR_KEY'}
res = requests.get('https://wsstore.pro/api/v1/getMe', headers=headers)
print(res.json())

Response 200 OK

{
  "ok": true,
  "service": "Winners Reseller API v1",
  "account": {
    "telegram_id": "1108583389",
    "username": "myusername",
    "balance_azn": 50.00,
    "currency": "AZN"
  },
  "api_key_info": {
    "name": "Production Bot",
    "total_orders": 14,
    "total_spent_azn": 84.50
  }
}

List Game Categories

GET /api/v1/categories

Returns all active gaming categories and digital services supported by the platform.

curl -X GET "https://wsstore.pro/api/v1/categories" \
  -H "X-API-KEY: wn_live_YOUR_KEY"

Response 200 OK

{
  "ok": true,
  "count": 12,
  "categories": [
    { "category_id": "pubg_mobile_web", "name": "PUBG Mobile (Web Purchase)", "type": "topup" },
    { "category_id": "pubg_mobile_epin", "name": "PUBG Mobile (E-Pin Voucher)", "type": "giftcard" },
    { "category_id": "free_fire_cis", "name": "Free Fire (CIS)", "type": "topup" }
  ]
}

Fetch Offers & Live Selling Prices

GET /api/v1/offers?category_id={category_id}

Returns all available SKU packages with wholesale AZN and USD selling prices.

Parameter	Type	Status	Description
category_id	string	Required	Category identifier, e.g. `pubg_mobile_web` or `free_fire_cis`

curl -X GET "https://wsstore.pro/api/v1/offers?category_id=pubg_mobile_web" \
  -H "X-API-KEY: wn_live_YOUR_KEY"

Response 200 OK

{
  "ok": true,
  "category_id": "pubg_mobile_web",
  "currency": "AZN",
  "offers": [
    { "offer_id": "174", "name": "60 UC", "price_azn": 1.61, "price_usd": 0.95 },
    { "offer_id": "175", "name": "325 UC (300+25)", "price_azn": 7.74, "price_usd": 4.55 },
    { "offer_id": "176", "name": "660 UC (600+60)", "price_azn": 15.34, "price_usd": 9.02 }
  ]
}

Validate Player ID & Username Lookup

POST /api/v1/validate-player-id

Checks if a player account ID exists and retrieves their official in-game nickname/character name before charging customer balance.

Field	Type	Status	Description
category_id	string	Required	E.g. `pubg_mobile_auto`, `free_fire_id`
player_id	string	Required	In-game numeric Player ID / User ID
additional_fields	object	Optional	Extra fields like `zone_id` for Mobile Legends

curl -X POST "https://wsstore.pro/api/v1/validate-player-id" \
  -H "X-API-KEY: wn_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category_id": "pubg_mobile_auto",
    "player_id": "5123456789"
  }'

Response 200 OK

{
  "ok": true,
  "username": "★ShadowHunter★"
}

Create Direct ID Top-Up Order

POST /api/v1/orders/topup

Executes instant direct deposit onto a Player ID. Balance is debited atomically upon fulfillment.

Field	Type	Status	Description
category_id	string	Required	E.g. `pubg_mobile_web`
offer_id	string	Required	Target offer ID from `/offers`
player_id	string	Required	In-game User ID of recipient

curl -X POST "https://wsstore.pro/api/v1/orders/topup" \
  -H "X-API-KEY: wn_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category_id": "pubg_mobile_web",
    "offer_id": "174",
    "player_id": "5123456789"
  }'

Response 200 OK

{
  "ok": true,
  "order_id": "ORD-829104",
  "status": "completed",
  "offer_name": "60 UC",
  "player_id": "5123456789",
  "charged_amount_azn": 1.61,
  "remaining_balance_azn": 48.39,
  "created_at": "2026-08-27T04:10:00Z"
}

Purchase Digital Voucher / E-Pin

POST /api/v1/orders/giftcard

Purchases digital card pins. Returns unmasked codes and activation keys instantly in payload.

Field	Type	Status	Description
category_id	string	Required	E.g. `pubg_mobile_epin`
offer_id	string	Required	Package SKU ID
count	integer	Optional	Number of cards (1 to 20, default: 1)

curl -X POST "https://wsstore.pro/api/v1/orders/giftcard" \
  -H "X-API-KEY: wn_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category_id": "pubg_mobile_epin",
    "offer_id": "1",
    "count": 1
  }'

Response 200 OK

{
  "ok": true,
  "order_id": "GC-491028",
  "status": "completed",
  "offer_name": "60 UC Voucher",
  "cards": [
    { "code": "M4N8-XK92-PL18-9201", "pin": "" }
  ],
  "charged_amount_azn": 1.66,
  "remaining_balance_azn": 46.73
}

Error Handling & Status Codes

Errors follow RFC standard HTTP status codes accompanied by a descriptive JSON message.

HTTP Code	Error Identifier	Meaning
`401 Unauthorized`	`UNAUTHORIZED`	Missing, expired or inactive API Key.
`400 Bad Request`	`INSUFFICIENT_FUNDS`	Account balance is insufficient for transaction.
`400 Bad Request`	`INVALID_PARAMS`	Missing required body fields (e.g. `player_id`).
`404 Not Found`	`NOT_FOUND`	Specified category or offer ID does not exist.
`500 Internal Error`	`SERVER_ERROR`	Provider timeout or network latency.