Finansal Hareketler

Bakiyenizi hareket ettiren tüm kayıtları listeler: hakediş, hakediş iadesi, ödeme kesintisi ve reklam ücreti.

GET/v1/finance-transactionsscope:FinanceRead

Yetkilendirme

Bu endpoint FinanceRead scope'u gerektirir. Bkz. İzinler.

Query parametreleri

Sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için Sayfalama sayfasına bakın.

Parametre	Tip	Açıklama
`entryType`	string	`Earning`, `EarningReversal`, `PayoutDebit`, `AdvertisingFee`
`fromDate`	date	Başlangıç tarihi; o günün tamamı dahildir
`toDate`	date	Bitiş tarihi; o günün tamamı dahildir

orderBy yalnızca CreatedAt ya da Amount olabilir.

Yanıt formatı

200 OK ile birlikte pagination header'ları (X-Total-Count, X-Page, X-Page-Size, X-Next-Page, X-Prev-Page) döner. Body sadece kayıt dizisini içerir.

[
  {
    "id": "019ebb179a7c7b8cad4217317cc7fc8b",
    "entryType": "AdvertisingFee",
    "referenceType": "FeaturedOffer",
    "referenceId": "019ebb17971b72e188868b7d40d40386",
    "amount": -120.0,
    "balanceAfter": 16467.02,
    "description": "Öne Çıkar — 1 Günlük",
    "createdAt": "2026-06-12T09:09:06.813023+00:00"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Hareket kimliği
`entryType`	string	Hareketin türü
`referenceType`	string	Hareketi doğuran kaynak: `OrderItem`, `Settlement`, `Payout`, `FeaturedOffer`
`referenceId`	string	O kaynağın kimliği
`amount`	decimal	Bakiyeye eklenen tutar; kesintilerde negatiftir
`balanceAfter`	decimal	Hareketten sonraki bakiye
`description`	string	Varsa açıklama; hakedişlerde genelde boştur
`createdAt`	datetime	ISO 8601, UTC

Hareket türleri

Tür	Anlamı
`Earning`	Teslim edilen bir sipariş kaleminden doğan hakediş
`EarningReversal`	İade sonrası hakedişin geri alınması
`PayoutDebit`	Ödeme yapıldığında bakiyeden düşülen tutar
`AdvertisingFee`	Öne çıkarma gibi reklam hizmetlerinin ücreti

Bakiyeyi doğrulama

En son hareketin balanceAfter değeri Finans Özeti ucundaki availableBalance ile aynıdır. Hareketten önceki bakiyeyi balanceAfter - amount ile bulabilirsiniz.

Hata kodları

Code	Anlam
`400`	Sayfalama, `entryType` ya da tarih aralığı geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`429`	Hız limiti aşıldı