/api/v2/server-side-api/vc/transactions/ Lister les transactions de monnaie virtuelle
Renvoie l'historique des transactions de monnaie virtuelle pour un profil, de la plus récente à la plus ancienne. Les résultats utilisent la pagination par curseur : lorsque la réponse inclut 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 renvoyé en tant que pagination.next_cursor dans une réponse précédente. Omettez ce paramètre 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. 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 monnaies virtuelles 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.
Variations de solde par monnaie enregistrées dans cette transaction.
Le code de la monnaie 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 monnaie après l'application de cette transaction.
Paires clé-valeur stockées avec la transaction, le cas échéant.
Quand 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": {
"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="
}
}Requête incorrecte. La valeur du cursor est invalide (error_code est invalid_cursor).
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.
Schema
Source de l'erreur
Tableau de messages d'erreur
Nom court de l'erreur
Code de statut HTTP
Interdit. L'API serveur pour les monnaies virtuelles n'est pas activée pour cette application.
Schema
Source de l'erreur
Tableau de messages d'erreur
Nom court de l'erreur
Code de statut HTTP
Profil introuvable.
Schema
Source de l'erreur
Tableau de messages d'erreur
Nom court de l'erreur
Code de statut HTTP
Erreur interne du serveur