Справочник API

Система

Работоспособность и статус сервиса.

GET/ping

Проверка работоспособности

API-ключ не нужен.

Ответы

200 OK

curl "https://corporative.oyunqurdu.az/api/v1/ping"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/ping",
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/ping", {
  method: "GET",
  headers: {
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "status": "ok",
  "version": "1.0.0",
  "service": {
    "status": "operational",
    "message": null,
    "retry_after": null
  },
  "time": "2026-10-24T09:12:44Z"
}

Аккаунт

Ваш аккаунт и баланс.

GET/account

Ваш аккаунт

Поля ответа

id string: ID заказа (ord_…).
company string
email string
balance string
currency string
rate_limit_per_minute integer
webhook object
created_at string

Ответы

200 OK
401 Ошибка unauthorized invalid_api_key
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/account" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/account", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "id": "acc_k3m9q2w7x4z8n5",
  "company": "Your Company LLC",
  "login": "yourshop",
  "email": "api@company.com",
  "balance": "1250.40",
  "currency": "USD",
  "rate_limit_per_minute": 120,
  "webhook": {
    "enabled": true,
    "url": "https://company.com/oq/webhook"
  },
  "created_at": "2026-10-01T10:00:00Z",
  "service": {
    "status": "operational",
    "message": null,
    "retry_after": null
  }
}

GET/balance

Текущий баланс

Ответы

200 OK
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/balance" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/balance", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "balance": "1250.40",
  "currency": "USD"
}

Каталог

Категории, товары и ваши цены.

GET/products

Список товаров с вашими ценами

Query

page integer по умолчанию 1: Номер страницы, с 1.
per_page integer по умолчанию 50: Элементов на странице, не более 100.
category string: Код категории, напр. free-fire.
region string: GLOBAL, EU, TR, US, CIS, RU или ID.
type string: topup · code: Фильтр по типу.
q string: Поиск по названию и коду.
in_stock boolean: Только товары, доступные для заказа сейчас.
live boolean: Переоценить по рынку сейчас; нужен `category`.

Ответы

200 OK
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/products" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/products",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "data": [
    {
      "code": "PUBGM-660-UC",
      "name": "PUBG Mobile — 660 UC",
      "category": "pubg-mobile",
      "category_name": "PUBG Mobile",
      "region": "GLOBAL",
      "type": "topup",
      "price": "9.17",
      "currency": "USD",
      "in_stock": true,
      "stock": null,
      "min_quantity": 1,
      "max_quantity": 10,
      "fields": [
        {
          "key": "player_id",
          "label": "Player ID",
          "type": "text",
          "required": true
        }
      ],
      "description": "Enter your Player ID before placing the order."
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

GET/products/{code}

Один товар

Путь

code string обязательно: Постоянный код товара. Никогда не меняется.

Поля ответа

code string: Постоянный код товара. Никогда не меняется.
name string
category string: Код категории, напр. free-fire.
category_name string
region string | null: GLOBAL, EU, TR, US, CIS, RU или ID.
type string: topup · code: Фильтр по типу.
price string: Ваша цена за единицу.
currency string
in_stock boolean: Только товары, доступные для заказа сейчас.
stock integer | null: null = не ограничено складом
min_quantity integer
max_quantity integer
fields array of Field: Что передать в `fields` при заказе.
description string | null

Ответы

200 OK
404 Ошибка product_not_found
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "code": "PUBGM-660-UC",
  "name": "PUBG Mobile — 660 UC",
  "category": "pubg-mobile",
  "category_name": "PUBG Mobile",
  "region": "GLOBAL",
  "type": "topup",
  "price": "9.17",
  "currency": "USD",
  "in_stock": true,
  "stock": null,
  "min_quantity": 1,
  "max_quantity": 10,
  "fields": [
    {
      "key": "player_id",
      "label": "Player ID",
      "type": "text",
      "required": true
    }
  ],
  "description": "Enter your Player ID before placing the order."
}

GET/products/{code}/quote

Живая цена товара (рыночная цена + ваша наценка, прямо сейчас)

Путь

code string обязательно: Постоянный код товара. Никогда не меняется.

Query

quantity integer по умолчанию 1: Количество единиц.

Поля ответа

product string: Код товара.
name string
quantity integer: Количество единиц.
unit_price string
total string: quantity × unit_price.
currency string
available boolean
in_stock boolean: Только товары, доступные для заказа сейчас.
stock integer | null: Остаток; null = не ограничено складом.
live boolean: true: цена получена сейчас; false: последняя известная цена
quoted_at string
valid_until string
hint string

Ответы

200 OK
404 Ошибка product_not_found
410 Ошибка product_discontinued
422 Ошибка quantity_out_of_range invalid_parameter
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/quote" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/quote",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/quote", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "product": "PUBGM-660-UC",
  "name": "PUBG Mobile — 660 UC",
  "quantity": 2,
  "unit_price": "9.17",
  "total": "18.34",
  "currency": "USD",
  "available": true,
  "in_stock": true,
  "stock": null,
  "live": true,
  "quoted_at": "2026-10-24T09:12:40Z",
  "valid_until": "2026-10-24T09:13:40Z",
  "hint": "Send max_unit_price with the order to lock this price."
}

