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.

Chargeback, kart sahibinin bankasına başvurarak işlemi reddetmesi durumunda bankanın size karşı açtığı geri alma talebidir. Cevap vermez veya kaybederseniz tutar hesabınızdan çekilir.

​
Endpoint’ler

GET /api/v1/chargebacks
GET /api/v1/chargebacks/{id}
POST /api/v1/chargebacks/{id}/respond

​
Liste

curl https://vpos.payven.com.tr/api/v1/chargebacks?status=NeedsResponse \
  -H "Authorization: Bearer $TOKEN"

{
  "data": {
    "items": [
      {
        "id": "cb_8e3f5c12",
        "paymentId": "8e3f5c12-...",
        "amount": 15000,
        "currency": "TRY",
        "reasonCode": "4837",
        "reasonDescription": "İşlem yetkisiz",
        "openedAt": "2026-05-15T10:00:00Z",
        "responseDeadline": "2026-05-22T23:59:59Z",
        "status": "NeedsResponse"
      }
    ]
  }
}

​
Statüler

StatusAnlam
NeedsResponseBankaya yanıt vermeniz gerekiyor
RespondedYanıt gönderildi, banka kararı bekleniyor
WonLehinize karara bağlandı
LostAleyhinize karara bağlandı, tutar düşüldü
WithdrawnMüşteri çekildi

​
Yanıt verme

POST /api/v1/chargebacks/{id}/respond
{
  "narrative": "Müşteri ürünü teslim aldı. Kargo takip no: ...",
  "evidenceUrls": [
    "https://files.example.com/teslimat.pdf",
    "https://files.example.com/yazismalar.pdf"
  ]
}
AlanAçıklama
narrativeMüşterinin iddiasına karşı açıklamanız
evidenceUrlsKanıt belgeleri (teslimat fişi, yazışmalar, IP logları)

​
Süre kısıtı

Chargeback’lere 7 gün içinde yanıt vermelisiniz. Süreyi geçirirseniz banka otomatik olarak müşteri lehine karar verir ve tutar düşülür.

​
Önleme

Chargeback’leri en aza indirmek için:
3D Secure kullanın — chargeback sorumluluğu bankaya geçer.
Müşteri iletişim kayıtlarını saklayın.
Net açıklama yapın — kart ekstresinde müşterinin tanıyacağı bir merchant adı kullanın.
Hızlı iade politikası uygulayın — müşteri sizden iade alabilse chargeback açmaz.