/api/v2/server-side-api/vc/transactions/ Listar transacciones de moneda virtual
Devuelve el historial de transacciones de moneda virtual de un perfil, de más reciente a más antigua. Los resultados usan paginación por cursor: cuando la respuesta incluye un pagination.next_cursor no nulo, pásalo como parámetro de consulta cursor para obtener la siguiente página.
Query parameters
Filtra el historial por un único código de moneda virtual.
Cursor de paginación opaco devuelto como pagination.next_cursor en una respuesta anterior. Omítelo para obtener la primera página.
Número máximo de transacciones a devolver por página. El valor predeterminado es 50.
Header parameters
El ID único del cliente en tu sistema. Se requiere adapty-customer-user-id o adapty-profile-id.
El ID único del perfil en tu sistema. Es la mejor opción si trabajas con perfiles anónimos. Se requiere adapty-customer-user-id o adapty-profile-id.
Responses
Historial de transacciones devuelto correctamente
Schema
Lista paginada de transacciones de moneda virtual para un perfil.
ID único de la transacción.
El origen de la transacción. Uno de store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund o expiry.
Cambios de saldo por moneda registrados en esta transacción.
El código de la moneda virtual.
El cambio con signo aplicado al saldo. Un valor positivo es un crédito, un valor negativo es un débito.
El saldo de la moneda después de aplicar esta transacción.
Pares clave-valor almacenados con la transacción, si los hubiera.
Momento en que se registró la transacción.
Cursor opaco para la siguiente página. Pásalo como parámetro de consulta cursor para obtener más resultados. Null cuando no hay más páginas.
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="
}
}Solicitud incorrecta. El valor de cursor no es válido (error_code es invalid_cursor).
Schema
Fuente del error
Array de mensajes de error
Nombre corto del error
Código de estado HTTP
No autorizado. La clave de API falta o no es válida.
Schema
Fuente del error
Array de mensajes de error
Nombre corto del error
Código de estado HTTP
Prohibido. La Server API para monedas virtuales no está habilitada para esta aplicación.
Schema
Fuente del error
Array de mensajes de error
Nombre corto del error
Código de estado HTTP
Perfil no encontrado.
Schema
Fuente del error
Array de mensajes de error
Nombre corto del error
Código de estado HTTP
Error interno del servidor