/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 döndürür. Sonuçlar imleç tabanlı sayfalama kullanır: yanıt null olmayan bir pagination.next_cursor içerdiğinde, bir sonraki sayfayı getirmek için bunu cursor sorgu parametresi olarak geri gönderin.
Query parameters
Geçmişi tek bir sanal para birimi koduna göre filtrele.
Önceki yanıtta pagination.next_cursor olarak döndürülen opak sayfalama imleci. İlk sayfayı getirmek için atlayın.
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'den 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'den 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 başına 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.
İşlemle birlikte saklanan anahtar-değer çiftleri (varsa).
İşlemin ne anlama geldiği. Adapty bunu kendi işlemlerinde otomatik olarak belirler: store_purchase, subscription_renewal ve trial_start için top_up, refund için refund, expiry için expiry atanır. Bir dashboard_transaction söz konusu olduğunda, bir ekip üyesinin Adapty Kontrol Paneli'nde bakiyeyi ayarlarken seçtiği işlemdir. Bir api_transaction söz konusu olduğunda ise sizin gönderdiğiniz değerdir; hiçbir değer göndermemişseniz null olur.
One of: "top_up", "refund", "spend", "spend_reversal", "reward", "reward_reversal", "exchange", "expiry", "migration", "adjustment"
Coinlerin ne için harcandığı veya ne karşılığında verildiği; sizin gönderdiğiniz değerdir. Adapty tarafından oluşturulan işlemlerde null olur.
Uygulamanızdaki ekran veya placement kimliği; sizin gönderdiğiniz değerdir. Adapty tarafından oluşturulan işlemlerde null olur.
Kendi sisteminizdeki ilgili nesnenin kimliği; sizin gönderdiğiniz değerdir. Adapty tarafından oluşturulan işlemlerde null olur.
İşlemin test işlemi olup olmadığı. Adapty tarafından oluşturulan işlemlerde mağaza satın alımının ortamını izler. Bir api_transaction söz konusu olduğunda ise sizin gönderdiğiniz değerdir; varsayılan olarak false kabul edilir.
İlgili satın alımın mağazası. Adapty tarafından mağaza olaylarından (satın alma, yenileme, deneme, iade) oluşturulan işlemlerde ve bir satın alma referansıyla gönderilen api_transaction işlemlerinde doldurulur.
İlgili satın alımın mağaza işlem kimliği. store ile aynı işlemlerde doldurulur.
İş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": 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="
}
} Hatalı istek. error_code alanı nedeni tanımlar:
validation_error—limit1–100 aralığının dışında ya da neadapty-profile-idne deadapty-customer-user-idgönderilmiş.invalid_cursor—cursordeğeri ayrıştırılamıyor.
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Yetkisiz. API anahtarı eksik veya geçersiz (error_code değeri not_authenticated).
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Profil bulunamadı (error_code değeri profile_does_not_exist).
Schema
Hatanın kaynağı
Hata mesajları dizisi
Kısa hata adı
HTTP durum kodu
Dahili sunucu hatası