İptal (Void)

Bu sayfada, VPOS üzerinden gerçekleştirilen iptal (void) işleminin API kullanımı, parametreleri ve işlem akışı detaylandırılmaktadır.

İptal (Void) İşlemi Nedir?

İptal işlemi, daha önce provizyon (authorized) alınmış bir ödemenin geriye alınması anlamına gelir. Yani, kart sahibinin onayladığı ancak henüz tamamlanmamış veya takas edilmemiş işlemler geri döndürülür.

1️) İşlem Akışı

1. Provizyon sırasında issuer banka, kart sahibinin hesabından belirli bir tutarı bloke eder (hesaptan çekilmez, sadece tutulur).

2. Kart sahibi veya üye işyeri işlemi iptal etmek istediğinde, Void talebi gönderilir.

3. Banka, bloke edilen tutarı serbest bırakır, böylece kart sahibi tekrar kullanabilir.

4. İptal işlemi yalnızca henüz takas edilmemiş işlemler için geçerlidir.

Önemli: İptal (Void) işlemi, yalnızca takas edilmemiş (settlement yapılmamış) işlemler için geçerlidir. Bu nedenle, aşağıdaki işlem türleri için iptal talebi gönderilebilir — ancak yalnızca işlem aynı gün içinde ve takas edilmeden önceyse:

• Satış (Sale): Eğer işlem henüz takas edilmediyse, iptal edilebilir. Takas sonrası yalnızca iade (Refund) mümkündür.

• Ön Provizyon (Pre-Sale): Bloke edilmiş tutar, işlem tamamlanmadan önce iptal edilebilir.

• İade (Refund): Bazı sistemlerde refund işlemi de iptal edilebilir, ancak bu bankaya ve entegrasyon yapısına göre değişir.

---

2️) İptal Edilebilirliği Kontrolü

İptal talebi göndermeden önce işlemin iptal edilebilir olduğunu doğrulamak gerekir:

• Batch No ve Process Date Kontrolü:

  • Eğer işlemin batchNo (Günsonu/İşlem Grubu Numarası) ve processDate ( İşlem Tarihi) bilgileri orijinal işlemle aynı gün ise, işlem iptal edilebilir.

• Takas Durumu:

  • İptal işlemi yalnızca takas edilmemiş işlemler için geçerlidir.

  • Takas edilmiş işlemler için Void mümkün değildir; bu durumda iade (Refund) işlemi uygulanmalıdır.

İptal işlemi, genellikle işlem günü içinde gerçekleştirilmelidir.

---

3️) Geliştirici Notları

• Request Hazırlığı:

  • Void talebi gönderirken mutlaka orijinal işlem bilgilerini (processId ve orderId) doğru iletilmelidir.

• Response Kontrolleri:

  • state → İşlemin iptalinin başarılı olup olmadığını gösterir.

  • result → İşlem sonucunun detaylarını gösterir (tutar, işlem ID, iptal durumu, vb.)

  • resultCode → VPOS uygulaması işlem durum kodu, reddedilen işlemlerde hata kodu döner. resultMessage alanında mesaj detayları bulunmaktadır.

  • procReturnCode → ISO-8583 formatında finansal işlem sonucu kodu döner. İşlem sonucu, issuer/acquirer banka tarafından belirlenir.

• Hata Yönetimi:

  • İşlem iptal edilemezse, geliştirici uygulama refund (iade) akışına yönlendirmelidir.