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

Lister les transactions de monnaie virtuelle

Retourne l'historique des transactions de monnaie virtuelle pour un profil, du plus récent au plus ancien. Les résultats utilisent une pagination par curseur : lorsque la réponse contient un pagination.next_cursor non nul, transmettez-le en tant que paramètre de requête cursor pour récupérer la page suivante.

Query parameters

currency_codestring

Filtrer l'historique sur un seul code de monnaie virtuelle.

cursorstring

Curseur de pagination opaque retourné en tant que pagination.next_cursor dans une réponse précédente. À omettre pour récupérer la première page.

limitinteger

Nombre maximum de transactions à retourner par page. Par défaut 50.

Header parameters

adapty-customer-user-idstring

L'identifiant unique du client dans votre système. adapty-customer-user-id ou adapty-profile-id est requis.

adapty-profile-idstring

L'identifiant unique du profil dans votre système. Votre meilleure option si vous travaillez avec des profils anonymes. adapty-customer-user-id ou adapty-profile-id est requis.

Responses

Historique des transactions retourné avec succès

Schema

Liste paginée des transactions de monnaie virtuelle pour un profil.

dataarray of objectrequired
transaction_idstringrequired

Identifiant unique de la transaction.

transaction_typestringrequired

La source de la transaction. L'une des valeurs suivantes : store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund ou expiry.

itemsarray of objectrequired

Modifications du solde par devise enregistrées dans cette transaction.

currency_codestringrequired

Le code de la devise virtuelle.

amountintegerrequired

La variation signée appliquée au solde. Une valeur positive est un crédit, une valeur négative est un débit.

balance_afterintegerrequired

Le solde de la devise après l'application de cette transaction.

metadataobject

Paires clé-valeur stockées avec la transaction, le cas échéant.

operationstringrequired

Ce que représente la transaction. Adapty le définit automatiquement pour ses propres transactions : store_purchase, subscription_renewal et trial_start reçoivent top_up, refund reçoit refund, et expiry reçoit expiry. Pour une dashboard_transaction, il s'agit de l'opération sélectionnée par un membre de l'équipe lors de l'ajustement du solde dans l'Adapty Dashboard. Pour une api_transaction, il s'agit de la valeur que vous avez envoyée, ou null si vous n'en avez envoyé aucune.

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

featurestringrequired

Ce pour quoi les crédits ont été dépensés ou accordés, tel que vous l'avez envoyé. null pour les transactions créées par Adapty.

customer_placement_idstringrequired

L'identifiant de l'écran ou du placement dans votre application, tel que vous l'avez envoyé. null pour les transactions créées par Adapty.

reference_idstringrequired

L'identifiant de l'objet associé dans votre système, tel que vous l'avez envoyé. null pour les transactions créées par Adapty.

is_sandboxbooleanrequired

Indique si la transaction est une transaction de test. Pour les transactions créées par Adapty, cette valeur suit l'environnement de l'achat dans le store. Pour une api_transaction, il s'agit de la valeur que vous avez envoyée, false par défaut.

storestringrequired

Store de l'achat associé. Défini pour les transactions créées par Adapty à partir d'événements du store (achat, renouvellement, essai, remboursement), ainsi que pour une api_transaction envoyée avec une référence d'achat.

store_transaction_idstringrequired

Identifiant de transaction du store pour l'achat associé. Défini pour les mêmes transactions que store.

created_atstringrequired

Date à laquelle la transaction a été enregistrée.

paginationobjectrequired
next_cursorstringrequired

Curseur opaque pour la page suivante. Transmettez-le en tant que paramètre de requête cursor pour récupérer d'autres résultats. Null lorsqu'il n'y a plus de pages.

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="
  }
}

Requête invalide. Le champ error_code identifie la cause :

  • validation_error — limit est en dehors de la plage 1–100, ou ni adapty-profile-id ni adapty-customer-user-id n'est envoyé.
  • invalid_cursor — la valeur de cursor ne peut pas être analysée.
Schema
errorsarray of objectrequired
sourcestring

Source de l'erreur

errorsarray of string

Tableau de messages d'erreur

error_codestringrequired

Nom court de l'erreur

status_codeintegerrequired

Code de statut HTTP

Non autorisé. La clé API est manquante ou invalide (error_code est not_authenticated).

Schema
errorsarray of objectrequired
sourcestring

Source de l'erreur

errorsarray of string

Tableau de messages d'erreur

error_codestringrequired

Nom court de l'erreur

status_codeintegerrequired

Code de statut HTTP

Profil introuvable (error_code est profile_does_not_exist).

Schema
errorsarray of objectrequired
sourcestring

Source de l'erreur

errorsarray of string

Tableau de messages d'erreur

error_codestringrequired

Nom court de l'erreur

status_codeintegerrequired

Code de statut HTTP

Erreur interne du serveur