GET /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

currency_codestring

Filtra el historial a un único código de moneda virtual.

cursorstring

Cursor de paginación opaco devuelto como pagination.next_cursor en una respuesta anterior. Omítelo para obtener la primera página.

limitinteger

Número máximo de transacciones a devolver por página. El valor predeterminado es 50.

Header parameters

adapty-customer-user-idstring

El ID único del cliente en tu sistema. Se requiere adapty-customer-user-id o adapty-profile-id.

adapty-profile-idstring

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.

dataarray of objectrequired
transaction_idstringrequired

ID único de la transacción.

transaction_typestringrequired

El origen de la transacción. Uno de los valores: store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund o expiry.

itemsarray of objectrequired

Cambios de saldo por moneda registrados en esta transacción.

currency_codestringrequired

El código de la moneda virtual.

amountintegerrequired

El cambio con signo aplicado al saldo. Un valor positivo es un crédito, un valor negativo es un débito.

balance_afterintegerrequired

El saldo de la moneda después de aplicar esta transacción.

metadataobject

Pares clave-valor almacenados con la transacción, si los hay.

operationstringrequired

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"

featurestringrequired

En qué se gastaron o por qué se otorgaron las monedas, tal como usted lo envió. null en las transacciones creadas por Adapty.

customer_placement_idstringrequired

El ID de pantalla o placement de su aplicación, tal como usted lo envió. null en las transacciones creadas por Adapty.

reference_idstringrequired

El ID del objeto relacionado en su sistema, tal como usted lo envió. null en las transacciones creadas por Adapty.

is_sandboxbooleanrequired

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.

storestringrequired

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.

store_transaction_idstringrequired

ID de transacción del store de la compra relacionada. Se establece en las mismas transacciones que store.

created_atstringrequired

Cuándo se registró la transacción.

paginationobjectrequired
next_cursorstringrequired

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 — limit está fuera del rango 1–100, o no se envía ni adapty-profile-id ni adapty-customer-user-id.
  • invalid_cursor — el valor de cursor no se puede analizar.
Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

No autorizado. La clave de API falta o no es válida (error_code es not_authenticated).

Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

Perfil no encontrado (error_code es profile_does_not_exist).

Schema
errorsarray of objectrequired
sourcestring

Fuente del error

errorsarray of string

Array de mensajes de error

error_codestringrequired

Nombre corto del error

status_codeintegerrequired

Código de estado HTTP

Error interno del servidor