İşlem Özeti

POST/partner/1.0/report/transaction/summary

Gerekli scope: report

Dönem içi işlemlerin durum + ödeme yöntemi + para birimi kırılımında adet ve tutar özetini döner. İşlem listesi değil, toplamlardır — kaç işlem olursa olsun tek sorgu maliyetindedir.

Kapsam API anahtarınızın işletmesidir; istekte işletme kimliği taşınmaz.

Dönem sınırı

Aralık en fazla 92 gün olabilir; daha uzun dönem date.range.too.long ile reddedilir. Daha geniş rapor için dönemi bölerek isteyin.

Örnek

curl -X POST https://<host>/partner/1.0/report/transaction/summary \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "startDate": "2026-08-01T00:00:00Z",
  "endDate": "2026-09-01T00:00:00Z"
}'

İstek Body

Alan	Tip	Açıklama
`startDate`	date	Başlangıç (dahil). Boş ise son 30 gün.
`endDate`	date	Bitiş (hariç). Boş ise şimdi.

Yanıt

Alan	Anlamı
`startDate` / `endDate`	Raporun kapsadığı dönem — boş gönderdiğiniz alanlar sunucunun uyguladığı varsayılanla döner.
`totalCount`	Dönemdeki toplam işlem adedi.
`totalAmount`	Kırılımdaki tutarların toplamı.
`totalRefundedAmount`	Dönemde iade edilen toplam.
`breakdown[]`	Durum + ödeme yöntemi + para birimi kırılımı; her satırda `count`, `amount`, `refundedAmount`.

Örnek yanıt (content)

{
  "startDate": "2026-08-01T00:00:00Z",
  "endDate": "2026-09-01T00:00:00Z",
  "totalCount": 128,
  "totalAmount": 45231.4,
  "totalRefundedAmount": 1200,
  "breakdown": [
    {
      "status": "COMPLETED",
      "paymentMethod": "POS",
      "currency": "TRY",
      "count": 120,
      "amount": 44031.4,
      "refundedAmount": 1200
    },
    {
      "status": "FAILED",
      "paymentMethod": "POS",
      "currency": "TRY",
      "count": 8,
      "amount": 1200,
      "refundedAmount": 0
    }
  ]
}

Hatalar

Mesaj anahtarı	HTTP	Neden
`date.range.too.long`	400	Aralık 92 günü aşıyor.
`date.range.invalid`	400	startDate, endDate’den önce değil.

İsteği Dene

Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.

Mock

startDateendDate