Raporlama

Paylox API üzerinden işlem verilerinizi sorgulama, filtreleme ve dışa aktarma yöntemleri.

İşlem Listesi

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

Filtreler

Parametre	Tip	Açıklama
start_date	string	Başlangıç tarihi (YYYY-MM-DD)
end_date	string	Bitiş tarihi (YYYY-MM-DD)
status	string	completed, failed, refunded, authorized
payment_type	string	creditcard, debitcard, bank_transfer
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)

Özet İstatistikler

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

Yanıt:

{
  "total_transactions": 1250,
  "total_amount": 18750000,
  "successful": 1150,
  "failed": 100,
  "refunded": 45,
  "approval_rate": 92.0
}

Dışa Aktarma

İşlem verilerini CSV veya JSON formatında indirin:

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

Format	Açıklama
csv	Excel, Google Sheets ile uyumlu
json	Programatik işleme için

Rapor Türleri

Rapor	Açıklama	Kullanım
Günlük özet	Günlük işlem sayısı ve toplam tutar	Operasyonel takip
Haftalık trend	Haftalık karşılaştırmalı veriler	Performans analizi
PSP bazlı	Her PSP için ayrı istatistikler	Routing optimizasyonu
Ödeme yöntemi	Yöntem bazında dağılım	Müşteri davranışı analizi
İade raporu	İade edilen işlemlerin detayı	Finansal kontrol

Otomatik Raporlama

Günlük veya haftalık otomatik rapor almak için bir cron job kurun:

from datetime import date, timedelta

def send_daily_report():
    yesterday = date.today() - timedelta(days=1)

    summary = requests.get(
        "https://api.jetcheckout.com/api/v1/payment/summary",
        params={
            "start_date": yesterday.isoformat(),
            "end_date": yesterday.isoformat()
        }
    ).json()

    send_email(
        to="[email protected]",
        subject=f"Paylox Gunluk Rapor - {yesterday}",
        body=format_report(summary)
    )