GET /api/v2/server-side-api/vc/transactions/

Список транзакций виртуальной валюты

Возвращает историю транзакций виртуальной валюты для профиля в порядке убывания даты (сначала новые). Результаты используют постраничную навигацию с курсором: если ответ содержит ненулевое значение pagination.next_cursor, передайте его в качестве параметра запроса cursor для получения следующей страницы.

Query parameters

currency_codestring

Фильтрация истории по коду одной виртуальной валюты.

cursorstring

Непрозрачный курсор постраничной навигации, возвращённый в поле pagination.next_cursor предыдущего ответа. Не передавайте для получения первой страницы.

limitinteger

Максимальное количество транзакций, возвращаемых на странице. По умолчанию — 50.

Header parameters

adapty-customer-user-idstring

Уникальный идентификатор клиента в вашей системе. Требуется либо adapty-customer-user-id, либо adapty-profile-id.

adapty-profile-idstring

Уникальный идентификатор профиля в вашей системе. Оптимальный вариант при работе с анонимными профилями. Требуется либо adapty-customer-user-id, либо adapty-profile-id.

Responses

История транзакций успешно возвращена

Schema

Постраничный список транзакций виртуальной валюты для профиля.

dataarray of objectrequired
transaction_idstringrequired

Уникальный идентификатор транзакции.

transaction_typestringrequired

Источник транзакции. Одно из значений: store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund или expiry.

itemsarray of objectrequired

Изменения баланса по каждой валюте, зафиксированные в данной транзакции.

currency_codestringrequired

Код виртуальной валюты.

amountintegerrequired

Подписанное изменение, применённое к балансу. Положительное значение — пополнение, отрицательное — списание.

balance_afterintegerrequired

Баланс валюты после применения данной транзакции.

metadataobject

Пары ключ-значение, сохранённые вместе с транзакцией, если они есть.

operationstringrequired

Смысл транзакции. Adapty устанавливает это значение для собственных транзакций: store_purchase, subscription_renewal и trial_start получают top_up, refund получает refund, а expiry получает expiry. Для dashboard_transaction — это операция, которую выбрал участник команды при корректировке баланса в дашборде Adapty. Для api_transaction — это значение, которое вы передали, или null, если вы ничего не передали.

One of: "top_up", "refund", "spend", "spend_reversal", "reward", "reward_reversal", "exchange", "expiry", "migration", "adjustment"

featurestringrequired

На что были потрачены или за что были начислены монеты — так, как вы это передали. null для транзакций, созданных Adapty.

customer_placement_idstringrequired

Идентификатор экрана или плейсмента из вашего приложения, так как вы его передали. null для транзакций, созданных Adapty.

reference_idstringrequired

Идентификатор связанного объекта в вашей системе, так как вы его передали. null для транзакций, созданных Adapty.

is_sandboxbooleanrequired

Является ли транзакция тестовой. Для транзакций, созданных Adapty, значение соответствует окружению покупки в сторе. Для api_transaction — это значение, которое вы передали; по умолчанию false.

storestringrequired

Стор связанной покупки. Устанавливается для транзакций, созданных Adapty на основе событий стора (покупка, продление, пробный период, возврат), а также для api_transaction, переданной со ссылкой на покупку.

store_transaction_idstringrequired

Идентификатор транзакции стора для связанной покупки. Устанавливается для тех же транзакций, что и store.

created_atstringrequired

Когда была зафиксирована транзакция.

paginationobjectrequired
next_cursorstringrequired

Непрозрачный курсор для следующей страницы. Передайте его как параметр запроса 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": null,
      "operation": "reward",
      "feature": "daily_bonus",
      "customer_placement_id": "home-screen",
      "reference_id": null,
      "is_sandbox": false,
      "store": null,
      "store_transaction_id": null,
      "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
        }
      ],
      "metadata": null,
      "operation": "top_up",
      "feature": null,
      "customer_placement_id": null,
      "reference_id": null,
      "is_sandbox": false,
      "store": "app_store",
      "store_transaction_id": "2000001218103228",
      "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
        }
      ],
      "metadata": null,
      "operation": "top_up",
      "feature": null,
      "customer_placement_id": null,
      "reference_id": null,
      "is_sandbox": false,
      "store": "play_store",
      "store_transaction_id": "GPA.3345-1234-5678-90123",
      "created_at": "2026-05-20T09:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "MjAyNi0wNS0yMFQwOTowMDowMFowMTkwZTVjMC0zZjE4LTdiOWEtOWU2ZC00NGExYzhiMjdlMDM="
  }
}

Некорректный запрос. Поле error_code указывает на причину:

  • validation_error — значение limit выходит за пределы диапазона 1–100, либо не передан ни adapty-profile-id, ни adapty-customer-user-id.
  • invalid_cursor — значение cursor не может быть разобрано.
Schema
errorsarray of objectrequired
sourcestring

Источник ошибки

errorsarray of string

Массив сообщений об ошибках

error_codestringrequired

Краткое название ошибки

status_codeintegerrequired

HTTP-код статуса

Не авторизован. API-ключ отсутствует или недействителен (значение error_code — not_authenticated).

Schema
errorsarray of objectrequired
sourcestring

Источник ошибки

errorsarray of string

Массив сообщений об ошибках

error_codestringrequired

Краткое название ошибки

status_codeintegerrequired

HTTP-код статуса

Профиль не найден (значение error_code — profile_does_not_exist).

Schema
errorsarray of objectrequired
sourcestring

Источник ошибки

errorsarray of string

Массив сообщений об ошибках

error_codestringrequired

Краткое название ошибки

status_codeintegerrequired

HTTP-код статуса

Внутренняя ошибка сервера