POST/products/{code}/validate

Проверить ID игрока до заказа (товары пополнения)

Путь

code string обязательно: Постоянный код товара. Никогда не меняется.

Тело · JSON

fields object: Что передать в `fields` при заказе.

Ответы

200 OK
422 Ошибка validation_error not_supported
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl -X POST "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/validate" \
  -H "Authorization: Bearer $OQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"player_id": "5123456789"}}'

import os, requests

r = requests.post(
    "https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/validate",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    json={'fields': {'player_id': '5123456789'}},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/products/PUBGM-660-UC/validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"fields": {"player_id": "5123456789"}}),
});
console.log(res.status, await res.json());

Пример ответа

{
  "valid": true,
  "player_name": "ShadowFox"
}

Заказы

Создавайте и отслеживайте заказы.

GET/orders

Список заказов

Query

page integer по умолчанию 1: Номер страницы, с 1.
per_page integer по умолчанию 50: Элементов на странице, не более 100.
status string: Текущий статус.
product string: Код товара.
reference string: Ваш уникальный ID. Делает запрос идемпотентным.
from string: С этой даты/времени (ISO 8601).
to string: До этой даты/времени (ISO 8601).

Ответы

200 OK
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/orders" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "data": [
    {
      "id": "ord_7kq2m9xw4hz8n3pd5t",
      "reference": "INV-10045",
      "status": "completed",
      "status_message": "The order is complete.",
      "product": {
        "code": "STEAM-GLOBAL-20-USD",
        "name": "Steam Wallet (Global) — 20 USD"
      },
      "quantity": 2,
      "unit_price": "21.62",
      "total": "43.24",
      "currency": "USD",
      "fields": {},
      "delivery": {
        "type": "code",
        "codes": [
          "XXXXX-XXXXX-XXXXX",
          "YYYYY-YYYYY-YYYYY"
        ],
        "message": null
      },
      "failure": null,
      "created_at": "2026-10-24T09:12:44Z",
      "updated_at": "2026-10-24T09:12:47Z",
      "completed_at": "2026-10-24T09:12:47Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

POST/orders

Создать заказ

Списывает с вашего баланса. Передайте reference, чтобы повтор никогда не купил дважды.

Тело · JSON

product string обязательно: Код товара.
quantity integer: Количество единиц.
fields object: Что передать в `fields` при заказе.
reference string: Ваш уникальный ID. Делает запрос идемпотентным.
callback_url string: https-адрес, получающий вебхуки этого заказа
max_unit_price string: Отклонить заказ, если цена выше

Поля ответа

id string: ID заказа (ord_…).
reference string | null: Ваш уникальный ID. Делает запрос идемпотентным.
status string: processing · completed · failed · on_hold · refunded: Текущий статус.
status_message string
product object: Код товара.
quantity integer: Количество единиц.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Что передать в `fields` при заказе.
delivery object | null: Коды (подарочные карты) или подтверждение пополнения; заполняется по завершении.
failure object | null: Почему заказ не выполнен; иначе null.
created_at string
updated_at string
completed_at string | null

Ответы

201 Создан
200 Тот же reference отправлен повторно — существующий заказ
402 Ошибка insufficient_balance
404 Ошибка product_not_found
409 Ошибка product_unavailable out_of_stock price_changed duplicate_reference
410 Ошибка product_discontinued
415 Ошибка unsupported_media_type
422 Ошибка validation_error invalid_fields quantity_out_of_range order_limit_exceeded
429 Ошибка rate_limited
503 Ошибка maintenance service_unavailable
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl -X POST "https://corporative.oyunqurdu.az/api/v1/orders" \
  -H "Authorization: Bearer $OQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product": "PUBGM-660-UC", "quantity": 1, "fields": {"player_id": "5123456789"}, "reference": "INV-10045"}'

