/api/v2/server-side-api/vc/transactions/ Sanal para birimi işlemlerini listele
Bir profil için sanal para birimi işlem geçmişini en yeniden en eskiye doğru döndürür. Sonuçlar imleç tabanlı sayfalama kullanır: yanıt null olmayan bir pagination.next_cursor içerdiğinde, sonraki sayfayı almak için bunu cursor sorgu parametresi olarak geri gönderin.
Query parameters
Geçmişi tek bir sanal para birimi koduna göre filtreler.
Önceki yanıtta pagination.next_cursor olarak döndürülen opak sayfalama imleci. İlk sayfayı almak için belirtmeyin.
Sayfa başına döndürülecek maksimum işlem sayısı. Varsayılan değer 50'dir.
Header parameters
Sisteminizdeki müşterinin benzersiz kimliği. adapty-customer-user-id veya adapty-profile-id alanlarından biri zorunludur.
Sisteminizdeki profilin benzersiz kimliği. Anonim profillerle çalışıyorsanız en iyi seçeneğinizdir. adapty-customer-user-id veya adapty-profile-id alanlarından biri zorunludur.
Responses
İşlem geçmişi başarıyla döndürüldü
Schema
Bir profil için sanal para birimi işlemlerinin sayfalandırılmış listesi.
İşlemin benzersiz kimliği.
İşlemin kaynağı. store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund veya expiry değerlerinden biri.
Bu işlemde kaydedilen para birimi bazında bakiye değişiklikleri.
Sanal para birimi kodu.
Bakiyeye uygulanan işaretli değişim. Pozitif bir değer alacak, negatif bir değer borçtur.
Bu işlem uygulandıktan sonraki para birimi bakiyesi.
Varsa işlemle birlikte saklanan anahtar-değer çiftleri.
İşlemin kaydedildiği zaman.
Sonraki sayfa için opak imleç. Daha fazla sonuç getirmek için cursor sorgu parametresi olarak iletin. Daha fazla sayfa yoksa null döner.
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="
}
}Hatalı istek. cursor değeri geçersiz (error_code değeri invalid_cursor).
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Yetkisiz. API anahtarı eksik veya geçersiz.
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Erişim reddedildi. Bu uygulama için sanal para birimleri Sunucu API'si etkin değil.
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Profil bulunamadı.
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Dahili sunucu hatası