/api/v2/server-side-api/vc/transactions/ Listar transacciones de moneda virtual
Devuelve el historial de transacciones de moneda virtual de un perfil, del más reciente al más antiguo. 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 a 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. 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 los valores: 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 hay.
Lo que representa la transacción. Adapty lo establece en sus propias transacciones: store_purchase, subscription_renewal y trial_start reciben top_up, refund recibe refund y expiry recibe expiry. En una dashboard_transaction, es la operación que un miembro del equipo seleccionó al ajustar el saldo en el Adapty Dashboard. En una api_transaction, es el valor que usted envió, o null si no envió ninguno.
One of: "top_up", "refund", "spend", "spend_reversal", "reward", "reward_reversal", "exchange", "expiry", "migration", "adjustment"
En qué se gastaron o por qué se otorgaron las monedas, tal como usted lo envió. null en las transacciones creadas por Adapty.
El ID de pantalla o placement de su aplicación, tal como usted lo envió. null en las transacciones creadas por Adapty.
El ID del objeto relacionado en su sistema, tal como usted lo envió. null en las transacciones creadas por Adapty.
Indica si la transacción es de prueba. En las transacciones creadas por Adapty, sigue el entorno de la compra en el store. En una api_transaction, es el valor que usted envió; por defecto es false.
Store de la compra relacionada. Se establece en las transacciones creadas por Adapty a partir de eventos del store (compra, renovación, prueba, reembolso) y en una api_transaction enviada con una referencia de compra.
ID de transacción del store de la compra relacionada. Se establece en las mismas transacciones que store.
Cuándo 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": 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="
}
} Solicitud incorrecta. El campo error_code identifica la causa:
validation_error—limitestá fuera del rango 1–100, o no se envía niadapty-profile-idniadapty-customer-user-id.invalid_cursor— el valor decursorno se puede analizar.
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 (error_code es not_authenticated).
Schema
Fuente del error
Array de mensajes de error
Nombre corto del error
Código de estado HTTP
Perfil no encontrado (error_code es profile_does_not_exist).
Schema
Fuente del error
Array de mensajes de error
Nombre corto del error
Código de estado HTTP
Error interno del servidor