Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

Settlement, Payven’in bilgi taşıdığı banka gün sonu transferi kayıtlarıdır. Banka, gün boyunca tahsil ettiği tutarı sizin hesabınıza aktarırken ürettiği özet kayıttır.

Endpoint

GET /api/v1/settlements
JWT Bearer auth gerektirir (Backoffice).

Sorgu parametreleri

ParametreAçıklama
from / toTarih aralığı
connectorCodeBelirli bir banka
currencyPara birimi
statusPending, Settled, Disputed

Yanıt

{
  "data": {
    "items": [
      {
        "id": "stl_8e3f5c12",
        "date": "2026-05-03",
        "connectorCode": "GarantiVPOS",
        "currency": "TRY",
        "grossAmount": 187435000,
        "commission": 6747260,
        "netAmount": 180687740,
        "transactionCount": 1247,
        "status": "Settled",
        "bankReference": "STL-2026-05-03-789"
      }
    ]
  }
}
AlanAçıklama
grossAmountBrüt tahsilat (kuruş)
commissionBanka komisyonu
netAmountSizin hesabınıza aktarılan net tutar
transactionCountBu settlement’a dahil işlem sayısı
bankReferenceBankanın referans numarası

Detay endpoint’i

GET /api/v1/settlements/{id}/transactions
Bu settlement’a dahil tüm işlemleri listeler. Mutabakatla birlikte muhasebe için kritik veridir.