Reports

İşlem geçmişini sorgulama, filtreleme ve dışa aktarma endpoint'leri.

İşlem Listesi

GET /api/v1/payment/transactions

Sorgu Parametreleri

Parametre	Tip	Açıklama
start_date	string	Başlangıç tarihi (ISO 8601)
end_date	string	Bitiş tarihi (ISO 8601)
status	string	Durum filtresi (completed, failed, refunded)
payment_type	string	Ödeme yöntemi filtresi
min_amount	integer	Minimum tutar (kuruş)
max_amount	integer	Maksimum tutar (kuruş)
page	integer	Sayfa numarası
per_page	integer	Sayfa başına kayıt (maks: 100)

Örnek

GET /api/v1/payment/transactions?start_date=2025-01-01&end_date=2025-01-31&status=completed&page=1&per_page=50

Yanıt

{
  "success": true,
  "total": 1250,
  "page": 1,
  "per_page": 50,
  "transactions": [
    {
      "order_id": "ORD-001",
      "amount": 15000,
      "currency": "TRY",
      "status": "completed",
      "payment_type": "creditcard",
      "card_last_four": "0055",
      "created_at": "2025-01-15T10:30:00Z"
    }
  ]
}

Özet Rapor

Belirli bir tarih aralığı için özet istatistikler:

GET /api/v1/payment/summary?start_date=2025-01-01&end_date=2025-01-31

{
  "success": true,
  "period": { "start": "2025-01-01", "end": "2025-01-31" },
  "total_transactions": 1250,
  "total_amount": 18750000,
  "successful": 1150,
  "failed": 100,
  "refunded": 45,
  "approval_rate": 92.0,
  "breakdown_by_type": {
    "creditcard": { "count": 1050, "amount": 15750000 },
    "debitcard": { "count": 150, "amount": 2250000 },
    "bank_transfer": { "count": 50, "amount": 750000 }
  }
}

Dışa Aktarma

İşlem verilerini CSV veya JSON formatında dışa aktarın:

GET /api/v1/payment/transactions/export?format=csv&start_date=2025-01-01&end_date=2025-01-31

Format	Content-Type
csv	text/csv
json	application/json