История транзакций

Возвращает детализированную историю движения средств. Включает пополнения, блокировки средств перед началом аренды (Lock), фактические списания (Charge) и возвраты (Unlock/Refund).

GET https://api.yougpu.ru/billing/transactions?type=DEPOSIT,USAGE_CHARGE

Заголовки (Headers)

Заголовок	Значение	Описание
X-API-KEY	<YOUR_API_KEY>	Ваш API ключ
Content-Type	application/json	Формат данных

Параметры запроса (Query)

Параметр

Тип

Описание

page

number

Номер страницы (по умолчанию 1).

limit

number

Количество записей на странице (по умолчанию 20).

type

TransactionType[]

Фильтр по типу операции. Можно указать несколько значений через запятую.

DEPOSIT

Value

Пополнение баланса.

RESERVATION_LOCK

Value

Блокировка средств перед стартом часа аренды.

RESERVATION_UNLOCK

Value

Возврат неиспользованного остатка блокировки.

USAGE_CHARGE

Value

Фактическое списание стоимости аренды.

BONUS

Value

Подарочное начисление от администратора.

REFUND

Value

Компенсация средств (возврат) при сбоях.

Примеры кода

curl -X GET "https://api.yougpu.ru/billing/transactions?page=1&limit=10&type=DEPOSIT,USAGE_CHARGE" \
  -H "X-API-KEY: <YOUR_API_KEY>"

import requests

url = "https://api.yougpu.ru/billing/transactions?page=1&limit=10&type=DEPOSIT,USAGE_CHARGE"
headers = {
    "X-API-KEY": "<YOUR_API_KEY>"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://api.yougpu.ru/billing/transactions?page=1&limit=10&type=DEPOSIT,USAGE_CHARGE', {
  "method": "GET",
  "headers": {
      "X-API-KEY": "<YOUR_API_KEY>"
  }
});
const data = await response.json();
console.log(data);

Ответ

200 OK

{
  "status": "success",
  "code": 200,
  "data": [
    {
      "id": "tx_usage_001",
      "type": "USAGE_CHARGE",
      "status": "COMPLETED",
      "amount": "2.55",
      "direction": "OUTGOING",
      "description": "Hourly rent for Instance gpu-h100-01",
      "created_at": "2026-02-05T19:00:00Z"
    },
    {
      "id": "tx_lock_002",
      "type": "RESERVATION_LOCK",
      "status": "COMPLETED",
      "amount": "3.00",
      "direction": "OUTGOING",
      "description": "Funds reservation for next hour",
      "created_at": "2026-02-05T18:00:00Z"
    },
    {
      "id": "tx_dep_003",
      "type": "DEPOSIT",
      "status": "PENDING",
      "amount": "1500.00",
      "direction": "INCOMING",
      "description": "Пополнение баланса. Заказ #550e8400",
      "created_at": "2026-02-05T12:30:00Z"
    }
  ],
  "meta": {
    "total": 45,
    "page": 1,
    "limit": 10,
    "total_pages": 5
  }
}

Структура ответа

Параметр

Тип

Описание

status

string

Статус выполнения запроса (например, success).

code

number

HTTP код ответа.

data

object

Данные ответа:

string

Уникальный ID транзакции.

amount

string

Сумма операции в рублях (абсолютное значение).

direction

Enum

Направление движения средств (вычисляемое поле):

INCOMING

Value

Баланс увеличивается (Deposit, Unlock, Bonus, Refund).

OUTGOING

Value

Баланс уменьшается (Lock, Usage).

status

TransactionStatus

Текущий статус операции:

PENDING

Value

Ожидает оплаты (для депозитов).

COMPLETED

Value

Успешно завершена.

FAILED

Value

Ошибка проведения.

CANCELLED

Value

Отменена пользователем.

EXPIRED

Value

Истек срок оплаты.

type

TransactionType

Тип финансовой операции.

DEPOSIT

Value

Пополнение баланса.

RESERVATION_LOCK

Value

Блокировка средств перед стартом часа аренды.

RESERVATION_UNLOCK

Value

Возврат неиспользованного остатка блокировки.

USAGE_CHARGE

Value

Фактическое списание стоимости аренды.

BONUS

Value

Подарочное начисление от администратора.

REFUND

Value

Компенсация средств (возврат) при сбоях.

description

string

Текстовое описание назначения платежа.

created_at

string

Дата создания записи.