Ön Provizyon Kapatma (Post-Sale)

Bu sayfada, ön provizyon işlemi sonrasında tutarın kesinleştirilmesini sağlayan kapatma (post-authorization) 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, özellikle otel, araç kiralama, e-ticaret gibi sektörlerde yaygın olarak kullanılır. Ancak ön provizyon tek başına nihai işlem değildir.

Ön provizyonun 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, ü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 için aldığı processId , orderId ve amount bilgilerini kullanarak kapatma talebi gönderir.

   • 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.

   • Kapatma tutarı, ön provizyon tutarından daha düşük olabilir (kısmi tahsilat).

3. İptal Durumu

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

     • Issuer banka, ön provizyonu iptal eder.

     • Kart üzerindeki bloke serbest bırakılır.

     • Bu durumda işlem tamamlanmamış sayılır ve sorumluluk tamamen üye işyerine aittir.

   • Süre dolmadan iptal talebi gönderilirse, işlem manuel olarak iptal edilebilir.

Not: Bloke süresi, issuer bankanın politikalarına göre değişir (genellikle 7–14 gün). Süre sonunda otomatik çözülme gerçekleşebilir, ancak bu durum bankaya göre farklılık gösterebilir.

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).

• Bu süre içinde kapatma yapılmazsa, işlem otomatik olarak iptal edilir.

Geliştirici İçin Önemli Noktalar

• Kapatma işlemini unutmamak için arka planda bir işlem takip mekanizması kurmanız önerilir.

  • Örn: cron job, queue worker, scheduled task.

• Kapatma tutarı ≤ Ön provizyon tutarı kuralını mutlaka kontrol edin.

• Ancak, yetkiniz varsa, sistemde tanımlı marj oranı kadar ön provizyon tutarının üzerinde kapatma yapılabilir. Marj oranı, işyeri sisteme tanımlanırken belirlenir ve işlem sırasında sistem tarafından kontrol edilir.

• processId , orderId ve amount parametrelerini tutarlı şekilde saklayın, çünkü kapatma işlemi için zorunludur.

• Eğer işlem iptal edilecekse, Void isteği gönderilmelidir. Void işlemi için detaylı bilgi ilgili sayfamızda bulunmaktadır.