Finans Özeti

Satıcının available/pending/onHold bakiyesini, bu ayki ödenen tutarı, bekleyen ödemesini ve son hakediş özetlerini döner.

GET/v1/finance-overviewsscope:FinanceRead

Yetkilendirme

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

Yanıt formatı

200 OK ile tek elemanlı bir dizi döner. Bu uç sayfalanmaz — diğer liste uçlarının aksine X-Total-Count, X-Page, X-Page-Size header'ları dönmez.

[
  {
    "sellerId": "019c7632858270679cd70b18de350fff",
    "availableBalance": 16467.02,
    "pendingBalance": 744.16,
    "onHoldBalance": 0.0,
    "paidThisMonth": 0.0,
    "pendingPayment": 17667.02,
    "recentSettlements": [
      {
        "id": "8aa264b8294c4197882678710c685964",
        "periodStart": "2026-05-20",
        "periodEnd": "2026-06-14",
        "amount": -224.6,
        "status": "AwaitingApproval",
        "createdAt": "2026-06-15T03:00:00.681492+00:00"
      }
    ]
  }
]

Alanlar

Alan	Tip	Açıklama
`sellerId`	string	Anahtarın ait olduğu satıcı
`availableBalance`	decimal	Çekilebilir bakiye
`pendingBalance`	decimal	Bekleyen bakiye
`onHoldBalance`	decimal	Bloke bakiye
`paidThisMonth`	decimal	İçinde bulunulan ayın 1'inden bugüne ödenen hakediş toplamı (sunucu UTC ayı)
`pendingPayment`	decimal	Henüz ödenmemiş hakedişlerin toplamı
`recentSettlements`	array	En yeniden eskiye doğru son 10 hakediş

recentSettlements[]:

Alan	Tip	Açıklama
`id`	string	Hakediş kimliği — detay için Hakediş Detayı
`periodStart` / `periodEnd`	date	Hakediş dönemi (`YYYY-MM-DD`)
`amount`	decimal	Hakedişin net tutarı — komisyon ve KDV düşülmüş; satıcı panelinde gösterilen değerle aynıdır. Negatif olabilir
`status`	string	`Draft`, `AwaitingApproval`, `Approved`, `Disputed`, `Paid`
`createdAt`	datetime	ISO 8601, UTC

Hata kodları

Code	Anlam
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`429`	Hız limiti aşıldı