import os, requests

r = requests.post(
    "https://corporative.oyunqurdu.az/api/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    json={'product': 'PUBGM-660-UC',
 'quantity': 1,
 'fields': {'player_id': '5123456789'},
 'reference': 'INV-10045'},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"product": "PUBGM-660-UC", "quantity": 1, "fields": {"player_id": "5123456789"}, "reference": "INV-10045"}),
});
console.log(res.status, await res.json());

Пример ответа

{
  "id": "ord_7kq2m9xw4hz8n3pd5t",
  "reference": "INV-10045",
  "status": "completed",
  "status_message": "The order is complete.",
  "product": {
    "code": "STEAM-GLOBAL-20-USD",
    "name": "Steam Wallet (Global) — 20 USD"
  },
  "quantity": 2,
  "unit_price": "21.62",
  "total": "43.24",
  "currency": "USD",
  "fields": {},
  "delivery": {
    "type": "code",
    "codes": [
      "XXXXX-XXXXX-XXXXX",
      "YYYYY-YYYYY-YYYYY"
    ],
    "message": null
  },
  "failure": null,
  "created_at": "2026-10-24T09:12:44Z",
  "updated_at": "2026-10-24T09:12:47Z",
  "completed_at": "2026-10-24T09:12:47Z"
}

GET/orders/{id}

Один заказ

Путь

id string обязательно: ID заказа (ord_…).

Поля ответа

id string: ID заказа (ord_…).
reference string | null: Ваш уникальный ID. Делает запрос идемпотентным.
status string: processing · completed · failed · on_hold · refunded: Текущий статус.
status_message string
product object: Код товара.
quantity integer: Количество единиц.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Что передать в `fields` при заказе.
delivery object | null: Коды (подарочные карты) или подтверждение пополнения; заполняется по завершении.
failure object | null: Почему заказ не выполнен; иначе null.
created_at string
updated_at string
completed_at string | null

Ответы

200 OK
404 Ошибка order_not_found
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/orders/ord_7kq2m9xw4hz8n3pd5t" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/orders/ord_7kq2m9xw4hz8n3pd5t",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders/ord_7kq2m9xw4hz8n3pd5t", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "id": "ord_7kq2m9xw4hz8n3pd5t",
  "reference": "INV-10045",
  "status": "completed",
  "status_message": "The order is complete.",
  "product": {
    "code": "STEAM-GLOBAL-20-USD",
    "name": "Steam Wallet (Global) — 20 USD"
  },
  "quantity": 2,
  "unit_price": "21.62",
  "total": "43.24",
  "currency": "USD",
  "fields": {},
  "delivery": {
    "type": "code",
    "codes": [
      "XXXXX-XXXXX-XXXXX",
      "YYYYY-YYYYY-YYYYY"
    ],
    "message": null
  },
  "failure": null,
  "created_at": "2026-10-24T09:12:44Z",
  "updated_at": "2026-10-24T09:12:47Z",
  "completed_at": "2026-10-24T09:12:47Z"
}

