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.

Void, mutabakat öncesinde tam tutarlı ödeme iptalidir. İade’den farkı: void işlemi banka tarafında muhasebe hareketi yaratmaz, ödeme hiç olmamış gibi kayıttan düşer.

​
Endpoint

POST /api/v1/payments/{paymentId}/void

​
İstek

curl -X POST https://vpos.payven.com.tr/api/v1/payments/8e3f5c12-.../void \
  -H "X-API-Key: $KEY" -H "X-API-Secret: $SECRET" -H "X-Merchant-Id: $MERCHANT" \
  -H "Idempotency-Key: order-1001-void"
İstek gövdesi opsiyoneldir: 
{
  "reason": "Stok kalmadı"
}

​
Yanıt

{
  "isSuccess": true,
  "data": {
    "id": "8e3f5c12-...",
    "status": "Voided",
    "voidedAmount": 15000,
    "connector": {
      "responseCode": "00",
      "responseMessage": "İptal onaylandı"
    },
    "voidedAt": "2026-05-03T16:00:00Z"
  }
}

​
Void mu, refund mu?

KriterVoidRefund
TutarSadece tam tutarTam veya kısmi
MutabakatÖncesinde — gün içiÖncesi veya sonrası
Banka komisyonuİade edilirMutabakat sonrasında çoğunlukla iade edilmez
Müşteri ekstresindeHareket görünmez”İade” satırı olarak görünür
SüreGenelde gün sonuna kadar (banka bağımlı)180 gün
Pratik kural: Aynı gün içinde iptal istiyorsanız ve tam tutar iade edilecekse → void. Diğer durumlarda → refund.

​
Pre-Auth iptali

Bir Pre-Auth (ön provizyon) henüz capture edilmemişse void ile rezervasyon serbest bırakılır: 
curl -X POST https://vpos.payven.com.tr/api/v1/payments/{preauthId}/void \
  -H "..."
Detay: Pre-Auth ve Capture.

​
Hata yanıtları

HTTPcodeAnlam
404PAYMENT_NOT_FOUNDÖdeme bulunamadı
422VOID_NOT_ALLOWED_AFTER_SETTLEMENTMutabakat sonrası void yapılamaz — refund kullanın
422PAYMENT_ALREADY_VOIDEDZaten iptal edilmiş
422PAYMENT_NOT_VOIDABLEBu durumdaki ödeme iptal edilemez

​
Webhook olayları

  • payment.voided — İptal başarıyla tamamlandı
  • payment.void.failed — İptal banka tarafından reddedildi