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.

Bu sayfa bir mutabakat oturumunun her aşamasını ve API çağrılarını detaylandırır.

​
1. Başlatma

Mutabakat genellikle gün sonunda otomatik çalışır (banka raporlarının gelmesinden sonra, tipik olarak 02:00-04:00 arası). Manuel başlatmak için: 
POST /api/v1/reconciliations/start
{ "date": "2026-05-03" }

​
2. Karşılaştırma

Payven, gün boyu kaydedilen tüm Captured, Refunded, Voided hareketleri her bankanın gün sonu raporuyla eşleştirir. Bu aşamada status: InProgress’tir.

​
3. İnceleme

Tamamlanınca status WaitingForReview olur. Detayları çekin: 
GET /api/v1/reconciliations/{id}/details?status=Discrepancy&pageSize=50

{
  "data": {
    "items": [
      {
        "id": "det_8e3f5c12",
        "type": "AmountMismatch",
        "paymentId": "8e3f5c12-...",
        "payvenAmount": 15000,
        "bankAmount": 14750,
        "difference": 250,
        "currency": "TRY",
        "connectorCode": "GarantiVPOS",
        "bankReference": "BANK-REF-789",
        "status": "Open"
      }
    ],
    "totalCount": 12
  }
}

​
4. Tutarsızlıkları çözme

Her tutarsızlık için bir resolution atanır: 
POST /api/v1/reconciliations/{id}/details/{detailId}/resolve
{
  "resolution": "BankIsCorrect",
  "note": "Banka 250 ₺ komisyon kesti, kayıt güncellendi"
}
ResolutionAnlam
PayvenIsCorrectPayven kaydı doğru, banka tarafında düzeltme bekleniyor
BankIsCorrectBanka doğru, Payven kaydı revize edilir
InvestigateDaha sonra incelenecek (askıda)
IgnoreTutarsızlık göz ardı edilir
Toplu çözüm için bulk-resolve kullanın.

​
5. Finalize

Tüm tutarsızlıklar çözülünce mutabakat finalize edilir: 
POST /api/v1/reconciliations/{id}/finalize

{
  "data": {
    "status": "Finalized",
    "totalTransactions": 1247,
    "matchedCount": 1235,
    "discrepancyCount": 12,
    "totalAmount": 187435000,
    "settledAt": "2026-05-04T08:23:11Z"
  }
}
Finalize sonrası:
  • İlgili payment’ların status’u Captured → Settled olarak güncellenir.
  • settlementDate alanı dolar.
  • Konsoldaki “Settlement” raporlarına dahil edilir.

​
6. Webhook’lar

OlayTetiklenme
reconciliation.createdMutabakat başlatıldı
reconciliation.discrepancyTutarsızlık tespit edildi
reconciliation.completedMutabakat finalize edildi
Bu olaylara abone olarak finansal ekibinizi otomatik bilgilendirebilirsiniz.

​
Geriye dönük inceleme

Geçmiş mutabakatları sorgulamak için: 
GET /api/v1/reconciliations?from=2026-04-01&to=2026-04-30

​
SLA

AşamaTipik süre
Başlatma → Karşılaştırma tamamlanma5-30 dk (işlem hacmine bağlı)
Karşılaştırma → Tutarsızlıkların listelenmesiAnlık
Otomatik finalize (tutarsızlık yoksa)Otomatik, anlık
Tutarsızlık varsa finalize manuel olarak yapılır — operatör çözümleri girene kadar WaitingForReview statüsünde bekler.