GET/orders/reference/{reference}

Найти заказ по вашему reference

Путь

reference string обязательно: Ваш уникальный ID. Делает запрос идемпотентным.

Поля ответа

id string: ID заказа (ord_…).
reference string | null: Ваш уникальный ID. Делает запрос идемпотентным.
status string: processing · completed · failed · on_hold · refunded: Текущий статус.
status_message string
product object: Код товара.
quantity integer: Количество единиц.
unit_price string
total string: quantity × unit_price.
currency string
fields object: Что передать в `fields` при заказе.
delivery object | null: Коды (подарочные карты) или подтверждение пополнения; заполняется по завершении.
failure object | null: Почему заказ не выполнен; иначе null.
created_at string
updated_at string
completed_at string | null

Ответы

200 OK
404 Ошибка order_not_found
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/orders/reference/INV-10045" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/orders/reference/INV-10045",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/orders/reference/INV-10045", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "id": "ord_7kq2m9xw4hz8n3pd5t",
  "reference": "INV-10045",
  "status": "completed",
  "status_message": "The order is complete.",
  "product": {
    "code": "STEAM-GLOBAL-20-USD",
    "name": "Steam Wallet (Global) — 20 USD"
  },
  "quantity": 2,
  "unit_price": "21.62",
  "total": "43.24",
  "currency": "USD",
  "fields": {},
  "delivery": {
    "type": "code",
    "codes": [
      "XXXXX-XXXXX-XXXXX",
      "YYYYY-YYYYY-YYYYY"
    ],
    "message": null
  },
  "failure": null,
  "created_at": "2026-10-24T09:12:44Z",
  "updated_at": "2026-10-24T09:12:47Z",
  "completed_at": "2026-10-24T09:12:47Z"
}

Транзакции

История баланса.

GET/transactions

История баланса

Query

page integer по умолчанию 1: Номер страницы, с 1.
per_page integer по умолчанию 50: Элементов на странице, не более 100.
type string: Фильтр по типу.
from string: С этой даты/времени (ISO 8601).
to string: До этой даты/времени (ISO 8601).

Ответы

200 OK
401 Проблема с ключом unauthorized invalid_api_key
429 rate_limited

curl "https://corporative.oyunqurdu.az/api/v1/transactions" \
  -H "Authorization: Bearer $OQ_API_KEY"

import os, requests

r = requests.get(
    "https://corporative.oyunqurdu.az/api/v1/transactions",
    headers={"Authorization": f"Bearer {os.environ['OQ_API_KEY']}"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch("https://corporative.oyunqurdu.az/api/v1/transactions", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.OQ_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Пример ответа

{
  "data": [
    {
      "id": "txn_k2m8q4w7x3z9n5p6r1",
      "type": "purchase",
      "amount": "-9.17",
      "balance_after": "1241.23",
      "currency": "USD",
      "order_id": "ord_7kq2m9xw4hz8n3pd5t",
      "description": "PUBGM-660-UC × 1",
      "created_at": "2026-10-24T09:12:44Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

Система

Проверка работоспособности

Ответы

Аккаунт

Ваш аккаунт

Ответы

Текущий баланс

Ответы

Каталог

Игры и сервисы

Ответы

Список товаров с вашими ценами

Query

Ответы

Один товар

Путь

Ответы

Живая цена товара (рыночная цена + ваша наценка, прямо сейчас)

Путь

Query

Ответы

Проверить ID игрока до заказа (товары пополнения)

Путь

Тело · JSON

Ответы

Заказы

Список заказов

Query

Ответы

Создать заказ

Тело · JSON

Ответы

Один заказ

Путь

Ответы

Найти заказ по вашему reference

Путь

Ответы

Транзакции

История баланса

Query

Ответы