Ön Provizyon Kapatma (Post-Sale)

Bu sayfada, ön provizyon işlemi sonrasında tutarın kesinleştirilmesini sağlayan kapatma (post-authorization / capture) adımının API kullanımı ve işlem detayları açıklanmaktadır.

Ön Provizyon Kapatma İşlemi

Ön provizyon (Pre-Sale), kart sahibinin hesabında belirli bir tutarı blokaj altına alarak işlem için kullanılabilir hale getiren geçici bir provizyondur. Bu işlem; otel, araç kiralama ve e-ticaret gibi sektörlerde yaygın olarak kullanılır.

Önemli Uyarı

Ön provizyon tek başına nihai bir işlem değildir. Gerçek tahsilatın tamamlanabilmesi için mutlaka kapatma (Post-Sale / Capture) çağrısının yapılması gerekir.

İşlem Akışı

1. Ön Provizyon (Pre-Sale)

• Kart bakiyesi/limiti, belirtilen tutar kadar bloke edilir.
• Bu aşamada tutar henüz üye işyerine aktarılmaz.

2. Ön Provizyon Kapatma (Post-Sale / Capture)

• İşlemin gerçek tahsilat aşamasıdır.
• Üye işyeri, ön provizyon sırasında aldığı processId, orderId ve amount bilgilerini kullanarak kapatma talebi gönderir.
• Kapatma tutarı, ön provizyon tutarından daha düşük olabilir (kısmi tahsilat).
• Kapatma tutarı, ön provizyon tutarını aşamaz — ancak yetkili işyerleri için sistemde tanımlanan marj oranı kadar üst tutar kapaması yapılabilir.

3. İptal Durumu

Eğer üye işyeri belirli bir süre içinde kapatma talebi göndermezse:

1. Issuer banka, ön provizyonu otomatik olarak iptal eder.
2. Kart üzerindeki bloke serbest bırakılır.
3. İşlem tamamlanmamış sayılır ve sorumluluk tamamen üye işyerine aittir.

Bilgi

Bloke süresi dolmadan üye işyeri tarafından manuel iptal talebi gönderilerek bloke kaldırılabilir.

Zaman Kısıtı

Ön provizyonun ne kadar süre geçerli kalacağı issuer banka politikalarına bağlıdır (genellikle 7–14 gün).

Risk Notu

Belirlenen süre içinde kapatma çağrısı yapılmazsa, işlem banka tarafından otomatik olarak iptal edilir ve blokaj çözülür.

Geliştirici İçin Önemli Noktalar

Geliştirici Kontrol Listesi (Checklist)

• [ ] İşlem Takip Mekanizması: Kapatma işlemini unutmamak için arka planda bir yapı kurmanız önerilir (ör. Cron job, Queue worker, Scheduled task).
• [ ] Tutar Kontrolü: Kapatma Tutarı ≤ Ön Provizyon Tutarı kuralını mutlaka kod seviyesinde kontrol edin. (Tanımlı marj oranınız varsa sistem üst tutar kapamasına izin verir).
• [ ] Parametre Veri Bütünlüğü: processId, orderId ve amount parametrelerini veritabanınızda tutarlı şekilde saklayın; bu alanlar kapatma çağrısı için zorunludur.
• [ ] Erken İptal (Void): Eğer işlem iptal edilecekse, Void isteği gönderilmelidir. Void işlemi için detaylı bilgi ilgili sayfamızda bulunmaktadır.