/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
Filtrer l'historique sur un seul code de monnaie virtuelle.
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.
Nombre maximum de transactions à retourner par page. Par défaut 50.
Header parameters
L'identifiant unique du client dans votre système. adapty-customer-user-id ou adapty-profile-id est requis.
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.
Identifiant unique de la transaction.
La source de la transaction. L'une des valeurs suivantes : store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund ou expiry.
Modifications du solde par devise enregistrées dans cette transaction.
Le code de la devise virtuelle.
La variation signée appliquée au solde. Une valeur positive est un crédit, une valeur négative est un débit.
Le solde de la devise après l'application de cette transaction.
Paires clé-valeur stockées avec la transaction, le cas échéant.
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"
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.
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.
L'identifiant de l'objet associé dans votre système, tel que vous l'avez envoyé. null pour les transactions créées par Adapty.
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.
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.
Identifiant de transaction du store pour l'achat associé. Défini pour les mêmes transactions que store.
Date à laquelle la transaction a été enregistrée.
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—limitest en dehors de la plage 1–100, ou niadapty-profile-idniadapty-customer-user-idn'est envoyé.invalid_cursor— la valeur decursorne peut pas être analysée.
Schema
Source de l'erreur
Tableau de messages d'erreur
Nom court de l'erreur
Code de statut HTTP
Non autorisé. La clé API est manquante ou invalide (error_code est not_authenticated).
Schema
Source de l'erreur
Tableau de messages d'erreur
Nom court de l'erreur
Code de statut HTTP
Profil introuvable (error_code est profile_does_not_exist).
Schema
Source de l'erreur
Tableau de messages d'erreur
Nom court de l'erreur
Code de statut HTTP
Erreur interne du serveur