Settlement Kayıtları

GET    /api/v1/settlements              # Liste (sayfalı)
GET    /api/v1/settlements/{id}         # Tek settlement detayı
GET    /api/v1/settlements/export       # CSV export
POST   /api/v1/settlements              # Manuel settlement oluştur (operasyonel)
PUT    /api/v1/settlements/{id}/status  # Durum güncelle

curl "https://vpos.payven.com.tr/api/v1/settlements?page=1&page_size=20&period_start_from=2026-05-01&period_start_to=2026-05-31" \
  -H "Authorization: Bearer $PAYVEN_TOKEN"

{
  "items": [
    {
      "id":                  "8e3f5c12-...",
      "merchant_id":         "3fa85f64-...",
      "period_start":        "2026-05-04",
      "period_end":          "2026-05-04",
      "bank_code":           "GARANTI",
      "currency":            "TRY",
      "gross_amount":        187435000,
      "refund_amount":       2350000,
      "bank_commission":     6747260,
      "platform_commission": 1872500,
      "net_amount":          176465240,
      "transaction_count":   1247,
      "refund_count":        18,
      "status":              "settled",
      "settled_at":          "2026-05-05T09:00:00.000+00:00",
      "bank_reference":      "STL-2026-05-04-789",
      "notes":               null,
      "created":             "2026-05-04T08:23:11.000+00:00"
    }
  ],
  "page":              1,
  "total_pages":       3,
  "total_count":       62,
  "has_previous_page": false,
  "has_next_page":     true
}

curl -X PUT https://vpos.payven.com.tr/api/v1/settlements/8e3f5c12.../status \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status":   "disputed",
    "remarks":  "Tutar bankadan eksik geldi — destek talebi açıldı"
  }'

curl -X POST https://vpos.payven.com.tr/api/v1/settlements \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Idempotency-Key: stl-garanti-2026-05-04" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_id":         "3fa85f64-...",
    "period_start":        "2026-05-04",
    "period_end":          "2026-05-04",
    "bank_code":           "GARANTI",
    "currency":            "TRY",
    "gross_amount":        187435000,
    "refund_amount":       2350000,
    "bank_commission":     6747260,
    "platform_commission": 1872500,
    "net_amount":          176465240,
    "transaction_count":   1247,
    "refund_count":        18,
    "bank_reference":      "STL-2026-05-04-789"
  }'