/api/v2/server-side-api/vc/transactions/ Список транзакций виртуальной валюты
Возвращает историю транзакций виртуальной валюты для профиля в порядке убывания (новые первыми). В результатах используется пагинация по курсору: если ответ содержит ненулевое значение pagination.next_cursor, передайте его в параметре запроса cursor для получения следующей страницы.
Query parameters
Фильтрация истории по коду одной виртуальной валюты.
Непрозрачный курсор пагинации, возвращённый как pagination.next_cursor в предыдущем ответе. Не указывайте для получения первой страницы.
Максимальное количество транзакций, возвращаемых на одной странице. По умолчанию 50.
Header parameters
Уникальный ID пользователя в вашей системе. Необходимо указать либо adapty-customer-user-id, либо adapty-profile-id.
Уникальный ID профиля в вашей системе. Лучший вариант при работе с анонимными профилями. Необходимо указать либо adapty-customer-user-id, либо adapty-profile-id.
Responses
История транзакций успешно возвращена
Schema
Постраничный список транзакций виртуальной валюты для профиля.
Уникальный идентификатор транзакции.
Источник транзакции. Одно из значений: store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund или expiry.
Изменения баланса по каждой валюте, зафиксированные в данной транзакции.
Код виртуальной валюты.
Подписанное изменение, применённое к балансу. Положительное значение — пополнение, отрицательное — списание.
Баланс валюты после применения данной транзакции.
Пары ключ-значение, сохранённые вместе с транзакцией, если таковые имеются.
Время записи транзакции.
Непрозрачный курсор для следующей страницы. Передайте его как параметр запроса cursor, чтобы получить больше результатов. Null, если страниц больше нет.
Example
{
"data": [
{
"transaction_id": "0190e8a4-1c2b-7def-8abc-2c1a4b6d8e90",
"transaction_type": "api_transaction",
"items": [
{
"currency_code": "COINS",
"amount": 500,
"balance_after": 12950
}
],
"metadata": {
"reason": "promo_bonus"
},
"created_at": "2026-05-23T10:30:00Z"
},
{
"transaction_id": "0190e7b2-9a44-7c10-bb31-7d2e9f0a1c55",
"transaction_type": "store_purchase",
"items": [
{
"currency_code": "COINS",
"amount": 1000,
"balance_after": 12450
}
],
"created_at": "2026-05-22T18:05:12Z"
},
{
"transaction_id": "0190e5c0-3f18-7b9a-9e6d-44a1c8b27e03",
"transaction_type": "subscription_renewal",
"items": [
{
"currency_code": "GEMS",
"amount": 200,
"balance_after": 3280
}
],
"created_at": "2026-05-20T09:00:00Z"
}
],
"pagination": {
"next_cursor": "MjAyNi0wNS0yMFQwOTowMDowMFowMTkwZTVjMC0zZjE4LTdiOWEtOWU2ZC00NGExYzhiMjdlMDM="
}
}Некорректный запрос. Значение cursor недействительно (error_code равен invalid_cursor).
Schema
Источник ошибки
Массив сообщений об ошибках
Краткое название ошибки
HTTP-код статуса
Не авторизован. API-ключ отсутствует или недействителен.
Schema
Источник ошибки
Массив сообщений об ошибках
Краткое название ошибки
HTTP-код статуса
Доступ запрещён. Server API для виртуальных валют не включён для этого приложения.
Schema
Источник ошибки
Массив сообщений об ошибках
Краткое название ошибки
HTTP-код статуса
Профиль не найден.
Schema
Источник ошибки
Массив сообщений об ошибках
Краткое название ошибки
HTTP-код статуса
Внутренняя ошибка сервера