GET /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

currency_codestring

Geçmişi tek bir sanal para birimi koduna göre filtrele.

cursorstring

Önceki yanıtta pagination.next_cursor olarak döndürülen opak sayfalama imleci. İlk sayfayı getirmek için atlayın.

limitinteger

Sayfa başına döndürülecek maksimum işlem sayısı. Varsayılan değer 50'dir.

Header parameters

adapty-customer-user-idstring

Sisteminizdeki müşterinin benzersiz kimliği. adapty-customer-user-id veya adapty-profile-id'den biri zorunludur.

adapty-profile-idstring

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.

dataarray of objectrequired
transaction_idstringrequired

İşlemin benzersiz kimliği.

transaction_typestringrequired

İşlemin kaynağı. store_purchase, subscription_renewal, trial_start, api_transaction, dashboard_transaction, refund veya expiry değerlerinden biri.

itemsarray of objectrequired

Bu işlemde kaydedilen para birimi başına bakiye değişiklikleri.

currency_codestringrequired

Sanal para birimi kodu.

amountintegerrequired

Bakiyeye uygulanan işaretli değişim. Pozitif bir değer alacak, negatif bir değer borçtur.

balance_afterintegerrequired

Bu işlem uygulandıktan sonraki para birimi bakiyesi.

metadataobject

İşlemle birlikte saklanan anahtar-değer çiftleri (varsa).

operationstringrequired

İş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"

featurestringrequired

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.

customer_placement_idstringrequired

Uygulamanızdaki ekran veya placement kimliği; sizin gönderdiğiniz değerdir. Adapty tarafından oluşturulan işlemlerde null olur.

reference_idstringrequired

Kendi sisteminizdeki ilgili nesnenin kimliği; sizin gönderdiğiniz değerdir. Adapty tarafından oluşturulan işlemlerde null olur.

is_sandboxbooleanrequired

İş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.

storestringrequired

İ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.

store_transaction_idstringrequired

İlgili satın alımın mağaza işlem kimliği. store ile aynı işlemlerde doldurulur.

created_atstringrequired

İşlemin kaydedildiği zaman.

paginationobjectrequired
next_cursorstringrequired

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 — limit 1–100 aralığının dışında ya da ne adapty-profile-id ne de adapty-customer-user-id gönderilmiş.
  • invalid_cursor — cursor değeri ayrıştırılamıyor.
Schema
errorsarray of objectrequired
sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Yetkisiz. API anahtarı eksik veya geçersiz (error_code değeri not_authenticated).

Schema
errorsarray of objectrequired
sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Profil bulunamadı (error_code değeri profile_does_not_exist).

Schema
errorsarray of objectrequired
sourcestring

Hatanın kaynağı

errorsarray of string

Hata mesajları dizisi

error_codestringrequired

Kısa hata adı

status_codeintegerrequired

HTTP durum kodu

Dahili sunucu hatası